@serenity-js/core 2.32.2 → 3.0.0-rc.0

package/lib/screenplay/questions/List.js.map

@@ -1 +1 @@
-{"version":3,"file":"List.js","sourceRoot":"","sources":["../../../src/screenplay/questions/List.ts"],"names":[],"mappings":";;;AAAA,iCAAqC;AAGrC,0CAAuC;AAEvC,mCAAwD;AAGxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAa,IAOT,SAAQ,mBAAgC;IAsBxC;;OAEG;IACH,YAA6B,UAA6B;QACtD,KAAK,CAAC,IAAA,cAAS,EAAA,GAAI,UAAW,EAAE,CAAC,CAAC;QADT,eAAU,GAAV,UAAU,CAAmB;IAE1D,CAAC;IAxBD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,CAAY,KAA8B;QAC/C,OAAO,IAAI,IAAI,CACX,IAAI,wBAAgB,CAAC,KAAK,CAAC,CAC9B,CAAC;IACN,CAAC;IASD;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK;QACD,OAAO,mBAAQ,CAAC,KAAK,CAAC,iBAAkB,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAG,EAAE,EAAE,KAAK,CAAC,EAAE,CAC3E,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAC/B,CAAC;IACN,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK;QACD,OAAO,mBAAQ,CAAC,KAAK,CAAC,gBAAiB,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAG,EAAE,EAAE,KAAK,CAAC,EAAE,CAC1E,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAC/B,CAAC;IACN,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,IAAI;QACA,OAAO,mBAAQ,CAAC,KAAK,CAAC,eAAgB,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAG,EAAE,EAAE,KAAK,CAAC,EAAE,CACzE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAC9B,CAAC;IACN,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,GAAG,CAAC,KAAa;QACb,OAAO,mBAAQ,CAAC,KAAK,CAAC,OAAQ,IAAI,CAAC,eAAe,CAAC,KAAK,GAAG,CAAC,CAAE,OAAQ,IAAI,CAAC,UAAW,EAAE,EAAE,KAAK,CAAC,EAAE,CAC9F,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CACpC,CAAC;IACN,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CACD,QAAqE,EACrE,WAA0C;QAE1C,OAAO,IAAI,IAAI,CACX,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,EAAE,WAAW,CAAsB,CACzE,CAAC;IACN,CAAC;IAED;;;;;;;;;;OAUG;IACH,UAAU,CAAC,KAAuC;QAC9C,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAEO,MAAM,CAAC,eAAe,CAAC,KAAa;QACxC,MACI,SAAS,GAAG,KAAK,GAAG,EAAE,EACtB,aAAa,GAAG,KAAK,GAAG,GAAG,CAAC;QAEhC,QAAQ,IAAI,EAAE;YACV,KAAK,CAAC,SAAS,KAAK,CAAC,IAAI,aAAa,KAAK,EAAE,CAAC;gBAC1C,OAAO,KAAK,GAAG,IAAI,CAAC;YACxB,KAAK,CAAC,SAAS,KAAK,CAAC,IAAI,aAAa,KAAK,EAAE,CAAC;gBAC1C,OAAO,KAAK,GAAG,IAAI,CAAC;YACxB,KAAK,CAAC,SAAS,KAAK,CAAC,IAAI,aAAa,KAAK,EAAE,CAAC;gBAC1C,OAAO,KAAK,GAAG,IAAI,CAAC;YACxB;gBACI,OAAO,KAAK,GAAG,IAAI,CAAC;SAC3B;IACL,CAAC;CACJ;AA1MD,oBA0MC"}
+{"version":3,"file":"List.js","sourceRoot":"","sources":["../../../src/screenplay/questions/List.ts"],"names":[],"mappings":"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"}

package/lib/screenplay/questions/Note.d.ts

@@ -40,6 +40,7 @@ import { Question } from '../Question';
  */
 export declare class Note<Answer> extends Question<Promise<Answer>> {
     private readonly topic;
+    private subject;
     /**
      * @desc
      *  Retrieves the previously recorded answer to a given {@link Question}
@@ -66,4 +67,13 @@ export declare class Note<Answer> extends Question<Promise<Answer>> {
      * @see {@link UsesAbilities}
      */
     answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<Answer>;
+    /**
+     * @desc
+     *  Changes the description of this question's subject.
+     *
+     * @param {string} subject
+     * @returns {Question<T>}
+     */
+    describedAs(subject: string): this;
+    toString(): string;
 }

package/lib/screenplay/questions/Note.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Note = void 0;
+const io_1 = require("../../io");
 const abilities_1 = require("../abilities");
 const Question_1 = require("../Question");
 /**
@@ -46,8 +47,9 @@ class Note extends Question_1.Question {
      * @param {Question<Promise<Answer>> | Question<Answer> | string} topic
      */
     constructor(topic) {
-        super(`a note of ${topic}`);
+        super();
         this.topic = topic;
+        this.subject = (0, io_1.formatted) `a note of ${topic}`;
     }
     /**
      * @desc
@@ -75,6 +77,20 @@ class Note extends Question_1.Question {
     answeredBy(actor) {
         return abilities_1.TakeNotes.as(actor).answerTo(this.topic);
     }
+    /**
+     * @desc
+     *  Changes the description of this question's subject.
+     *
+     * @param {string} subject
+     * @returns {Question<T>}
+     */
+    describedAs(subject) {
+        this.subject = subject;
+        return this;
+    }
+    toString() {
+        return this.subject;
+    }
 }
 exports.Note = Note;
 //# sourceMappingURL=Note.js.map

package/lib/screenplay/questions/Note.js.map

@@ -1 +1 @@
-{"version":3,"file":"Note.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Note.ts"],"names":[],"mappings":";;;AAAA,4CAAyC;AAEzC,0CAAuC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAa,IAAa,SAAQ,mBAAyB;IAcvD;;OAEG;IACH,YAA6B,KAA4D;QACrF,KAAK,CAAC,aAAc,KAAM,EAAE,CAAC,CAAC;QADL,UAAK,GAAL,KAAK,CAAuD;IAEzF,CAAC;IAjBD;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,CAAI,KAAkD;QAC3D,OAAO,IAAI,IAAI,CAAI,KAAK,CAAC,CAAC;IAC9B,CAAC;IASD;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAuC;QAC9C,OAAO,qBAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;CACJ;AApCD,oBAoCC"}
+{"version":3,"file":"Note.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Note.ts"],"names":[],"mappings":";;;AAAA,iCAAqC;AACrC,4CAAyC;AAEzC,0CAAuC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAa,IAAa,SAAQ,mBAAyB;IAgBvD;;OAEG;IACH,YAA6B,KAA4D;QACrF,KAAK,EAAE,CAAC;QADiB,UAAK,GAAL,KAAK,CAAuD;QAErF,IAAI,CAAC,OAAO,GAAG,IAAA,cAAS,EAAC,aAAc,KAAM,EAAE,CAAC;IACpD,CAAC;IAlBD;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,CAAI,KAAkD;QAC3D,OAAO,IAAI,IAAI,CAAI,KAAK,CAAC,CAAC;IAC9B,CAAC;IAUD;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAuC;QAC9C,OAAO,qBAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,OAAe;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;CACJ;AAvDD,oBAuDC"}

package/lib/screenplay/questions/index.d.ts

@@ -2,9 +2,6 @@ export * from './Check';
 export * from './Expectation';
 export * from './expectations';
 export * from './List';
-export * from './mappings';
 export * from './MetaQuestion';
 export * from './Note';
-export { Property } from './Property';
 export * from './q';
-export * from './Transform';

package/lib/screenplay/questions/index.js

@@ -10,16 +10,11 @@ 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 });
-exports.Property = void 0;
 __exportStar(require("./Check"), exports);
 __exportStar(require("./Expectation"), exports);
 __exportStar(require("./expectations"), exports);
 __exportStar(require("./List"), exports);
-__exportStar(require("./mappings"), exports);
 __exportStar(require("./MetaQuestion"), exports);
 __exportStar(require("./Note"), exports);
-var Property_1 = require("./Property");
-Object.defineProperty(exports, "Property", { enumerable: true, get: function () { return Property_1.Property; } });
 __exportStar(require("./q"), exports);
-__exportStar(require("./Transform"), exports);
 //# sourceMappingURL=index.js.map

package/lib/screenplay/questions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/questions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,0CAAwB;AACxB,gDAA8B;AAC9B,iDAA+B;AAC/B,yCAAuB;AACvB,6CAA2B;AAC3B,iDAA+B;AAC/B,yCAAuB;AACvB,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,sCAAoB;AACpB,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/questions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0CAAwB;AACxB,gDAA8B;AAC9B,iDAA+B;AAC/B,yCAAuB;AACvB,iDAA+B;AAC/B,yCAAuB;AACvB,sCAAoB"}

package/lib/screenplay/questions/lists/ArrayListAdapter.js

@@ -130,14 +130,15 @@ exports.ArrayListAdapter = ArrayListAdapter;
  */
 class ArrayListFilter extends Question_1.Question {
     constructor(collection, question, expectation) {
-        super([
-            (0, io_1.formatted) `${collection}`,
-            collection instanceof ArrayListFilter ? 'and' : 'where',
-            (0, io_1.formatted) `${question} does ${expectation}`
-        ].join(' '));
+        super();
         this.collection = collection;
         this.question = question;
         this.expectation = expectation;
+        this.subject = [
+            (0, io_1.formatted) `${collection}`,
+            collection instanceof ArrayListFilter ? 'and' : 'where',
+            (0, io_1.formatted) `${question} does ${expectation}`
+        ].join(' ');
     }
     answeredBy(actor) {
         return actor.answer(this.collection)
@@ -148,5 +149,19 @@ class ArrayListFilter extends Question_1.Question {
             .then(results => results.filter(result => result.outcome instanceof expectations_1.ExpectationMet)
             .map(result => result.item));
     }
+    /**
+     * @desc
+     *  Changes the description of this question's subject.
+     *
+     * @param {string} subject
+     * @returns {Question<T>}
+     */
+    describedAs(subject) {
+        this.subject = subject;
+        return this;
+    }
+    toString() {
+        return this.subject;
+    }
 }
 //# sourceMappingURL=ArrayListAdapter.js.map

package/lib/screenplay/questions/lists/ArrayListAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"ArrayListAdapter.js","sourceRoot":"","sources":["../../../../src/screenplay/questions/lists/ArrayListAdapter.ts"],"names":[],"mappings":";;;AAAA,2CAAuD;AAEvD,oCAAwC;AAGxC,6CAA0C;AAE1C,kDAAiD;AAIjD;;;;;GAKG;AACH,MAAa,gBAAgB;IAEzB;;OAEG;IACH,YAA6B,KAA8B;QAA9B,UAAK,GAAL,KAAK,CAAyB;IAC3D,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAuC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;aACrB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAuC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAuC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;aACrB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,KAAuC,EAAE,KAAa;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;aACrB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,KAAuC;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;aACrB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;;OAUG;IACH,UAAU,CACN,QAAqE,EACrE,WAA0C;QAE1C,OAAO,IAAI,gBAAgB,CACvB,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,CACzD,CAAC;IACN,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACJ,OAAO,IAAA,cAAS,EAAC,GAAI,IAAI,CAAC,KAAM,EAAE,CAAA;IACtC,CAAC;IAEO,OAAO,CAAC,KAAuC;QACnD,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;aAC1B,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAA,mBAAM,EAAC,wCAAwC,EAAE,KAAK,EAAE,IAAA,oBAAO,GAAE,CAAC,CAAC,CAAC;IAC3F,CAAC;IAEO,SAAS,CAAC,KAAkB,EAAE,KAAa;QAE/C,IAAA,mBAAM,EAAC,OAAO,EAAE,KAAK,EAAE,IAAA,qBAAQ,GAAE,CAAC,CAAC;QAEnC,MAAM,qBAAqB,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9C,MAAM,gBAAgB,GAAG,IAAA,cAAS,EAAA,GAAI,KAAM,EAAE,CAAC;QAC/C,MAAM,WAAW,GAAG,qBAAqB,KAAK,gBAAgB;YAC1D,CAAC,CAAC,GAAI,qBAAsB,IAAK,gBAAiB,EAAE;YACpD,CAAC,CAAC,gBAAgB,CAAC;QAEvB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;YACpB,MAAM,IAAI,KAAK,CAAC,GAAI,WAAY,WAAW,CAAC,CAAC;SAChD;QAED,IAAI,KAAK,IAAI,KAAK,EAAE;YAChB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;SACvB;QAED,MAAM,IAAI,KAAK,CAAC,GAAI,WAAY,yBAA0B,KAAM,EAAE,CAAC,CAAC;IACxE,CAAC;CACJ;AAnID,4CAmIC;AAED;;GAEG;AACH,MAAM,eACF,SAAQ,mBAA8B;IAEtC,YACqB,UAAmC,EACnC,QAAqE,EACrE,WAA0C;QAE3D,KAAK,CAAC;YACF,IAAA,cAAS,EAAC,GAAI,UAAW,EAAE;YAC3B,UAAU,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO;YACvD,IAAA,cAAS,EAAC,GAAI,QAAS,SAAU,WAAY,EAAE;SAClD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QARI,eAAU,GAAV,UAAU,CAAyB;QACnC,aAAQ,GAAR,QAAQ,CAA6D;QACrE,gBAAW,GAAX,WAAW,CAA+B;IAO/D,CAAC;IAED,UAAU,CAAC,KAAuC;QAE9C,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;aAC/B,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAA,mBAAM,EAAC,wCAAwC,EAAE,KAAK,EAAE,IAAA,oBAAO,GAAE,CAAC,CAAC,CAAE,sCAAsC;aACzH,IAAI,CAAC,KAAK,CAAC,EAAE,CACV,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CACzB,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;aACpD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;aAC1D,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAC5C,CAAC,CACL;aACA,IAAI,CAAC,OAAO,CAAC,EAAE,CACZ,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,YAAY,6BAAc,CAAC;aAC7D,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAClC,CAAC;IACV,CAAC;CACJ"}
+{"version":3,"file":"ArrayListAdapter.js","sourceRoot":"","sources":["../../../../src/screenplay/questions/lists/ArrayListAdapter.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/core",
-  "version": "2.32.2",
+  "version": "3.0.0-rc.0",
   "description": "Serenity/JS Screenplay, reporting engine and core interfaces.",
   "author": {
     "name": "Jan Molak",
@@ -47,17 +47,17 @@
   },
   "devDependencies": {
     "@documentation/esdoc-template": "2.0.0",
-    "@types/chai": "^4.2.22",
+    "@types/chai": "^4.3.0",
     "@types/cuid": "^1.3.1",
     "@types/diff": "^5.0.1",
     "@types/filenamify": "^2.0.2",
     "@types/mocha": "^9.0.0",
-    "@types/semver": "^7.3.8",
+    "@types/semver": "^7.3.9",
     "assertion-error-formatter": "^3.0.0",
-    "memfs": "^3.3.0",
-    "mocha": "^9.1.1",
-    "ts-node": "^10.2.1",
-    "typescript": "^4.4.3"
+    "memfs": "^3.4.0",
+    "mocha": "^9.1.3",
+    "ts-node": "^10.4.0",
+    "typescript": "^4.5.2"
   },
   "repository": {
     "type": "git",
@@ -67,8 +67,8 @@
     "url": "https://github.com/serenity-js/serenity-js/issues"
   },
   "engines": {
-    "node": "^12 || ^14 || ^16",
-    "npm": "^6 || ^7"
+    "node": "^14 || ^16",
+    "npm": "^6 || ^7 || ^8"
   },
   "nyc": {
     "include": [
@@ -92,5 +92,5 @@
     "cache": true,
     "all": true
   },
-  "gitHead": "327f61fa241cf9fe61913246c5ff579b06e47f26"
+  "gitHead": "a63381d088cc068bc3edcbd1eb59a7e609cb6a8c"
 }

package/src/index.ts

@@ -1,6 +1,7 @@
 export * from './errors';
 export * from './instance';
-export { Duration } from './model';
+export { format } from './io';
+export { Duration, Timestamp } from './model';
 export * from './screenplay';
 export * from './Serenity';
 export { SerenityConfig } from './SerenityConfig';

package/src/io/ErrorSerialiser.ts

@@ -39,10 +39,14 @@ export class ErrorSerialiser {
     ];
 
     static serialise(error: Error): string {
+        const name = error && error.constructor && error.constructor.name
+            ? error.constructor.name
+            : error.name;
+
         const serialisedError = Object.getOwnPropertyNames(error).reduce((serialised, key) => {
             serialised[key] = error[key]
             return serialised;
-        }, { name: error.constructor.name || error.name }) as SerialisedError;
+        }, { name }) as SerialisedError;
 
         return stringify(serialisedError);
     }

package/src/io/collections/index.ts

@@ -1,2 +1 @@
-export * from './mappable';
 export * from './reducible';

package/src/io/format.ts

@@ -0,0 +1,46 @@
+import { Answerable } from '../screenplay';
+import { inspected } from './inspected';
+
+/**
+ * @desc
+ *  A factory function returning a tag function that produces a human-readable description of a template containing one or more {@link Answerable}s.
+ *
+ * @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals#Tagged_template_literals
+ *
+ * @example
+ *  import { format, Question } from '@serenity-js/core';
+ *
+ *  const someQuestion = () =>
+ *      Question.about('some question', actor => 'some value');
+ *
+ *  format({ markQuestions: true }) `actor answers ${ question() }`;
+ *  // returns: actor answers <<some question>>
+ *
+ *  format({ markQuestions: false }) `actor answers ${ question() }`;
+ *  // returns: actor answers <<some question>>
+ *
+ * @example <caption>Aliasing</caption>
+ *  import { format, Question } from '@serenity-js/core';
+ *
+ *  const f = format({ markQuestions: true });
+ *
+ *  const someQuestion = () =>
+ *      Question.about('some question', actor => 'some value');
+ *
+ *  f `actor answers ${ question() }`;
+ *  // produces: actor answers <<some question>>
+ *
+ * @param {object} config
+ *  - `markQuestions`: boolean - if set to true, descriptions of questions passed in as arguments will be surrounded with double angled brackets, i.e. `<<description>>`
+ * @returns {function(templates: TemplateStringsArray, placeholders: ...Array<Answerable<any>>): string}
+ */
+export function format(config: { markQuestions: boolean }): (templates: TemplateStringsArray, ...placeholders: Array<Answerable<any>>) => string {
+    return (templates: TemplateStringsArray, ...placeholders: Array<Answerable<any>>): string => {
+        return templates
+            .map((template, i) => i < placeholders.length
+                ? [ template, inspected(placeholders[i], { inline: true, markQuestions: config.markQuestions }) ]
+                : [ template ])
+            .reduce((acc, tuple) => acc.concat(tuple))
+            .join('');
+    }
+}

package/src/io/formatted.ts

@@ -1,28 +1,20 @@
-import { Answerable } from '../screenplay/Answerable';
-import { inspected } from './inspected';
+import { Answerable } from '../screenplay';
+import { format } from './format';
 
 /**
  * @desc
  *  A tag function returning a human-readable description of a template containing one or more {@link Answerable}s.
+ *  This function is deprecated, please use {@link format} instead.
  *
  * @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals#Tagged_template_literals
  *
+ *
+ * @deprecated
+ *
  * @param {TemplateStringsArray} templates
  * @param {Array<Answerable<any>>} placeholders
  * @returns {string}
  */
 export function formatted(templates: TemplateStringsArray, ...placeholders: Array<Answerable<any>>): string {
-    return templates
-        .map((template, i) => i < placeholders.length
-            ? [ template, compacted(inspected(placeholders[i])) ]
-            : [ template ])
-        .reduce((acc, tuple) => acc.concat(tuple))
-        .join('');
-}
-
-/** @private */
-function compacted(multiline: string) {
-    return multiline
-        .replace(/\r?\n/g, ' ')
-        .replace(/\s+/g, ' ');
+    return format({ markQuestions: false })(templates, ...placeholders);
 }

package/src/io/index.ts

@@ -7,6 +7,7 @@ export * from './ErrorStackParser';
 export * from './FileFinder';
 export * from './FileSystem';
 export * from './FileSystemLocation';
+export * from './format';
 export * from './formatted';
 export * from './json';
 export * from './ModuleLoader';

package/src/io/inspected.ts

@@ -3,6 +3,11 @@ import { inspect } from 'util';
 import { Answerable } from '../screenplay/Answerable';
 import { Question } from '../screenplay/Question';
 
+interface InspectedConfig {
+    inline: boolean;
+    markQuestions?: boolean;
+}
+
 /**
  * @desc
  *  Provides a human-readable description of the {@link Answerable<T>}.
@@ -10,27 +15,29 @@ import { Question } from '../screenplay/Question';
  *
  * @public
  * @param {Answerable<any>} 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>>
  * @return {string}
  */
-export function inspected(value: Answerable<any>): string {
+export function inspected(value: Answerable<any>, config?: InspectedConfig): string {
+
+    const { inline, markQuestions } = { inline: false, markQuestions: false, ...config };
+
     if (! isDefined(value)) {
         return inspect(value);
     }
 
     if (Array.isArray(value)) {
-        return [
-            '[',
-            value.map(item => `  ${ inspected(item) }`).join(',\n'),
-            ']',
-        ].join('\n');
+        return stringifiedArray(value, inline);
     }
 
     if (isAPromise(value)) {
-        return `a Promise`;
+        return markAs('Promise', true);
     }
 
     if (Question.isAQuestion(value)) {
-        return value.toString();
+        return markAs(value.toString(), markQuestions);
     }
 
     if (isADate(value)) {
@@ -45,15 +52,49 @@ export function inspected(value: Answerable<any>): string {
         return value.inspect();
     }
 
-    if (isANamedFunction(value)) {
-        return `${ value.name } property`;
+    if (isAFunction(value)) {
+        return hasName(value)
+            ? value.name
+            : markAs(`Function`, true);
     }
 
     if (! hasCustomInspectionFunction(value) && isPlainObject(value) && isSerialisableAsJSON(value)) {
-        return JSON.stringify(value, undefined, 4);
+        return stringifiedToJson(value, inline);
     }
 
-    return inspect(value, { breakLength: Number.POSITIVE_INFINITY, compact: true, sorted: false  });
+    return inspect(value, { breakLength: Number.POSITIVE_INFINITY, compact: ! inline, sorted: false  });
+}
+
+function stringifiedToJson(value: any, inline: boolean): string {
+    const indentation = inline ? 0 : 4;
+
+    return JSON.stringify(value, undefined, indentation);
+}
+
+function stringifiedArray(value: any[], inline: boolean): string {
+    const indentation   = inline ? '' : '  ';
+    const separator     = inline ? ' ' : '\n';
+
+    const inspectedItem = (item: unknown, index: number) =>
+        [
+            indentation,
+            inspected(item, { inline, markQuestions: true }),
+            index < value.length - 1 ? ',' : ''
+        ].join('')
+
+    return [
+        '[',
+        ...value.map(inspectedItem),
+        ']',
+    ].join(separator);
+}
+
+function markAs(value: string, markValue: boolean): string {
+    const [left, right] = markValue && ! value.startsWith('<<')
+        ? [ '<<', '>>' ]
+        : ['', ''];
+
+    return [ left, value, right ].join('');
 }
 
 /**
@@ -121,8 +162,19 @@ function isAPromise<T>(v: Answerable<T>): v is Promise<T> {
  * @private
  * @param {Answerable<any>} v
  */
-function isANamedFunction(v: any): v is { name: string } {
-    return Object.prototype.toString.call(v) === '[object Function]' && (v as any).name !== '';
+function isAFunction(v: any): v is Function {       // eslint-disable-line @typescript-eslint/ban-types
+    return Object.prototype.toString.call(v) === '[object Function]';
+}
+
+/**
+ * @desc
+ *  Checks if the value is has a property called 'name' with a non-empty value.
+ *
+ * @private
+ * @param {Answerable<any>} v
+ */
+function hasName(v: any): v is { name: string } {
+    return typeof (v as any).name === 'string' && (v as any).name !== '';
 }
 
 /**

package/src/model/Timestamp.ts

@@ -8,7 +8,11 @@ export class Timestamp extends TinyType {
         return new Timestamp(new Date(ensure(Timestamp.name, v, isSerialisedISO8601Date())));
     }
 
-    static fromMillisecondTimestamp(v: number): Timestamp {
+    static fromTimestampInSeconds(v: number): Timestamp {
+        return Timestamp.fromTimestampInMilliseconds(v * 1000);
+    }
+
+    static fromTimestampInMilliseconds(v: number): Timestamp {
         return new Timestamp(moment(v).toDate());
     }
 
@@ -29,10 +33,14 @@ export class Timestamp extends TinyType {
         return new Timestamp(moment(this.value).subtract(duration.inMilliseconds(), 'ms').toDate());
     }
 
-    toMillisecondTimestamp(): number {
+    toMilliseconds(): number {
         return moment(this.value).valueOf();
     }
 
+    toSeconds(): number {
+        return moment(this.value).unix();
+    }
+
     toJSON(): string {
         return this.value.toJSON();
     }