poku 1.15.1 → 1.16.0

package/README.md

@@ -184,6 +184,7 @@ That's it 🎉
 - [**test**](https://poku.io/docs/documentation/helpers/test)
 - [**describe**](https://poku.io/docs/documentation/helpers/describe) and [**it**](https://poku.io/docs/documentation/helpers/it)
 - [**beforeEach**](https://poku.io/docs/category/beforeeach-and-aftereach) and [**afterEach**](https://poku.io/docs/category/beforeeach-and-aftereach)
+- [**watch**](https://poku.io/docs/documentation/poku/options/watch)
 - **Processes**
   - [**kill**](https://poku.io/docs/documentation/processes/kill) (_terminate Ports, Port Ranges and PIDs_)
   - [**getPIDs**](https://poku.io/docs/documentation/processes/get-pids) (_get all processes IDs using ports and port ranges_)

package/lib/bin/index.js

@@ -13,12 +13,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 const list_files_js_1 = require("../modules/list-files.js");
 const get_arg_js_1 = require("../helpers/get-arg.js");
-const poku_js_1 = require("../modules/poku.js");
-const processes_js_1 = require("../modules/processes.js");
+const files_js_1 = require("../configs/files.js");
 const get_runtime_js_1 = require("../helpers/get-runtime.js");
 const format_js_1 = require("../helpers/format.js");
 const logs_js_1 = require("../helpers/logs.js");
 const hr_js_1 = require("../helpers/hr.js");
+const watch_js_1 = require("../services/watch.js");
+const poku_js_1 = require("../modules/poku.js");
+const processes_js_1 = require("../modules/processes.js");
 (() => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     const dirs = (() => {
@@ -43,6 +45,7 @@ const hr_js_1 = require("../helpers/hr.js");
     const quiet = (0, get_arg_js_1.hasArg)('quiet');
     const debug = (0, get_arg_js_1.hasArg)('debug');
     const failFast = (0, get_arg_js_1.hasArg)('fail-fast');
+    const watchMode = (0, get_arg_js_1.hasArg)('watch');
     const concurrency = parallel
         ? Number((0, get_arg_js_1.getArg)('concurrency')) || undefined
         : undefined;
@@ -72,6 +75,7 @@ const hr_js_1 = require("../helpers/hr.js");
         debug,
         failFast,
         concurrency,
+        noExit: watchMode,
         deno: {
             allow: denoAllow,
             deny: denoDeny,
@@ -87,6 +91,30 @@ const hr_js_1 = require("../helpers/hr.js");
         (0, logs_js_1.write)(`${format_js_1.format.italic(format_js_1.format.info('…'))} ${format_js_1.format.bold('Options')}`);
         console.dir(options, { depth: null, colors: true });
     }
-    (0, poku_js_1.poku)(dirs, options);
+    yield (0, poku_js_1.poku)(dirs, options);
+    if (watchMode) {
+        const executing = new Set();
+        const interval = Number((0, get_arg_js_1.getArg)('watch-interval')) || 1500;
+        files_js_1.fileResults.success.clear();
+        files_js_1.fileResults.fail.clear();
+        (0, hr_js_1.hr)();
+        (0, logs_js_1.write)(`Watching: ${dirs.join(', ')}`);
+        dirs.forEach((dir) => {
+            (0, watch_js_1.watch)(dir, (file, event) => {
+                if (event === 'change') {
+                    if (executing.has(file))
+                        return;
+                    executing.add(file);
+                    files_js_1.fileResults.success.clear();
+                    files_js_1.fileResults.fail.clear();
+                    (0, poku_js_1.poku)(file, options).then(() => {
+                        setTimeout(() => {
+                            executing.delete(file);
+                        }, interval);
+                    });
+                }
+            });
+        });
+    }
 }))();
 /* c8 ignore stop */

package/lib/modules/each.d.ts

@@ -47,5 +47,5 @@ export declare const beforeEach: (callback: () => unknown, options?: EachOptions
  * after.reset();
  * ```
  */
-export declare const afterEach: (callback: () => unknown, options: Omit<EachOptions, 'immediate'>) => Control;
+export declare const afterEach: (callback: () => unknown, options?: Omit<EachOptions, 'immediate'>) => Control;
 export {};

package/lib/polyfills/fs.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="node" />
+import { type Dirent, type Stats } from 'node:fs';
+export declare const readdir: (path: string, options: {
+    withFileTypes: true;
+}) => Promise<Dirent[]>;
+export declare const stat: (path: string) => Promise<Stats>;

package/lib/polyfills/fs.js

@@ -0,0 +1,26 @@
+"use strict";
+/* c8 ignore start */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stat = exports.readdir = void 0;
+const node_fs_1 = require("fs");
+const readdir = (path, options) => new Promise((resolve, reject) => {
+    (0, node_fs_1.readdir)(path, options, (err, entries) => {
+        if (err)
+            reject(err);
+        else
+            resolve(entries);
+    });
+});
+exports.readdir = readdir;
+const stat = (path) => {
+    return new Promise((resolve, reject) => {
+        (0, node_fs_1.stat)(path, (err, stats) => {
+            if (err)
+                reject(err);
+            else
+                resolve(stats);
+        });
+    });
+};
+exports.stat = stat;
+/* c8 ignore stop */

package/lib/services/watch.d.ts

@@ -0,0 +1,18 @@
+export type WatchCallback = (file: string, event: string) => void;
+declare class Watcher {
+    private rootDir;
+    private files;
+    private fileWatchers;
+    private dirWatchers;
+    private callback;
+    constructor(rootDir: string, callback: WatchCallback);
+    private watchFile;
+    private unwatchFiles;
+    private watchFiles;
+    private watchDirectory;
+    start(): Promise<void>;
+    stop(): void;
+    private unwatchDirectories;
+}
+export declare const watch: (path: string, callback: WatchCallback) => Promise<Watcher>;
+export {};

package/lib/services/watch.js

@@ -0,0 +1,122 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.watch = void 0;
+/* c8 ignore next */
+const node_fs_1 = require("fs");
+const node_path_1 = require("path");
+const fs_js_1 = require("../polyfills/fs.js");
+const list_files_js_1 = require("../modules/list-files.js");
+class Watcher {
+    constructor(rootDir, callback) {
+        this.files = [];
+        this.fileWatchers = new Map();
+        this.dirWatchers = new Map();
+        this.rootDir = rootDir;
+        this.callback = callback;
+    }
+    watchFile(filePath) {
+        /* c8 ignore next */
+        if (this.fileWatchers.has(filePath))
+            return;
+        const watcher = (0, node_fs_1.watch)(filePath, (eventType) => {
+            this.callback(filePath, eventType);
+        });
+        /* c8 ignore start */
+        watcher.on('error', () => {
+            return;
+        });
+        /* c8 ignore stop */
+        this.fileWatchers.set(filePath, watcher);
+    }
+    unwatchFiles() {
+        for (const [filePath, watcher] of this.fileWatchers) {
+            watcher.close();
+            this.fileWatchers.delete(filePath);
+        }
+    }
+    watchFiles(filePaths) {
+        this.unwatchFiles();
+        for (const filePath of filePaths) {
+            this.watchFile(filePath);
+        }
+    }
+    watchDirectory(dir) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.dirWatchers.has(dir))
+                return;
+            const watcher = (0, node_fs_1.watch)(dir, (_, filename) => __awaiter(this, void 0, void 0, function* () {
+                if (filename) {
+                    const fullPath = (0, node_path_1.join)(dir, filename);
+                    this.files = yield (0, list_files_js_1.listFiles)(this.rootDir);
+                    this.watchFiles(this.files);
+                    try {
+                        const stats = yield (0, fs_js_1.stat)(fullPath);
+                        if (stats.isDirectory())
+                            yield this.watchDirectory(fullPath);
+                        /* c8 ignore start */
+                    }
+                    catch (_a) { }
+                    /* c8 ignore stop */
+                }
+            }));
+            /* c8 ignore start */
+            watcher.on('error', () => {
+                return;
+            });
+            /* c8 ignore stop */
+            this.dirWatchers.set(dir, watcher);
+            const entries = yield (0, fs_js_1.readdir)(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const fullPath = (0, node_path_1.join)(dir, entry.name);
+                    yield this.watchDirectory(fullPath);
+                }
+            }
+        });
+    }
+    start() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const stats = yield (0, fs_js_1.stat)(this.rootDir);
+                if (stats.isDirectory()) {
+                    this.files = yield (0, list_files_js_1.listFiles)(this.rootDir);
+                    this.watchFiles(this.files);
+                    yield this.watchDirectory(this.rootDir);
+                }
+                else
+                    this.watchFile(this.rootDir);
+                /* c8 ignore start */
+            }
+            catch (err) {
+                throw new Error(`Path does not exist or is not accessible: ${this.rootDir}`);
+            }
+            /* c8 ignore stop */
+        });
+    }
+    stop() {
+        this.unwatchFiles();
+        this.unwatchDirectories();
+    }
+    unwatchDirectories() {
+        for (const [dirPath, watcher] of this.dirWatchers) {
+            watcher.close();
+            this.dirWatchers.delete(dirPath);
+        }
+    }
+}
+/* c8 ignore next */
+const watch = (path, callback) => __awaiter(void 0, void 0, void 0, function* () {
+    const watcher = new Watcher(path, callback);
+    yield watcher.start();
+    return watcher;
+});
+exports.watch = watch;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poku",
-  "version": "1.15.1",
+  "version": "1.16.0",
   "description": "🐷 Poku makes testing easy for Node.js, Bun, Deno and you at the same time.",
   "main": "./lib/index.js",
   "scripts": {
@@ -126,7 +126,7 @@
     "@types/node": "^20.14.2",
     "@typescript-eslint/eslint-plugin": "^7.13.0",
     "@typescript-eslint/parser": "^7.13.0",
-    "c8": "^10.1.0",
+    "c8": "^10.1.2",
     "esbuild": "^0.21.5",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^9.1.0",
@@ -136,7 +136,7 @@
     "packages-update": "^2.0.0",
     "prettier": "^3.3.2",
     "shx": "^0.3.4",
-    "tsx": "4.15.2",
+    "tsx": "4.15.4",
     "typescript": "^5.4.5"
   }
 }