@serenity-js/core 3.0.0-rc.18 → 3.0.0-rc.19

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.0.0-rc.19](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.18...v3.0.0-rc.19) (2022-06-11)
+
+
+### Bug Fixes
+
+* **deps:** upgraded "error-stack-parser" to 2.1.4 and removed dependency on "stackframe" ([8d44563](https://github.com/serenity-js/serenity-js/commit/8d445631c015887a608c3a62079d47bbec22794c)), closes [stacktracejs/error-stack-parser#75](https://github.com/stacktracejs/error-stack-parser/issues/75) [stacktracejs/error-stack-parser#80](https://github.com/stacktracejs/error-stack-parser/issues/80)
+* **rest:** updated Axios to 0.27.2 ([b54694b](https://github.com/serenity-js/serenity-js/commit/b54694ba3dd2b8e0316d94c44381f51b1ab79ad0)), closes [axios/axios#4124](https://github.com/axios/axios/issues/4124) [#1223](https://github.com/serenity-js/serenity-js/issues/1223)
+
+
+### Features
+
+* **core:** Question.fromObject() generates questions from plain objects with nested Answerables ([3113f20](https://github.com/serenity-js/serenity-js/commit/3113f20ed5c86cb4bcf11479855d4ceaa5696970)), closes [#1219](https://github.com/serenity-js/serenity-js/issues/1219)
+
+
+
+
+
 # [3.0.0-rc.18](https://github.com/serenity-js/serenity-js/compare/v2.33.9...v3.0.0-rc.18) (2022-06-06)
 
 

package/lib/io/ErrorStackParser.d.ts

@@ -1,4 +1,4 @@
-import StackFrame from 'stackframe';
+import * as parser from 'error-stack-parser';
 /**
  * @desc
  *  A thin wrapper around error-stack-parser module
@@ -8,5 +8,5 @@ import StackFrame from 'stackframe';
  * @package
  */
 export declare class ErrorStackParser {
-    parse(error: Error): StackFrame[];
+    parse(error: Error): parser.StackFrame[];
 }

package/lib/io/ErrorStackParser.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ErrorStackParser = void 0;
-const parser = require('error-stack-parser'); // eslint-disable-line @typescript-eslint/no-var-requires
+const parser = require("error-stack-parser");
 /**
  * @desc
  *  A thin wrapper around error-stack-parser module

package/lib/io/ErrorStackParser.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorStackParser.js","sourceRoot":"","sources":["../../src/io/ErrorStackParser.ts"],"names":[],"mappings":";;;AAAA,MAAM,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAG,yDAAyD;AAGzG;;;;;;;GAOG;AACH,MAAa,gBAAgB;IACzB,KAAK,CAAC,KAAY;QACd,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACJ;AAJD,4CAIC"}
+{"version":3,"file":"ErrorStackParser.js","sourceRoot":"","sources":["../../src/io/ErrorStackParser.ts"],"names":[],"mappings":";;;AAAA,6CAA6C;AAE7C;;;;;;;GAOG;AACH,MAAa,gBAAgB;IACzB,KAAK,CAAC,KAAY;QACd,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACJ;AAJD,4CAIC"}

package/lib/model/artifacts/HTTPRequestResponse.d.ts

@@ -10,16 +10,14 @@ export interface RequestAndResponse extends JSONObject {
     request: {
         url: string;
         method: string;
-        headers: {
-            [header: string]: string;
-        };
+        headers: Record<string, string | number | boolean>;
         data?: any;
     };
     response: {
         status: number;
         data?: any;
-        headers?: {
-            [header: string]: string;
+        headers?: Record<string, string> & {
+            'set-cookie'?: string[];
         };
     };
 }

package/lib/model/artifacts/HTTPRequestResponse.js.map

@@ -1 +1 @@
-{"version":3,"file":"HTTPRequestResponse.js","sourceRoot":"","sources":["../../../src/model/artifacts/HTTPRequestResponse.ts"],"names":[],"mappings":";;;AAEA,yCAAsC;AAsBtC;;;;;GAKG;AACH,MAAa,mBAAoB,SAAQ,mBAAQ;IAC7C,MAAM,CAAC,QAAQ,CAAC,KAAyB;QACrC,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChH,CAAC;CACJ;AAJD,kDAIC"}
+{"version":3,"file":"HTTPRequestResponse.js","sourceRoot":"","sources":["../../../src/model/artifacts/HTTPRequestResponse.ts"],"names":[],"mappings":";;;AAEA,yCAAsC;AAwBtC;;;;;GAKG;AACH,MAAa,mBAAoB,SAAQ,mBAAQ;IAC7C,MAAM,CAAC,QAAQ,CAAC,KAAyB;QACrC,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChH,CAAC;CACJ;AAJD,kDAIC"}

package/lib/screenplay/Question.d.ts

@@ -2,12 +2,14 @@ import { AnswersQuestions, UsesAbilities } from './actor';
 import { Answerable } from './Answerable';
 import { Interaction } from './Interaction';
 import { Optional } from './Optional';
+import { RecursivelyAnswered } from './RecursivelyAnswered';
+import { WithAnswerableProperties } from './WithAnswerableProperties';
 /**
  * @desc
  *  Enables the {@link Actor} to query the system under test.
  *
  * @example <caption>A basic Question</caption>
- *  import { Actor, AnswersQuestions, UsesAbilities, Question } from '@serenity-js/core'
+ *  import { actorCalled, AnswersQuestions, UsesAbilities, Question } from '@serenity-js/core'
  *  import { Ensure, equals } from '@serenity-js/assertions'
  *
  *  const LastItemOf = <T>(list: T[]): Question<T> =>
@@ -15,7 +17,7 @@ import { Optional } from './Optional';
  *          return list[list.length - 1];
  *      });
  *
- *  Actor.named('Quentin').attemptsTo(
+ *  await actorCalled('Quentin').attemptsTo(
  *      Ensure.that(LastItemFrom([1,2,3]), equals(3)),
  *  );
  *
@@ -28,8 +30,8 @@ import { Optional } from './Optional';
  *          return CallAnApi.as(actor).mapLastResponse(response => response.statusText);
  *      });
  *
- *  @example <caption>Mapping answers to other questions</caption>
- *  import { Actor, AnswersQuestions, UsesAbilities, Question } from '@serenity-js/core'
+ * @example <caption>Mapping answers to other questions</caption>
+ *  import { actorCalled, AnswersQuestions, UsesAbilities, Question } from '@serenity-js/core'
  *  import { CallAnApi, LastResponse } from '@serenity-js/rest'
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
@@ -38,12 +40,12 @@ import { Optional } from './Optional';
  *          return LastResponse.status().answeredBy(actor) === 200;
  *      });
  *
- *  const actor = Actor.named('Quentin').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Quentin')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'));
+ *    .attemptsTo(
  *      Send.a(GetRequest.to('/books/0-688-00230-7')),
  *      Ensure.that(RequestWasSuccessful(), isTrue()),
- *  );
+ *    );
  *
  * @see {@link Actor}
  * @see {@link Interaction}
@@ -68,6 +70,60 @@ export declare abstract class Question<T> {
      * @returns {QuestionAdapter<Awaited<R>>}
      */
     static about<R>(description: string, body: (actor: AnswersQuestions & UsesAbilities) => Promise<R> | R): QuestionAdapter<Awaited<R>>;
+    /**
+     * @desc
+     *  Generates a {@link QuestionAdapter} that recursively resolves
+     *  any {@link Answerable} fields of the provided object,
+     *  including {@link Answerable} fields of nested objects.
+     *
+     *  Optionally, the method accepts `overrides` to be shallow-merged with the fields of the original `source`, producing a new merged object.
+     *
+     *  Overrides are applied from left to right, with subsequent objects overwriting property assignments of the previous ones.
+     *
+     * @example <caption>Resolving an object recursively</caption>
+     *  import { actorCalled, Question } from '@serenity-js/core'
+     *  import { Send, PostRequest } from '@serenity-js/rest'
+     *  import { By, Text, PageElement } from '@serenity-js/web'
+     *
+     *  actorCalled('Daisy')
+     *    .whoCan(CallAnApi.at('https://api.example.org'))
+     *    .attemptsTo(
+     *      Send.a(
+     *        PostRequest.to('/products/2')
+     *          .with(Question.fromObject({
+     *              name: Text.of(PageElement.located(By.css('.name'))),
+     *          }))
+     *        )
+     *    );
+     *
+     * @example <caption>Resolving an object recursively</caption>
+     *  import { actorCalled, Question } from '@serenity-js/core'
+     *  import { Send, PostRequest } from '@serenity-js/rest'
+     *  import { By, Text, PageElement } from '@serenity-js/web'
+     *
+     *  actorCalled('Daisy')
+     *    .whoCan(CallAnApi.at('https://api.example.org'))
+     *    .attemptsTo(
+     *      Send.a(
+     *        PostRequest.to('/products/2')
+     *          .with(Question.fromObject({
+     *              name: Text.of(PageElement.located(By.css('.name'))),
+     *              quantity: undefined,
+     *          }, {
+     *              quantity: 2,
+     *          }))
+     *        )
+     *    );
+     *
+     * @param {Answerable<O>} source
+     * @param {Array<Answerable<Partial<O>>>} overrides
+     *
+     * @returns {QuestionAdapter<Record<Key, Value>>>}
+     *
+     * @see {@link WithAnswerableProperties}
+     * @see {@link RecursivelyAnswered}
+     */
+    static fromObject<Source_Type extends object>(source: Answerable<WithAnswerableProperties<Source_Type>>, ...overrides: Array<Answerable<Partial<WithAnswerableProperties<Source_Type>>>>): QuestionAdapter<RecursivelyAnswered<Source_Type>>;
     /**
      * @desc
      *  Checks if the value is a {@link Question}.

package/lib/screenplay/Question.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Question = void 0;
+const objects_1 = require("tiny-types/lib/objects");
+const errors_1 = require("../errors");
 const io_1 = require("../io");
 const Interaction_1 = require("./Interaction");
 /**
@@ -8,7 +10,7 @@ const Interaction_1 = require("./Interaction");
  *  Enables the {@link Actor} to query the system under test.
  *
  * @example <caption>A basic Question</caption>
- *  import { Actor, AnswersQuestions, UsesAbilities, Question } from '@serenity-js/core'
+ *  import { actorCalled, AnswersQuestions, UsesAbilities, Question } from '@serenity-js/core'
  *  import { Ensure, equals } from '@serenity-js/assertions'
  *
  *  const LastItemOf = <T>(list: T[]): Question<T> =>
@@ -16,7 +18,7 @@ const Interaction_1 = require("./Interaction");
  *          return list[list.length - 1];
  *      });
  *
- *  Actor.named('Quentin').attemptsTo(
+ *  await actorCalled('Quentin').attemptsTo(
  *      Ensure.that(LastItemFrom([1,2,3]), equals(3)),
  *  );
  *
@@ -29,8 +31,8 @@ const Interaction_1 = require("./Interaction");
  *          return CallAnApi.as(actor).mapLastResponse(response => response.statusText);
  *      });
  *
- *  @example <caption>Mapping answers to other questions</caption>
- *  import { Actor, AnswersQuestions, UsesAbilities, Question } from '@serenity-js/core'
+ * @example <caption>Mapping answers to other questions</caption>
+ *  import { actorCalled, AnswersQuestions, UsesAbilities, Question } from '@serenity-js/core'
  *  import { CallAnApi, LastResponse } from '@serenity-js/rest'
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
@@ -39,12 +41,12 @@ const Interaction_1 = require("./Interaction");
  *          return LastResponse.status().answeredBy(actor) === 200;
  *      });
  *
- *  const actor = Actor.named('Quentin').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Quentin')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'));
+ *    .attemptsTo(
  *      Send.a(GetRequest.to('/books/0-688-00230-7')),
  *      Ensure.that(RequestWasSuccessful(), isTrue()),
- *  );
+ *    );
  *
  * @see {@link Actor}
  * @see {@link Interaction}
@@ -71,6 +73,71 @@ class Question {
     static about(description, body) {
         return Question.createAdapter(new QuestionStatement(description, body));
     }
+    /**
+     * @desc
+     *  Generates a {@link QuestionAdapter} that recursively resolves
+     *  any {@link Answerable} fields of the provided object,
+     *  including {@link Answerable} fields of nested objects.
+     *
+     *  Optionally, the method accepts `overrides` to be shallow-merged with the fields of the original `source`, producing a new merged object.
+     *
+     *  Overrides are applied from left to right, with subsequent objects overwriting property assignments of the previous ones.
+     *
+     * @example <caption>Resolving an object recursively</caption>
+     *  import { actorCalled, Question } from '@serenity-js/core'
+     *  import { Send, PostRequest } from '@serenity-js/rest'
+     *  import { By, Text, PageElement } from '@serenity-js/web'
+     *
+     *  actorCalled('Daisy')
+     *    .whoCan(CallAnApi.at('https://api.example.org'))
+     *    .attemptsTo(
+     *      Send.a(
+     *        PostRequest.to('/products/2')
+     *          .with(Question.fromObject({
+     *              name: Text.of(PageElement.located(By.css('.name'))),
+     *          }))
+     *        )
+     *    );
+     *
+     * @example <caption>Resolving an object recursively</caption>
+     *  import { actorCalled, Question } from '@serenity-js/core'
+     *  import { Send, PostRequest } from '@serenity-js/rest'
+     *  import { By, Text, PageElement } from '@serenity-js/web'
+     *
+     *  actorCalled('Daisy')
+     *    .whoCan(CallAnApi.at('https://api.example.org'))
+     *    .attemptsTo(
+     *      Send.a(
+     *        PostRequest.to('/products/2')
+     *          .with(Question.fromObject({
+     *              name: Text.of(PageElement.located(By.css('.name'))),
+     *              quantity: undefined,
+     *          }, {
+     *              quantity: 2,
+     *          }))
+     *        )
+     *    );
+     *
+     * @param {Answerable<O>} source
+     * @param {Array<Answerable<Partial<O>>>} overrides
+     *
+     * @returns {QuestionAdapter<Record<Key, Value>>>}
+     *
+     * @see {@link WithAnswerableProperties}
+     * @see {@link RecursivelyAnswered}
+     */
+    static fromObject(source, ...overrides) {
+        return Question.about('value', async (actor) => {
+            if (source === null || source === undefined) {
+                return source;
+            }
+            const sources = [];
+            for (const [i, currentSource] of [source, ...overrides].entries()) {
+                sources.push(await recursivelyAnswer(actor, currentSource, `argument ${i}`));
+            }
+            return Object.assign({}, ...sources);
+        });
+    }
     /**
      * @desc
      *  Checks if the value is a {@link Question}.
@@ -152,9 +219,7 @@ class Question {
             return `${targetDescription} ${parameters[0]}`;
         }
         const parameterDescriptions = [
-            '(',
-            parameters.map(p => (0, io_1.f) `${p}`).join(', '),
-            ')'
+            '(', parameters.map(p => (0, io_1.f) `${p}`).join(', '), ')',
         ].join('');
         return `${targetDescription}${parameterDescriptions}`;
     }
@@ -183,10 +248,7 @@ class QuestionStatement extends Interaction_1.Interaction {
         return new IsPresent((0, io_1.f) `${this}.isPresent()`, this.body);
     }
     async answeredBy(actor) {
-        const result = await this.body(actor);
-        return isDefined(result)
-            ? result
-            : undefined;
+        return await this.body(actor);
     }
     async performAs(actor) {
         await this.body(actor);
@@ -251,4 +313,33 @@ function isDefined(value) {
     return value !== undefined
         && value !== null;
 }
+/**
+ * @package
+ */
+const maxRecursiveCallsLimit = 100;
+/**
+ * @package
+ */
+async function recursivelyAnswer(actor, answerable, description, currentRecursion = 0) {
+    if (currentRecursion >= maxRecursiveCallsLimit) {
+        throw new errors_1.LogicError(`Question.fromObject() has reached the limit of ${maxRecursiveCallsLimit} recursive calls while trying to resolve ${description}. Could it contain cyclic references?`);
+    }
+    const answer = await actor.answer(answerable);
+    if ((0, objects_1.isRecord)(answer)) {
+        const entries = Object.entries(answer);
+        const answeredEntries = [];
+        for (const [key, value] of entries) {
+            answeredEntries.push([key, await recursivelyAnswer(actor, value, description, currentRecursion + 1)]);
+        }
+        return Object.fromEntries(answeredEntries);
+    }
+    if (Array.isArray(answer)) {
+        const answeredEntries = [];
+        for (const item of answer) {
+            answeredEntries.push(await recursivelyAnswer(actor, item, description, currentRecursion + 1));
+        }
+        return answeredEntries;
+    }
+    return answer;
+}
 //# sourceMappingURL=Question.js.map

package/lib/screenplay/Question.js.map

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

package/lib/screenplay/RecursivelyAnswered.d.ts

@@ -0,0 +1,38 @@
+import { Question } from './Question';
+/**
+ * @desc
+ *  Describes a recursively resolved plain JavaScript {@link WithAnswerableProperties}.
+ *  Typically, used in conjunction with {@link Question.fromObject}.
+ *
+ * @example
+ *  import {
+ *    actorCalled, notes, q, Question, QuestionAdapter, WithAnswerableProperties
+ *  } from '@serenity-js/core';
+ *
+ *  interface RequestConfiguration {
+ *      headers: Record<string, string>;
+ *  }
+ *
+ *  const requestConfiguration: WithAnswerableProperties<RequestConfiguration> = {
+ *      headers: {
+ *          Authorization: q`Bearer ${ notes().get('authDetails').token }`
+ *      }
+ *  }
+ *
+ *  const question: QuestionAdapter<RequestConfiguration> =
+ *      Question.fromObject<RequestConfiguration>(requestConfiguration)
+ *
+ *  const answer = await actorCalled('Annie').answer(question);
+ *
+ *  const a1: RequestConfiguration = answer;
+ *  const a2: RecursivelyAnswered<WithAnswerableProperties<RequestConfiguration>> = answer;
+ *
+ *  // RequestConfiguration === RecursivelyAnswered<WithAnswerableProperties<RequestConfiguration>>
+ *
+ * @public
+ *
+ * @typedef {object} RecursivelyAnswered<T>
+ */
+export declare type RecursivelyAnswered<T> = T extends null | undefined ? T : T extends Question<Promise<infer A>> | Question<infer A> | Promise<infer A> ? RecursivelyAnswered<Awaited<A>> : T extends object ? {
+    [K in keyof T]: RecursivelyAnswered<T[K]>;
+} : T;

package/lib/screenplay/RecursivelyAnswered.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=RecursivelyAnswered.js.map

package/lib/screenplay/RecursivelyAnswered.js.map

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

package/lib/screenplay/WithAnswerableProperties.d.ts

@@ -0,0 +1,34 @@
+import { Answerable } from './Answerable';
+import { Question } from './Question';
+/**
+ * @desc
+ *  Describes a plain JavaScript object with {@link Answerable} properties.
+ *  Typically, used in conjunction with {@link RecursivelyAnswered} and {@link Question.fromObject}.
+ *
+ * @example
+ *  import {
+ *    actorCalled, notes, q, Question, QuestionAdapter, WithAnswerableProperties
+ *  } from '@serenity-js/core';
+ *
+ *  interface RequestConfiguration {
+ *      headers: Record<string, string>;
+ *  }
+ *
+ *  const requestConfiguration: WithAnswerableProperties<RequestConfiguration> = {
+ *      headers: {
+ *          Authorization: q`Bearer ${ notes().get('authDetails').token }`
+ *      }
+ *  }
+ *
+ *  const question: QuestionAdapter<RequestConfiguration> =
+ *      Question.fromObject<RequestConfiguration>(requestConfiguration)
+ *
+ *  const answer: RequestConfiguration = await actorCalled('Annie').answer(question);
+ *
+ * @public
+ *
+ * @typedef {object} WithAnswerableProperties<T>
+ */
+export declare type WithAnswerableProperties<T> = T extends null | undefined ? T : T extends Question<Promise<infer A>> | Question<infer A> | Promise<infer A> ? Answerable<A> : T extends object ? Answerable<{
+    [K in keyof T]: WithAnswerableProperties<T[K]>;
+}> : Answerable<T>;

package/lib/screenplay/WithAnswerableProperties.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=WithAnswerableProperties.js.map

package/lib/screenplay/WithAnswerableProperties.js.map

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

package/lib/screenplay/index.d.ts

@@ -4,11 +4,12 @@ export * from './AbilityType';
 export * from './Activity';
 export * from './actor';
 export * from './Answerable';
-export * from './DynamicRecord';
 export * from './Interaction';
 export * from './interactions';
 export * from './notes';
 export * from './Optional';
 export * from './Question';
 export * from './questions';
+export * from './RecursivelyAnswered';
 export * from './Task';
+export * from './WithAnswerableProperties';

package/lib/screenplay/index.js

@@ -20,12 +20,13 @@ __exportStar(require("./AbilityType"), exports);
 __exportStar(require("./Activity"), exports);
 __exportStar(require("./actor"), exports);
 __exportStar(require("./Answerable"), exports);
-__exportStar(require("./DynamicRecord"), exports);
 __exportStar(require("./Interaction"), exports);
 __exportStar(require("./interactions"), exports);
 __exportStar(require("./notes"), exports);
 __exportStar(require("./Optional"), exports);
 __exportStar(require("./Question"), exports);
 __exportStar(require("./questions"), exports);
+__exportStar(require("./RecursivelyAnswered"), exports);
 __exportStar(require("./Task"), exports);
+__exportStar(require("./WithAnswerableProperties"), exports);
 //# sourceMappingURL=index.js.map

package/lib/screenplay/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/screenplay/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,4CAA0B;AAC1B,gDAA8B;AAC9B,6CAA2B;AAC3B,0CAAwB;AACxB,+CAA6B;AAC7B,kDAAgC;AAChC,gDAA8B;AAC9B,iDAA+B;AAC/B,0CAAwB;AACxB,6CAA2B;AAC3B,6CAA2B;AAC3B,8CAA4B;AAC5B,yCAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/screenplay/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,4CAA0B;AAC1B,gDAA8B;AAC9B,6CAA2B;AAC3B,0CAAwB;AACxB,+CAA6B;AAC7B,gDAA8B;AAC9B,iDAA+B;AAC/B,0CAAwB;AACxB,6CAA2B;AAC3B,6CAA2B;AAC3B,8CAA4B;AAC5B,wDAAsC;AACtC,yCAAuB;AACvB,6DAA2C"}

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

@@ -1,5 +1,4 @@
 export * from './Check';
-export * from './Dictionary';
 export * from './Expectation';
 export * from './expectations';
 export * from './List';

package/lib/screenplay/questions/index.js

@@ -15,7 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Check"), exports);
-__exportStar(require("./Dictionary"), exports);
 __exportStar(require("./Expectation"), exports);
 __exportStar(require("./expectations"), exports);
 __exportStar(require("./List"), exports);

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,+CAA6B;AAC7B,gDAA8B;AAC9B,iDAA+B;AAC/B,yCAAuB;AACvB,iDAA+B;AAC/B,sCAAoB"}
+{"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,sCAAoB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/core",
-  "version": "3.0.0-rc.18",
+  "version": "3.0.0-rc.19",
   "description": "Serenity/JS Screenplay, reporting engine and core interfaces.",
   "author": {
     "name": "Jan Molak",
@@ -36,13 +36,12 @@
   "dependencies": {
     "cuid": "^2.1.8",
     "diff": "^5.0.0",
-    "error-stack-parser": "2.1.0",
+    "error-stack-parser": "2.1.4",
     "fast-glob": "^3.2.11",
     "filenamify": "^4.3.0",
     "graceful-fs": "^4.2.10",
     "moment": "^2.29.3",
     "semver": "^7.3.7",
-    "stackframe": "1.3.0",
     "tiny-types": "^1.18.4",
     "upath": "^2.0.1"
   },
@@ -72,5 +71,5 @@
     "node": "^14 || ^16",
     "npm": "^6 || ^7 || ^8"
   },
-  "gitHead": "e6b62850b6c59e661314e5675d1f196e7e4fce03"
+  "gitHead": "dda2a6eab593e2525aa67888f197e48f2e3ae148"
 }

package/src/io/ErrorStackParser.ts

@@ -1,5 +1,4 @@
-const parser = require('error-stack-parser');   // eslint-disable-line @typescript-eslint/no-var-requires
-import StackFrame from 'stackframe';
+import * as parser from 'error-stack-parser';
 
 /**
  * @desc
@@ -10,7 +9,7 @@ import StackFrame from 'stackframe';
  * @package
  */
 export class ErrorStackParser {
-    parse(error: Error): StackFrame[] {
+    parse(error: Error): parser.StackFrame[] {
         return parser.parse(error);
     }
 }

package/src/model/artifacts/HTTPRequestResponse.ts

@@ -12,13 +12,15 @@ export interface RequestAndResponse extends JSONObject {
     request: {
         url: string;
         method: string;
-        headers: { [header: string]: string };
+        headers: Record<string, string | number | boolean>;
         data?: any;
     };
     response: {
         status: number;
         data?: any;
-        headers?: { [header: string]: string };
+        headers?: Record<string, string> & {
+            'set-cookie'?: string[]
+        };
     };
 }