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

package/lib/stage/Stage.js.map

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

package/lib/stage/StageCrewMember.d.ts

@@ -1,26 +1,78 @@
 import { ListensToDomainEvents } from './ListensToDomainEvents';
 import { Stage } from './Stage';
 /**
- * @desc
- *  You can think of the {@link StageCrewMember} as an in-memory micro-service that reacts to {@link DomainEvent}s
- *  from the {@link StageManager}.
+ * You can think of the {@apilink StageCrewMember} as an in-memory microservice that reacts to {@apilink DomainEvent|domain events},
+ * published by the {@apilink StageManager}, and originally emitted by {@apilink Actor|actors} performing activities and Serenity/JS
+ * test runner adapters notifying the framework about test scenario-specific events like {@apilink SceneStarts} or {@apilink SceneFinishes}.
  *
- *  Every {@link StageCrewMember} receives a reference to the {@link Stage},
- *  and therefore {@link StageManager} as well, which enables them to emit {@link DomainEvent}s back.
+ * Every {@apilink StageCrewMember} receives a reference to the {@apilink Stage},
+ * and therefore {@apilink StageManager} as well, which enables them to emit {@apilink DomainEvent}s back.
  *
- *  Useful when you're interested in implementing [custom reporters](/handbook/reporting/index.html).
+ * This interface is useful when you're interested in implementing custom Serenity/JS reporters or supporting services.
  *
- * @extends {ListensToDomainEvents}
- * @see {@link StageCrewMemberBuilder}
- * @see {@link SerenityConfig#crew}
+ * ## Implementing a custom StageCrewMember
+ *
+ * ```ts
+ * import { Stage, StageCrewMember } from '@serenity-js/core'
+ * import * as events from '@serenity-js/core/lib/events'
+ * import { ArbitraryTag } from '@serenity-js/core/lib/model'
+ *
+ * export class TestRunnerTagger implements StageCrewMember {
+ *
+ *   static using(tagName: string) {
+ *     return new TestRunnerTagger(tagName);
+ *   }
+ *
+ *   protected constructor(
+ *     private readonly tagName: string,
+ *     private stage?: Stage,
+ *   ) {
+ *   }
+ *
+ *   assignedTo(stage: Stage): StageCrewMember {
+ *     this.stage = stage;
+ *     return this;
+ *   }
+ *
+ *   notifyOf(event: events.DomainEvent): void {
+ *     if (event instanceof events.TestRunnerDetected) {
+ *       this.stage.announce(
+ *         new events.SceneTagged(
+ *           this.stage.currentSceneId(),
+ *           new ArbitraryTag(this.tagName),
+ *           this.stage.currentTime()
+ *         )
+ *       )
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * ## Using the custom StageCrewMember
+ *
+ * ```ts
+ * import { configure } from '@serenity-js/core'
+ *
+ * configure({
+ *   crew: [
+ *     TestRunnerTagger.using(`Node:${ process.version }`),
+ *   ]
+ * })
+ * ```
+ *
+ * ## Learn more
+ * - {@apilink SerenityConfig.crew}
+ * - {@apilink configure}
+ * - {@apilink StageCrewMemberBuilder}
+ * - {@apilink ListensToDomainEvents}
+ * - {@apilink DomainEvent}
+ *
+ * @group Stage
  */
 export interface StageCrewMember extends ListensToDomainEvents {
     /**
-     * @desc
-     *  Assigns a {@link Stage} to this {@link StageCrewMember}
-     *
-     * @type {function(stage: Stage): StageCrewMember}
-     *  An instance of a {@link Stage} this {@link StageCrewMember} will be assigned to
+     * Assigns a {@apilink Stage} to this {@apilink StageCrewMember}
      */
-    assignedTo: (stage: Stage) => StageCrewMember;
+    assignedTo(stage: Stage): StageCrewMember;
 }
+//# sourceMappingURL=StageCrewMember.d.ts.map

package/lib/stage/StageCrewMember.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StageCrewMember.d.ts","sourceRoot":"","sources":["../../src/stage/StageCrewMember.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,MAAM,WAAW,eAAgB,SAAQ,qBAAqB;IAE1D;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CAAC;CAC7C"}

package/lib/stage/StageCrewMemberBuilder.d.ts

@@ -1,21 +1,23 @@
 import { ListensToDomainEvents } from './ListensToDomainEvents';
 import { StageCrewMemberBuilderDependencies } from './StageCrewMemberBuilderDependencies';
 /**
- * @desc
- *  Use a {@link StageCrewMemberBuilder} to configure complex {@link StageCrewMember} objects.
- *  Useful when you're interested in implementing custom reporters with multiple configuration options.
+ * Use a {@apilink StageCrewMemberBuilder} to configure complex {@apilink StageCrewMember} objects.
  *
- * @see {@link StageCrewMember}
- * @see {@link StageCrewMemberBuilderDependencies}
- * @see {@link SerenityConfig#crew}
+ * Useful when you're interested in implementing custom reporters with multiple configuration options.
+ * See {@apilink ConsoleReporter} for an example.
+ *
+ * ## Learn more
+ * - {@apilink StageCrewMember}
+ * - {@apilink StageCrewMemberBuilderDependencies}
+ * - {@apilink SerenityConfig.crew}
+ *
+ * @group Stage
  */
 export interface StageCrewMemberBuilder<T extends ListensToDomainEvents = ListensToDomainEvents> {
     /**
-     * @desc
-     *  Instantiates a {@link StageCrewMember}, giving it access to shared dependencies
-     *  such as {@link Stage} or {@link OutputStream}
-     *
-     * @type {function(dependencies: StageCrewMemberBuilderDependencies): T}
+     * Instantiates a {@apilink StageCrewMember}, giving it access to shared dependencies
+     * such as {@apilink Stage} or {@apilink OutputStream}
      */
-    build: (dependencies: StageCrewMemberBuilderDependencies) => T;
+    build(dependencies: StageCrewMemberBuilderDependencies): T;
 }
+//# sourceMappingURL=StageCrewMemberBuilder.d.ts.map

package/lib/stage/StageCrewMemberBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StageCrewMemberBuilder.d.ts","sourceRoot":"","sources":["../../src/stage/StageCrewMemberBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,kCAAkC,EAAE,MAAM,sCAAsC,CAAC;AAE1F;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,qBAAqB,GAAG,qBAAqB;IAE3F;;;OAGG;IACH,KAAK,CAAC,YAAY,EAAE,kCAAkC,GAAG,CAAC,CAAC;CAC9D"}

package/lib/stage/StageCrewMemberBuilderDependencies.d.ts

@@ -1,22 +1,15 @@
-import { OutputStream } from '../io';
+import { OutputStream } from '../adapter';
 import { Stage } from './Stage';
 /**
- * @desc
- *  Dependencies injected by {@link Serenity} into {@link StageCrewMemberBuilder#build}
+ * Dependencies injected by {@apilink Serenity.configure} into {@apilink StageCrewMemberBuilder.build}
  *
- * @interface
+ * ## Learn more
+ * - {@apilink StageCrewMemberBuilder}
  *
- * @see {@link StageCrewMemberBuilder}
+ * @group Stage
  */
 export interface StageCrewMemberBuilderDependencies {
-    /**
-     * @type {Stage}
-     */
     stage: Stage;
-    /**
-     * @desc
-     *
-     * @type {OutputStream}
-     */
     outputStream: OutputStream;
 }
+//# sourceMappingURL=StageCrewMemberBuilderDependencies.d.ts.map

package/lib/stage/StageCrewMemberBuilderDependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StageCrewMemberBuilderDependencies.d.ts","sourceRoot":"","sources":["../../src/stage/StageCrewMemberBuilderDependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,WAAW,kCAAkC;IAC/C,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;CAC9B"}

package/lib/stage/StageManager.d.ts

@@ -1,7 +1,9 @@
 import { DomainEvent } from '../events';
-import { Duration, Timestamp } from '../model';
+import { Clock, Duration, Timestamp } from '../screenplay';
 import { ListensToDomainEvents } from '../stage';
-import { Clock } from './Clock';
+/**
+ * @group Stage
+ */
 export declare class StageManager {
     private readonly cueTimeout;
     private readonly clock;
@@ -11,6 +13,8 @@ export declare class StageManager {
     register(...subscribers: ListensToDomainEvents[]): void;
     deregister(subscriber: ListensToDomainEvents): void;
     notifyOf(event: DomainEvent): void;
+    waitForAsyncOperationsToComplete(): Promise<void>;
     waitForNextCue(): Promise<void>;
     currentTime(): Timestamp;
 }
+//# sourceMappingURL=StageManager.d.ts.map

package/lib/stage/StageManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StageManager.d.ts","sourceRoot":"","sources":["../../src/stage/StageManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0E,WAAW,EAAE,MAAM,WAAW,CAAC;AAEhH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEjD;;GAEG;AACH,qBAAa,YAAY;IAIT,OAAO,CAAC,QAAQ,CAAC,UAAU;IAAY,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHzE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;gBAEG,UAAU,EAAE,QAAQ,EAAmB,KAAK,EAAE,KAAK;IAIhF,QAAQ,CAAC,GAAG,WAAW,EAAE,qBAAqB,EAAE,GAAG,IAAI;IAIvD,UAAU,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAInD,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAMlC,gCAAgC,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3C,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBrC,WAAW,IAAI,SAAS;CAG3B"}

package/lib/stage/StageManager.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StageManager = void 0;
 const events_1 = require("../events");
+/**
+ * @group Stage
+ */
 class StageManager {
     constructor(cueTimeout, clock) {
         this.cueTimeout = cueTimeout;
@@ -19,35 +22,32 @@ class StageManager {
         this.wip.recordIfAsync(event);
         this.subscribers.forEach(crewMember => crewMember.notifyOf(event));
     }
-    waitForNextCue() {
+    waitForAsyncOperationsToComplete() {
         return new Promise((resolve, reject) => {
             const timeout = setTimeout(() => {
                 clearInterval(interval);
-                if (this.wip.hasFailedOperations()) {
-                    const error = new Error(this.wip.descriptionOfFailedOperations());
-                    this.wip.resetFailedOperations();
-                    return reject(error);
-                }
-                if (this.wip.hasActiveOperations()) {
-                    const error = new Error(this.wip.descriptionOfTimedOutOperations());
-                    return reject(error);
-                }
-                // "else" can't happen because this case is covered by the interval check below
+                return resolve();
             }, this.cueTimeout.inMilliseconds());
             const interval = setInterval(() => {
                 if (this.wip.hasAllOperationsCompleted()) {
                     clearTimeout(timeout);
                     clearInterval(interval);
-                    if (this.wip.hasFailedOperations()) {
-                        const error = new Error(this.wip.descriptionOfFailedOperations());
-                        this.wip.resetFailedOperations();
-                        return reject(error);
-                    }
                     return resolve();
                 }
             }, 10);
         });
     }
+    async waitForNextCue() {
+        await this.waitForAsyncOperationsToComplete();
+        if (this.wip.hasFailedOperations()) {
+            const error = new Error(this.wip.descriptionOfFailedOperations());
+            this.wip.resetFailedOperations();
+            throw error;
+        }
+        if (this.wip.hasActiveOperations()) {
+            throw new Error(this.wip.descriptionOfTimedOutOperations());
+        }
+    }
     currentTime() {
         return this.clock.now();
     }
@@ -66,7 +66,8 @@ class WIP {
     recordIfAsync(event) {
         if (event instanceof events_1.AsyncOperationAttempted) {
             this.set(event.correlationId, {
-                taskDescription: event.taskDescription,
+                name: event.name,
+                description: event.description,
                 startedAt: event.timestamp,
             });
         }
@@ -76,7 +77,8 @@ class WIP {
         if (event instanceof events_1.AsyncOperationFailed) {
             const original = this.get(event.correlationId);
             this.failedOperations.push({
-                taskDescription: original.taskDescription,
+                name: original.name,
+                description: original.description,
                 startedAt: original.startedAt,
                 duration: event.timestamp.diff(original.startedAt),
                 error: event.error,
@@ -95,12 +97,12 @@ class WIP {
     }
     descriptionOfTimedOutOperations() {
         const now = this.clock.now();
-        return this.activeOperations().reduce((acc, op) => acc.concat(`${now.diff(op.startedAt)} - ${op.taskDescription.value}`), [`${this.header(this.wip.size)} within a ${this.cueTimeout} cue timeout:`]).join('\n');
+        return this.activeOperations().reduce((acc, op) => acc.concat(`${now.diff(op.startedAt)} - [${op.name.value}] ${op.description.value}`), [`${this.header(this.wip.size)} within a ${this.cueTimeout} cue timeout:`]).join('\n');
     }
     descriptionOfFailedOperations() {
         let message = `${this.header(this.failedOperations.length)}:\n`;
         this.failedOperations.forEach((op) => {
-            message += `${op.taskDescription.value} - ${op.error.stack}\n---\n`;
+            message += `[${op.name.value}] ${op.description.value} - ${op.error.stack}\n---\n`;
         });
         return message;
     }

package/lib/stage/StageManager.js.map

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

package/lib/stage/crew/artifact-archiver/ArtifactArchiver.d.ts

@@ -3,82 +3,105 @@ import { FileSystem } from '../../../io';
 import { Stage } from '../../Stage';
 import { StageCrewMember } from '../../StageCrewMember';
 /**
- * @desc
- *  Stores any {@link Artifact}s emitted via {@link ArtifactGenerated} events on the {@link FileSystem}
+ * Stores any {@apilink Artifact|artifacts} emitted via {@apilink ArtifactGenerated} events on the {@apilink FileSystem}
  *
- * @example <caption>Registering ArtifactArchiver programmatically</caption>
- *  import { configure, StreamReporter } from '@serenity-js/core';
+ * ## Registering `ArtifactArchiver` programmatically
  *
- *  configure({
- *      crew: [
- *          ArtifactArchiver.storingArtifactsAt('./target/site/serenity'),
- *      ],
- *  });
+ * ```ts
+ * import { ArtifactArchiver, configure } from '@serenity-js/core'
  *
- * @example <caption>Registering ArtifactArchiver using Protractor configuration</caption>
- *  // protractor.conf.js
- *  const { ArtifactArchiver } = require('@serenity-js/core');
+ * configure({
+ *   crew: [
+ *     ArtifactArchiver.storingArtifactsAt(`/target/site/serenity`),
+ *   ]
+ *   // other Serenity/JS config
+ * })
+ * ```
  *
- *  exports.config = {
- *    framework:     'custom',
- *    frameworkPath: require.resolve('@serenity-js/protractor/adapter'),
+ * ## Registering `ArtifactArchiver` using Protractor configuration
  *
- *    serenity: {
- *      crew: [
- *        ArtifactArchiver.storingArtifactsAt('./target/site/serenity'),
- *      ],
- *      // other Serenity/JS config
- *    },
+ * ```js
+ * // protractor.conf.js
+ * const { ArtifactArchiver } = require('@serenity-js/core')
  *
- *    // other Protractor config
- *  };
+ * exports.config = {
+ *   framework:     'custom',
+ *   frameworkPath: require.resolve('@serenity-js/protractor/adapter'),
  *
- * @public
- * @implements {StageCrewMember}
+ *   serenity: {
+ *     crew: [
+ *       ArtifactArchiver.storingArtifactsAt('./target/site/serenity'),
+ *     ],
+ *     // other Serenity/JS config
+ *   },
+ *   // other Protractor config
+ * };
+ * ```
+ *
+ * ## Registering `ArtifactArchiver` using WebdriverIO configuration
+ *
+ * ```ts
+ * // wdio.conf.js
+ * import { ArtifactArchiver } from '@serenity-js/core'
+ * import { WebdriverIOConfig } from '@serenity-js/webdriverio'
+ *
+ * export const config: WebdriverIOConfig = {
+ *
+ *     framework: '@serenity-js/webdriverio',
+ *
+ *     serenity: {
+ *         crew: [
+ *             ArtifactArchiver.storingArtifactsAt(`/target/site/serenity`),
+ *         ]
+ *         // other Serenity/JS config
+ *     },
+ *     // other WebdriverIO config
+ * }
+ * ```
+ *
+ * [ '@serenity-js/core:ArtifactArchiver', { outputDirectory: 'target/site/serenity' } ],
+ *
+ * @group Stage
  */
 export declare class ArtifactArchiver implements StageCrewMember {
     private readonly fileSystem;
-    private readonly stage?;
+    private stage?;
     /**
-     * @desc
-     *  Instantiates an `ArtifactArchiver` storing artifacts in a given `destination`.
-     *  The `destination` directory will be created automatically and recursively if it doesn't exist.
-     *
-     * @param {string[]} destination
+     * Instantiates an `ArtifactArchiver` storing artifacts in a given `destination`.
+     * The `destination` directory will be created automatically and recursively if it doesn't exist.
      *
-     * @returns {StageCrewMember}
+     * @param destination
      */
     static storingArtifactsAt(...destination: string[]): StageCrewMember;
+    /**
+     * Instantiates an `ArtifactArchiver` storing artifacts in a given `outputDirectory`.
+     * The `outputDirectory` will be created automatically and recursively if it doesn't exist.
+     *
+     * @param config
+     */
+    static fromJSON(config: {
+        outputDirectory: string;
+    }): StageCrewMember;
     /**
      * @param {FileSystem} fileSystem
      * @param {Stage} [stage]
-     *  The stage this {@link StageCrewMember} should be assigned to
+     *  The stage this {@apilink StageCrewMember} should be assigned to
      */
     constructor(fileSystem: FileSystem, stage?: Stage);
-    /**
-     * @desc
-     *  Creates a new instance of this {@link StageCrewMember} and assigns it to a given {@link Stage}.
-     *
-     * @see {@link StageCrewMember}
-     *
-     * @param {Stage} stage - An instance of a {@link Stage} this {@link StageCrewMember} will be assigned to
-     * @returns {StageCrewMember} - A new instance of this {@link StageCrewMember}
-     */
     assignedTo(stage: Stage): StageCrewMember;
     /**
-     * @desc
-     *  Handles {@link DomainEvent} objects emitted by the {@link StageManager}.
+     * Handles {@apilink DomainEvent} objects emitted by the {@apilink StageManager}.
      *
-     * @see {@link StageCrewMember}
+     * @see {@apilink StageCrewMember}
      *
      * @listens {ArtifactGenerated}
      * @emits {ArtifactArchived}
      *
-     * @param {DomainEvent} event
-     * @returns {void}
+     * @param event
      */
     notifyOf(event: DomainEvent): void;
     private fileNameFor;
     private archive;
     private archivisationAnnouncement;
 }
+//# sourceMappingURL=ArtifactArchiver.d.ts.map

package/lib/stage/crew/artifact-archiver/ArtifactArchiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactArchiver.d.ts","sourceRoot":"","sources":["../../../../src/stage/crew/artifact-archiver/ArtifactArchiver.ts"],"names":[],"mappings":"AAGA,OAAO,EAQH,WAAW,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAQ,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,qBAAa,gBAAiB,YAAW,eAAe;IAkChD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,KAAK,CAAC;IAjClB;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,GAAG,WAAW,EAAE,MAAM,EAAE,GAAG,eAAe;IAQpE;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe;IAMrE;;;;OAIG;gBAEkB,UAAU,EAAE,UAAU,EAC/B,KAAK,CAAC,EAAE,KAAK;IAIzB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe;IAKzC;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IA8BlC,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,OAAO;IAwBf,OAAO,CAAC,yBAAyB;CAoBpC"}