@serenity-js/core 3.41.2 → 3.42.1

package/esm/model/tags/Tags.js

@@ -0,0 +1,67 @@
+import { ensure, isDefined, isString, match } from 'tiny-types';
+import { ArbitraryTag } from './ArbitraryTag.js';
+import { BrowserTag } from './BrowserTag.js';
+import { CapabilityTag } from './CapabilityTag.js';
+import { ExecutionRetriedTag } from './ExecutionRetriedTag.js';
+import { FeatureTag } from './FeatureTag.js';
+import { IssueTag } from './IssueTag.js';
+import { ManualTag } from './ManualTag.js';
+import { PlatformTag } from './PlatformTag.js';
+import { ProjectTag } from './ProjectTag.js';
+import { ThemeTag } from './ThemeTag.js';
+function hasCustomDeserialiser(tagType) {
+    return Object.prototype.hasOwnProperty.call(tagType, 'fromJSON');
+}
+/**
+ * @package
+ */
+export class Tags {
+    static supportedTypes = new Map([
+        ArbitraryTag,
+        BrowserTag,
+        CapabilityTag,
+        ExecutionRetriedTag,
+        FeatureTag,
+        IssueTag,
+        ManualTag,
+        PlatformTag,
+        ProjectTag,
+        ThemeTag,
+    ].map(tagType => [tagType.Type, tagType]));
+    static Pattern = /^@([\w-]+)[\s:]?(.*)/i;
+    static matchTags(tagText) {
+        if (tagText === '') {
+            return [];
+        }
+        const [, tagType, value] = Tags.Pattern.exec(tagText);
+        return match(tagType.toLowerCase())
+            .when('manual', _ => [new ManualTag()])
+            .when(/^issues?$/, _ => value.split(',').map(value => new IssueTag(value.trim())))
+            .else(value => [new ArbitraryTag(value.trim())]);
+    }
+    static fromJSON(o) {
+        const type = ensure('serialised tag type', o.type, isDefined(), isString());
+        if (!this.supportedTypes.has(type)) {
+            return new ArbitraryTag(o.name);
+        }
+        const found = this.supportedTypes.get(type);
+        if (hasCustomDeserialiser(found)) {
+            return found.fromJSON(o);
+        }
+        return new found(o.name);
+    }
+    static from(text) {
+        const tags = text.split(/\s+/)
+            .filter(word => word.startsWith('@'))
+            .flatMap(tag => Tags.matchTags(tag));
+        return tags ?? Tags.matchTags(text);
+    }
+    static stripFrom(text) {
+        return text.split(/\s+/)
+            .map(word => Tags.Pattern.test(word) ? undefined : word)
+            .filter(Boolean)
+            .join(' ')
+            .trim();
+    }
+}
+//# sourceMappingURL=Tags.js.map

package/esm/model/tags/Tags.js.map

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

package/esm/model/tags/ThemeTag.d.ts

@@ -0,0 +1,9 @@
+import { Tag } from './Tag.js';
+/**
+ * @access public
+ */
+export declare class ThemeTag extends Tag {
+    static readonly Type = "theme";
+    constructor(theme: string);
+}
+//# sourceMappingURL=ThemeTag.d.ts.map

package/esm/model/tags/ThemeTag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeTag.d.ts","sourceRoot":"","sources":["../../../src/model/tags/ThemeTag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B;;GAEG;AACH,qBAAa,QAAS,SAAQ,GAAG;IAC7B,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW;gBAEnB,KAAK,EAAE,MAAM;CAG5B"}

package/esm/model/tags/ThemeTag.js

@@ -0,0 +1,11 @@
+import { Tag } from './Tag.js';
+/**
+ * @access public
+ */
+export class ThemeTag extends Tag {
+    static Type = 'theme';
+    constructor(theme) {
+        super(theme, ThemeTag.Type);
+    }
+}
+//# sourceMappingURL=ThemeTag.js.map

package/esm/model/tags/ThemeTag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeTag.js","sourceRoot":"","sources":["../../../src/model/tags/ThemeTag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,GAAG;IAC7B,MAAM,CAAU,IAAI,GAAG,OAAO,CAAC;IAE/B,YAAY,KAAa;QACrB,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC"}

package/esm/model/tags/index.d.ts

@@ -0,0 +1,13 @@
+export * from './ArbitraryTag.js';
+export * from './BrowserTag.js';
+export * from './CapabilityTag.js';
+export * from './ExecutionRetriedTag.js';
+export * from './FeatureTag.js';
+export * from './IssueTag.js';
+export * from './ManualTag.js';
+export * from './PlatformTag.js';
+export * from './ProjectTag.js';
+export * from './Tag.js';
+export * from './Tags.js';
+export * from './ThemeTag.js';
+//# sourceMappingURL=index.d.ts.map

package/esm/model/tags/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/model/tags/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/esm/model/tags/index.js

@@ -0,0 +1,13 @@
+export * from './ArbitraryTag.js';
+export * from './BrowserTag.js';
+export * from './CapabilityTag.js';
+export * from './ExecutionRetriedTag.js';
+export * from './FeatureTag.js';
+export * from './IssueTag.js';
+export * from './ManualTag.js';
+export * from './PlatformTag.js';
+export * from './ProjectTag.js';
+export * from './Tag.js';
+export * from './Tags.js';
+export * from './ThemeTag.js';
+//# sourceMappingURL=index.js.map

package/esm/model/tags/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/model/tags/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/esm/screenplay/Activity.d.ts

@@ -0,0 +1,40 @@
+import { FileSystemLocation } from '../io/index.js';
+import type { UsesAbilities } from './abilities/index.js';
+import type { PerformsActivities } from './activities/index.js';
+import type { Answerable } from './Answerable.js';
+import type { AnswersQuestions } from './questions/AnswersQuestions.js';
+import { Describable } from './questions/Describable.js';
+/**
+ * **Activities** represents [tasks](https://serenity-js.org/api/core/class/Task/) and [interactions](https://serenity-js.org/api/core/class/Interaction/) to be performed by an [actor](https://serenity-js.org/api/core/class/Actor/).
+ *
+ * Learn more about:
+ * - [Performing activities at multiple levels](https://serenity-js.org/handbook/design/screenplay-pattern#performing-activities-at-multiple-levels)
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+ * - [`PerformsActivities`](https://serenity-js.org/api/core/interface/PerformsActivities/)
+ * - [Command design pattern on Wikipedia](https://en.wikipedia.org/wiki/Command_pattern)
+ *
+ * @group Screenplay Pattern
+ */
+export declare abstract class Activity extends Describable {
+    #private;
+    private static errorStackParser;
+    constructor(description: Answerable<string>, location?: FileSystemLocation);
+    /**
+     * Returns the location where this [`Activity`](https://serenity-js.org/api/core/class/Activity/) was instantiated.
+     */
+    instantiationLocation(): FileSystemLocation;
+    /**
+     * Instructs the provided [`Actor`](https://serenity-js.org/api/core/class/Actor/) to perform this [`Activity`](https://serenity-js.org/api/core/class/Activity/).
+     *
+     * @param actor
+     *
+     * #### Learn more
+     * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+     * - [`PerformsActivities`](https://serenity-js.org/api/core/interface/PerformsActivities/)
+     * - [`UsesAbilities`](https://serenity-js.org/api/core/interface/UsesAbilities/)
+     * - [`AnswersQuestions`](https://serenity-js.org/api/core/interface/AnswersQuestions/)
+     */
+    abstract performAs(actor: PerformsActivities | UsesAbilities | AnswersQuestions): Promise<any>;
+    protected static callerLocation(frameOffset: number): FileSystemLocation;
+}
+//# sourceMappingURL=Activity.d.ts.map

package/esm/screenplay/Activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Activity.d.ts","sourceRoot":"","sources":["../../src/screenplay/Activity.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAQ,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,8BAAsB,QAAS,SAAQ,WAAW;;IAE9C,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAA0B;gBAIrD,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,EAC/B,QAAQ,GAAE,kBAA+C;IAM7D;;OAEG;IACH,qBAAqB,IAAI,kBAAkB;IAI3C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,GAAG,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IAE9F,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB;CA0B3E"}

package/esm/screenplay/Activity.js

@@ -0,0 +1,46 @@
+import path from 'node:path';
+import { ErrorStackParser } from '../errors/index.js';
+import { FileSystemLocation, Path } from '../io/index.js';
+import { Describable } from './questions/Describable.js';
+/**
+ * **Activities** represents [tasks](https://serenity-js.org/api/core/class/Task/) and [interactions](https://serenity-js.org/api/core/class/Interaction/) to be performed by an [actor](https://serenity-js.org/api/core/class/Actor/).
+ *
+ * Learn more about:
+ * - [Performing activities at multiple levels](https://serenity-js.org/handbook/design/screenplay-pattern#performing-activities-at-multiple-levels)
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+ * - [`PerformsActivities`](https://serenity-js.org/api/core/interface/PerformsActivities/)
+ * - [Command design pattern on Wikipedia](https://en.wikipedia.org/wiki/Command_pattern)
+ *
+ * @group Screenplay Pattern
+ */
+export class Activity extends Describable {
+    static errorStackParser = new ErrorStackParser();
+    #location;
+    constructor(description, location = Activity.callerLocation(5)) {
+        super(description);
+        this.#location = location;
+    }
+    /**
+     * Returns the location where this [`Activity`](https://serenity-js.org/api/core/class/Activity/) was instantiated.
+     */
+    instantiationLocation() {
+        return this.#location;
+    }
+    static callerLocation(frameOffset) {
+        const originalStackTraceLimit = Error.stackTraceLimit;
+        Error.stackTraceLimit = 30;
+        const error = new Error('Caller location marker');
+        Error.stackTraceLimit = originalStackTraceLimit;
+        const nonSerenityNodeModulePattern = new RegExp(`node_modules` + `\\` + path.sep + `(?!@serenity-js` + `\\` + path.sep + `)`);
+        const frames = this.errorStackParser.parse(error);
+        const userLandFrames = frames.filter(frame => !(frame?.fileName.startsWith('node:') || // node 16 and 18
+            frame?.fileName.startsWith('internal') || // node 14
+            nonSerenityNodeModulePattern.test(frame?.fileName) // ignore node_modules, except for @serenity-js/*
+        ));
+        const index = Math.min(Math.max(1, frameOffset), userLandFrames.length - 1);
+        // use the desired user-land frame, or the last one from the stack trace for internal invocations
+        const invocationFrame = userLandFrames[index] || frames.at(-1);
+        return new FileSystemLocation(Path.from(invocationFrame.fileName?.replace(/^file:/, '')), invocationFrame.lineNumber, invocationFrame.columnNumber);
+    }
+}
+//# sourceMappingURL=Activity.js.map

package/esm/screenplay/Activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Activity.js","sourceRoot":"","sources":["../../src/screenplay/Activity.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAK1D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,MAAM,OAAgB,QAAS,SAAQ,WAAW;IAEtC,MAAM,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAChD,SAAS,CAAqB;IAEvC,YACI,WAA+B,EAC/B,WAA+B,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;QAEzD,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,qBAAqB;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAeS,MAAM,CAAC,cAAc,CAAC,WAAmB;QAE/C,MAAM,uBAAuB,GAAG,KAAK,CAAC,eAAe,CAAC;QACtD,KAAK,CAAC,eAAe,GAAG,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAClD,KAAK,CAAC,eAAe,GAAG,uBAAuB,CAAC;QAEhD,MAAM,4BAA4B,GAAG,IAAI,MAAM,CAAC,cAAc,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,iBAAiB,GAAE,IAAI,GAAG,IAAI,CAAC,GAAG,GAAE,GAAG,CAAC,CAAC;QAE5H,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAE,CAC5C,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,IAAa,iBAAiB;YACjE,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,IAAU,UAAU;YAC1D,4BAA4B,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAI,iDAAiD;SAC1G,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC5E,iGAAiG;QACjG,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAE/D,OAAO,IAAI,kBAAkB,CACzB,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAC1D,eAAe,CAAC,UAAU,EAC1B,eAAe,CAAC,YAAY,CAC/B,CAAC;IACN,CAAC"}

package/esm/screenplay/Actor.d.ts

@@ -0,0 +1,162 @@
+import type { Artifact } from '../model/index.js';
+import { Name } from '../model/index.js';
+import type { Stage } from '../stage/index.js';
+import type { AbilityType, CanHaveAbilities, UsesAbilities } from './abilities/index.js';
+import { Ability } from './abilities/index.js';
+import type { PerformsActivities } from './activities/index.js';
+import type { Activity } from './Activity.js';
+import type { Answerable } from './Answerable.js';
+import type { CollectsArtifacts } from './artifacts/index.js';
+import type { AnswersQuestions } from './questions/index.js';
+import type { SerialisedActor } from './SerialisedActor.js';
+import type { TellsTime, Timestamp } from './time/index.js';
+/**
+ * **Actors** represent **people** and **external systems** interacting with the system under test.
+ * Their role is to perform [activities](https://serenity-js.org/api/core/class/Activity/) that demonstrate how to accomplish a given goal.
+ *
+ * Actors are the core building block of the [Screenplay Pattern](https://serenity-js.org/handbook/design/screenplay-pattern),
+ * along with [abilities](https://serenity-js.org/api/core/class/Ability/), [interactions](https://serenity-js.org/api/core/class/Interaction/), [tasks](https://serenity-js.org/api/core/class/Task/), and [questions](https://serenity-js.org/api/core/class/Question/).
+ * Actors are also the first thing you see in a typical Serenity/JS test scenario.
+ *
+ * ![Screenplay Pattern](https://serenity-js.org/images/design/serenity-js-screenplay-pattern.png)
+ *
+ * Learn more about:
+ * - [`Cast`](https://serenity-js.org/api/core/class/Cast/)
+ * - [`Stage`](https://serenity-js.org/api/core/class/Stage/)
+ * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
+ * - [`Activity`](https://serenity-js.org/api/core/class/Activity/)
+ * - [`Interaction`](https://serenity-js.org/api/core/class/Interaction/)
+ * - [`Task`](https://serenity-js.org/api/core/class/Task/)
+ * - [`Question`](https://serenity-js.org/api/core/class/Question/)
+ *
+ * ## Representing people and systems as actors
+ *
+ * To use a Serenity/JS [`Actor`](https://serenity-js.org/api/core/class/Actor/), all you need is to say their name:
+ *
+ * ```typescript
+ * import { actorCalled } from '@serenity-js/core'
+ *
+ * actorCalled('Alice')
+ * // returns: Actor
+ * ```
+ *
+ * Serenity/JS actors perform within the scope of a test scenario, so the first time you invoke [`actorCalled`](https://serenity-js.org/api/core/function/actorCalled/),
+ * Serenity/JS instantiates a new actor from the default [cast](https://serenity-js.org/api/core/class/Cast/) of actors (or any custom cast you might have [configured](https://serenity-js.org/api/core/function/configure/)).
+ * Any subsequent invocations of this function within the scope of the same test scenario retrieve the already instantiated actor, identified by their name.
+ *
+ * ```typescript
+ * import { actorCalled } from '@serenity-js/core'
+ *
+ * actorCalled('Alice')    // instantiates Alice
+ * actorCalled('Bob')      // instantiates Bob
+ * actorCalled('Alice')    // retrieves Alice, since she's already been instantiated
+ * ```
+ *
+ * Serenity/JS scenarios can involve as many or as few actors as you need to model the given business workflow.
+ * For example, you might want to use **multiple actors** in test scenarios that model how **different people** perform different parts of a larger business process, such as reviewing and approving a loan application.
+ * It is also quite common to introduce **supporting actors** to perform **administrative tasks**, like setting up test data and environment, or **audit tasks**, like checking the logs or messages emitted to a message queue
+ * by the system under test.
+ *
+ * :::info The Stan Lee naming convention
+ * Actor names can be much more than just simple identifiers like `Alice` or `Bob`. While you can give your actors any names you like, a good convention to follow is to give them
+ * names indicating the [personae](https://articles.uie.com/goodwin_interview/) they represent or the role they play in the system.
+ *
+ * Just like the characters in [Stan Lee](https://en.wikipedia.org/wiki/Stan_Lee) graphic novels,
+ * actors in Serenity/JS test scenarios are often given alliterate names as a mnemonic device.
+ * Names like "Adam the Admin", "Edna the Editor", "Trevor the Traveller", are far more memorable than a generic "UI user" or "API user".
+ * They're also much easier for people to associate with the context, constraints, and affordances of the given actor.
+ * :::
+ *
+ * @group Screenplay Pattern
+ */
+export declare class Actor implements PerformsActivities, UsesAbilities, CanHaveAbilities<Actor>, AnswersQuestions, CollectsArtifacts, TellsTime {
+    readonly name: string;
+    private readonly stage;
+    /**
+     * Map of abilities keyed by ability type name.
+     * Using string keys instead of constructor references to work across ESM/CJS module boundaries
+     * where the same class loaded from different module systems creates distinct constructor functions.
+     */
+    private readonly abilities;
+    constructor(name: string, stage: Stage, abilities?: Ability[]);
+    /**
+     * Retrieves actor's [`Ability`](https://serenity-js.org/api/core/class/Ability/) of `abilityType`, or one that extends `abilityType`.
+     *
+     * Please note that this method performs an [`instanceof`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/instanceof) check against abilities
+     * given to this actor via [`Actor.whoCan`](https://serenity-js.org/api/core/class/Actor/#whoCan).
+     *
+     * Please also note that [`Actor.whoCan`](https://serenity-js.org/api/core/class/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 abilityType
+     */
+    abilityTo<T extends Ability>(abilityType: AbilityType<T>): T;
+    /**
+     * Instructs the actor to attempt to perform a number of [activities](https://serenity-js.org/api/core/class/Activity/),
+     * so either [tasks](https://serenity-js.org/api/core/class/Task/) or [interactions](https://serenity-js.org/api/core/class/Interaction/)),
+     * one by one.
+     *
+     * @param {...activities: Activity[]} activities
+     */
+    attemptsTo(...activities: Activity[]): Promise<void>;
+    /**
+     * Gives this Actor a list of [abilities](https://serenity-js.org/api/core/class/Ability/) they can use
+     * to interact with the system under test or the test environment.
+     *
+     * @param abilities
+     *  A vararg list of abilities to give the actor
+     *
+     * @returns
+     *  The actor with newly gained abilities
+     *
+     * @throws [`ConfigurationError`](https://serenity-js.org/api/core/class/ConfigurationError/)
+     *  Throws a ConfigurationError if the actor already has an ability of this type.
+     */
+    whoCan(...abilities: Ability[]): Actor;
+    /**
+     * @param answerable -
+     *  An [`Answerable`](https://serenity-js.org/api/core/#Answerable) to answer (resolve the value of).
+     *
+     * @returns
+     *  The answer to the Answerable
+     */
+    answer<T>(answerable: Answerable<T>): Promise<T>;
+    /**
+     * @inheritDoc
+     */
+    collect(artifact: Artifact, name?: string | Name): void;
+    /**
+     * Returns current time.
+     */
+    currentTime(): Timestamp;
+    /**
+     * Instructs the actor to invoke [`Discardable.discard`](https://serenity-js.org/api/core/interface/Discardable/#discard) method on any
+     * [discardable](https://serenity-js.org/api/core/interface/Discardable/) [ability](https://serenity-js.org/api/core/class/Ability/) it's been configured with.
+     */
+    dismiss(): Promise<void>;
+    /**
+     * Returns a human-readable, string representation of this actor and their abilities.
+     *
+     * **PRO TIP:** To get the name of the actor, use [`Actor.name`](https://serenity-js.org/api/core/class/Actor/#name)
+     */
+    toString(): string;
+    /**
+     * Returns a JSON representation of the actor and its current state.
+     *
+     * The purpose of this method is to enable reporting the state of the actor in a human-readable format,
+     * rather than to serialise and deserialise the actor itself.
+     */
+    toJSON(): SerialisedActor;
+    private initialiseAbilities;
+    private findAbilitiesOfType;
+    private findAbilityTo;
+    private acquireAbility;
+    /**
+     * Instantiates a `Name` based on the string value of the parameter,
+     * or returns the argument if it's already an instance of `Name`.
+     *
+     * @param maybeName
+     */
+    private nameFrom;
+}
+//# sourceMappingURL=Actor.d.ts.map

package/esm/screenplay/Actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Actor.d.ts","sourceRoot":"","sources":["../../src/screenplay/Actor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAG,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAA8B,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrH,OAAO,EAAE,OAAO,EAAsC,MAAM,sBAAsB,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,qBAAa,KAAM,YAAW,kBAAkB,EAC5C,aAAa,EACb,gBAAgB,CAAC,KAAK,CAAC,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,SAAS;aAUW,IAAI,EAAE,MAAM;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAT1B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoD;gBAG1D,IAAI,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EAC7B,SAAS,GAAE,OAAO,EAAO;IAS7B;;;;;;;;;;OAUG;IACH,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC;IAc5D;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,UAAU,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,GAAG,KAAK;IAMtC;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhD;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAUvD;;OAEG;IACH,WAAW,IAAI,SAAS;IAIxB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IASxB;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAMlB;;;;;OAKG;IACH,MAAM,IAAI,eAAe;IAOzB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,cAAc;IAQtB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;CAKnB"}

package/esm/screenplay/Actor.js

@@ -0,0 +1,221 @@
+import { ConfigurationError, TestCompromisedError } from '../errors/index.js';
+import { ActivityRelatedArtifactGenerated } from '../events/index.js';
+import { ValueInspector } from '../io/index.js';
+import { Name, } from '../model/index.js';
+import { Ability, AnswerQuestions, PerformActivities } from './abilities/index.js';
+/**
+ * **Actors** represent **people** and **external systems** interacting with the system under test.
+ * Their role is to perform [activities](https://serenity-js.org/api/core/class/Activity/) that demonstrate how to accomplish a given goal.
+ *
+ * Actors are the core building block of the [Screenplay Pattern](https://serenity-js.org/handbook/design/screenplay-pattern),
+ * along with [abilities](https://serenity-js.org/api/core/class/Ability/), [interactions](https://serenity-js.org/api/core/class/Interaction/), [tasks](https://serenity-js.org/api/core/class/Task/), and [questions](https://serenity-js.org/api/core/class/Question/).
+ * Actors are also the first thing you see in a typical Serenity/JS test scenario.
+ *
+ * ![Screenplay Pattern](https://serenity-js.org/images/design/serenity-js-screenplay-pattern.png)
+ *
+ * Learn more about:
+ * - [`Cast`](https://serenity-js.org/api/core/class/Cast/)
+ * - [`Stage`](https://serenity-js.org/api/core/class/Stage/)
+ * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
+ * - [`Activity`](https://serenity-js.org/api/core/class/Activity/)
+ * - [`Interaction`](https://serenity-js.org/api/core/class/Interaction/)
+ * - [`Task`](https://serenity-js.org/api/core/class/Task/)
+ * - [`Question`](https://serenity-js.org/api/core/class/Question/)
+ *
+ * ## Representing people and systems as actors
+ *
+ * To use a Serenity/JS [`Actor`](https://serenity-js.org/api/core/class/Actor/), all you need is to say their name:
+ *
+ * ```typescript
+ * import { actorCalled } from '@serenity-js/core'
+ *
+ * actorCalled('Alice')
+ * // returns: Actor
+ * ```
+ *
+ * Serenity/JS actors perform within the scope of a test scenario, so the first time you invoke [`actorCalled`](https://serenity-js.org/api/core/function/actorCalled/),
+ * Serenity/JS instantiates a new actor from the default [cast](https://serenity-js.org/api/core/class/Cast/) of actors (or any custom cast you might have [configured](https://serenity-js.org/api/core/function/configure/)).
+ * Any subsequent invocations of this function within the scope of the same test scenario retrieve the already instantiated actor, identified by their name.
+ *
+ * ```typescript
+ * import { actorCalled } from '@serenity-js/core'
+ *
+ * actorCalled('Alice')    // instantiates Alice
+ * actorCalled('Bob')      // instantiates Bob
+ * actorCalled('Alice')    // retrieves Alice, since she's already been instantiated
+ * ```
+ *
+ * Serenity/JS scenarios can involve as many or as few actors as you need to model the given business workflow.
+ * For example, you might want to use **multiple actors** in test scenarios that model how **different people** perform different parts of a larger business process, such as reviewing and approving a loan application.
+ * It is also quite common to introduce **supporting actors** to perform **administrative tasks**, like setting up test data and environment, or **audit tasks**, like checking the logs or messages emitted to a message queue
+ * by the system under test.
+ *
+ * :::info The Stan Lee naming convention
+ * Actor names can be much more than just simple identifiers like `Alice` or `Bob`. While you can give your actors any names you like, a good convention to follow is to give them
+ * names indicating the [personae](https://articles.uie.com/goodwin_interview/) they represent or the role they play in the system.
+ *
+ * Just like the characters in [Stan Lee](https://en.wikipedia.org/wiki/Stan_Lee) graphic novels,
+ * actors in Serenity/JS test scenarios are often given alliterate names as a mnemonic device.
+ * Names like "Adam the Admin", "Edna the Editor", "Trevor the Traveller", are far more memorable than a generic "UI user" or "API user".
+ * They're also much easier for people to associate with the context, constraints, and affordances of the given actor.
+ * :::
+ *
+ * @group Screenplay Pattern
+ */
+export class Actor {
+    name;
+    stage;
+    /**
+     * Map of abilities keyed by ability type name.
+     * Using string keys instead of constructor references to work across ESM/CJS module boundaries
+     * where the same class loaded from different module systems creates distinct constructor functions.
+     */
+    abilities = new Map();
+    constructor(name, stage, abilities = []) {
+        this.name = name;
+        this.stage = stage;
+        [
+            new PerformActivities(this, stage),
+            new AnswerQuestions(this),
+            ...abilities
+        ].forEach(ability => this.acquireAbility(ability));
+    }
+    /**
+     * Retrieves actor's [`Ability`](https://serenity-js.org/api/core/class/Ability/) of `abilityType`, or one that extends `abilityType`.
+     *
+     * Please note that this method performs an [`instanceof`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/instanceof) check against abilities
+     * given to this actor via [`Actor.whoCan`](https://serenity-js.org/api/core/class/Actor/#whoCan).
+     *
+     * Please also note that [`Actor.whoCan`](https://serenity-js.org/api/core/class/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 abilityType
+     */
+    abilityTo(abilityType) {
+        const found = this.findAbilityTo(abilityType);
+        if (!found) {
+            throw new ConfigurationError(`${this.name} can ${Array.from(this.abilities.values()).map(ability => ability.constructor.name).join(', ')}. ` +
+                `They can't, however, ${abilityType.name} yet. ` +
+                `Did you give them the ability to do so?`);
+        }
+        return found;
+    }
+    /**
+     * Instructs the actor to attempt to perform a number of [activities](https://serenity-js.org/api/core/class/Activity/),
+     * so either [tasks](https://serenity-js.org/api/core/class/Task/) or [interactions](https://serenity-js.org/api/core/class/Interaction/)),
+     * one by one.
+     *
+     * @param {...activities: Activity[]} activities
+     */
+    attemptsTo(...activities) {
+        return activities
+            .reduce((previous, current) => {
+            return previous
+                .then(() => PerformActivities.as(this).perform(current));
+        }, this.initialiseAbilities());
+    }
+    /**
+     * Gives this Actor a list of [abilities](https://serenity-js.org/api/core/class/Ability/) they can use
+     * to interact with the system under test or the test environment.
+     *
+     * @param abilities
+     *  A vararg list of abilities to give the actor
+     *
+     * @returns
+     *  The actor with newly gained abilities
+     *
+     * @throws [`ConfigurationError`](https://serenity-js.org/api/core/class/ConfigurationError/)
+     *  Throws a ConfigurationError if the actor already has an ability of this type.
+     */
+    whoCan(...abilities) {
+        abilities.forEach(ability => this.acquireAbility(ability));
+        return this;
+    }
+    /**
+     * @param answerable -
+     *  An [`Answerable`](https://serenity-js.org/api/core/#Answerable) to answer (resolve the value of).
+     *
+     * @returns
+     *  The answer to the Answerable
+     */
+    answer(answerable) {
+        return AnswerQuestions.as(this).answer(answerable);
+    }
+    /**
+     * @inheritDoc
+     */
+    collect(artifact, name) {
+        this.stage.announce(new ActivityRelatedArtifactGenerated(this.stage.currentSceneId(), this.stage.currentActivityId(), this.nameFrom(name || new Name(artifact.constructor.name)), artifact, this.stage.currentTime()));
+    }
+    /**
+     * Returns current time.
+     */
+    currentTime() {
+        return this.stage.currentTime();
+    }
+    /**
+     * Instructs the actor to invoke [`Discardable.discard`](https://serenity-js.org/api/core/interface/Discardable/#discard) method on any
+     * [discardable](https://serenity-js.org/api/core/interface/Discardable/) [ability](https://serenity-js.org/api/core/class/Ability/) it's been configured with.
+     */
+    dismiss() {
+        return this.findAbilitiesOfType('discard')
+            .reduce((previous, ability) => previous.then(() => ability.discard()), Promise.resolve(void 0));
+    }
+    /**
+     * Returns a human-readable, string representation of this actor and their abilities.
+     *
+     * **PRO TIP:** To get the name of the actor, use [`Actor.name`](https://serenity-js.org/api/core/class/Actor/#name)
+     */
+    toString() {
+        const abilities = Array.from(this.abilities.values()).map(ability => ability.constructor.name);
+        return `Actor(name=${this.name}, abilities=[${abilities.join(', ')}])`;
+    }
+    /**
+     * Returns a JSON representation of the actor and its current state.
+     *
+     * The purpose of this method is to enable reporting the state of the actor in a human-readable format,
+     * rather than to serialise and deserialise the actor itself.
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            abilities: Array.from(this.abilities.values()).map(ability => ability.toJSON())
+        };
+    }
+    initialiseAbilities() {
+        return this.findAbilitiesOfType('initialise', 'isInitialised')
+            .filter(ability => !ability.isInitialised())
+            .reduce((previous, ability) => previous
+            .then(() => ability.initialise())
+            .catch(error => {
+            throw new TestCompromisedError(`${this.name} couldn't initialise the ability to ${ability.constructor.name}`, error);
+        }), Promise.resolve(void 0));
+    }
+    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);
+    }
+    findAbilityTo(doSomething) {
+        return this.abilities.get(doSomething.abilityType().name);
+    }
+    acquireAbility(ability) {
+        if (!(ability instanceof Ability)) {
+            throw new ConfigurationError(`Custom abilities must extend Ability from '@serenity-js/core'. Received ${ValueInspector.typeOf(ability)}`);
+        }
+        this.abilities.set(ability.abilityType().name, ability);
+    }
+    /**
+     * Instantiates a `Name` based on the string value of the parameter,
+     * or returns the argument if it's already an instance of `Name`.
+     *
+     * @param maybeName
+     */
+    nameFrom(maybeName) {
+        return typeof maybeName === 'string'
+            ? new Name(maybeName)
+            : maybeName;
+    }
+}
+//# sourceMappingURL=Actor.js.map

package/esm/screenplay/Actor.js.map

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