@serenity-js/core 3.18.1 → 3.20.0

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.20.0](https://github.com/serenity-js/serenity-js/compare/v3.19.0...v3.20.0) (2024-03-02)
+
+
+### Features
+
+* **core:** simplified reading and writing files in CrewMembers using the FileSystem ([7f0d0cc](https://github.com/serenity-js/serenity-js/commit/7f0d0cc6de675a526a6e9351fe94055501d87e2c)), closes [#2244](https://github.com/serenity-js/serenity-js/issues/2244)
+
+
+
+
+
+# [3.19.0](https://github.com/serenity-js/serenity-js/compare/v3.18.1...v3.19.0) (2024-03-01)
+
+**Note:** Version bump only for package @serenity-js/core
+
+
+
+
+
 ## [3.18.1](https://github.com/serenity-js/serenity-js/compare/v3.18.0...v3.18.1) (2024-02-23)
 
 **Note:** Version bump only for package @serenity-js/core

package/lib/io/FileSystem.d.ts

@@ -1,26 +1,43 @@
 /// <reference types="node" />
 /// <reference types="node" />
 /// <reference types="node" />
-import type * as nodeFS from 'fs';
-import type { WriteFileOptions } from 'fs';
-import * as nodeOS from 'os';
+/// <reference types="node" />
+import * as nodeOS from 'node:os';
+import type * as NodeFS from 'fs';
 import { Path } from './Path';
 export declare class FileSystem {
     private readonly root;
     private readonly fs;
     private readonly os;
     private readonly directoryMode;
-    constructor(root: Path, fs?: typeof nodeFS, os?: typeof nodeOS, directoryMode?: number);
+    constructor(root: Path, fs?: typeof NodeFS, os?: typeof nodeOS, directoryMode?: number);
     resolve(relativeOrAbsolutePath: Path): Path;
-    store(relativeOrAbsolutePathToFile: Path, data: string | NodeJS.ArrayBufferView, encoding?: WriteFileOptions): Promise<Path>;
-    createReadStream(relativeOrAbsolutePathToFile: Path): nodeFS.ReadStream;
-    createWriteStreamTo(relativeOrAbsolutePathToFile: Path): nodeFS.WriteStream;
-    stat(relativeOrAbsolutePathToFile: Path): Promise<nodeFS.Stats>;
+    store(relativeOrAbsolutePathToFile: Path, data: string | NodeJS.ArrayBufferView, encoding?: NodeFS.WriteFileOptions): Promise<Path>;
+    readFile(relativeOrAbsolutePathToFile: Path, options?: {
+        encoding?: null | undefined;
+        flag?: string | undefined;
+    }): Promise<Buffer>;
+    readFile(relativeOrAbsolutePathToFile: Path, options: {
+        encoding: BufferEncoding;
+        flag?: string | undefined;
+    } | NodeJS.BufferEncoding): Promise<string>;
+    readFileSync(relativeOrAbsolutePathToFile: Path, options?: {
+        encoding?: null | undefined;
+        flag?: string | undefined;
+    }): Buffer;
+    readFileSync(relativeOrAbsolutePathToFile: Path, options: {
+        encoding: BufferEncoding;
+        flag?: string | undefined;
+    } | NodeJS.BufferEncoding): string;
+    writeFile(relativeOrAbsolutePathToFile: Path, data: string | NodeJS.ArrayBufferView, options?: NodeFS.WriteFileOptions): Promise<Path>;
+    writeFileSync(relativeOrAbsolutePathToFile: Path, data: string | NodeJS.ArrayBufferView, options?: NodeFS.WriteFileOptions): Path;
+    createReadStream(relativeOrAbsolutePathToFile: Path): NodeFS.ReadStream;
+    createWriteStreamTo(relativeOrAbsolutePathToFile: Path): NodeFS.WriteStream;
+    stat(relativeOrAbsolutePathToFile: Path): Promise<NodeFS.Stats>;
     exists(relativeOrAbsolutePathToFile: Path): boolean;
     remove(relativeOrAbsolutePathToFileOrDirectory: Path): Promise<void>;
     ensureDirectoryExistsAt(relativeOrAbsolutePathToDirectory: Path): Promise<Path>;
     rename(source: Path, destination: Path): Promise<void>;
     tempFilePath(prefix?: string, suffix?: string): Path;
-    private write;
 }
 //# sourceMappingURL=FileSystem.d.ts.map

package/lib/io/FileSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../../src/io/FileSystem.ts"],"names":[],"mappings":";;;AACA,OAAO,KAAK,KAAK,MAAM,MAAM,IAAI,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,IAAI,CAAC;AAE3C,OAAO,KAAK,MAAM,MAAM,IAAI,CAAC;AAG7B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,qBAAa,UAAU;IAGf,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAHb,IAAI,EAAE,IAAI,EACV,EAAE,GAAE,OAAO,MAAmB,EAC9B,EAAE,GAAE,OAAO,MAAe,EAC1B,aAAa,SAAkD;IAI7E,OAAO,CAAC,sBAAsB,EAAE,IAAI,GAAG,IAAI;IAI3C,KAAK,CAAC,4BAA4B,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5H,gBAAgB,CAAC,4BAA4B,EAAE,IAAI,GAAG,MAAM,CAAC,UAAU;IAIvE,mBAAmB,CAAC,4BAA4B,EAAE,IAAI,GAAG,MAAM,CAAC,WAAW;IAI3E,IAAI,CAAC,4BAA4B,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAM/D,MAAM,CAAC,4BAA4B,EAAE,IAAI,GAAG,OAAO;IAInD,MAAM,CAAC,uCAAuC,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BpE,uBAAuB,CAAC,iCAAiC,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B/E,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtD,YAAY,CAAC,MAAM,SAAK,EAAE,MAAM,SAAS,GAAG,IAAI;IAIvD,OAAO,CAAC,KAAK;CAYhB"}
+{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../../src/io/FileSystem.ts"],"names":[],"mappings":";;;;AAAA,OAAO,KAAK,MAAM,MAAM,SAAS,CAAC;AAGlC,OAAO,KAAK,KAAK,MAAM,MAAM,IAAI,CAAC;AAGlC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,qBAAa,UAAU;IAGf,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAHb,IAAI,EAAE,IAAI,EACV,EAAE,GAAE,OAAO,MAAmB,EAC9B,EAAE,GAAE,OAAO,MAAe,EAC1B,aAAa,SAAkD;IAI7E,OAAO,CAAC,sBAAsB,EAAE,IAAI,GAAG,IAAI;IAIrC,KAAK,CAAC,4BAA4B,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzI,QAAQ,CAAC,4BAA4B,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACpI,QAAQ,CAAC,4BAA4B,EAAE,IAAI,EAAE,OAAO,EAAE;QAAE,QAAQ,EAAE,cAAc,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAAE,GAAG,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAKxJ,YAAY,CAAC,4BAA4B,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAAE,GAAG,MAAM;IAC/H,YAAY,CAAC,4BAA4B,EAAE,IAAI,EAAE,OAAO,EAAE;QAAE,QAAQ,EAAE,cAAc,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAAE,GAAG,MAAM,CAAC,cAAc,GAAG,MAAM;IAK7I,SAAS,CAAC,4BAA4B,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5I,aAAa,CAAC,4BAA4B,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,gBAAgB,GAAG,IAAI;IAOjI,gBAAgB,CAAC,4BAA4B,EAAE,IAAI,GAAG,MAAM,CAAC,UAAU;IAIvE,mBAAmB,CAAC,4BAA4B,EAAE,IAAI,GAAG,MAAM,CAAC,WAAW;IAI3E,IAAI,CAAC,4BAA4B,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAI/D,MAAM,CAAC,4BAA4B,EAAE,IAAI,GAAG,OAAO;IAI7C,MAAM,CAAC,uCAAuC,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BpE,uBAAuB,CAAC,iCAAiC,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IASrF,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,YAAY,CAAC,MAAM,SAAK,EAAE,MAAM,SAAS,GAAG,IAAI;CAG1D"}

package/lib/io/FileSystem.js

@@ -24,10 +24,9 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileSystem = void 0;
+const nodeOS = __importStar(require("node:os"));
 const cuid2_1 = require("@paralleldrive/cuid2");
 const gracefulFS = __importStar(require("graceful-fs"));
-const nodeOS = __importStar(require("os"));
-const util_1 = require("util");
 const Path_1 = require("./Path");
 class FileSystem {
     root;
@@ -43,10 +42,25 @@ class FileSystem {
     resolve(relativeOrAbsolutePath) {
         return this.root.resolve(relativeOrAbsolutePath);
     }
-    store(relativeOrAbsolutePathToFile, data, encoding) {
-        return Promise.resolve()
-            .then(() => this.ensureDirectoryExistsAt(relativeOrAbsolutePathToFile.directory()))
-            .then(() => this.write(this.resolve(relativeOrAbsolutePathToFile), data, encoding));
+    async store(relativeOrAbsolutePathToFile, data, encoding) {
+        await this.ensureDirectoryExistsAt(relativeOrAbsolutePathToFile.directory());
+        return this.writeFile(relativeOrAbsolutePathToFile, data, encoding);
+    }
+    readFile(relativeOrAbsolutePathToFile, options) {
+        return this.fs.promises.readFile(this.resolve(relativeOrAbsolutePathToFile).value, options);
+    }
+    readFileSync(relativeOrAbsolutePathToFile, options) {
+        return this.fs.readFileSync(this.resolve(relativeOrAbsolutePathToFile).value, options);
+    }
+    async writeFile(relativeOrAbsolutePathToFile, data, options) {
+        const resolvedPath = this.resolve(relativeOrAbsolutePathToFile);
+        await this.fs.promises.writeFile(resolvedPath.value, data, options);
+        return resolvedPath;
+    }
+    writeFileSync(relativeOrAbsolutePathToFile, data, options) {
+        const resolvedPath = this.resolve(relativeOrAbsolutePathToFile);
+        this.fs.writeFileSync(resolvedPath.value, data, options);
+        return resolvedPath;
     }
     createReadStream(relativeOrAbsolutePathToFile) {
         return this.fs.createReadStream(this.resolve(relativeOrAbsolutePathToFile).value);
@@ -55,64 +69,44 @@ class FileSystem {
         return this.fs.createWriteStream(this.resolve(relativeOrAbsolutePathToFile).value);
     }
     stat(relativeOrAbsolutePathToFile) {
-        const stat = (0, util_1.promisify)(this.fs.stat);
-        return stat(this.resolve(relativeOrAbsolutePathToFile).value);
+        return this.fs.promises.stat(this.resolve(relativeOrAbsolutePathToFile).value);
     }
     exists(relativeOrAbsolutePathToFile) {
         return this.fs.existsSync(this.resolve(relativeOrAbsolutePathToFile).value);
     }
-    remove(relativeOrAbsolutePathToFileOrDirectory) {
-        const stat = (0, util_1.promisify)(this.fs.stat), unlink = (0, util_1.promisify)(this.fs.unlink), readdir = (0, util_1.promisify)(this.fs.readdir), rmdir = (0, util_1.promisify)(this.fs.rmdir);
-        const absolutePath = this.resolve(relativeOrAbsolutePathToFileOrDirectory);
-        return stat(absolutePath.value)
-            .then(result => result.isFile()
-            ? unlink(absolutePath.value)
-            : readdir(absolutePath.value)
-                .then(entries => Promise.all(entries.map(entry => this.remove(absolutePath.join(new Path_1.Path(entry))))).then(() => rmdir(absolutePath.value))))
-            .then(() => void 0)
-            .catch(error => {
+    async remove(relativeOrAbsolutePathToFileOrDirectory) {
+        try {
+            const absolutePath = this.resolve(relativeOrAbsolutePathToFileOrDirectory);
+            const stat = await this.stat(relativeOrAbsolutePathToFileOrDirectory);
+            if (stat.isFile()) {
+                await this.fs.promises.unlink(absolutePath.value);
+            }
+            else {
+                const entries = await this.fs.promises.readdir(absolutePath.value);
+                for (const entry of entries) {
+                    await this.remove(absolutePath.join(new Path_1.Path(entry)));
+                }
+                await this.fs.promises.rmdir(absolutePath.value);
+            }
+        }
+        catch (error) {
             if (error?.code === 'ENOENT') {
                 return void 0;
             }
             throw error;
-        });
+        }
     }
-    ensureDirectoryExistsAt(relativeOrAbsolutePathToDirectory) {
+    async ensureDirectoryExistsAt(relativeOrAbsolutePathToDirectory) {
         const absolutePath = this.resolve(relativeOrAbsolutePathToDirectory);
-        return absolutePath.split().reduce((promisedParent, child) => {
-            return promisedParent.then(parent => new Promise((resolve, reject) => {
-                const current = parent.resolve(new Path_1.Path(child));
-                this.fs.mkdir(current.value, this.directoryMode, error => {
-                    if (!error || error.code === 'EEXIST') {
-                        return resolve(current);
-                    }
-                    // To avoid `EISDIR` error on Mac and `EACCES`-->`ENOENT` and `EPERM` on Windows.
-                    if (error.code === 'ENOENT') { // Throw the original parentDir error on `current` `ENOENT` failure.
-                        throw new Error(`EACCES: permission denied, mkdir '${parent.value}'`);
-                    }
-                    const caughtError = !!~['EACCES', 'EPERM', 'EISDIR'].indexOf(error.code);
-                    if (!caughtError || (caughtError && current.equals(relativeOrAbsolutePathToDirectory))) {
-                        throw error; // Throw if it's just the last created dir.
-                    }
-                    return resolve(current);
-                });
-            }));
-        }, Promise.resolve(absolutePath.root()));
+        await this.fs.promises.mkdir(absolutePath.value, { recursive: true, mode: this.directoryMode });
+        return absolutePath;
     }
     rename(source, destination) {
-        const rename = (0, util_1.promisify)(this.fs.rename);
-        return rename(source.value, destination.value);
+        return this.fs.promises.rename(source.value, destination.value);
     }
     tempFilePath(prefix = '', suffix = '.tmp') {
         return Path_1.Path.from(this.fs.realpathSync(this.os.tmpdir()), `${prefix}${(0, cuid2_1.createId)()}${suffix}`);
     }
-    write(path, data, encoding) {
-        return new Promise((resolve, reject) => {
-            this.fs.writeFile(path.value, data, encoding, error => error
-                ? reject(error)
-                : resolve(path));
-        });
-    }
 }
 exports.FileSystem = FileSystem;
 //# sourceMappingURL=FileSystem.js.map

package/lib/io/FileSystem.js.map

@@ -1 +1 @@
-{"version":3,"file":"FileSystem.js","sourceRoot":"","sources":["../../src/io/FileSystem.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FileSystem.js","sourceRoot":"","sources":["../../src/io/FileSystem.ts"],"names":[],"mappings":"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"}

package/lib/io/Version.d.ts

@@ -0,0 +1,24 @@
+import { TinyType } from 'tiny-types';
+/**
+ * A tiny type describing a version number, like `1.2.3`
+ */
+export declare class Version extends TinyType {
+    private readonly version;
+    static fromJSON(version: string): Version;
+    constructor(version: string);
+    isLowerThan(other: Version): boolean;
+    isAtMost(other: Version): boolean;
+    /**
+     * @param other
+     */
+    isAtLeast(other: Version): boolean;
+    isHigherThan(other: Version): boolean;
+    /**
+     * @returns
+     *  Major version number of a given package version, i.e. `1` in `1.2.3`
+     */
+    major(): number;
+    satisfies(range: string): boolean;
+    toString(): string;
+}
+//# sourceMappingURL=Version.d.ts.map

package/lib/io/Version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Version.d.ts","sourceRoot":"","sources":["../../src/io/Version.ts"],"names":[],"mappings":"AACA,OAAO,EAA0C,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE9E;;GAEG;AACH,qBAAa,OAAQ,SAAQ,QAAQ;IAMrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;gBAIZ,OAAO,EAAE,MAAM;IAK5C,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIpC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIjC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIlC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIrC;;;OAGG;IACH,KAAK,IAAI,MAAM;IAIf,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIjC,QAAQ,IAAI,MAAM;CAGrB"}

package/lib/io/Version.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Version = void 0;
+const semver_1 = __importDefault(require("semver"));
+const tiny_types_1 = require("tiny-types");
+/**
+ * A tiny type describing a version number, like `1.2.3`
+ */
+class Version extends tiny_types_1.TinyType {
+    version;
+    static fromJSON(version) {
+        return new Version(version);
+    }
+    constructor(version) {
+        super();
+        this.version = version;
+        (0, tiny_types_1.ensure)('version', version, (0, tiny_types_1.isDefined)(), (0, tiny_types_1.isString)(), isValid());
+    }
+    isLowerThan(other) {
+        return semver_1.default.lt(this.version, other.version, { loose: false });
+    }
+    isAtMost(other) {
+        return semver_1.default.lte(this.version, other.version, { loose: false });
+    }
+    /**
+     * @param other
+     */
+    isAtLeast(other) {
+        return semver_1.default.gte(this.version, other.version, { loose: false });
+    }
+    isHigherThan(other) {
+        return semver_1.default.gt(this.version, other.version, { loose: false });
+    }
+    /**
+     * @returns
+     *  Major version number of a given package version, i.e. `1` in `1.2.3`
+     */
+    major() {
+        return Number(this.version.split('.')[0]);
+    }
+    satisfies(range) {
+        return semver_1.default.satisfies(this.version, range, { loose: false });
+    }
+    toString() {
+        return `${this.version}`;
+    }
+}
+exports.Version = Version;
+/**
+ * @package
+ */
+function isValid() {
+    return tiny_types_1.Predicate.to(`be a valid version number`, (version) => !!semver_1.default.valid(version));
+}
+//# sourceMappingURL=Version.js.map

package/lib/io/Version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Version.js","sourceRoot":"","sources":["../../src/io/Version.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAC5B,2CAA8E;AAE9E;;GAEG;AACH,MAAa,OAAQ,SAAQ,qBAAQ;IAMJ;IAJ7B,MAAM,CAAC,QAAQ,CAAC,OAAe;QAC3B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,YAA6B,OAAe;QACxC,KAAK,EAAE,CAAC;QADiB,YAAO,GAAP,OAAO,CAAQ;QAExC,IAAA,mBAAM,EAAC,SAAS,EAAE,OAAO,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,qBAAQ,GAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,WAAW,CAAC,KAAc;QACtB,OAAO,gBAAM,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,QAAQ,CAAC,KAAc;QACnB,OAAO,gBAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAc;QACpB,OAAO,gBAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,YAAY,CAAC,KAAc;QACvB,OAAO,gBAAM,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;OAGG;IACH,KAAK;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,SAAS,CAAC,KAAa;QACnB,OAAO,gBAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,QAAQ;QACJ,OAAO,GAAI,IAAI,CAAC,OAAQ,EAAE,CAAC;IAC/B,CAAC;CACJ;AA7CD,0BA6CC;AAED;;GAEG;AACH,SAAS,OAAO;IACZ,OAAO,sBAAS,CAAC,EAAE,CAAC,2BAA2B,EAAE,CAAC,OAAe,EAAE,EAAE,CACjE,CAAC,CAAE,gBAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAC3B,CAAC;AACN,CAAC"}

package/lib/io/index.d.ts

@@ -12,4 +12,5 @@ export * from './Path';
 export * from './reflection';
 export * from './RequirementsHierarchy';
 export * from './trimmed';
+export * from './Version';
 //# sourceMappingURL=index.d.ts.map

package/lib/io/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/io/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/io/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/lib/io/index.js

@@ -28,4 +28,5 @@ __exportStar(require("./Path"), exports);
 __exportStar(require("./reflection"), exports);
 __exportStar(require("./RequirementsHierarchy"), exports);
 __exportStar(require("./trimmed"), exports);
+__exportStar(require("./Version"), exports);
 //# sourceMappingURL=index.js.map

package/lib/io/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/io/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,mDAAiC;AACjC,2CAAyB;AACzB,+CAA6B;AAC7B,+CAA6B;AAC7B,uDAAqC;AACrC,2CAAyB;AACzB,8CAA4B;AAC5B,oDAAkC;AAClC,2CAAyB;AACzB,yCAAuB;AACvB,+CAA6B;AAC7B,0DAAwC;AACxC,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/io/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,mDAAiC;AACjC,2CAAyB;AACzB,+CAA6B;AAC7B,+CAA6B;AAC7B,uDAAqC;AACrC,2CAAyB;AACzB,8CAA4B;AAC5B,oDAAkC;AAClC,2CAAyB;AACzB,yCAAuB;AACvB,+CAA6B;AAC7B,0DAAwC;AACxC,4CAA0B;AAC1B,4CAA0B"}

package/lib/io/loader/ModuleLoader.d.ts

@@ -1,14 +1,18 @@
-import { Version } from './Version';
+import { Version } from '../Version';
 /**
  * Dynamically loads Node modules located relative to `cwd`.
  */
 export declare class ModuleLoader {
     readonly cwd: string;
+    readonly useRequireCache: boolean;
     /**
      * @param {string} cwd
      *  Current working directory, relative to which Node modules should be resolved.
+     * @param useRequireCache
+     *  Whether to use Node's `require.cache`. Defaults to `true`.
+     *  Set to `false` to force Node to reload required modules on every call.
      */
-    constructor(cwd: string);
+    constructor(cwd: string, useRequireCache?: boolean);
     /**
      * Returns `true` if a given module is available to be required, false otherwise.
      *
@@ -23,7 +27,7 @@ export declare class ModuleLoader {
      *  NPM module id, for example `cucumber` or `@serenity-js/core`
      *
      * @returns
-     *  Path a given Node module
+     *  Path to a given Node.js module
      */
     resolve(moduleId: string): string;
     /**
@@ -32,6 +36,7 @@ export declare class ModuleLoader {
      * @param moduleId
      */
     require(moduleId: string): any;
+    private cachedIfNeeded;
     /**
      * Returns {@apilink Version} of module specified by `moduleId`, based on its `package.json`.
      *

package/lib/io/loader/ModuleLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModuleLoader.d.ts","sourceRoot":"","sources":["../../../src/io/loader/ModuleLoader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;GAEG;AACH,qBAAa,YAAY;aAMO,GAAG,EAAE,MAAM;IAJvC;;;OAGG;gBACyB,GAAG,EAAE,MAAM;IAGvC;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQvC;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAUjC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG;IAS9B;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGvC"}
+{"version":3,"file":"ModuleLoader.d.ts","sourceRoot":"","sources":["../../../src/io/loader/ModuleLoader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;GAEG;AACH,qBAAa,YAAY;aAUD,GAAG,EAAE,MAAM;aACX,eAAe,EAAE,OAAO;IAT5C;;;;;;OAMG;gBAEiB,GAAG,EAAE,MAAM,EACX,eAAe,GAAE,OAAc;IAInD;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQvC;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAUjC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG;IAS9B,OAAO,CAAC,cAAc;IAQtB;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGvC"}

package/lib/io/loader/ModuleLoader.js

@@ -27,18 +27,23 @@ exports.ModuleLoader = void 0;
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const Module = require('module'); // No type definitions available
 const path = __importStar(require("path")); // eslint-disable-line unicorn/import-style
-const Version_1 = require("./Version");
+const Version_1 = require("../Version");
 /**
  * Dynamically loads Node modules located relative to `cwd`.
  */
 class ModuleLoader {
     cwd;
+    useRequireCache;
     /**
      * @param {string} cwd
      *  Current working directory, relative to which Node modules should be resolved.
+     * @param useRequireCache
+     *  Whether to use Node's `require.cache`. Defaults to `true`.
+     *  Set to `false` to force Node to reload required modules on every call.
      */
-    constructor(cwd) {
+    constructor(cwd, useRequireCache = true) {
         this.cwd = cwd;
+        this.useRequireCache = useRequireCache;
     }
     /**
      * Returns `true` if a given module is available to be required, false otherwise.
@@ -61,7 +66,7 @@ class ModuleLoader {
      *  NPM module id, for example `cucumber` or `@serenity-js/core`
      *
      * @returns
-     *  Path a given Node module
+     *  Path to a given Node.js module
      */
     resolve(moduleId) {
         const fromFile = path.join(this.cwd, 'noop.js');
@@ -78,12 +83,18 @@ class ModuleLoader {
      */
     require(moduleId) {
         try {
-            return require(this.resolve(moduleId));
+            return require(this.cachedIfNeeded(this.resolve(moduleId)));
         }
         catch {
-            return require(moduleId);
+            return require(this.cachedIfNeeded(moduleId));
         }
     }
+    cachedIfNeeded(moduleId) {
+        if (!this.useRequireCache) {
+            delete require.cache[moduleId];
+        }
+        return moduleId;
+    }
     /**
      * Returns {@apilink Version} of module specified by `moduleId`, based on its `package.json`.
      *

package/lib/io/loader/ModuleLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"ModuleLoader.js","sourceRoot":"","sources":["../../../src/io/loader/ModuleLoader.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,8DAA8D;AAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,gCAAgC;AAClE,2CAA6B,CAAC,2CAA2C;AAEzE,uCAAoC;AAEpC;;GAEG;AACH,MAAa,YAAY;IAMO;IAJ5B;;;OAGG;IACH,YAA4B,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IACvC,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,QAAgB;QACzB,IAAI;YACA,OAAO,CAAC,CAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;SACpC;QAAC,MAAM;YACJ,OAAO,KAAK,CAAC;SAChB;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAgB;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAEhD,OAAO,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE;YACrC,EAAE,EAAE,QAAQ;YACZ,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC;SAC3C,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,QAAgB;QACpB,IAAI;YACA,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;SAC1C;QACD,MAAM;YACF,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;SAC5B;IACL,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,QAAgB;QACtB,OAAO,IAAI,iBAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAI,QAAS,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC;IAC3E,CAAC;CACJ;AAhED,oCAgEC"}
+{"version":3,"file":"ModuleLoader.js","sourceRoot":"","sources":["../../../src/io/loader/ModuleLoader.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,8DAA8D;AAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,gCAAgC;AAClE,2CAA6B,CAAC,2CAA2C;AAEzE,wCAAqC;AAErC;;GAEG;AACH,MAAa,YAAY;IAUD;IACA;IATpB;;;;;;OAMG;IACH,YACoB,GAAW,EACX,kBAA2B,IAAI;QAD/B,QAAG,GAAH,GAAG,CAAQ;QACX,oBAAe,GAAf,eAAe,CAAgB;IAEnD,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,QAAgB;QACzB,IAAI;YACA,OAAO,CAAC,CAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;SACpC;QAAC,MAAM;YACJ,OAAO,KAAK,CAAC;SAChB;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAgB;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAEhD,OAAO,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE;YACrC,EAAE,EAAE,QAAQ;YACZ,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC;SAC3C,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,QAAgB;QACpB,IAAI;YACA,OAAO,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;SAC/D;QACD,MAAM;YACF,OAAO,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;SACjD;IACL,CAAC;IAEO,cAAc,CAAC,QAAgB;QACnC,IAAI,CAAE,IAAI,CAAC,eAAe,EAAE;YACxB,OAAO,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;SAClC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,QAAgB;QACtB,OAAO,IAAI,iBAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAI,QAAS,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC;IAC3E,CAAC;CACJ;AA9ED,oCA8EC"}

package/lib/io/loader/index.d.ts

@@ -2,5 +2,4 @@ export * from './ClassDescriptionParser';
 export * from './ClassDescriptor';
 export * from './ClassLoader';
 export * from './ModuleLoader';
-export * from './Version';
 //# sourceMappingURL=index.d.ts.map

package/lib/io/loader/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/io/loader/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/io/loader/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/lib/io/loader/index.js

@@ -18,5 +18,4 @@ __exportStar(require("./ClassDescriptionParser"), exports);
 __exportStar(require("./ClassDescriptor"), exports);
 __exportStar(require("./ClassLoader"), exports);
 __exportStar(require("./ModuleLoader"), exports);
-__exportStar(require("./Version"), exports);
 //# sourceMappingURL=index.js.map

package/lib/io/loader/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/io/loader/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,oDAAkC;AAClC,gDAA8B;AAC9B,iDAA+B;AAC/B,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/io/loader/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,oDAAkC;AAClC,gDAA8B;AAC9B,iDAA+B"}

package/lib/screenplay/abilities/Ability.d.ts

@@ -7,7 +7,7 @@ import type { UsesAbilities } from './UsesAbilities';
  *
  * From the technical perspective, **abilities** act as **wrappers** around any **integration libraries** required
  * to communicate with the external interfaces of system under test,
- * such as {@apilink BrowseTheWeb|web browser drivers} or a {@apilink CallAnApi|HTTP client}.
+ * such as {@apilink BrowseTheWeb|web browser drivers} or an {@apilink CallAnApi|HTTP client}.
  * They also enable [portability](/handbook/design/portable-test-code)
  * of your test code across such integration libraries.
  *

package/lib/screenplay/abilities/Ability.js

@@ -8,7 +8,7 @@ exports.Ability = void 0;
  *
  * From the technical perspective, **abilities** act as **wrappers** around any **integration libraries** required
  * to communicate with the external interfaces of system under test,
- * such as {@apilink BrowseTheWeb|web browser drivers} or a {@apilink CallAnApi|HTTP client}.
+ * such as {@apilink BrowseTheWeb|web browser drivers} or an {@apilink CallAnApi|HTTP client}.
  * They also enable [portability](/handbook/design/portable-test-code)
  * of your test code across such integration libraries.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/core",
-  "version": "3.18.1",
+  "version": "3.20.0",
   "description": "Serenity/JS Screenplay, reporting engine and core interfaces.",
   "author": {
     "name": "Jan Molak",
@@ -50,7 +50,7 @@
     "@types/diff": "5.0.9",
     "@types/filenamify": "2.0.2",
     "@types/mocha": "10.0.6",
-    "@types/semver": "7.5.7",
+    "@types/semver": "7.5.8",
     "@types/validate-npm-package-name": "4.0.2",
     "assertion-error-formatter": "3.0.0",
     "c8": "9.1.0",
@@ -71,5 +71,5 @@
   "engines": {
     "node": "^16.13 || ^18.12 || ^20"
   },
-  "gitHead": "e64f71601cae8bf0060f60a5d65dbe5e1e981a72"
+  "gitHead": "2089afc60adb2751416fa6d800d4e7af95a99f25"
 }

package/src/io/FileSystem.ts

@@ -1,9 +1,8 @@
+import * as nodeOS from 'node:os';
+
 import { createId } from '@paralleldrive/cuid2';
-import type * as nodeFS from 'fs';
-import type { WriteFileOptions } from 'fs';
+import type * as NodeFS from 'fs';
 import * as gracefulFS from 'graceful-fs';
-import * as nodeOS from 'os';
-import { promisify } from 'util';
 
 import { Path } from './Path';
 
@@ -11,7 +10,7 @@ export class FileSystem {
 
     constructor(
         private readonly root: Path,
-        private readonly fs: typeof nodeFS = gracefulFS,
+        private readonly fs: typeof NodeFS = gracefulFS,
         private readonly os: typeof nodeOS = nodeOS,
         private readonly directoryMode = Number.parseInt('0777', 8) & (~process.umask()),
     ) {
@@ -21,108 +20,93 @@ export class FileSystem {
         return this.root.resolve(relativeOrAbsolutePath);
     }
 
-    public store(relativeOrAbsolutePathToFile: Path, data: string | NodeJS.ArrayBufferView, encoding?: WriteFileOptions): Promise<Path> {
-        return Promise.resolve()
-            .then(() => this.ensureDirectoryExistsAt(relativeOrAbsolutePathToFile.directory()))
-            .then(() => this.write(this.resolve(relativeOrAbsolutePathToFile), data, encoding));
+    public async store(relativeOrAbsolutePathToFile: Path, data: string | NodeJS.ArrayBufferView, encoding?: NodeFS.WriteFileOptions): Promise<Path> {
+        await this.ensureDirectoryExistsAt(relativeOrAbsolutePathToFile.directory());
+        return this.writeFile(relativeOrAbsolutePathToFile, data, encoding);
+    }
+
+    public readFile(relativeOrAbsolutePathToFile: Path, options?: { encoding?: null | undefined; flag?: string | undefined; }): Promise<Buffer>
+    public readFile(relativeOrAbsolutePathToFile: Path, options: { encoding: BufferEncoding; flag?: string | undefined; } | NodeJS.BufferEncoding): Promise<string>
+    public readFile(relativeOrAbsolutePathToFile: Path, options?: (NodeFS.ObjectEncodingOptions & { flag?: string | undefined; }) | NodeJS.BufferEncoding): Promise<string | Buffer> {
+        return this.fs.promises.readFile(this.resolve(relativeOrAbsolutePathToFile).value, options);
+    }
+
+    public readFileSync(relativeOrAbsolutePathToFile: Path, options?: { encoding?: null | undefined; flag?: string | undefined; }): Buffer
+    public readFileSync(relativeOrAbsolutePathToFile: Path, options: { encoding: BufferEncoding; flag?: string | undefined; } | NodeJS.BufferEncoding): string
+    public readFileSync(relativeOrAbsolutePathToFile: Path, options?: (NodeFS.ObjectEncodingOptions & { flag?: string | undefined; }) | NodeJS.BufferEncoding): string | Buffer {
+        return this.fs.readFileSync(this.resolve(relativeOrAbsolutePathToFile).value, options);
     }
 
-    public createReadStream(relativeOrAbsolutePathToFile: Path): nodeFS.ReadStream {
+    public async writeFile(relativeOrAbsolutePathToFile: Path, data: string | NodeJS.ArrayBufferView, options?: NodeFS.WriteFileOptions): Promise<Path> {
+        const resolvedPath = this.resolve(relativeOrAbsolutePathToFile);
+        await this.fs.promises.writeFile(resolvedPath.value, data, options);
+
+        return resolvedPath;
+    }
+
+    public writeFileSync(relativeOrAbsolutePathToFile: Path, data: string | NodeJS.ArrayBufferView, options?: NodeFS.WriteFileOptions): Path {
+        const resolvedPath = this.resolve(relativeOrAbsolutePathToFile);
+        this.fs.writeFileSync(resolvedPath.value, data, options);
+
+        return resolvedPath;
+    }
+
+    public createReadStream(relativeOrAbsolutePathToFile: Path): NodeFS.ReadStream {
         return this.fs.createReadStream(this.resolve(relativeOrAbsolutePathToFile).value);
     }
 
-    public createWriteStreamTo(relativeOrAbsolutePathToFile: Path): nodeFS.WriteStream {
+    public createWriteStreamTo(relativeOrAbsolutePathToFile: Path): NodeFS.WriteStream {
         return this.fs.createWriteStream(this.resolve(relativeOrAbsolutePathToFile).value);
     }
 
-    public stat(relativeOrAbsolutePathToFile: Path): Promise<nodeFS.Stats> {
-        const stat = promisify(this.fs.stat);
-
-        return stat(this.resolve(relativeOrAbsolutePathToFile).value);
+    public stat(relativeOrAbsolutePathToFile: Path): Promise<NodeFS.Stats> {
+        return this.fs.promises.stat(this.resolve(relativeOrAbsolutePathToFile).value);
     }
 
     public exists(relativeOrAbsolutePathToFile: Path): boolean {
         return this.fs.existsSync(this.resolve(relativeOrAbsolutePathToFile).value);
     }
 
-    public remove(relativeOrAbsolutePathToFileOrDirectory: Path): Promise<void> {
-        const
-            stat = promisify(this.fs.stat),
-            unlink = promisify(this.fs.unlink),
-            readdir = promisify(this.fs.readdir),
-            rmdir = promisify(this.fs.rmdir);
-
-        const absolutePath = this.resolve(relativeOrAbsolutePathToFileOrDirectory);
-
-        return stat(absolutePath.value)
-            .then(result =>
-                result.isFile()
-                    ? unlink(absolutePath.value)
-                    : readdir(absolutePath.value)
-                        .then(entries =>
-                            Promise.all(entries.map(entry =>
-                                this.remove(absolutePath.join(new Path(entry)))),
-                            ).then(() => rmdir(absolutePath.value)),
-                        ),
-            )
-            .then(() => void 0)
-            .catch(error => {
-                if (error?.code === 'ENOENT') {
-                    return void 0;
+    public async remove(relativeOrAbsolutePathToFileOrDirectory: Path): Promise<void> {
+        try {
+            const absolutePath = this.resolve(relativeOrAbsolutePathToFileOrDirectory);
+
+            const stat = await this.stat(relativeOrAbsolutePathToFileOrDirectory);
+
+            if (stat.isFile()) {
+                await this.fs.promises.unlink(absolutePath.value);
+            }
+            else {
+                const entries = await this.fs.promises.readdir(absolutePath.value);
+                for (const entry of entries) {
+                    await this.remove(absolutePath.join(new Path(entry)));
                 }
-                throw error;
-            });
+
+                await this.fs.promises.rmdir(absolutePath.value);
+            }
+        }
+        catch (error) {
+            if (error?.code === 'ENOENT') {
+                return void 0;
+            }
+            throw error;
+        }
     }
 
-    public ensureDirectoryExistsAt(relativeOrAbsolutePathToDirectory: Path): Promise<Path> {
+    public async ensureDirectoryExistsAt(relativeOrAbsolutePathToDirectory: Path): Promise<Path> {
 
         const absolutePath = this.resolve(relativeOrAbsolutePathToDirectory);
 
-        return absolutePath.split().reduce((promisedParent, child) => {
-            return promisedParent.then(parent => new Promise((resolve, reject) => {
-                const current = parent.resolve(new Path(child));
-
-                this.fs.mkdir(current.value, this.directoryMode, error => {
-                    if (! error || error.code === 'EEXIST') {
-                        return resolve(current);
-                    }
-
-                    // To avoid `EISDIR` error on Mac and `EACCES`-->`ENOENT` and `EPERM` on Windows.
-                    if (error.code === 'ENOENT') { // Throw the original parentDir error on `current` `ENOENT` failure.
-                        throw new Error(`EACCES: permission denied, mkdir '${ parent.value }'`);
-                    }
-
-                    const caughtError = !! ~['EACCES', 'EPERM', 'EISDIR'].indexOf(error.code);
-                    if (! caughtError || (caughtError && current.equals(relativeOrAbsolutePathToDirectory))) {
-                        throw error; // Throw if it's just the last created dir.
-                    }
-
-                    return resolve(current);
-                });
-            }));
-        }, Promise.resolve(absolutePath.root()));
+        await this.fs.promises.mkdir(absolutePath.value, { recursive: true, mode: this.directoryMode });
+
+        return absolutePath;
     }
 
     public rename(source: Path, destination: Path): Promise<void> {
-        const rename = promisify(this.fs.rename);
-
-        return rename(source.value, destination.value);
+        return this.fs.promises.rename(source.value, destination.value);
     }
 
     public tempFilePath(prefix = '', suffix = '.tmp'): Path {
         return Path.from(this.fs.realpathSync(this.os.tmpdir()), `${ prefix }${ createId() }${ suffix }`);
     }
-
-    private write(path: Path, data: string | NodeJS.ArrayBufferView, encoding?: WriteFileOptions): Promise<Path> {
-        return new Promise((resolve, reject) => {
-            this.fs.writeFile(
-                path.value,
-                data,
-                encoding,
-                error => error
-                    ? reject(error)
-                    : resolve(path),
-            );
-        });
-    }
 }

package/src/io/Version.ts

@@ -0,0 +1,61 @@
+import semver from 'semver';
+import { ensure, isDefined, isString, Predicate, TinyType } from 'tiny-types';
+
+/**
+ * A tiny type describing a version number, like `1.2.3`
+ */
+export class Version extends TinyType {
+
+    static fromJSON(version: string): Version {
+        return new Version(version);
+    }
+
+    constructor(private readonly version: string) {
+        super();
+        ensure('version', version, isDefined(), isString(), isValid());
+    }
+
+    isLowerThan(other: Version): boolean {
+        return semver.lt(this.version, other.version, { loose: false });
+    }
+
+    isAtMost(other: Version): boolean {
+        return semver.lte(this.version, other.version, { loose: false });
+    }
+
+    /**
+     * @param other
+     */
+    isAtLeast(other: Version): boolean {
+        return semver.gte(this.version, other.version, { loose: false });
+    }
+
+    isHigherThan(other: Version): boolean {
+        return semver.gt(this.version, other.version, { loose: false });
+    }
+
+    /**
+     * @returns
+     *  Major version number of a given package version, i.e. `1` in `1.2.3`
+     */
+    major(): number {
+        return Number(this.version.split('.')[0]);
+    }
+
+    satisfies(range: string): boolean {
+        return semver.satisfies(this.version, range, { loose: false });
+    }
+
+    toString(): string {
+        return `${ this.version }`;
+    }
+}
+
+/**
+ * @package
+ */
+function isValid(): Predicate<string> {
+    return Predicate.to(`be a valid version number`, (version: string) =>
+        !! semver.valid(version),
+    );
+}

package/src/io/index.ts

@@ -12,3 +12,4 @@ export * from './Path';
 export * from './reflection';
 export * from './RequirementsHierarchy';
 export * from './trimmed';
+export * from './Version';

package/src/io/loader/ModuleLoader.ts

@@ -2,7 +2,7 @@
 const Module = require('module'); // No type definitions available
 import * as path from 'path'; // eslint-disable-line unicorn/import-style
 
-import { Version } from './Version';
+import { Version } from '../Version';
 
 /**
  * Dynamically loads Node modules located relative to `cwd`.
@@ -12,8 +12,14 @@ export class ModuleLoader {
     /**
      * @param {string} cwd
      *  Current working directory, relative to which Node modules should be resolved.
+     * @param useRequireCache
+     *  Whether to use Node's `require.cache`. Defaults to `true`.
+     *  Set to `false` to force Node to reload required modules on every call.
      */
-    constructor(public readonly cwd: string) {
+    constructor(
+        public readonly cwd: string,
+        public readonly useRequireCache: boolean = true,
+    ) {
     }
 
     /**
@@ -37,7 +43,7 @@ export class ModuleLoader {
      *  NPM module id, for example `cucumber` or `@serenity-js/core`
      *
      * @returns
-     *  Path a given Node module
+     *  Path to a given Node.js module
      */
     resolve(moduleId: string): string {
         const fromFile = path.join(this.cwd, 'noop.js');
@@ -56,13 +62,21 @@ export class ModuleLoader {
      */
     require(moduleId: string): any {
         try {
-            return require(this.resolve(moduleId));
+            return require(this.cachedIfNeeded(this.resolve(moduleId)));
         }
         catch {
-            return require(moduleId);
+            return require(this.cachedIfNeeded(moduleId));
         }
     }
 
+    private cachedIfNeeded(moduleId: string): string {
+        if (! this.useRequireCache) {
+            delete require.cache[moduleId];
+        }
+
+        return moduleId;
+    }
+
     /**
      * Returns {@apilink Version} of module specified by `moduleId`, based on its `package.json`.
      *

package/src/io/loader/index.ts

@@ -2,4 +2,3 @@ export * from './ClassDescriptionParser';
 export * from './ClassDescriptor';
 export * from './ClassLoader';
 export * from './ModuleLoader';
-export * from './Version';

package/src/screenplay/abilities/Ability.ts

@@ -8,7 +8,7 @@ import type { UsesAbilities } from './UsesAbilities';
  *
  * From the technical perspective, **abilities** act as **wrappers** around any **integration libraries** required
  * to communicate with the external interfaces of system under test,
- * such as {@apilink BrowseTheWeb|web browser drivers} or a {@apilink CallAnApi|HTTP client}.
+ * such as {@apilink BrowseTheWeb|web browser drivers} or an {@apilink CallAnApi|HTTP client}.
  * They also enable [portability](/handbook/design/portable-test-code)
  * of your test code across such integration libraries.
  *