@serenity-js/core 3.41.1 → 3.42.0

package/esm/io/inspectedObject.js

@@ -0,0 +1,28 @@
+import util from 'node:util';
+import { ValueInspector } from './reflection/index.js';
+export function inspectedObject(value, allowFields) {
+    return function (depth, options, inspect = util.inspect) {
+        const typeName = options.stylize(ValueInspector.typeOf(value), 'special');
+        if (depth < 0) {
+            return typeName;
+        }
+        const fields = Object.getOwnPropertyNames(value)
+            .filter(field => typeof value[field] !== 'function')
+            .filter(field => allowFields ? allowFields.includes(field) : true)
+            .sort();
+        if (fields.length === 0) {
+            return `${typeName} { }`;
+        }
+        const newOptions = Object.assign({}, options, {
+            depth: options?.depth > 0
+                ? options.depth - 1
+                : undefined,
+        });
+        const padding = ' '.repeat(2);
+        const lines = fields.flatMap(field => `${field}: ${inspect(value[field], newOptions)}`
+            .split('\n')
+            .map(line => `${padding}${line}`)).join('\n');
+        return `${typeName} {\n${lines}\n}`;
+    };
+}
+//# sourceMappingURL=inspectedObject.js.map

package/esm/io/inspectedObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectedObject.js","sourceRoot":"","sources":["../../src/io/inspectedObject.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,UAAU,eAAe,CAAI,KAAQ,EAAE,WAA4B;IACrE,OAAO,UAAU,KAAa,EAAE,OAAoC,EAAE,UAA+B,IAAI,CAAC,OAAO;QAC7G,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;QAE1E,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACZ,OAAO,QAAQ,CAAC;QACpB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC;aAC3C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,UAAU,CAAC;aACnD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;aAC5E,IAAI,EAAE,CAAC;QAEZ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,GAAI,QAAS,MAAM,CAAC;QAC/B,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE;YAC1C,KAAK,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC;gBACrB,CAAC,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC;gBACnB,CAAC,CAAC,SAAS;SAClB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAE9B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CACxB,KAAK,CAAC,EAAE,CAAC,GAAI,KAAM,KAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,UAAU,CAAE,EAAE;aACxD,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAI,OAAQ,GAAI,IAAK,EAAE,CAAC,CAC5C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO,GAAI,QAAS,OAAQ,KAAM,KAAK,CAAC;IAC5C,CAAC,CAAA;AACL,CAAC"}

package/esm/io/loader/ClassDescriptionParser.d.ts

@@ -0,0 +1,8 @@
+import type { ClassDescription } from '../../config/index.js';
+import type { ClassDescriptor } from './ClassDescriptor.js';
+export declare class ClassDescriptionParser {
+    private static validClassNamePattern;
+    looksLikeClassDescription(candidate: unknown): candidate is ClassDescription;
+    parse(classDescription: ClassDescription): ClassDescriptor;
+}
+//# sourceMappingURL=ClassDescriptionParser.d.ts.map

package/esm/io/loader/ClassDescriptionParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassDescriptionParser.d.ts","sourceRoot":"","sources":["../../../src/io/loader/ClassDescriptionParser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAmB;IAEvD,yBAAyB,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,IAAI,gBAAgB;IAO5E,KAAK,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,eAAe;CAiD7D"}

package/esm/io/loader/ClassDescriptionParser.js

@@ -0,0 +1,45 @@
+import validate from 'validate-npm-package-name';
+import { ConfigurationError } from '../../errors/index.js';
+import { d } from '../format.js';
+export class ClassDescriptionParser {
+    static validClassNamePattern = /^[A-Za-z]\w+$/;
+    looksLikeClassDescription(candidate) {
+        const stringDescription = typeof candidate === 'string';
+        const tupleDescription = Array.isArray(candidate) && [1, 2].includes(candidate.length) && typeof candidate[0] === 'string';
+        return stringDescription || tupleDescription;
+    }
+    parse(classDescription) {
+        if (!this.looksLikeClassDescription(classDescription)) {
+            throw new ConfigurationError(d `${classDescription} is not a valid class description. Valid class description must be a string or an Array with 1-2 items, where the first item is a string.`);
+        }
+        const moduleIdAndClassDescription = Array.isArray(classDescription)
+            ? classDescription[0]
+            : classDescription;
+        const [moduleId, desiredClassName, ...rest] = moduleIdAndClassDescription.split(':');
+        if (rest.length > 0) {
+            throw new ConfigurationError(`${classDescription} is not a valid class description. Valid class description must be:\n` +
+                `- a module ID of a Node module providing a default export, e.g. "@serenity-js/serenity-bdd"\n` +
+                `- a module ID followed by a class name, e.g. "@serenity-js/core:StreamReporter"`);
+        }
+        if (desiredClassName === '') {
+            throw new ConfigurationError(`Invalid class name in "${moduleIdAndClassDescription}". If you want to import the default export from a given module, please use the module ID.\n` +
+                `For example, valid class descriptions include "@serenity-js/serenity-bdd", "@serenity-js/serenity-bdd:default", "@serenity-js/serenity-bdd:SerenityBDD".`);
+        }
+        const className = desiredClassName ?? 'default';
+        if (!ClassDescriptionParser.validClassNamePattern.test(className)) {
+            throw new ConfigurationError(`"${className}" doesn't seem like a valid JavaScript class name in "${moduleIdAndClassDescription}"`);
+        }
+        if (!moduleId.startsWith('./')) {
+            const result = validate(moduleId);
+            if (!result.validForNewPackages) {
+                throw new ConfigurationError(`"${moduleId}" doesn't seem like a valid module id:\n${result.errors.map(error => `- ${error}\n`)}`);
+            }
+        }
+        return {
+            moduleId,
+            className,
+            parameter: Array.isArray(classDescription) ? classDescription[1] : undefined,
+        };
+    }
+}
+//# sourceMappingURL=ClassDescriptionParser.js.map

package/esm/io/loader/ClassDescriptionParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassDescriptionParser.js","sourceRoot":"","sources":["../../../src/io/loader/ClassDescriptionParser.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,2BAA2B,CAAC;AAGjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,cAAc,CAAC;AAGjC,MAAM,OAAO,sBAAsB;IACvB,MAAM,CAAC,qBAAqB,GAAG,eAAe,CAAC;IAEvD,yBAAyB,CAAC,SAAkB;QACxC,MAAM,iBAAiB,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC;QACxD,MAAM,gBAAgB,GAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAE,CAAC,EAAE,CAAC,CAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,OAAO,SAAS,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;QAE9H,OAAO,iBAAiB,IAAI,gBAAgB,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,gBAAkC;QACpC,IAAI,CAAE,IAAI,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,kBAAkB,CAAC,CAAC,CAAA,GAAI,gBAAiB,2IAA2I,CAAC,CAAC;QACpM,CAAC;QAED,MAAM,2BAA2B,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC;YAC/D,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;YACrB,CAAC,CAAC,gBAA0B,CAAC;QAEjC,MAAM,CAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAE,GAAG,2BAA2B,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEvF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,kBAAkB,CACxB,GAAI,gBAAiB,uEAAuE;gBAC5F,+FAA+F;gBAC/F,iFAAiF,CACpF,CAAC;QACN,CAAC;QAED,IAAI,gBAAgB,KAAK,EAAE,EAAE,CAAC;YAC1B,MAAM,IAAI,kBAAkB,CACxB,0BAA2B,2BAA4B,8FAA8F;gBACrJ,0JAA0J,CAC7J,CAAC;QACN,CAAC;QAED,MAAM,SAAS,GAAG,gBAAgB,IAAI,SAAS,CAAC;QAEhD,IAAI,CAAE,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACjE,MAAM,IAAI,kBAAkB,CACxB,IAAI,SAAS,yDAA0D,2BAA4B,GAAG,CACzG,CAAC;QACN,CAAC;QAED,IAAI,CAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,CAAE,MAAM,CAAC,mBAAmB,EAAE,CAAC;gBAC/B,MAAM,IAAI,kBAAkB,CACxB,IAAK,QAAS,2CAA4C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,IAAI,CAAE,EAAE,CAC1G,CAAC;YACN,CAAC;QACL,CAAC;QAED,OAAO;YACH,QAAQ;YACR,SAAS;YACT,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;SAC/E,CAAA;IACL,CAAC"}

package/esm/io/loader/ClassDescriptor.d.ts

@@ -0,0 +1,7 @@
+import type { JSONValue } from 'tiny-types';
+export interface ClassDescriptor {
+    moduleId: string;
+    className: string;
+    parameter: JSONValue;
+}
+//# sourceMappingURL=ClassDescriptor.d.ts.map

package/esm/io/loader/ClassDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassDescriptor.d.ts","sourceRoot":"","sources":["../../../src/io/loader/ClassDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;CACxB"}

package/esm/io/loader/ClassDescriptor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ClassDescriptor.js.map

package/esm/io/loader/ClassDescriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassDescriptor.js","sourceRoot":"","sources":["../../../src/io/loader/ClassDescriptor.ts"],"names":[],"mappings":""}

package/esm/io/loader/ClassLoader.d.ts

@@ -0,0 +1,12 @@
+import type { ClassDescription } from '../../config/index.js';
+import type { ClassDescriptionParser } from './ClassDescriptionParser.js';
+import type { ModuleLoader } from './ModuleLoader.js';
+export declare class ClassLoader {
+    private readonly loader;
+    private readonly parser;
+    constructor(loader: ModuleLoader, parser: ClassDescriptionParser);
+    looksLoadable(description: unknown): description is ClassDescription;
+    instantiate<T>(description: ClassDescription): T;
+    private ensureDefined;
+}
+//# sourceMappingURL=ClassLoader.d.ts.map

package/esm/io/loader/ClassLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassLoader.d.ts","sourceRoot":"","sources":["../../../src/io/loader/ClassLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,qBAAa,WAAW;IAEhB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,sBAAsB;IAInD,aAAa,CAAC,WAAW,EAAE,OAAO,GAAG,WAAW,IAAI,gBAAgB;IAIpE,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,gBAAgB,GAAG,CAAC;IAgDhD,OAAO,CAAC,aAAa;CAOxB"}

package/esm/io/loader/ClassLoader.js

@@ -0,0 +1,54 @@
+import { ConfigurationError } from '../../errors/index.js';
+import { d } from '../format.js';
+export class ClassLoader {
+    loader;
+    parser;
+    constructor(loader, parser) {
+        this.loader = loader;
+        this.parser = parser;
+    }
+    looksLoadable(description) {
+        return this.parser.looksLikeClassDescription(description);
+    }
+    instantiate(description) {
+        const descriptor = this.parser.parse(description);
+        const requiredModule = this.loader.require(descriptor.moduleId);
+        const requiredType = requiredModule[descriptor.className];
+        if (typeof requiredType !== 'function') {
+            throw new ConfigurationError(d `Module ${descriptor.moduleId} doesn't seem to export ${descriptor.className}. Exported members include: ${Object.keys(requiredModule).join(', ')}`);
+        }
+        const needsParameter = Boolean(descriptor.parameter);
+        if (needsParameter && typeof requiredType.fromJSON === 'function') {
+            return this.ensureDefined(requiredType.fromJSON(descriptor.parameter), `${requiredType}.fromJSON(${descriptor.parameter})`);
+        }
+        if (needsParameter && requiredType.length > 1) {
+            throw new ConfigurationError(d `${descriptor.className} exported by ${descriptor.moduleId} must be a class with a static fromJSON(config) method or a function that accepts a single config parameter: ${descriptor.parameter}`);
+        }
+        if (!needsParameter && requiredType.length > 0) {
+            throw new ConfigurationError(d `${descriptor.className} exported by ${descriptor.moduleId} must be a parameterless function since no config parameter is specified`);
+        }
+        try {
+            return this.ensureDefined(requiredType(descriptor.parameter), `${requiredType}(${descriptor.parameter})`);
+        }
+        catch (error) {
+            if (error instanceof TypeError && error.message.includes('constructor')) {
+                return new requiredType(descriptor.parameter);
+            }
+            const errorMessage = [
+                d `${descriptor.className} exported by ${descriptor.moduleId} must be either:`,
+                descriptor.parameter && d `- a class with a static fromJSON(config) method`,
+                descriptor.parameter ? '- a no-arg constructor function' : '- a constructor function accepting config',
+                descriptor.parameter ? '- a no-arg function' : '- a function accepting config',
+                descriptor.parameter && d `where config is: ${descriptor.parameter}`,
+            ].filter(Boolean).join('\n');
+            throw new ConfigurationError(errorMessage);
+        }
+    }
+    ensureDefined(value, operation) {
+        if (value === undefined || value === null) {
+            throw new ConfigurationError(`Calling ${operation} produced ${value}, which might indicate a configuration or programming error`);
+        }
+        return value;
+    }
+}
+//# sourceMappingURL=ClassLoader.js.map

package/esm/io/loader/ClassLoader.js.map

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

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

@@ -0,0 +1,48 @@
+import { Version } from '../Version.js';
+/**
+ * Dynamically loads Node modules located relative to `cwd`.
+ */
+export declare class ModuleLoader {
+    readonly cwd: string;
+    readonly useRequireCache: boolean;
+    private readonly requireFn;
+    /**
+     * @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, useRequireCache?: boolean);
+    /**
+     * Returns `true` if a given module is available to be required, false otherwise.
+     *
+     * @param moduleId
+     *  NPM module id, for example 'cucumber' or '@serenity-js/core'
+     */
+    hasAvailable(moduleId: string): boolean;
+    /**
+     * Works like `require.resolve`, but relative to specified current working directory
+     *
+     * @param moduleId
+     *  NPM module id, for example `cucumber` or `@serenity-js/core`
+     *
+     * @returns
+     *  Path to a given Node.js module
+     */
+    resolve(moduleId: string): string;
+    /**
+     * Works like `require`, but relative to specified current working directory
+     *
+     * @param moduleId
+     */
+    require(moduleId: string): any;
+    private cachedIfNeeded;
+    /**
+     * Returns `Version` of module specified by `moduleId`, based on its `package.json`.
+     *
+     * @param moduleId
+     */
+    versionOf(moduleId: string): Version;
+}
+//# sourceMappingURL=ModuleLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ModuleLoader.d.ts","sourceRoot":"","sources":["../../../src/io/loader/ModuleLoader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAexC;;GAEG;AACH,qBAAa,YAAY;aAYD,GAAG,EAAE,MAAM;aACX,eAAe,EAAE,OAAO;IAX5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IAExC;;;;;;OAMG;gBAEiB,GAAG,EAAE,MAAM,EACX,eAAe,GAAE,OAAc;IAMnD;;;;;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/esm/io/loader/ModuleLoader.js

@@ -0,0 +1,95 @@
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { Version } from '../Version.js';
+// Get the Module object for internal resolution APIs
+const bootstrapRequire = createRequire(pathToFileURL(path.join(process.cwd(), 'package.json')).href);
+const Module = bootstrapRequire('module'); // No type definitions available
+/**
+ * Creates a require function for the given directory.
+ * Uses createRequire to create a require function anchored to the specified cwd.
+ */
+function createRequireForCwd(cwd) {
+    const contextFile = path.join(cwd, 'noop.js');
+    return createRequire(pathToFileURL(contextFile).href);
+}
+/**
+ * Dynamically loads Node modules located relative to `cwd`.
+ */
+export class ModuleLoader {
+    cwd;
+    useRequireCache;
+    requireFn;
+    /**
+     * @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, useRequireCache = true) {
+        this.cwd = cwd;
+        this.useRequireCache = useRequireCache;
+        // Create a require function anchored to the cwd
+        this.requireFn = createRequireForCwd(cwd);
+    }
+    /**
+     * Returns `true` if a given module is available to be required, false otherwise.
+     *
+     * @param moduleId
+     *  NPM module id, for example 'cucumber' or '@serenity-js/core'
+     */
+    hasAvailable(moduleId) {
+        try {
+            return !!this.require(moduleId);
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Works like `require.resolve`, but relative to specified current working directory
+     *
+     * @param moduleId
+     *  NPM module id, for example `cucumber` or `@serenity-js/core`
+     *
+     * @returns
+     *  Path to a given Node.js module
+     */
+    resolve(moduleId) {
+        const fromFile = path.join(this.cwd, 'noop.js');
+        return Module._resolveFilename(moduleId, {
+            id: fromFile,
+            filename: fromFile,
+            paths: Module._nodeModulePaths(this.cwd),
+        });
+    }
+    /**
+     * Works like `require`, but relative to specified current working directory
+     *
+     * @param moduleId
+     */
+    require(moduleId) {
+        try {
+            return this.requireFn(this.cachedIfNeeded(this.resolve(moduleId)));
+        }
+        catch {
+            return this.requireFn(this.cachedIfNeeded(moduleId));
+        }
+    }
+    cachedIfNeeded(moduleId) {
+        if (!this.useRequireCache) {
+            delete this.requireFn.cache[moduleId];
+        }
+        return moduleId;
+    }
+    /**
+     * Returns `Version` of module specified by `moduleId`, based on its `package.json`.
+     *
+     * @param moduleId
+     */
+    versionOf(moduleId) {
+        return new Version(this.require(`${moduleId}/package.json`).version);
+    }
+}
+//# sourceMappingURL=ModuleLoader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ModuleLoader.js","sourceRoot":"","sources":["../../../src/io/loader/ModuleLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,qDAAqD;AACrD,MAAM,gBAAgB,GAAG,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACrG,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,gCAAgC;AAE3E;;;GAGG;AACH,SAAS,mBAAmB,CAAC,GAAW;IACpC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC9C,OAAO,aAAa,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IAYD;IACA;IAXH,SAAS,CAAc;IAExC;;;;;;OAMG;IACH,YACoB,GAAW,EACX,kBAA2B,IAAI;QAD/B,QAAG,GAAH,GAAG,CAAQ;QACX,oBAAe,GAAf,eAAe,CAAgB;QAE/C,gDAAgD;QAChD,IAAI,CAAC,SAAS,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,QAAgB;QACzB,IAAI,CAAC;YACD,OAAO,CAAC,CAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;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,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzD,CAAC;IACL,CAAC;IAEO,cAAc,CAAC,QAAgB;QACnC,IAAI,CAAE,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,QAAgB;QACtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAI,QAAS,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC;IAC3E,CAAC;CACJ"}

package/esm/io/loader/Version.d.ts

@@ -0,0 +1,31 @@
+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;
+    /**
+     * @param {string} version
+     * @returns {Version}
+     */
+    static fromJSON(version: string): Version;
+    /**
+     * @param {string} version
+     */
+    constructor(version: string);
+    /**
+     * @param {Version} other
+     * @returns {boolean}
+     */
+    isAtLeast(other: Version): boolean;
+    /**
+     * @returns {number}
+     *  Major version number of a given package version, i.e. `1` in `1.2.3`
+     */
+    major(): number;
+    /**
+     * @returns {string}
+     */
+    toString(): string;
+}
+//# sourceMappingURL=Version.d.ts.map

package/esm/io/loader/Version.d.ts.map

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

package/esm/io/loader/Version.js

@@ -0,0 +1,50 @@
+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 {
+    version;
+    /**
+     * @param {string} version
+     * @returns {Version}
+     */
+    static fromJSON(version) {
+        return new Version(version);
+    }
+    /**
+     * @param {string} version
+     */
+    constructor(version) {
+        super();
+        this.version = version;
+        ensure('version', version, isDefined(), isString(), isValid());
+    }
+    /**
+     * @param {Version} other
+     * @returns {boolean}
+     */
+    isAtLeast(other) {
+        return semver.gte(this.version, other.version);
+    }
+    /**
+     * @returns {number}
+     *  Major version number of a given package version, i.e. `1` in `1.2.3`
+     */
+    major() {
+        return Number(this.version.split('.')[0]);
+    }
+    /**
+     * @returns {string}
+     */
+    toString() {
+        return `${this.version}`;
+    }
+}
+/**
+ * @package
+ */
+function isValid() {
+    return Predicate.to(`be a valid version number`, (version) => !!semver.valid(version));
+}
+//# sourceMappingURL=Version.js.map

package/esm/io/loader/Version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Version.js","sourceRoot":"","sources":["../../../src/io/loader/Version.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE9E;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,QAAQ;IAaJ;IAX7B;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAe;QAC3B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,YAA6B,OAAe;QACxC,KAAK,EAAE,CAAC;QADiB,YAAO,GAAP,OAAO,CAAQ;QAExC,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAAc;QACpB,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACnD,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;;OAEG;IACH,QAAQ;QACJ,OAAO,GAAI,IAAI,CAAC,OAAQ,EAAE,CAAC;IAC/B,CAAC;CACJ;AAED;;GAEG;AACH,SAAS,OAAO;IACZ,OAAO,SAAS,CAAC,EAAE,CAAC,2BAA2B,EAAE,CAAC,OAAe,EAAE,EAAE,CACjE,CAAC,CAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAC3B,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from './ClassDescriptionParser.js';
+export * from './ClassDescriptor.js';
+export * from './ClassLoader.js';
+export * from './ModuleLoader.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/io/loader/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/esm/io/loader/index.js

@@ -0,0 +1,5 @@
+export * from './ClassDescriptionParser.js';
+export * from './ClassDescriptor.js';
+export * from './ClassLoader.js';
+export * from './ModuleLoader.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/io/loader/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/esm/io/proxies.d.ts

@@ -0,0 +1,8 @@
+export interface Dictionary {
+    [key: string]: any;
+}
+/**
+ * @private
+ */
+export declare function caseInsensitive<T extends Dictionary>(dictionary: T): T & Dictionary;
+//# sourceMappingURL=proxies.d.ts.map

package/esm/io/proxies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxies.d.ts","sourceRoot":"","sources":["../../src/io/proxies.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,GAAG,UAAU,CASnF"}

package/esm/io/proxies.js

@@ -0,0 +1,13 @@
+/**
+ * @private
+ */
+export function caseInsensitive(dictionary) {
+    return new Proxy(dictionary, {
+        get: (obj, key) => {
+            const found = Object.keys(obj)
+                .find(k => k.toLocaleLowerCase() === key.toLocaleLowerCase());
+            return found && obj[found];
+        },
+    });
+}
+//# sourceMappingURL=proxies.js.map

package/esm/io/proxies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxies.js","sourceRoot":"","sources":["../../src/io/proxies.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAuB,UAAa;IAC/D,OAAO,IAAI,KAAK,CAAC,UAAU,EAAE;QACzB,GAAG,EAAE,CAA6B,GAAmB,EAAE,GAAM,EAAE,EAAE;YAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;iBACzB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,EAAE,KAAK,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;YAElE,OAAO,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;KACJ,CAAC,CAAC;AACP,CAAC"}

package/esm/io/reflection/ValueInspector.d.ts

@@ -0,0 +1,56 @@
+export declare class ValueInspector {
+    static isPromise(value: unknown): value is Promise<unknown>;
+    static isDate(value: unknown): value is Date;
+    /**
+     * Checks if the value is a named [`Function`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function)
+     *
+     * @param value
+     */
+    static isFunction(value: unknown): value is Function;
+    /**
+     * Checks if the value has a good chance of being a plain JavaScript object
+     *
+     * @param value
+     */
+    static isPlainObject(value: unknown): value is object;
+    /**
+     * Returns true if `value` is a [JavaScript primitive](https://developer.mozilla.org/en-US/docs/Glossary/Primitive),
+     * false otherwise.
+     *
+     * @param value
+     */
+    static isPrimitive(value: unknown): boolean;
+    /**
+     * Checks if the value defines its own `toString` method
+     *
+     * @param value
+     */
+    static hasItsOwnToString(value: unknown): boolean;
+    /**
+     * Describes the type of the provided value.
+     *
+     * @param value
+     */
+    static typeOf(value: unknown): string;
+    /**
+     * Inspired by https://davidwalsh.name/detect-native-function
+     *
+     * @param value
+     */
+    static isNative(value: unknown): value is Function;
+    /**
+     * Checks if the value defines its own `inspect` method
+     *
+     * @param value
+     */
+    static isInspectable(value: unknown): value is {
+        inspect: () => string;
+    };
+    /**
+     * Checks if the value defines its own [`inspect` method](https://nodejs.org/api/util.html#util_util_inspect_custom)
+     *
+     * @param value
+     */
+    static hasCustomInspectionFunction(value: unknown): value is object;
+}
+//# sourceMappingURL=ValueInspector.d.ts.map

package/esm/io/reflection/ValueInspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValueInspector.d.ts","sourceRoot":"","sources":["../../../src/io/reflection/ValueInspector.ts"],"names":[],"mappings":"AAEA,qBAAa,cAAc;IACvB,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAK3D,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI;IAI5C;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ;IAIpD;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM;IAoBrD;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAe3C;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAOjD;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAyBrC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ;IAiClD;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,MAAM,CAAA;KAAE;IAIxE;;;;OAIG;IACH,MAAM,CAAC,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM;CAGtE"}