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

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 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
+
+* **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/model/DeleteRequest.d.ts

@@ -1,4 +1,4 @@
-import { Answerable, DynamicRecord } from '@serenity-js/core';
+import { Answerable, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 import { HTTPRequest } from './HTTPRequest';
 /**
@@ -8,13 +8,13 @@ import { HTTPRequest } from './HTTPRequest';
  *  functionality.
  *
  * @example <caption>Create and remove a resource</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, DeleteRequest, LastResponse, PostRequest, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, DeleteRequest, LastResponse, PostRequest, Send } from '@serenity-js/rest';
  *  import { Ensure, equals, startsWith } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      // create a new test user account
  *      Send.a(PostRequest.to('/users').with({
  *          login: 'tester',
@@ -26,7 +26,7 @@ import { HTTPRequest } from './HTTPRequest';
  *      // delete the test user account
  *      Send.a(DeleteRequest.to(LastResponse.header('Location'))),
  *      Ensure.that(LastResponse.status(), equals(200)),
- *  );
+ *    );
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/DELETE
  * @see https://tools.ietf.org/html/rfc7231#section-4.3.5
@@ -54,10 +54,10 @@ export declare class DeleteRequest extends HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {DeleteRequest}
      */
-    using(config: Answerable<DynamicRecord<AxiosRequestConfig>>): DeleteRequest;
+    using(config: Answerable<WithAnswerableProperties<AxiosRequestConfig>>): DeleteRequest;
 }

package/lib/model/DeleteRequest.js

@@ -10,13 +10,13 @@ const HTTPRequest_1 = require("./HTTPRequest");
  *  functionality.
  *
  * @example <caption>Create and remove a resource</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, DeleteRequest, LastResponse, PostRequest, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, DeleteRequest, LastResponse, PostRequest, Send } from '@serenity-js/rest';
  *  import { Ensure, equals, startsWith } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      // create a new test user account
  *      Send.a(PostRequest.to('/users').with({
  *          login: 'tester',
@@ -28,7 +28,7 @@ const HTTPRequest_1 = require("./HTTPRequest");
  *      // delete the test user account
  *      Send.a(DeleteRequest.to(LastResponse.header('Location'))),
  *      Ensure.that(LastResponse.status(), equals(200)),
- *  );
+ *    );
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/DELETE
  * @see https://tools.ietf.org/html/rfc7231#section-4.3.5
@@ -58,13 +58,13 @@ class DeleteRequest extends HTTPRequest_1.HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {DeleteRequest}
      */
     using(config) {
-        return new DeleteRequest(this.resourceUri, undefined, core_1.Dictionary.of(config));
+        return new DeleteRequest(this.resourceUri, undefined, core_1.Question.fromObject(config));
     }
 }
 exports.DeleteRequest = DeleteRequest;

package/lib/model/DeleteRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"DeleteRequest.js","sourceRoot":"","sources":["../../src/model/DeleteRequest.ts"],"names":[],"mappings":";;;AAAA,4CAA0E;AAG1E,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAa,aAAc,SAAQ,yBAAW;IAE1C;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,WAA+B;QACrC,OAAO,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAqD;QACvD,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,iBAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACjF,CAAC;CACJ;AAjCD,sCAiCC"}
+{"version":3,"file":"DeleteRequest.js","sourceRoot":"","sources":["../../src/model/DeleteRequest.ts"],"names":[],"mappings":";;;AAAA,4CAAmF;AAGnF,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAa,aAAc,SAAQ,yBAAW;IAE1C;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,WAA+B;QACrC,OAAO,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAgE;QAClE,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,eAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACvF,CAAC;CACJ;AAjCD,sCAiCC"}

package/lib/model/GetRequest.d.ts

@@ -1,4 +1,4 @@
-import { Answerable, DynamicRecord } from '@serenity-js/core';
+import { Answerable, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 import { HTTPRequest } from './HTTPRequest';
 /**
@@ -15,8 +15,8 @@ import { HTTPRequest } from './HTTPRequest';
  *  the server in the same state.
  *
  * @example <caption>Verify response to a GET request</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, GetRequest, LastResponse, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, GetRequest, LastResponse, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
  *  interface Book {
@@ -24,16 +24,16 @@ import { HTTPRequest } from './HTTPRequest';
  *      author: string;
  *  }
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(GetRequest.to('/books/0-688-00230-7')),
  *      Ensure.that(LastResponse.status(), equals(200)),
  *      Ensure.that(LastResponse.body<Book>(), equals({
  *          title: 'Zen and the Art of Motorcycle Maintenance: An Inquiry into Values',
  *          author: 'Robert M. Pirsig',
  *      })),
- *  );
+ *    );
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/GET
  * @see https://tools.ietf.org/html/rfc7231#section-4.3.1
@@ -61,10 +61,10 @@ export declare class GetRequest extends HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {GetRequest}
      */
-    using(config: Answerable<DynamicRecord<AxiosRequestConfig>>): GetRequest;
+    using(config: Answerable<WithAnswerableProperties<AxiosRequestConfig>>): GetRequest;
 }

package/lib/model/GetRequest.js

@@ -17,8 +17,8 @@ const HTTPRequest_1 = require("./HTTPRequest");
  *  the server in the same state.
  *
  * @example <caption>Verify response to a GET request</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, GetRequest, LastResponse, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, GetRequest, LastResponse, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
  *  interface Book {
@@ -26,16 +26,16 @@ const HTTPRequest_1 = require("./HTTPRequest");
  *      author: string;
  *  }
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(GetRequest.to('/books/0-688-00230-7')),
  *      Ensure.that(LastResponse.status(), equals(200)),
  *      Ensure.that(LastResponse.body<Book>(), equals({
  *          title: 'Zen and the Art of Motorcycle Maintenance: An Inquiry into Values',
  *          author: 'Robert M. Pirsig',
  *      })),
- *  );
+ *    );
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/GET
  * @see https://tools.ietf.org/html/rfc7231#section-4.3.1
@@ -65,13 +65,13 @@ class GetRequest extends HTTPRequest_1.HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {GetRequest}
      */
     using(config) {
-        return new GetRequest(this.resourceUri, undefined, core_1.Dictionary.of(config));
+        return new GetRequest(this.resourceUri, undefined, core_1.Question.fromObject(config));
     }
 }
 exports.GetRequest = GetRequest;

package/lib/model/GetRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"GetRequest.js","sourceRoot":"","sources":["../../src/model/GetRequest.ts"],"names":[],"mappings":";;;AAAA,4CAA0E;AAG1E,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAa,UAAW,SAAQ,yBAAW;IAEvC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,WAA+B;QACrC,OAAO,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAqD;QACvD,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,iBAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9E,CAAC;CACJ;AAjCD,gCAiCC"}
+{"version":3,"file":"GetRequest.js","sourceRoot":"","sources":["../../src/model/GetRequest.ts"],"names":[],"mappings":";;;AAAA,4CAAmF;AAGnF,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAa,UAAW,SAAQ,yBAAW;IAEvC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,WAA+B;QACrC,OAAO,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAgE;QAClE,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,eAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACpF,CAAC;CACJ;AAjCD,gCAiCC"}

package/lib/model/HTTPRequest.d.ts

@@ -1,4 +1,4 @@
-import { Answerable, AnswersQuestions, Question, UsesAbilities } from '@serenity-js/core';
+import { Answerable, AnswersQuestions, Question, UsesAbilities, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 /**
  * @desc
@@ -11,7 +11,7 @@ import { AxiosRequestConfig } from 'axios';
 export declare abstract class HTTPRequest extends Question<Promise<AxiosRequestConfig>> {
     protected readonly resourceUri?: Answerable<string>;
     protected readonly data?: Answerable<any>;
-    protected readonly config?: Answerable<AxiosRequestConfig>;
+    protected readonly config?: Answerable<WithAnswerableProperties<AxiosRequestConfig>>;
     private subject;
     /**
      * @protected
@@ -26,7 +26,7 @@ export declare abstract class HTTPRequest extends Question<Promise<AxiosRequestC
      *  Axios request configuration, which can be used to override the defaults
      *  provided when the {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} is instantiated
      */
-    protected constructor(resourceUri?: Answerable<string>, data?: Answerable<any>, config?: Answerable<AxiosRequestConfig>);
+    protected constructor(resourceUri?: Answerable<string>, data?: Answerable<any>, config?: Answerable<WithAnswerableProperties<AxiosRequestConfig>>);
     /**
      * @desc
      *  Resolves the {@link Question} in the context of a given {@link @serenity-js/core/lib/screenplay/actor~Actor}

package/lib/model/HTTPRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"HTTPRequest.js","sourceRoot":"","sources":["../../src/model/HTTPRequest.ts"],"names":[],"mappings":";;;AAAA,4CAA0F;AAC1F,iDAAqD;AAGrD;;;;;;;GAOG;AACH,MAAsB,WAAY,SAAQ,eAAqC;IAI3E;;;;;;;;;;;;OAYG;IACH,YACuB,WAAgC,EAChC,IAAsB,EACtB,MAAuC;QAE1D,KAAK,EAAE,CAAC;QAJW,gBAAW,GAAX,WAAW,CAAqB;QAChC,SAAI,GAAJ,IAAI,CAAkB;QACtB,WAAM,GAAN,MAAM,CAAiC;QAG1D,IAAI,CAAC,OAAO,GAAG,GAAI,IAAI,CAAC,kBAAkB,EAAG,OAAQ,IAAA,cAAS,EAAC,GAAI,IAAI,CAAC,WAAY,EAAG,EAAE,CAAC;IAC9F,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,KAAuC;QAC9C,OAAO,OAAO,CAAC,GAAG,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7E,IAAI,CAAC,MAAM,CAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAQ,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACzE,IAAI,CAAC,IAAI,CAAQ,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAU,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;SAChF,CAAC;YACF,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAEzB,MAAM,CAAC,MAAM,CACT,EAAE,EACF,EAAE,GAAG,EAAE,IAAI,EAAE,EACb,MAAM,EACN,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,EAAE,CACpC,CACJ;YACD,IAAI,CAAC,MAAM,CAAC,EAAE;QACV,8DAA8D;QAC9D,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACpC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAG;gBACpD,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;aAC1B;YACD,OAAO,GAAG,CAAC;QACf,CAAC,EAAE,EAAE,CAAC,CACT,CAAC;IACN,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;IAED;;;OAGG;IACK,cAAc;QAClB,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACtE,CAAC;IAED;;OAEG;IACK,kBAAkB;QACtB,MACI,MAAM,GAAG,CAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAE,EACpC,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAEnC,OAAO,GAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAI,IAAK,MAAO,UAAU,CAAC;IAC9E,CAAC;CACJ;AA7FD,kCA6FC"}
+{"version":3,"file":"HTTPRequest.js","sourceRoot":"","sources":["../../src/model/HTTPRequest.ts"],"names":[],"mappings":";;;AAAA,4CAAoH;AACpH,iDAAqD;AAGrD;;;;;;;GAOG;AACH,MAAsB,WAAY,SAAQ,eAAqC;IAI3E;;;;;;;;;;;;OAYG;IACH,YACuB,WAAgC,EAChC,IAAsB,EACtB,MAAiE;QAEpF,KAAK,EAAE,CAAC;QAJW,gBAAW,GAAX,WAAW,CAAqB;QAChC,SAAI,GAAJ,IAAI,CAAkB;QACtB,WAAM,GAAN,MAAM,CAA2D;QAGpF,IAAI,CAAC,OAAO,GAAG,GAAI,IAAI,CAAC,kBAAkB,EAAG,OAAQ,IAAA,cAAS,EAAC,GAAI,IAAI,CAAC,WAAY,EAAG,EAAE,CAAC;IAC9F,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,KAAuC;QAC9C,OAAO,OAAO,CAAC,GAAG,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7E,IAAI,CAAC,MAAM,CAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAQ,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACzE,IAAI,CAAC,IAAI,CAAQ,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAU,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;SAChF,CAAC;YACF,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAEzB,MAAM,CAAC,MAAM,CACT,EAAE,EACF,EAAE,GAAG,EAAE,IAAI,EAAE,EACb,MAAM,EACN,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,EAAE,CACpC,CACJ;YACD,IAAI,CAAC,MAAM,CAAC,EAAE;QACV,8DAA8D;QAC9D,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACpC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAG;gBACpD,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;aAC1B;YACD,OAAO,GAAG,CAAC;QACf,CAAC,EAAE,EAAE,CAAC,CACT,CAAC;IACN,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;IAED;;;OAGG;IACK,cAAc;QAClB,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACtE,CAAC;IAED;;OAEG;IACK,kBAAkB;QACtB,MACI,MAAM,GAAG,CAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAE,EACpC,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAEnC,OAAO,GAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAI,IAAK,MAAO,UAAU,CAAC;IAC9E,CAAC;CACJ;AA7FD,kCA6FC"}

package/lib/model/HeadRequest.d.ts

@@ -1,4 +1,4 @@
-import { Answerable, DynamicRecord } from '@serenity-js/core';
+import { Answerable, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 import { HTTPRequest } from './HTTPRequest';
 /**
@@ -8,17 +8,17 @@ import { HTTPRequest } from './HTTPRequest';
  *  Such a request can be done before deciding to download a large resource to save bandwidth, for example.
  *
  * @example <caption>File download test</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, HeadRequest, LastResponse, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, HeadRequest, LastResponse, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(HeadRequest.to('/downloads/my-test-document.pdf')),
  *      Ensure.that(LastResponse.status(), equals(200)),
  *      Ensure.that(LastResponse.header('Content-Length'), equals(256)),    // assuming we know the size of the document
- *  );
+ *    );
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/HEAD
  * @see https://tools.ietf.org/html/rfc7231#section-4.3.2
@@ -46,10 +46,10 @@ export declare class HeadRequest extends HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {HeadRequest}
      */
-    using(config: Answerable<DynamicRecord<AxiosRequestConfig>>): HeadRequest;
+    using(config: Answerable<WithAnswerableProperties<AxiosRequestConfig>>): HeadRequest;
 }

package/lib/model/HeadRequest.js

@@ -10,17 +10,17 @@ const HTTPRequest_1 = require("./HTTPRequest");
  *  Such a request can be done before deciding to download a large resource to save bandwidth, for example.
  *
  * @example <caption>File download test</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, HeadRequest, LastResponse, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, HeadRequest, LastResponse, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(HeadRequest.to('/downloads/my-test-document.pdf')),
  *      Ensure.that(LastResponse.status(), equals(200)),
  *      Ensure.that(LastResponse.header('Content-Length'), equals(256)),    // assuming we know the size of the document
- *  );
+ *    );
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/HEAD
  * @see https://tools.ietf.org/html/rfc7231#section-4.3.2
@@ -50,13 +50,13 @@ class HeadRequest extends HTTPRequest_1.HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {HeadRequest}
      */
     using(config) {
-        return new HeadRequest(this.resourceUri, undefined, core_1.Dictionary.of(config));
+        return new HeadRequest(this.resourceUri, undefined, core_1.Question.fromObject(config));
     }
 }
 exports.HeadRequest = HeadRequest;

package/lib/model/HeadRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"HeadRequest.js","sourceRoot":"","sources":["../../src/model/HeadRequest.ts"],"names":[],"mappings":";;;AAAA,4CAA0E;AAG1E,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,WAAY,SAAQ,yBAAW;IAExC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,WAA+B;QACrC,OAAO,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAqD;QACvD,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,iBAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/E,CAAC;CACJ;AAjCD,kCAiCC"}
+{"version":3,"file":"HeadRequest.js","sourceRoot":"","sources":["../../src/model/HeadRequest.ts"],"names":[],"mappings":";;;AAAA,4CAAmF;AAGnF,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,WAAY,SAAQ,yBAAW;IAExC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,WAA+B;QACrC,OAAO,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAgE;QAClE,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,eAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACrF,CAAC;CACJ;AAjCD,kCAiCC"}

package/lib/model/OptionsRequest.d.ts

@@ -1,4 +1,4 @@
-import { Answerable, DynamicRecord } from '@serenity-js/core';
+import { Answerable, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 import { HTTPRequest } from './HTTPRequest';
 /**
@@ -11,13 +11,13 @@ import { HTTPRequest } from './HTTPRequest';
  *  resource action.
  *
  * @example <caption>File download test</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, OptionsRequest, LastResponse, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, OptionsRequest, LastResponse, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(OptionsRequest.to('/downloads/my-test-document.pdf')),
  *      Ensure.that(LastResponse.status(), equals(200)),
  *      Ensure.that(LastResponse.header('Allow'), equals('OPTIONS, GET, HEAD')),
@@ -49,10 +49,10 @@ export declare class OptionsRequest extends HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {OptionsRequest}
      */
-    using(config: Answerable<DynamicRecord<AxiosRequestConfig>>): OptionsRequest;
+    using(config: Answerable<WithAnswerableProperties<AxiosRequestConfig>>): OptionsRequest;
 }

package/lib/model/OptionsRequest.js

@@ -13,13 +13,13 @@ const HTTPRequest_1 = require("./HTTPRequest");
  *  resource action.
  *
  * @example <caption>File download test</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, OptionsRequest, LastResponse, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, OptionsRequest, LastResponse, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(OptionsRequest.to('/downloads/my-test-document.pdf')),
  *      Ensure.that(LastResponse.status(), equals(200)),
  *      Ensure.that(LastResponse.header('Allow'), equals('OPTIONS, GET, HEAD')),
@@ -53,13 +53,13 @@ class OptionsRequest extends HTTPRequest_1.HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {OptionsRequest}
      */
     using(config) {
-        return new OptionsRequest(this.resourceUri, undefined, core_1.Dictionary.of(config));
+        return new OptionsRequest(this.resourceUri, undefined, core_1.Question.fromObject(config));
     }
 }
 exports.OptionsRequest = OptionsRequest;

package/lib/model/OptionsRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"OptionsRequest.js","sourceRoot":"","sources":["../../src/model/OptionsRequest.ts"],"names":[],"mappings":";;;AAAA,4CAA0E;AAG1E,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAa,cAAe,SAAQ,yBAAW;IAE3C;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,WAA+B;QACrC,OAAO,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAqD;QACvD,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,iBAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAClF,CAAC;CACJ;AAjCD,wCAiCC"}
+{"version":3,"file":"OptionsRequest.js","sourceRoot":"","sources":["../../src/model/OptionsRequest.ts"],"names":[],"mappings":";;;AAAA,4CAAmF;AAGnF,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAa,cAAe,SAAQ,yBAAW;IAE3C;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,WAA+B;QACrC,OAAO,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAgE;QAClE,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,eAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACxF,CAAC;CACJ;AAjCD,wCAiCC"}

package/lib/model/PatchRequest.d.ts

@@ -1,4 +1,4 @@
-import { Answerable, DynamicRecord } from '@serenity-js/core';
+import { Answerable, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 import { HTTPRequest } from './HTTPRequest';
 /**
@@ -8,12 +8,12 @@ import { HTTPRequest } from './HTTPRequest';
  *
  * @example <caption>Add new resource to a collection</caption>
  *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, LastResponse, PatchRequest, Send } from '@serenity-js/rest'
+ *  import { CallAnApi, LastResponse, PatchRequest, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(PatchRequest.to('/books/0-688-00230-7').with({
  *          lastReadOn: '2016-06-16',
  *      })),
@@ -56,10 +56,10 @@ export declare class PatchRequest extends HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {PatchRequest}
      */
-    using(config: Answerable<DynamicRecord<AxiosRequestConfig>>): PatchRequest;
+    using(config: Answerable<WithAnswerableProperties<AxiosRequestConfig>>): PatchRequest;
 }

package/lib/model/PatchRequest.js

@@ -10,12 +10,12 @@ const HTTPRequest_1 = require("./HTTPRequest");
  *
  * @example <caption>Add new resource to a collection</caption>
  *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, LastResponse, PatchRequest, Send } from '@serenity-js/rest'
+ *  import { CallAnApi, LastResponse, PatchRequest, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(PatchRequest.to('/books/0-688-00230-7').with({
  *          lastReadOn: '2016-06-16',
  *      })),
@@ -62,13 +62,13 @@ class PatchRequest extends HTTPRequest_1.HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {PatchRequest}
      */
     using(config) {
-        return new PatchRequest(this.resourceUri, this.data, core_1.Dictionary.of(config));
+        return new PatchRequest(this.resourceUri, this.data, core_1.Question.fromObject(config));
     }
 }
 exports.PatchRequest = PatchRequest;

package/lib/model/PatchRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"PatchRequest.js","sourceRoot":"","sources":["../../src/model/PatchRequest.ts"],"names":[],"mappings":";;;AAAA,4CAA0E;AAG1E,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,YAAa,SAAQ,yBAAW;IAEzC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,WAA+B;QACrC,OAAO,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAqB;QACtB,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAqD;QACvD,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,iBAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,CAAC;CACJ;AA9CD,oCA8CC"}
+{"version":3,"file":"PatchRequest.js","sourceRoot":"","sources":["../../src/model/PatchRequest.ts"],"names":[],"mappings":";;;AAAA,4CAAmF;AAGnF,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,YAAa,SAAQ,yBAAW;IAEzC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,WAA+B;QACrC,OAAO,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAqB;QACtB,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAgE;QAClE,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,eAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACtF,CAAC;CACJ;AA9CD,oCA8CC"}

package/lib/model/PostRequest.d.ts

@@ -1,4 +1,4 @@
-import { Answerable, DynamicRecord } from '@serenity-js/core';
+import { Answerable, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 import { HTTPRequest } from './HTTPRequest';
 /**
@@ -16,13 +16,13 @@ import { HTTPRequest } from './HTTPRequest';
  *  a correctly implemented HTTP REST API will create N resources with N different URIs.
  *
  * @example <caption>Add new resource to a collection</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, LastResponse, PostRequest, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, LastResponse, PostRequest, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(PostRequest.to('/books').with({
  *          isbn: '0-688-00230-7',
  *          title: 'Zen and the Art of Motorcycle Maintenance: An Inquiry into Values',
@@ -32,21 +32,21 @@ import { HTTPRequest } from './HTTPRequest';
  *      Ensure.that(LastResponse.header('Location'), equals('/books/0-688-00230-7')),
  *  );
  *
- * @example <caption>Submit a HTML form</caption>
- *  import { Actor } from '@serenity-js/core';
+ * @example <caption>Submit an HTML form</caption>
+ *  import { actorCalled } from '@serenity-js/core';
  *  import { CallAnApi, LastResponse, PostRequest, Send } from '@serenity-js/rest'
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *  import { stringify } from 'querystring';
  *
- *  const
- *      actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com')),
- *      formData = stringify({
- *          name: actor.name,
- *          email: `${ actor.name }@example.com`,
- *          text: 'Your website is great! Learnt a lot :-)'
- *      });
+ *  const formData = stringify({
+ *      name: actor.name,
+ *      email: `${ actor.name }@example.com`,
+ *      text: 'Your website is great! Learnt a lot :-)'
+ *  });
  *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(PostRequest.to('/feedback').with(postData).using({
  *          headers: {
  *              'Content-Type': 'application/x-www-form-urlencoded',
@@ -93,10 +93,10 @@ export declare class PostRequest extends HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {PostRequest}
      */
-    using(config: Answerable<DynamicRecord<AxiosRequestConfig>>): PostRequest;
+    using(config: Answerable<WithAnswerableProperties<AxiosRequestConfig>>): PostRequest;
 }

package/lib/model/PostRequest.js

@@ -18,13 +18,13 @@ const HTTPRequest_1 = require("./HTTPRequest");
  *  a correctly implemented HTTP REST API will create N resources with N different URIs.
  *
  * @example <caption>Add new resource to a collection</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, LastResponse, PostRequest, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, LastResponse, PostRequest, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(PostRequest.to('/books').with({
  *          isbn: '0-688-00230-7',
  *          title: 'Zen and the Art of Motorcycle Maintenance: An Inquiry into Values',
@@ -34,21 +34,21 @@ const HTTPRequest_1 = require("./HTTPRequest");
  *      Ensure.that(LastResponse.header('Location'), equals('/books/0-688-00230-7')),
  *  );
  *
- * @example <caption>Submit a HTML form</caption>
- *  import { Actor } from '@serenity-js/core';
+ * @example <caption>Submit an HTML form</caption>
+ *  import { actorCalled } from '@serenity-js/core';
  *  import { CallAnApi, LastResponse, PostRequest, Send } from '@serenity-js/rest'
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *  import { stringify } from 'querystring';
  *
- *  const
- *      actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com')),
- *      formData = stringify({
- *          name: actor.name,
- *          email: `${ actor.name }@example.com`,
- *          text: 'Your website is great! Learnt a lot :-)'
- *      });
+ *  const formData = stringify({
+ *      name: actor.name,
+ *      email: `${ actor.name }@example.com`,
+ *      text: 'Your website is great! Learnt a lot :-)'
+ *  });
  *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(PostRequest.to('/feedback').with(postData).using({
  *          headers: {
  *              'Content-Type': 'application/x-www-form-urlencoded',
@@ -99,13 +99,13 @@ class PostRequest extends HTTPRequest_1.HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {PostRequest}
      */
     using(config) {
-        return new PostRequest(this.resourceUri, this.data, core_1.Dictionary.of(config));
+        return new PostRequest(this.resourceUri, this.data, core_1.Question.fromObject(config));
     }
 }
 exports.PostRequest = PostRequest;

package/lib/model/PostRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"PostRequest.js","sourceRoot":"","sources":["../../src/model/PostRequest.ts"],"names":[],"mappings":";;;AAAA,4CAA0E;AAG1E,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,MAAa,WAAY,SAAQ,yBAAW;IAExC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,WAA+B;QACrC,OAAO,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAqB;QACtB,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAqD;QACvD,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,iBAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/E,CAAC;CACJ;AA9CD,kCA8CC"}
+{"version":3,"file":"PostRequest.js","sourceRoot":"","sources":["../../src/model/PostRequest.ts"],"names":[],"mappings":";;;AAAA,4CAAmF;AAGnF,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,MAAa,WAAY,SAAQ,yBAAW;IAExC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,WAA+B;QACrC,OAAO,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAqB;QACtB,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAgE;QAClE,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,eAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACrF,CAAC;CACJ;AA9CD,kCA8CC"}

package/lib/model/PutRequest.d.ts

@@ -1,4 +1,4 @@
-import { Answerable, DynamicRecord } from '@serenity-js/core';
+import { Answerable, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 import { HTTPRequest } from './HTTPRequest';
 /**
@@ -15,13 +15,13 @@ import { HTTPRequest } from './HTTPRequest';
  *  calling it once or several times successively has the same effect (that is no _side effect_).
  *
  * @example <caption>Create a new resource at a known location</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, LastResponse, PutRequest, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, LastResponse, PutRequest, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(PutRequest.to('/books/0-688-00230-7').with({
  *          isbn: '0-688-00230-7',
  *          title: 'Zen and the Art of Motorcycle Maintenance: An Inquiry into Values',
@@ -66,10 +66,10 @@ export declare class PutRequest extends HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {@serenity-js/core/lib/screenplay/questions~DynamicRecord<AxiosRequestConfig>} config
+     * @param {WithAnswerableProperties<AxiosRequestConfig>} config
      *  Axios request configuration overrides
      *
      * @returns {PutRequest}
      */
-    using(config: Answerable<DynamicRecord<AxiosRequestConfig>>): PutRequest;
+    using(config: Answerable<WithAnswerableProperties<AxiosRequestConfig>>): PutRequest;
 }

package/lib/model/PutRequest.js

@@ -17,13 +17,13 @@ const HTTPRequest_1 = require("./HTTPRequest");
  *  calling it once or several times successively has the same effect (that is no _side effect_).
  *
  * @example <caption>Create a new resource at a known location</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, LastResponse, PutRequest, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, LastResponse, PutRequest, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(PutRequest.to('/books/0-688-00230-7').with({
  *          isbn: '0-688-00230-7',
  *          title: 'Zen and the Art of Motorcycle Maintenance: An Inquiry into Values',
@@ -72,13 +72,13 @@ class PutRequest extends HTTPRequest_1.HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {@serenity-js/core/lib/screenplay/questions~DynamicRecord<AxiosRequestConfig>} config
+     * @param {WithAnswerableProperties<AxiosRequestConfig>} config
      *  Axios request configuration overrides
      *
      * @returns {PutRequest}
      */
     using(config) {
-        return new PutRequest(this.resourceUri, this.data, core_1.Dictionary.of(config));
+        return new PutRequest(this.resourceUri, this.data, core_1.Question.fromObject(config));
     }
 }
 exports.PutRequest = PutRequest;

package/lib/model/PutRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"PutRequest.js","sourceRoot":"","sources":["../../src/model/PutRequest.ts"],"names":[],"mappings":";;;AAAA,4CAA0E;AAG1E,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAa,UAAW,SAAQ,yBAAW;IAEvC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,WAA+B;QACrC,OAAO,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAqB;QACtB,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAqD;QACvD,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,iBAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9E,CAAC;CACJ;AA9CD,gCA8CC"}
+{"version":3,"file":"PutRequest.js","sourceRoot":"","sources":["../../src/model/PutRequest.ts"],"names":[],"mappings":";;;AAAA,4CAAmF;AAGnF,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAa,UAAW,SAAQ,yBAAW;IAEvC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,WAA+B;QACrC,OAAO,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAqB;QACtB,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAgE;QAClE,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,eAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACpF,CAAC;CACJ;AA9CD,gCA8CC"}

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

@@ -1,5 +1,5 @@
 import { Ability, UsesAbilities } from '@serenity-js/core';
-import { AxiosInstance, AxiosRequestConfig, AxiosResponse } from 'axios';
+import { AxiosDefaults, AxiosInstance, AxiosRequestConfig, AxiosResponse } from 'axios';
 /**
  * @desc
  *  An {@link @serenity-js/core/lib/screenplay~Ability} that enables the {@link Actor} to call a HTTP API.
@@ -107,7 +107,7 @@ export declare class CallAnApi implements Ability {
      *
      * @see {@link AxiosRequestConfig}
      */
-    modifyConfig(fn: (original: AxiosRequestConfig) => any): void;
+    modifyConfig(fn: (original: AxiosDefaults<any>) => any): void;
     /**
      * @desc
      *  Sends a HTTP request to a specified url.

package/lib/screenplay/abilities/CallAnApi.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/rest",
-  "version": "3.0.0-rc.18",
+  "version": "3.0.0-rc.19",
   "description": "Test REST APIs with Serenity/JS",
   "author": {
     "name": "Jan Molak",
@@ -48,13 +48,13 @@
     "npm": "^6 || ^7 || ^8"
   },
   "dependencies": {
-    "@serenity-js/core": "3.0.0-rc.18",
-    "axios": "^0.21.4"
+    "@serenity-js/core": "3.0.0-rc.19",
+    "axios": "^0.27.2"
   },
   "devDependencies": {
     "@documentation/esdoc-template": "3.0.0",
     "@integration/testing-tools": "3.0.0",
-    "@serenity-js/assertions": "3.0.0-rc.18",
+    "@serenity-js/assertions": "3.0.0-rc.19",
     "@types/chai": "^4.3.1",
     "@types/mocha": "^9.1.1",
     "axios-mock-adapter": "^1.20.0",
@@ -62,5 +62,5 @@
     "ts-node": "^10.7.0",
     "typescript": "^4.7.2"
   },
-  "gitHead": "e6b62850b6c59e661314e5675d1f196e7e4fce03"
+  "gitHead": "dda2a6eab593e2525aa67888f197e48f2e3ae148"
 }

package/src/model/DeleteRequest.ts

@@ -1,4 +1,4 @@
-import { Answerable, Dictionary, DynamicRecord } from '@serenity-js/core';
+import { Answerable, Question, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 
 import { HTTPRequest } from './HTTPRequest';
@@ -10,13 +10,13 @@ import { HTTPRequest } from './HTTPRequest';
  *  functionality.
  *
  * @example <caption>Create and remove a resource</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, DeleteRequest, LastResponse, PostRequest, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, DeleteRequest, LastResponse, PostRequest, Send } from '@serenity-js/rest';
  *  import { Ensure, equals, startsWith } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      // create a new test user account
  *      Send.a(PostRequest.to('/users').with({
  *          login: 'tester',
@@ -28,7 +28,7 @@ import { HTTPRequest } from './HTTPRequest';
  *      // delete the test user account
  *      Send.a(DeleteRequest.to(LastResponse.header('Location'))),
  *      Ensure.that(LastResponse.status(), equals(200)),
- *  );
+ *    );
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/DELETE
  * @see https://tools.ietf.org/html/rfc7231#section-4.3.5
@@ -60,12 +60,12 @@ export class DeleteRequest extends HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {DeleteRequest}
      */
-    using(config: Answerable<DynamicRecord<AxiosRequestConfig>>): DeleteRequest {
-        return new DeleteRequest(this.resourceUri, undefined, Dictionary.of(config));
+    using(config: Answerable<WithAnswerableProperties<AxiosRequestConfig>>): DeleteRequest {
+        return new DeleteRequest(this.resourceUri, undefined, Question.fromObject(config));
     }
 }

package/src/model/GetRequest.ts

@@ -1,4 +1,4 @@
-import { Answerable, Dictionary, DynamicRecord } from '@serenity-js/core';
+import { Answerable, Question, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 
 import { HTTPRequest } from './HTTPRequest';
@@ -17,8 +17,8 @@ import { HTTPRequest } from './HTTPRequest';
  *  the server in the same state.
  *
  * @example <caption>Verify response to a GET request</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, GetRequest, LastResponse, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, GetRequest, LastResponse, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
  *  interface Book {
@@ -26,16 +26,16 @@ import { HTTPRequest } from './HTTPRequest';
  *      author: string;
  *  }
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(GetRequest.to('/books/0-688-00230-7')),
  *      Ensure.that(LastResponse.status(), equals(200)),
  *      Ensure.that(LastResponse.body<Book>(), equals({
  *          title: 'Zen and the Art of Motorcycle Maintenance: An Inquiry into Values',
  *          author: 'Robert M. Pirsig',
  *      })),
- *  );
+ *    );
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/GET
  * @see https://tools.ietf.org/html/rfc7231#section-4.3.1
@@ -67,12 +67,12 @@ export class GetRequest extends HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {GetRequest}
      */
-    using(config: Answerable<DynamicRecord<AxiosRequestConfig>>): GetRequest {
-        return new GetRequest(this.resourceUri, undefined, Dictionary.of(config));
+    using(config: Answerable<WithAnswerableProperties<AxiosRequestConfig>>): GetRequest {
+        return new GetRequest(this.resourceUri, undefined, Question.fromObject(config));
     }
 }

package/src/model/HTTPRequest.ts

@@ -1,4 +1,4 @@
-import { Answerable, AnswersQuestions, Question, UsesAbilities } from '@serenity-js/core';
+import { Answerable, AnswersQuestions, Question, UsesAbilities, WithAnswerableProperties } from '@serenity-js/core';
 import { formatted } from '@serenity-js/core/lib/io';
 import { AxiosRequestConfig } from 'axios';
 
@@ -30,7 +30,7 @@ export abstract class HTTPRequest extends Question<Promise<AxiosRequestConfig>>
     protected constructor(
         protected readonly resourceUri?: Answerable<string>,
         protected readonly data?: Answerable<any>,
-        protected readonly config?: Answerable<AxiosRequestConfig>,
+        protected readonly config?: Answerable<WithAnswerableProperties<AxiosRequestConfig>>,
     ) {
         super();
         this.subject = `${ this.requestDescription() } to ${ formatted `${ this.resourceUri }` }`;

package/src/model/HeadRequest.ts

@@ -1,4 +1,4 @@
-import { Answerable, Dictionary, DynamicRecord } from '@serenity-js/core';
+import { Answerable, Question, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 
 import { HTTPRequest } from './HTTPRequest';
@@ -10,17 +10,17 @@ import { HTTPRequest } from './HTTPRequest';
  *  Such a request can be done before deciding to download a large resource to save bandwidth, for example.
  *
  * @example <caption>File download test</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, HeadRequest, LastResponse, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, HeadRequest, LastResponse, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(HeadRequest.to('/downloads/my-test-document.pdf')),
  *      Ensure.that(LastResponse.status(), equals(200)),
  *      Ensure.that(LastResponse.header('Content-Length'), equals(256)),    // assuming we know the size of the document
- *  );
+ *    );
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/HEAD
  * @see https://tools.ietf.org/html/rfc7231#section-4.3.2
@@ -52,12 +52,12 @@ export class HeadRequest extends HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {HeadRequest}
      */
-    using(config: Answerable<DynamicRecord<AxiosRequestConfig>>): HeadRequest {
-        return new HeadRequest(this.resourceUri, undefined, Dictionary.of(config));
+    using(config: Answerable<WithAnswerableProperties<AxiosRequestConfig>>): HeadRequest {
+        return new HeadRequest(this.resourceUri, undefined, Question.fromObject(config));
     }
 }

package/src/model/OptionsRequest.ts

@@ -1,4 +1,4 @@
-import { Answerable, Dictionary, DynamicRecord } from '@serenity-js/core';
+import { Answerable, Question, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 
 import { HTTPRequest } from './HTTPRequest';
@@ -13,13 +13,13 @@ import { HTTPRequest } from './HTTPRequest';
  *  resource action.
  *
  * @example <caption>File download test</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, OptionsRequest, LastResponse, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, OptionsRequest, LastResponse, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(OptionsRequest.to('/downloads/my-test-document.pdf')),
  *      Ensure.that(LastResponse.status(), equals(200)),
  *      Ensure.that(LastResponse.header('Allow'), equals('OPTIONS, GET, HEAD')),
@@ -55,12 +55,12 @@ export class OptionsRequest extends HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {OptionsRequest}
      */
-    using(config: Answerable<DynamicRecord<AxiosRequestConfig>>): OptionsRequest {
-        return new OptionsRequest(this.resourceUri, undefined, Dictionary.of(config));
+    using(config: Answerable<WithAnswerableProperties<AxiosRequestConfig>>): OptionsRequest {
+        return new OptionsRequest(this.resourceUri, undefined, Question.fromObject(config));
     }
 }

package/src/model/PatchRequest.ts

@@ -1,4 +1,4 @@
-import { Answerable, Dictionary, DynamicRecord } from '@serenity-js/core';
+import { Answerable, Question, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 
 import { HTTPRequest } from './HTTPRequest';
@@ -10,12 +10,12 @@ import { HTTPRequest } from './HTTPRequest';
  *
  * @example <caption>Add new resource to a collection</caption>
  *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, LastResponse, PatchRequest, Send } from '@serenity-js/rest'
+ *  import { CallAnApi, LastResponse, PatchRequest, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(PatchRequest.to('/books/0-688-00230-7').with({
  *          lastReadOn: '2016-06-16',
  *      })),
@@ -65,12 +65,12 @@ export class PatchRequest extends HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {PatchRequest}
      */
-    using(config: Answerable<DynamicRecord<AxiosRequestConfig>>): PatchRequest {
-        return new PatchRequest(this.resourceUri, this.data, Dictionary.of(config));
+    using(config: Answerable<WithAnswerableProperties<AxiosRequestConfig>>): PatchRequest {
+        return new PatchRequest(this.resourceUri, this.data, Question.fromObject(config));
     }
 }

package/src/model/PostRequest.ts

@@ -1,4 +1,4 @@
-import { Answerable, Dictionary, DynamicRecord } from '@serenity-js/core';
+import { Answerable, Question, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 
 import { HTTPRequest } from './HTTPRequest';
@@ -18,13 +18,13 @@ import { HTTPRequest } from './HTTPRequest';
  *  a correctly implemented HTTP REST API will create N resources with N different URIs.
  *
  * @example <caption>Add new resource to a collection</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, LastResponse, PostRequest, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, LastResponse, PostRequest, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(PostRequest.to('/books').with({
  *          isbn: '0-688-00230-7',
  *          title: 'Zen and the Art of Motorcycle Maintenance: An Inquiry into Values',
@@ -34,21 +34,21 @@ import { HTTPRequest } from './HTTPRequest';
  *      Ensure.that(LastResponse.header('Location'), equals('/books/0-688-00230-7')),
  *  );
  *
- * @example <caption>Submit a HTML form</caption>
- *  import { Actor } from '@serenity-js/core';
+ * @example <caption>Submit an HTML form</caption>
+ *  import { actorCalled } from '@serenity-js/core';
  *  import { CallAnApi, LastResponse, PostRequest, Send } from '@serenity-js/rest'
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *  import { stringify } from 'querystring';
  *
- *  const
- *      actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com')),
- *      formData = stringify({
- *          name: actor.name,
- *          email: `${ actor.name }@example.com`,
- *          text: 'Your website is great! Learnt a lot :-)'
- *      });
+ *  const formData = stringify({
+ *      name: actor.name,
+ *      email: `${ actor.name }@example.com`,
+ *      text: 'Your website is great! Learnt a lot :-)'
+ *  });
  *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(PostRequest.to('/feedback').with(postData).using({
  *          headers: {
  *              'Content-Type': 'application/x-www-form-urlencoded',
@@ -102,12 +102,12 @@ export class PostRequest extends HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {Answerable<DynamicRecord<AxiosRequestConfig>>} config
+     * @param {Answerable<WithAnswerableProperties<AxiosRequestConfig>>} config
      *  Axios request configuration overrides
      *
      * @returns {PostRequest}
      */
-    using(config: Answerable<DynamicRecord<AxiosRequestConfig>>): PostRequest {
-        return new PostRequest(this.resourceUri, this.data, Dictionary.of(config));
+    using(config: Answerable<WithAnswerableProperties<AxiosRequestConfig>>): PostRequest {
+        return new PostRequest(this.resourceUri, this.data, Question.fromObject(config));
     }
 }

package/src/model/PutRequest.ts

@@ -1,4 +1,4 @@
-import { Answerable, Dictionary, DynamicRecord } from '@serenity-js/core';
+import { Answerable, Question, WithAnswerableProperties } from '@serenity-js/core';
 import { AxiosRequestConfig } from 'axios';
 
 import { HTTPRequest } from './HTTPRequest';
@@ -17,13 +17,13 @@ import { HTTPRequest } from './HTTPRequest';
  *  calling it once or several times successively has the same effect (that is no _side effect_).
  *
  * @example <caption>Create a new resource at a known location</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { CallAnApi, LastResponse, PutRequest, Send } from '@serenity-js/rest'
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { CallAnApi, LastResponse, PutRequest, Send } from '@serenity-js/rest';
  *  import { Ensure, equals } from '@serenity-js/assertions';
  *
- *  const actor = Actor.named('Apisit').whoCan(CallAnApi.at('https://myapp.com/api'));
- *
- *  actor.attemptsTo(
+ *  await actorCalled('Apisit')
+ *    .whoCan(CallAnApi.at('https://myapp.com/api'))
+ *    .attemptsTo(
  *      Send.a(PutRequest.to('/books/0-688-00230-7').with({
  *          isbn: '0-688-00230-7',
  *          title: 'Zen and the Art of Motorcycle Maintenance: An Inquiry into Values',
@@ -75,12 +75,12 @@ export class PutRequest extends HTTPRequest {
      *  Overrides the default Axios request configuration provided
      *  when {@link CallAnApi} {@link @serenity-js/core/lib/screenplay~Ability} was instantiated.
      *
-     * @param {@serenity-js/core/lib/screenplay/questions~DynamicRecord<AxiosRequestConfig>} config
+     * @param {WithAnswerableProperties<AxiosRequestConfig>} config
      *  Axios request configuration overrides
      *
      * @returns {PutRequest}
      */
-    using(config: Answerable<DynamicRecord<AxiosRequestConfig>>): PutRequest {
-        return new PutRequest(this.resourceUri, this.data, Dictionary.of(config));
+    using(config: Answerable<WithAnswerableProperties<AxiosRequestConfig>>): PutRequest {
+        return new PutRequest(this.resourceUri, this.data, Question.fromObject(config));
     }
 }

package/src/screenplay/abilities/CallAnApi.ts

@@ -1,5 +1,5 @@
 import { Ability, ConfigurationError, LogicError, TestCompromisedError, UsesAbilities } from '@serenity-js/core';
-import axios, { AxiosError, AxiosInstance, AxiosPromise, AxiosRequestConfig, AxiosResponse } from 'axios';
+import axios, { AxiosDefaults, AxiosError, AxiosInstance, AxiosPromise, AxiosRequestConfig, AxiosResponse } from 'axios';
 const mergeConfig = require('axios/lib/core/mergeConfig');      // eslint-disable-line @typescript-eslint/no-var-requires
 const buildFullPath = require('axios/lib/core/buildFullPath');  // eslint-disable-line @typescript-eslint/no-var-requires
 
@@ -126,7 +126,7 @@ export class CallAnApi implements Ability {
      *
      * @see {@link AxiosRequestConfig}
      */
-    modifyConfig(fn: (original: AxiosRequestConfig) => any): void {
+    modifyConfig(fn: (original: AxiosDefaults<any>) => any): void {
         fn(this.axiosInstance.defaults);
     }