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

package/lib/screenplay/actor/Actor.js

@@ -1,189 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Actor = void 0;
-const errors_1 = require("../../errors");
-const events_1 = require("../../events");
-const model_1 = require("../../model");
-const activities_1 = require("../activities");
-const Question_1 = require("../Question");
-class Actor {
-    // todo: Actor should have execution strategies
-    // todo: the default one executes every activity
-    // todo: there could be a dry-run mode that default to skip strategy
-    constructor(name, stage, abilities = new Map()) {
-        this.name = name;
-        this.stage = stage;
-        this.abilities = abilities;
-    }
-    /**
-     * @desc
-     *  Retrieves actor's {@link Ability} to `doSomething`.
-     *
-     *  Please note that this method performs an [`instancepf`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/instanceof)
-     *  check against abilities given to this actor via {@link Actor#whoCan}. Please also note that {@link Actor#whoCan} performs
-     *  the same check when abilities are assigned to the actor to ensure the actor has at most one instance of a given ability type.
-     *
-     * @param doSomething
-     */
-    abilityTo(doSomething) {
-        const found = this.findAbilityTo(doSomething);
-        if (!found) {
-            throw new errors_1.ConfigurationError(`${this.name} can't ${doSomething.name} yet. ` +
-                `Did you give them the ability to do so?`);
-        }
-        return found;
-    }
-    /**
-     * @desc
-     *  Instructs the actor to attempt to perform a number of activities
-     *  (see {@link Activity}, so either {@link Task}s or {@link Interaction}s)
-     *  one by one.
-     *
-     * @param {...activities: Activity[]} activities
-     * @return {Promise<void>}
-     */
-    attemptsTo(...activities) {
-        return activities
-            .map(activity => new activities_1.TrackedActivity(activity, this.stage))
-            .reduce((previous, current) => {
-            return previous
-                // synchronise async operations like taking screenshots
-                .then(() => this.stage.waitForNextCue())
-                .then(() => {
-                /* todo: add an execution strategy */
-                return current.performAs(this);
-            });
-        }, this.initialiseAbilities());
-    }
-    /**
-     * @desc
-     *  Gives this Actor a list of abilities (see {@link Ability}) they can use
-     *  to interact with the system under test or the test environment.
-     *
-     * @param {...Ability[]} abilities
-     *  A vararg list of abilities to give the actor
-     *
-     * @returns {Actor}
-     *  The actor with newly gained abilities
-     *
-     * @throws {ConfigurationError}
-     *  Throws a ConfigurationError if the actor already has an ability of this type.
-     */
-    whoCan(...abilities) {
-        abilities.forEach(ability => {
-            const abilityType = ability.constructor;
-            const found = this.findAbilityTo(abilityType);
-            if (found) {
-                const description = found.constructor.name === abilityType.name
-                    ? found.constructor.name
-                    : `${found.constructor.name} (which extends ${abilityType.name})`;
-                throw new errors_1.ConfigurationError(`${this.name} already has an ability to ${description}, so you don't need to give it to them again.`);
-            }
-            this.abilities.set(ability.constructor, ability);
-        });
-        return this;
-    }
-    /**
-     * @param {Answerable<T>} answerable - a Question<Promise<T>>, Question<T>, Promise<T> or T
-     * @returns {Promise<T>} The answer to the Answerable
-     */
-    answer(answerable) {
-        function isAPromise(v) {
-            return Object.prototype.hasOwnProperty.call(v, 'then');
-        }
-        function isDefined(v) {
-            return !(v === undefined || v === null);
-        }
-        if (isDefined(answerable) && isAPromise(answerable)) {
-            return answerable;
-        }
-        if (isDefined(answerable) && Question_1.Question.isAQuestion(answerable)) {
-            return this.answer(answerable.answeredBy(this));
-        }
-        return Promise.resolve(answerable);
-    }
-    /**
-     * @desc
-     *  Announce collection of an {@link Artifact} so that it can be picked up by a {@link StageCrewMember}.
-     *
-     * @param {Artifact} artifact
-     * @param {?(string | Name)} name
-     *
-     * @returns {void}
-     */
-    collect(artifact, name) {
-        this.stage.announce(new events_1.ActivityRelatedArtifactGenerated(this.stage.currentSceneId(), this.stage.currentActivityId(), this.nameFrom(name || new model_1.Name(artifact.constructor.name)), artifact, this.stage.currentTime()));
-    }
-    /**
-     * @desc
-     *  Instructs the actor to invoke {@link Discardable#discard} method on any
-     *  {@link Discardable} {@link Ability} it's been configured with.
-     *
-     * @returns {Promise<void>}
-     */
-    dismiss() {
-        return this.findAbilitiesOfType('discard')
-            .reduce((previous, ability) => previous.then(() => ability.discard()), Promise.resolve(void 0));
-    }
-    /**
-     * @desc
-     *  Returns a human-readable, string representation of this Actor
-     *
-     * @returns {string}
-     */
-    toString() {
-        const abilities = Array.from(this.abilities.keys()).map(type => type.name);
-        return `Actor(name=${this.name}, abilities=[${abilities.join(', ')}])`;
-    }
-    /**
-     * @private
-     */
-    initialiseAbilities() {
-        return this.findAbilitiesOfType('initialise', 'isInitialised')
-            .filter(ability => !ability.isInitialised())
-            .reduce((previous, ability) => previous
-            .then(() => ability.initialise())
-            .catch(error => {
-            throw new errors_1.TestCompromisedError(`${this.name} couldn't initialise the ability to ${ability.constructor.name}`, error);
-        }), Promise.resolve(void 0));
-    }
-    /**
-     * @param {...string[]} methodNames
-     * @private
-     */
-    findAbilitiesOfType(...methodNames) {
-        const abilitiesFrom = (map) => Array.from(map.values());
-        const abilitiesWithDesiredMethods = (ability) => methodNames.every(methodName => typeof (ability[methodName]) === 'function');
-        return abilitiesFrom(this.abilities)
-            .filter(abilitiesWithDesiredMethods);
-    }
-    /**
-     * @param {string} doSomething
-     * @private
-     */
-    findAbilityTo(doSomething) {
-        for (const [abilityType_, ability] of this.abilities) {
-            if (ability instanceof doSomething) {
-                return ability;
-            }
-        }
-        return undefined;
-    }
-    /**
-     * @desc
-     *  Instantiates a {@link Name} based on the string value of the parameter,
-     *  or returns the argument if it's already an instance of {@link Name}.
-     *
-     * @param {string | Name} maybeName
-     * @returns {Name}
-     *
-     * @private
-     */
-    nameFrom(maybeName) {
-        return typeof maybeName === 'string'
-            ? new model_1.Name(maybeName)
-            : maybeName;
-    }
-}
-exports.Actor = Actor;
-//# sourceMappingURL=Actor.js.map

package/lib/screenplay/actor/Actor.js.map

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

package/lib/screenplay/actor/AnswersQuestions.d.ts

@@ -1,10 +0,0 @@
-import { Answerable } from '../Answerable';
-/**
- * @desc
- *  Enables the {@link Actor} to answer a {@link Question} about the system under test
- *
- * @public
- */
-export interface AnswersQuestions {
-    answer<T>(knownUnknown: Answerable<T>): Promise<T>;
-}

package/lib/screenplay/actor/AnswersQuestions.js.map

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

package/lib/screenplay/actor/CanHaveAbilities.d.ts

@@ -1,15 +0,0 @@
-import { Ability } from '../Ability';
-import { UsesAbilities } from './UsesAbilities';
-/**
- * @desc
- *  Enables the {@link Actor} to have an {@link Ability} or Abilities to perform some {@link Activity}.
- *
- * @public
- */
-export interface CanHaveAbilities<Returned_Type = UsesAbilities> {
-    /**
-     * @param {Ability[]} abilities
-     * @returns {Actor}
-     */
-    whoCan(...abilities: Ability[]): Returned_Type;
-}

package/lib/screenplay/actor/CanHaveAbilities.js.map

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

package/lib/screenplay/actor/CollectsArtifacts.d.ts

@@ -1,17 +0,0 @@
-import { Artifact, Name } from '../../model';
-/**
- * @desc
- *  Enables the {@link Actor} to collect {@link Artifact}s while the scenario is being executed
- *
- * @public
- */
-export interface CollectsArtifacts {
-    /**
-     * @desc
-     * Makes the {@link Actor} collect an {@link Artifact} so that it's included in the test report.
-     *
-     * @param {Artifact} artifact - The artifact to be collected, such as {@link JSONData}
-     * @param {Name} [name] - The name of the artifact to make it easy to recognise in the test report
-     */
-    collect(artifact: Artifact, name?: Name): void;
-}

package/lib/screenplay/actor/CollectsArtifacts.js.map

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

package/lib/screenplay/actor/PerformsActivities.d.ts

@@ -1,10 +0,0 @@
-import { Activity } from '../Activity';
-/**
- * @desc
- *  Enables the {@link Actor} to perform an {@link Activity}, such as a {@link Task} or an {@link Interaction}
- *
- * @public
- */
-export interface PerformsActivities {
-    attemptsTo(...tasks: Activity[]): Promise<void>;
-}

package/lib/screenplay/actor/PerformsActivities.js.map

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

package/lib/screenplay/actor/UsesAbilities.d.ts

@@ -1,18 +0,0 @@
-import { Ability } from '../Ability';
-import { AbilityType } from '../AbilityType';
-/**
- * @desc
- *  Enables the {@link Actor} to use an {@link Ability} to perform some {@link Activity}.
- *
- * @public
- */
-export interface UsesAbilities {
-    /**
-     * @desc
-     *  Grants access to the Actor's ability
-     *
-     * @param {AbilityType<T extends Ability>} doSomething
-     * @returns {T}
-     */
-    abilityTo<T extends Ability>(doSomething: AbilityType<T>): T;
-}

package/lib/screenplay/actor/UsesAbilities.js.map

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

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

@@ -1,6 +0,0 @@
-export * from './Actor';
-export * from './AnswersQuestions';
-export * from './CanHaveAbilities';
-export * from './CollectsArtifacts';
-export * from './PerformsActivities';
-export * from './UsesAbilities';

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/actor/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0CAAwB;AACxB,qDAAmC;AACnC,qDAAmC;AACnC,sDAAoC;AACpC,uDAAqC;AACrC,kDAAgC"}

package/lib/screenplay/interactions/Log.d.ts

@@ -1,57 +0,0 @@
-import { AnswersQuestions, CollectsArtifacts, UsesAbilities } from '../actor';
-import { Answerable } from '../Answerable';
-import { Interaction } from '../Interaction';
-/**
- * @desc
- *  Enables the {@link Actor} to log arbitrary static values and answers to {@link Question}s,
- *  so that they can be printed to the terminal by the [`ConsoleReporter`](/modules/console-reporter/)
- *  and attached to the HTML report by the [`SerenityBDDReporter`](/modules/serenity-bdd/).
- *
- * @example
- *  import { Log } from '@serenity-js/core';
- *  import { Website } from '@serenity-js/protractor';
- *
- *  actor.attemptsTo(
- *      Log.the('Current page', Website.title(), Website.url()),
- *  );
- *
- * @extends {Interaction}
- */
-export declare class Log extends Interaction {
-    private readonly items;
-    /**
-     * @desc
-     *  Instantiates a new {@link Log} {@link Interaction}.
-     *
-     * @param {...items: any[]} items
-     *  The items to be logged
-     * @returns {Interaction}
-     */
-    static the(...items: Array<Answerable<any>>): Interaction;
-    /**
-     * @param {...items: any[]} items
-     *  The items to be logged
-     */
-    constructor(items: Array<Answerable<any>>);
-    /**
-     * @desc
-     *  Makes the provided {@link Actor}
-     *  perform this {@link Interaction}.
-     *
-     * @param {UsesAbilities & AnswersQuestions & CollectsArtifacts} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link Actor}
-     * @see {@link UsesAbilities}
-     * @see {@link AnswersQuestions}
-     * @see {@link CollectsArtifacts}
-     */
-    performAs(actor: UsesAbilities & AnswersQuestions & CollectsArtifacts): Promise<void>;
-    /**
-     * @desc
-     *  Generates a description to be used when reporting this {@link Activity}.
-     *
-     * @returns {string}
-     */
-    toString(): string;
-}

package/lib/screenplay/interactions/Log.js

@@ -1,74 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Log = void 0;
-const io_1 = require("../../io");
-const inspected_1 = require("../../io/inspected");
-const model_1 = require("../../model");
-const artifacts_1 = require("../../model/artifacts");
-const Interaction_1 = require("../Interaction");
-/**
- * @desc
- *  Enables the {@link Actor} to log arbitrary static values and answers to {@link Question}s,
- *  so that they can be printed to the terminal by the [`ConsoleReporter`](/modules/console-reporter/)
- *  and attached to the HTML report by the [`SerenityBDDReporter`](/modules/serenity-bdd/).
- *
- * @example
- *  import { Log } from '@serenity-js/core';
- *  import { Website } from '@serenity-js/protractor';
- *
- *  actor.attemptsTo(
- *      Log.the('Current page', Website.title(), Website.url()),
- *  );
- *
- * @extends {Interaction}
- */
-class Log extends Interaction_1.Interaction {
-    /**
-     * @param {...items: any[]} items
-     *  The items to be logged
-     */
-    constructor(items) {
-        super();
-        this.items = items;
-    }
-    /**
-     * @desc
-     *  Instantiates a new {@link Log} {@link Interaction}.
-     *
-     * @param {...items: any[]} items
-     *  The items to be logged
-     * @returns {Interaction}
-     */
-    static the(...items) {
-        return new Log(items);
-    }
-    /**
-     * @desc
-     *  Makes the provided {@link Actor}
-     *  perform this {@link Interaction}.
-     *
-     * @param {UsesAbilities & AnswersQuestions & CollectsArtifacts} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link Actor}
-     * @see {@link UsesAbilities}
-     * @see {@link AnswersQuestions}
-     * @see {@link CollectsArtifacts}
-     */
-    performAs(actor) {
-        return Promise
-            .all(this.items.map(item => actor.answer(item)))
-            .then(items => items.forEach((item, i) => actor.collect(artifacts_1.LogEntry.fromJSON({ data: (0, inspected_1.inspected)(item) }), new model_1.Name((0, inspected_1.inspected)(this.items[i])))));
-    }
-    /**
-     * @desc
-     *  Generates a description to be used when reporting this {@link Activity}.
-     *
-     * @returns {string}
-     */
-    toString() {
-        return `#actor logs: ${this.items.map(item => (0, io_1.formatted) `${item}`).join(', ')}`;
-    }
-}
-exports.Log = Log;
-//# sourceMappingURL=Log.js.map

package/lib/screenplay/interactions/Log.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Log.js","sourceRoot":"","sources":["../../../src/screenplay/interactions/Log.ts"],"names":[],"mappings":";;;AAAA,iCAAqC;AACrC,kDAA+C;AAC/C,uCAAmC;AACnC,qDAAiD;AAGjD,gDAA6C;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,MAAa,GAAI,SAAQ,yBAAW;IAchC;;;OAGG;IACH,YACqB,KAA6B;QAE9C,KAAK,EAAE,CAAC;QAFS,UAAK,GAAL,KAAK,CAAwB;IAGlD,CAAC;IApBD;;;;;;;OAOG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,KAA6B;QACvC,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAYD;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,KAA2D;QACjE,OAAO,OAAO;aACT,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;aAC/C,IAAI,CAAC,KAAK,CAAC,EAAE,CACV,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CACtB,KAAK,CAAC,OAAO,CAAC,oBAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAA,qBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,YAAI,CAAC,IAAA,qBAAS,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAClG,CACJ,CAAC;IACV,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACJ,OAAO,gBAAiB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAA,cAAS,EAAA,GAAI,IAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAE,EAAE,CAAC;IACvF,CAAC;CACJ;AAxDD,kBAwDC"}

package/lib/screenplay/interactions/TakeNote.d.ts

@@ -1,87 +0,0 @@
-import { AnswersQuestions, UsesAbilities } from '../actor';
-import { Interaction } from '../Interaction';
-import { Question } from '../Question';
-/**
- * @desc
- *  Enables the {@link Actor} to remember an answer to a given {@link Question},
- *  and recall it later.
- *
- * @example <caption>Using default subject name based on the name of the question</caption>
- *  import { actorCalled, Note, TakeNote, TakeNotes } from '@serenity-js/core'
- *  import { BrowseTheWeb, Target, Text } from '@serenity-js/protractor'
- *  import { by, protractor } from 'protractor';
- *
- *  class Vouchers {
- *      static code             = Target.the('voucher code').located(by.id('voucher'));
- *      static appliedVoucher   = Target.the('voucher code').located(by.id('applied-voucher'));
- *  }
- *
- *  const actor = actorCalled('Noah').whoCan(
- *      TakeNotes.usingAnEmptyNotepad(),
- *      BrowseTheWeb.using(protractor.browser),
- *  );
- *
- *  actor.attemptsTo(
- *      TakeNote.of(Text.of(Vouchers.code)),
- *      // ... add the product to a basket, go to checkout, etc.
- *      Ensure.that(Text.of(Vouchers.appliedVoucher), equals(Note.of(Text.of(Vouchers.code)))),
- *  );
- *
- * @example <caption>Using custom subject name</caption>
- *  actor.attemptsTo(
- *      TakeNote.of(Text.of(Vouchers.code)).as('voucher code'),
- *      // ... add the product to a basket, go to checkout, etc.
- *      Ensure.that(Text.of(Vouchers.appliedVoucher), equals(Note.of('voucher code'))),
- *  );
- *
- * @see {@link Note}
- * @see {@link TakeNotes}
- *
- * @extends {Interaction}
- */
-export declare class TakeNote<Answer> extends Interaction {
-    private readonly question;
-    private readonly subject;
-    /**
-     * @desc
-     *  Instructs the {@link Actor} to remember the answer to a given question
-     *
-     * @param {Question<Promise<A>> | Question<A>} question
-     *
-     * @returns {TakeNote<A>}
-     */
-    static of<A>(question: Question<Promise<A>> | Question<A>): TakeNote<A>;
-    /**
-     * @param {Question<Promise<Answer>> | Question<Answer>} question
-     * @param {string} subject
-     */
-    constructor(question: Question<Promise<Answer>> | Question<Answer>, subject?: string);
-    /**
-     * @desc
-     *  Sets a custom subject name to remember the answer as.
-     *
-     * @param {string} subject
-     * @returns {TakeNote<Answer>}
-     */
-    as(subject: string): TakeNote<Answer>;
-    /**
-     * @desc
-     *  Makes the provided {@link Actor}
-     *  perform this {@link Interaction}.
-     *
-     * @param {UsesAbilities & AnswersQuestions} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link Actor}
-     * @see {@link UsesAbilities}
-     * @see {@link AnswersQuestions}
-     */
-    performAs(actor: UsesAbilities & AnswersQuestions): PromiseLike<void>;
-    /**
-     * @desc
-     *  Generates a description to be used when reporting this {@link Activity}.
-     *
-     * @returns {string}
-     */
-    toString(): string;
-}

package/lib/screenplay/interactions/TakeNote.js

@@ -1,103 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TakeNote = void 0;
-const io_1 = require("../../io");
-const abilities_1 = require("../abilities");
-const Interaction_1 = require("../Interaction");
-/**
- * @desc
- *  Enables the {@link Actor} to remember an answer to a given {@link Question},
- *  and recall it later.
- *
- * @example <caption>Using default subject name based on the name of the question</caption>
- *  import { actorCalled, Note, TakeNote, TakeNotes } from '@serenity-js/core'
- *  import { BrowseTheWeb, Target, Text } from '@serenity-js/protractor'
- *  import { by, protractor } from 'protractor';
- *
- *  class Vouchers {
- *      static code             = Target.the('voucher code').located(by.id('voucher'));
- *      static appliedVoucher   = Target.the('voucher code').located(by.id('applied-voucher'));
- *  }
- *
- *  const actor = actorCalled('Noah').whoCan(
- *      TakeNotes.usingAnEmptyNotepad(),
- *      BrowseTheWeb.using(protractor.browser),
- *  );
- *
- *  actor.attemptsTo(
- *      TakeNote.of(Text.of(Vouchers.code)),
- *      // ... add the product to a basket, go to checkout, etc.
- *      Ensure.that(Text.of(Vouchers.appliedVoucher), equals(Note.of(Text.of(Vouchers.code)))),
- *  );
- *
- * @example <caption>Using custom subject name</caption>
- *  actor.attemptsTo(
- *      TakeNote.of(Text.of(Vouchers.code)).as('voucher code'),
- *      // ... add the product to a basket, go to checkout, etc.
- *      Ensure.that(Text.of(Vouchers.appliedVoucher), equals(Note.of('voucher code'))),
- *  );
- *
- * @see {@link Note}
- * @see {@link TakeNotes}
- *
- * @extends {Interaction}
- */
-class TakeNote extends Interaction_1.Interaction {
-    /**
-     * @param {Question<Promise<Answer>> | Question<Answer>} question
-     * @param {string} subject
-     */
-    constructor(question, subject = question.toString()) {
-        super();
-        this.question = question;
-        this.subject = subject;
-    }
-    /**
-     * @desc
-     *  Instructs the {@link Actor} to remember the answer to a given question
-     *
-     * @param {Question<Promise<A>> | Question<A>} question
-     *
-     * @returns {TakeNote<A>}
-     */
-    static of(question) {
-        return new TakeNote(question);
-    }
-    /**
-     * @desc
-     *  Sets a custom subject name to remember the answer as.
-     *
-     * @param {string} subject
-     * @returns {TakeNote<Answer>}
-     */
-    as(subject) {
-        return new TakeNote(this.question, subject);
-    }
-    /**
-     * @desc
-     *  Makes the provided {@link Actor}
-     *  perform this {@link Interaction}.
-     *
-     * @param {UsesAbilities & AnswersQuestions} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link Actor}
-     * @see {@link UsesAbilities}
-     * @see {@link AnswersQuestions}
-     */
-    performAs(actor) {
-        return actor.answer(this.question)
-            .then(answer => abilities_1.TakeNotes.as(actor).record(this.subject, answer));
-    }
-    /**
-     * @desc
-     *  Generates a description to be used when reporting this {@link Activity}.
-     *
-     * @returns {string}
-     */
-    toString() {
-        return (0, io_1.formatted) `#actor takes note of ${this.subject}`;
-    }
-}
-exports.TakeNote = TakeNote;
-//# sourceMappingURL=TakeNote.js.map

package/lib/screenplay/interactions/TakeNote.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TakeNote.js","sourceRoot":"","sources":["../../../src/screenplay/interactions/TakeNote.ts"],"names":[],"mappings":";;;AAAA,iCAAqC;AACrC,4CAAyC;AAEzC,gDAA6C;AAG7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAa,QAAiB,SAAQ,yBAAW;IAc7C;;;OAGG;IACH,YACqB,QAAsD,EACtD,UAAkB,QAAQ,CAAC,QAAQ,EAAE;QAEtD,KAAK,EAAE,CAAC;QAHS,aAAQ,GAAR,QAAQ,CAA8C;QACtD,YAAO,GAAP,OAAO,CAA8B;IAG1D,CAAC;IArBD;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,CAAI,QAA4C;QACrD,OAAO,IAAI,QAAQ,CAAI,QAAQ,CAAC,CAAC;IACrC,CAAC;IAaD;;;;;;OAMG;IACH,EAAE,CAAC,OAAe;QACd,OAAO,IAAI,QAAQ,CAAS,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,KAAuC;QAC7C,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;aAC7B,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,qBAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACJ,OAAO,IAAA,cAAS,EAAC,wBAAyB,IAAI,CAAC,OAAQ,EAAE,CAAC;IAC9D,CAAC;CACJ;AA9DD,4BA8DC"}

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

@@ -1,2 +0,0 @@
-export * from './Log';
-export * from './TakeNote';

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/interactions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,wCAAsB;AACtB,6CAA2B"}