@serenity-js/core 3.0.0-rc.9 → 3.0.0

package/lib/io/loader/ModuleLoader.js

@@ -0,0 +1,96 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+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");
+/**
+ * Dynamically loads Node modules located relative to `cwd`.
+ */
+class ModuleLoader {
+    /**
+     * @param {string} cwd
+     *  Current working directory, relative to which Node modules should be resolved.
+     */
+    constructor(cwd) {
+        this.cwd = 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 a given Node 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 require(this.resolve(moduleId));
+        }
+        catch {
+            return require(moduleId);
+        }
+    }
+    /**
+     * Returns {@apilink Version} of module specified by `moduleId`, based on its `package.json`.
+     *
+     * @param moduleId
+     */
+    versionOf(moduleId) {
+        return new Version_1.Version(this.require(`${moduleId}/package.json`).version);
+    }
+}
+exports.ModuleLoader = ModuleLoader;
+//# sourceMappingURL=ModuleLoader.js.map

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

@@ -0,0 +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;IAErB;;;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"}

package/lib/io/{Version.d.ts → loader/Version.d.ts}

@@ -1,9 +1,6 @@
 import { TinyType } from 'tiny-types';
 /**
- * @desc
- *  A tiny type describing a version number, like `1.2.3`
- *
- * @extends {tiny-types~TinyType}
+ * A tiny type describing a version number, like `1.2.3`
  */
 export declare class Version extends TinyType {
     private readonly version;
@@ -31,3 +28,4 @@ export declare class Version extends TinyType {
      */
     toString(): string;
 }
+//# sourceMappingURL=Version.d.ts.map

package/lib/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/lib/io/{Version.js → loader/Version.js}

@@ -1,36 +1,36 @@
 "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 = require("semver");
+const semver_1 = __importDefault(require("semver"));
 const tiny_types_1 = require("tiny-types");
 /**
- * @desc
- *  A tiny type describing a version number, like `1.2.3`
- *
- * @extends {tiny-types~TinyType}
+ * A tiny type describing a version number, like `1.2.3`
  */
 class Version extends tiny_types_1.TinyType {
     /**
      * @param {string} version
+     * @returns {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());
+    static fromJSON(version) {
+        return new Version(version);
     }
     /**
      * @param {string} version
-     * @returns {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());
     }
     /**
      * @param {Version} other
      * @returns {boolean}
      */
     isAtLeast(other) {
-        return semver.gte(this.version, other.version);
+        return semver_1.default.gte(this.version, other.version);
     }
     /**
      * @returns {number}
@@ -51,6 +51,6 @@ exports.Version = Version;
  * @package
  */
 function isValid() {
-    return tiny_types_1.Predicate.to(`be a valid version number`, (version) => !!semver.valid(version));
+    return tiny_types_1.Predicate.to(`be a valid version number`, (version) => !!semver_1.default.valid(version));
 }
 //# sourceMappingURL=Version.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Version.js","sourceRoot":"","sources":["../../../src/io/loader/Version.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAC5B,2CAA8E;AAE9E;;GAEG;AACH,MAAa,OAAQ,SAAQ,qBAAQ;IAEjC;;;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,IAAA,mBAAM,EAAC,SAAS,EAAE,OAAO,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,qBAAQ,GAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAAc;QACpB,OAAO,gBAAM,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;AAxCD,0BAwCC;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/loader/index.d.ts

@@ -0,0 +1,6 @@
+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

@@ -0,0 +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"}

package/lib/io/loader/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__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

@@ -0,0 +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"}

package/lib/io/proxies.d.ts

@@ -5,3 +5,4 @@ export interface Dictionary {
  * @private
  */
 export declare function caseInsensitive<T extends Dictionary>(dictionary: T): T & Dictionary;
+//# sourceMappingURL=proxies.d.ts.map

package/lib/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/lib/io/reflection/has.d.ts

@@ -1,12 +1,11 @@
 /**
- * @desc
  *  Checks if the `candidate` value "quacks like a duck".
  *  In particular, it checks if the `candidate`:
  *  - is not `null`
  *  - is not `undefined`
  *  - has expected methods or fields (evaluated via [`typeof`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/typeof))
  *
- * @example
+ * ```ts
  *  const looksLikeADuck = has({
  *      name:   'string',
  *      quack:  'function',
@@ -18,11 +17,11 @@
  *  }
  *
  *  looksLikeADuck(daisy) // true
+ * ```
  *
- * @param {object} api
+ * @param api
  *  An object where the keys are names of member fields and methods expected on the `candidate`,
  *  and values are the names of their types, i.e. `function`, `object`, etc.
- *
- * @returns {boolean}
  */
 export declare function has<T>(api: Record<keyof T, string>): (candidate: unknown) => candidate is T;
+//# sourceMappingURL=has.d.ts.map

package/lib/io/reflection/has.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"has.d.ts","sourceRoot":"","sources":["../../../src/io/reflection/has.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,KAAK,SAAS,IAAI,CAAC,CAS3F"}

package/lib/io/reflection/has.js

@@ -2,14 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.has = void 0;
 /**
- * @desc
  *  Checks if the `candidate` value "quacks like a duck".
  *  In particular, it checks if the `candidate`:
  *  - is not `null`
  *  - is not `undefined`
  *  - has expected methods or fields (evaluated via [`typeof`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/typeof))
  *
- * @example
+ * ```ts
  *  const looksLikeADuck = has({
  *      name:   'string',
  *      quack:  'function',
@@ -21,12 +20,11 @@ exports.has = void 0;
  *  }
  *
  *  looksLikeADuck(daisy) // true
+ * ```
  *
- * @param {object} api
+ * @param api
  *  An object where the keys are names of member fields and methods expected on the `candidate`,
  *  and values are the names of their types, i.e. `function`, `object`, etc.
- *
- * @returns {boolean}
  */
 function has(api) {
     return (candidate) => candidate !== null

package/lib/io/reflection/has.js.map

@@ -1 +1 @@
-{"version":3,"file":"has.js","sourceRoot":"","sources":["../../../src/io/reflection/has.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,GAAG,CAAI,GAA4B;IAC/C,OAAO,CAAC,SAAkB,EAAkB,EAAE,CAC1C,SAAS,KAAK,IAAI;WACf,SAAS,KAAK,SAAS;WACvB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CACzB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CACpB,MAAM,IAAI,CAAC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAC9C,IAAI,CACP,CAAA;AACT,CAAC;AATD,kBASC"}
+{"version":3,"file":"has.js","sourceRoot":"","sources":["../../../src/io/reflection/has.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,GAAG,CAAI,GAA4B;IAC/C,OAAO,CAAC,SAAkB,EAAkB,EAAE,CAC1C,SAAS,KAAK,IAAI;WACf,SAAS,KAAK,SAAS;WACvB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CACzB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CACpB,MAAM,IAAI,CAAC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAC9C,IAAI,CACP,CAAA;AACT,CAAC;AATD,kBASC"}

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

@@ -1 +1,4 @@
 export * from './has';
+export * from './isPrimitive';
+export * from './typeOf';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/io/reflection/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC"}

package/lib/io/reflection/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -11,4 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./has"), exports);
+__exportStar(require("./isPrimitive"), exports);
+__exportStar(require("./typeOf"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/io/reflection/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,wCAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/io/reflection/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,gDAA8B;AAC9B,2CAAyB"}

package/lib/io/reflection/isPrimitive.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Returns true if `value` is a [JavaScript primitive](https://developer.mozilla.org/en-US/docs/Glossary/Primitive),
+ * false otherwise.
+ *
+ * @param value
+ */
+export declare function isPrimitive(value: unknown): boolean;
+//# sourceMappingURL=isPrimitive.d.ts.map

package/lib/io/reflection/isPrimitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isPrimitive.d.ts","sourceRoot":"","sources":["../../../src/io/reflection/isPrimitive.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAanD"}

package/lib/io/reflection/isPrimitive.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPrimitive = void 0;
+/**
+ * Returns true if `value` is a [JavaScript primitive](https://developer.mozilla.org/en-US/docs/Glossary/Primitive),
+ * false otherwise.
+ *
+ * @param value
+ */
+function isPrimitive(value) {
+    if (value === null) {
+        return true;
+    }
+    return [
+        'string',
+        'number',
+        'bigint',
+        'boolean',
+        'undefined',
+        'symbol'
+    ].includes(typeof value);
+}
+exports.isPrimitive = isPrimitive;
+//# sourceMappingURL=isPrimitive.js.map

package/lib/io/reflection/isPrimitive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isPrimitive.js","sourceRoot":"","sources":["../../../src/io/reflection/isPrimitive.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,KAAc;IACtC,IAAI,KAAK,KAAK,IAAI,EAAE;QAChB,OAAO,IAAI,CAAC;KACf;IAED,OAAO;QACH,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,WAAW;QACX,QAAQ;KACX,CAAC,QAAQ,CAAC,OAAO,KAAK,CAAC,CAAC;AAC7B,CAAC;AAbD,kCAaC"}

package/lib/io/reflection/typeOf.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Describes the type of the provided value.
+ *
+ * @param value
+ */
+export declare function typeOf(value: unknown): string;
+//# sourceMappingURL=typeOf.d.ts.map

package/lib/io/reflection/typeOf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeOf.d.ts","sourceRoot":"","sources":["../../../src/io/reflection/typeOf.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAuB7C"}

package/lib/io/reflection/typeOf.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typeOf = void 0;
+const util_1 = require("util");
+/**
+ * Describes the type of the provided value.
+ *
+ * @param value
+ */
+function typeOf(value) {
+    switch (true) {
+        case value === null:
+            return 'null';
+        case util_1.types.isProxy(value):
+            return `Proxy<${Reflect.getPrototypeOf(value).constructor.name}>`;
+        case typeof value !== 'object':
+            return typeof value;
+        case value instanceof Date:
+            return `Date`;
+        case Array.isArray(value):
+            return `Array`;
+        case value instanceof RegExp:
+            return `RegExp`;
+        case value instanceof Set:
+            return 'Set';
+        case value instanceof Map:
+            return 'Map';
+        case !!value.constructor && value.constructor !== Object:
+            return value.constructor.name;
+        default:
+            return 'object';
+    }
+}
+exports.typeOf = typeOf;
+//# sourceMappingURL=typeOf.js.map

package/lib/io/reflection/typeOf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeOf.js","sourceRoot":"","sources":["../../../src/io/reflection/typeOf.ts"],"names":[],"mappings":";;;AAAA,+BAA6B;AAE7B;;;;GAIG;AACH,SAAgB,MAAM,CAAC,KAAc;IACjC,QAAQ,IAAI,EAAE;QACV,KAAK,KAAK,KAAK,IAAI;YACf,OAAO,MAAM,CAAC;QAClB,KAAK,YAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACrB,OAAO,SAAU,OAAO,CAAC,cAAc,CAAC,KAAe,CAAC,CAAC,WAAW,CAAC,IAAK,GAAG,CAAC;QAClF,KAAK,OAAO,KAAK,KAAK,QAAQ;YAC1B,OAAO,OAAO,KAAK,CAAC;QACxB,KAAK,KAAK,YAAY,IAAI;YACtB,OAAO,MAAM,CAAC;QAClB,KAAK,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACrB,OAAO,OAAO,CAAC;QACnB,KAAK,KAAK,YAAY,MAAM;YACxB,OAAO,QAAQ,CAAA;QACnB,KAAK,KAAK,YAAY,GAAG;YACrB,OAAO,KAAK,CAAC;QACjB,KAAK,KAAK,YAAY,GAAG;YACrB,OAAO,KAAK,CAAC;QACjB,KAAK,CAAC,CAAE,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM;YACrD,OAAO,KAAK,CAAC,WAAW,CAAC,IAAI,CAAA;QACjC;YACI,OAAO,QAAQ,CAAC;KACvB;AACL,CAAC;AAvBD,wBAuBC"}

package/lib/io/stringified.d.ts

@@ -0,0 +1,24 @@
+import { Answerable } from '../screenplay/Answerable';
+interface StringifyConfig {
+    inline: boolean;
+    indentationLevel?: number;
+    markQuestions?: boolean;
+}
+/**
+ * Provides a human-readable description of the {@apilink Answerable<T>}.
+ * Similar to [Node util~inspect](https://nodejs.org/api/util.html#utilinspectobject-options).
+ *
+ * @param value
+ * @param config
+ *  - inline - Return a single-line string instead of the default potentially multi-line description
+ *  - markQuestions - Surround the description of async values, such as Promises and Questions with <<value>>
+ */
+export declare function stringified(value: Answerable<any>, config?: StringifyConfig): string;
+/**
+ * Checks if the value has a good chance of being a plain JavaScript object
+ *
+ * @param v
+ */
+export declare function isPlainObject(v: unknown): v is object;
+export {};
+//# sourceMappingURL=stringified.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stringified.d.ts","sourceRoot":"","sources":["../../src/io/stringified.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAKtD,UAAU,eAAe;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,CA2CpF;AA4HD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAkBrD"}