@serenity-js/core 3.41.1 → 3.42.0

package/CHANGELOG.md

@@ -3,6 +3,27 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.42.0](https://github.com/serenity-js/serenity-js/compare/v3.41.2...v3.42.0) (2026-03-19)
+
+
+### Features
+
+* **core:** add dual ESM/CJS build support ([09b457d](https://github.com/serenity-js/serenity-js/commit/09b457dee4a0b86d650af845ba224651e7805a11))
+* **core:** add dual ESM/CJS build support for Wave 2 packages ([0e2631c](https://github.com/serenity-js/serenity-js/commit/0e2631ca7cdbe68da7feec343eaf4f7fe9bb64d6))
+* **core:** add ESM/CJS dual build support for web packages ([94c5a64](https://github.com/serenity-js/serenity-js/commit/94c5a6423dc369477bbabbacee5a54f8fca20209))
+
+
+
+
+
+## [3.41.2](https://github.com/serenity-js/serenity-js/compare/v3.41.1...v3.41.2) (2026-03-05)
+
+**Note:** Version bump only for package @serenity-js/core
+
+
+
+
+
 ## [3.41.1](https://github.com/serenity-js/serenity-js/compare/v3.41.0...v3.41.1) (2026-02-27)
 
 **Note:** Version bump only for package @serenity-js/core

package/esm/Serenity.d.ts

@@ -0,0 +1,209 @@
+import type { SerenityConfig } from './config/index.js';
+import type { ErrorOptions, RuntimeError } from './errors/index.js';
+import type { DomainEvent, EmitsDomainEvents } from './events/index.js';
+import { Path } from './io/index.js';
+import { type ActivityDetails, CorrelationId, type CorrelationIdFactory } from './model/index.js';
+import type { Actor, Timestamp } from './screenplay/index.js';
+import { Clock } from './screenplay/index.js';
+import type { Cast } from './stage/Cast.js';
+/**
+ * @group Serenity
+ */
+export declare class Serenity implements EmitsDomainEvents {
+    private static defaultCueTimeout;
+    private static defaultInteractionTimeout;
+    private static defaultActors;
+    private readonly stage;
+    private readonly fileSystem;
+    private outputStream;
+    private readonly classLoader;
+    private readonly workingDirectory;
+    /**
+     * @param clock
+     * @param cwd
+     * @param sceneIdFactory
+     */
+    constructor(clock?: Clock, cwd?: string, sceneIdFactory?: CorrelationIdFactory);
+    /**
+     * Configures Serenity/JS. Every call to this function
+     * replaces the previous configuration provided,
+     * so this function should be called exactly once
+     * in your test suite.
+     *
+     * @param config
+     */
+    configure(config: SerenityConfig): void;
+    /**
+     * Re-configures Serenity/JS with a new [cast](https://serenity-js.org/api/core/class/Cast/) of [actors](https://serenity-js.org/api/core/class/Actor/)
+     * you want to use in any subsequent calls to [`actorCalled`](https://serenity-js.org/api/core/function/actorCalled/).
+     *
+     * For your convenience, use [`engage`](https://serenity-js.org/api/core/function/engage/) function instead,
+     * which provides an alternative to calling [`Actor.whoCan`](https://serenity-js.org/api/core/class/Actor/#whoCan) directly in your tests
+     * and is typically invoked in a "before all" or "before each" hook of your test runner of choice.
+     *
+     * If your implementation of the [cast](https://serenity-js.org/api/core/class/Cast/) interface is stateless,
+     * you can invoke this function just once before your entire test suite is executed, see
+     * - [`beforeAll`](https://jasmine.github.io/api/3.6/global.html#beforeAll) in Jasmine,
+     * - [`before`](https://mochajs.org/#hooks) in Mocha,
+     * - [`BeforeAll`](https://github.com/cucumber/cucumber-js/blob/master/docs/support_files/hooks.md#beforeall--afterall) in Cucumber.js
+     *
+     * However, if your [cast](https://serenity-js.org/api/core/class/Cast/) holds state that you want to reset before each scenario,
+     * it's better to invoke `engage` before each test using:
+     * - [`beforeEach`](https://jasmine.github.io/api/3.6/global.html#beforeEach) in Jasmine
+     * - [`beforeEach`](https://mochajs.org/#hooks) in Mocha,
+     * - [`Before`](https://github.com/cucumber/cucumber-js/blob/master/docs/support_files/hooks.md#hooks) in Cucumber.js
+     *
+     * ## Engaging a cast of actors
+     *
+     * ```ts
+     * import { Actor, Cast } from '@serenity-js/core';
+     *
+     * class Actors implements Cast {
+     *   prepare(actor: Actor) {
+     *     return actor.whoCan(
+     *       // ... abilities you'd like the Actor to have
+     *     );
+     *   }
+     * }
+     *
+     * engage(new Actors());
+     * ```
+     *
+     * ### Using with Mocha test runner
+     *
+     * ```ts
+     * import { beforeEach } from 'mocha'
+     *
+     * beforeEach(() => engage(new Actors()))
+     * ```
+     *
+     * ### Using with Jasmine test runner
+     *
+     * ```ts
+     * import 'jasmine'
+     *
+     * beforeEach(() => engage(new Actors()))
+     * ```
+     *
+     * ### Using with Cucumber.js test runner
+     *
+     * ```ts
+     * import { Before } from '@cucumber/cucumber'
+     *
+     * Before(() => engage(new Actors()))
+     * ```
+     *
+     * ## Learn more
+     * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+     * - [`Cast`](https://serenity-js.org/api/core/class/Cast/)
+     * - [`engage`](https://serenity-js.org/api/core/function/engage/)
+     *
+     * @param actors
+     */
+    engage(actors: Cast): void;
+    /**
+     * Instantiates or retrieves an [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+     * called `name` if one has already been instantiated.
+     *
+     * For your convenience, use [`actorCalled`](https://serenity-js.org/api/core/function/actorCalled/) function instead.
+     *
+     * ## Usage with Mocha
+     *
+     * ```typescript
+     *   import { describe, it } from 'mocha';
+     *   import { actorCalled } from '@serenity-js/core';
+     *
+     *   describe('Feature', () => {
+     *
+     *      it('should have some behaviour', () =>
+     *          actorCalled('James').attemptsTo(
+     *              // ... activities
+     *          ))
+     *   })
+     * ```
+     *
+     * ## Usage with Jasmine
+     *
+     * ```typescript
+     *   import 'jasmine';
+     *   import { actorCalled } from '@serenity-js/core';
+     *
+     *   describe('Feature', () => {
+     *
+     *      it('should have some behaviour', () =>
+     *          actorCalled('James').attemptsTo(
+     *              // ... activities
+     *          ))
+     *   })
+     * ```
+     *
+     * ## Usage with Cucumber
+     *
+     * ```typescript
+     * import { actorCalled } from '@serenity-js/core';
+     * import { Given } from '@cucumber/cucumber';
+     *
+     * Given(/(.*?) is a registered user/, (name: string) =>
+     *   actorCalled(name).attemptsTo(
+     *     // ... activities
+     *   ))
+     * ```
+     *
+     * ## Learn more
+     *
+     * - [`engage`](https://serenity-js.org/api/core/function/engage/)
+     * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+     * - [`Cast`](https://serenity-js.org/api/core/class/Cast/)
+     * - [`actorCalled`](https://serenity-js.org/api/core/function/actorCalled/)
+     *
+     * @param name
+     *  The name of the actor to instantiate or retrieve
+     */
+    theActorCalled(name: string): Actor;
+    /**
+     * Retrieves an actor who was last instantiated or retrieved
+     * using [`Serenity.theActorCalled`](https://serenity-js.org/api/core/class/Serenity/#theActorCalled).
+     *
+     * This function is particularly useful when automating Cucumber scenarios.
+     *
+     * For your convenience, use [`actorInTheSpotlight`](https://serenity-js.org/api/core/function/actorInTheSpotlight/) function instead.
+     *
+     * ## Usage with Cucumber
+     *
+     * ```ts
+     * import { actorCalled } from '@serenity-js/core';
+     * import { Given, When } from '@cucumber/cucumber';
+     *
+     * Given(/(.*?) is a registered user/, (name: string) =>
+     *   actorCalled(name).attemptsTo(
+     *     // ... activities
+     *   ))
+     *
+     * When(/(?:he|she|they) browse their recent orders/, () =>
+     *   actorInTheSpotlight().attemptsTo(
+     *     // ... activities
+     *   ))
+     * ```
+     *
+     * ## Learn more
+     *
+     * - [`engage`](https://serenity-js.org/api/core/function/engage/)
+     * - [`actorCalled`](https://serenity-js.org/api/core/function/actorCalled/)
+     * - [`actorInTheSpotlight`](https://serenity-js.org/api/core/function/actorInTheSpotlight/)
+     * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+     * - [`Cast`](https://serenity-js.org/api/core/class/Cast/)
+     */
+    theActorInTheSpotlight(): Actor;
+    announce(...events: Array<DomainEvent>): void;
+    currentTime(): Timestamp;
+    assignNewSceneId(): CorrelationId;
+    currentSceneId(): CorrelationId;
+    assignNewActivityId(activityDetails: ActivityDetails): CorrelationId;
+    createError<RE extends RuntimeError>(errorType: new (...args: any[]) => RE, options: ErrorOptions): RE;
+    /**
+     * @package
+     */
+    waitForNextCue(): Promise<void>;
+    cwd(): Path;
+}
+//# sourceMappingURL=Serenity.d.ts.map

package/esm/Serenity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Serenity.d.ts","sourceRoot":"","sources":["../src/Serenity.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAyE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC5G,OAAO,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAClG,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAY,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAM5C;;GAEG;AACH,qBAAa,QAAS,YAAW,iBAAiB;IAC9C,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAoC;IACpE,OAAO,CAAC,MAAM,CAAC,yBAAyB,CAA4B;IACpE,OAAO,CAAC,MAAM,CAAC,aAAa,CAA+B;IAE3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,YAAY,CAAiC;IAErD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAO;IAExC;;;;OAIG;gBAEC,KAAK,GAAE,KAAmB,EAC1B,GAAG,GAAE,MAAsB,EAC3B,cAAc,GAAE,oBAAoC;IAqBxD;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAmDvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkEG;IACH,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI;IAI1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyDG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAInC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,sBAAsB,IAAI,KAAK;IAI/B,QAAQ,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,IAAI;IAI7C,WAAW,IAAI,SAAS;IAIxB,gBAAgB,IAAI,aAAa;IAIjC,cAAc,IAAI,aAAa;IAI/B,mBAAmB,CAAC,eAAe,EAAE,eAAe,GAAG,aAAa;IAIpE,WAAW,CAAC,EAAE,SAAS,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,EAAE;IAItG;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,GAAG,IAAI,IAAI;CAGd"}

package/esm/Serenity.js

@@ -0,0 +1,272 @@
+import { ensure, isInstanceOf } from 'tiny-types';
+import { ConfigurationError, ErrorFactory, NoOpDiffFormatter } from './errors/index.js';
+import { ClassDescriptionParser, ClassLoader, d, FileSystem, has, ModuleLoader, Path } from './io/index.js';
+import { CorrelationId } from './model/index.js';
+import { Clock, Duration } from './screenplay/index.js';
+import { Extras } from './stage/Extras.js';
+import { Stage } from './stage/Stage.js';
+import { StageManager } from './stage/StageManager.js';
+/**
+ * @group Serenity
+ */
+export class Serenity {
+    static defaultCueTimeout = Duration.ofSeconds(5);
+    static defaultInteractionTimeout = Duration.ofSeconds(5);
+    static defaultActors = new Extras();
+    stage;
+    fileSystem;
+    outputStream = process.stdout;
+    classLoader;
+    workingDirectory;
+    /**
+     * @param clock
+     * @param cwd
+     * @param sceneIdFactory
+     */
+    constructor(clock = new Clock(), cwd = process.cwd(), sceneIdFactory = CorrelationId) {
+        this.stage = new Stage(Serenity.defaultActors, new StageManager(Serenity.defaultCueTimeout, clock), new ErrorFactory(), clock, Serenity.defaultInteractionTimeout, sceneIdFactory);
+        this.classLoader = new ClassLoader(new ModuleLoader(cwd), new ClassDescriptionParser());
+        this.workingDirectory = new Path(cwd);
+        this.fileSystem = new FileSystem(this.workingDirectory);
+    }
+    /**
+     * Configures Serenity/JS. Every call to this function
+     * replaces the previous configuration provided,
+     * so this function should be called exactly once
+     * in your test suite.
+     *
+     * @param config
+     */
+    configure(config) {
+        const looksLikeBuilder = has({ build: 'function' });
+        const looksLikeStageCrewMember = has({ assignedTo: 'function', notifyOf: 'function' });
+        const cueTimeout = config.cueTimeout
+            ? ensure('cueTimeout', config.cueTimeout, isInstanceOf(Duration))
+            : Serenity.defaultCueTimeout;
+        const interactionTimeout = config.interactionTimeout
+            ? ensure('interactionTimeout', config.interactionTimeout, isInstanceOf(Duration))
+            : Serenity.defaultInteractionTimeout;
+        if (config.outputStream) {
+            this.outputStream = config.outputStream;
+        }
+        this.stage.configure({
+            actors: config.actors ?? Serenity.defaultActors,
+            cueTimeout,
+            interactionTimeout,
+            diffFormatter: config.diffFormatter ?? new NoOpDiffFormatter(),
+        });
+        if (Array.isArray(config.crew)) {
+            this.stage.assign(...config.crew.map((stageCrewMemberDescription, i) => {
+                const stageCrewMember = this.classLoader.looksLoadable(stageCrewMemberDescription)
+                    ? this.classLoader.instantiate(stageCrewMemberDescription)
+                    : stageCrewMemberDescription;
+                if (looksLikeBuilder(stageCrewMember)) {
+                    return stageCrewMember.build({
+                        stage: this.stage,
+                        fileSystem: this.fileSystem,
+                        outputStream: this.outputStream,
+                    });
+                }
+                if (looksLikeStageCrewMember(stageCrewMember)) {
+                    return stageCrewMember.assignedTo(this.stage);
+                }
+                throw new ConfigurationError(d `Entries under \`crew\` should implement either StageCrewMember or StageCrewMemberBuilder interfaces, \`${stageCrewMemberDescription}\` found at index ${i}`);
+            }));
+        }
+    }
+    /**
+     * Re-configures Serenity/JS with a new [cast](https://serenity-js.org/api/core/class/Cast/) of [actors](https://serenity-js.org/api/core/class/Actor/)
+     * you want to use in any subsequent calls to [`actorCalled`](https://serenity-js.org/api/core/function/actorCalled/).
+     *
+     * For your convenience, use [`engage`](https://serenity-js.org/api/core/function/engage/) function instead,
+     * which provides an alternative to calling [`Actor.whoCan`](https://serenity-js.org/api/core/class/Actor/#whoCan) directly in your tests
+     * and is typically invoked in a "before all" or "before each" hook of your test runner of choice.
+     *
+     * If your implementation of the [cast](https://serenity-js.org/api/core/class/Cast/) interface is stateless,
+     * you can invoke this function just once before your entire test suite is executed, see
+     * - [`beforeAll`](https://jasmine.github.io/api/3.6/global.html#beforeAll) in Jasmine,
+     * - [`before`](https://mochajs.org/#hooks) in Mocha,
+     * - [`BeforeAll`](https://github.com/cucumber/cucumber-js/blob/master/docs/support_files/hooks.md#beforeall--afterall) in Cucumber.js
+     *
+     * However, if your [cast](https://serenity-js.org/api/core/class/Cast/) holds state that you want to reset before each scenario,
+     * it's better to invoke `engage` before each test using:
+     * - [`beforeEach`](https://jasmine.github.io/api/3.6/global.html#beforeEach) in Jasmine
+     * - [`beforeEach`](https://mochajs.org/#hooks) in Mocha,
+     * - [`Before`](https://github.com/cucumber/cucumber-js/blob/master/docs/support_files/hooks.md#hooks) in Cucumber.js
+     *
+     * ## Engaging a cast of actors
+     *
+     * ```ts
+     * import { Actor, Cast } from '@serenity-js/core';
+     *
+     * class Actors implements Cast {
+     *   prepare(actor: Actor) {
+     *     return actor.whoCan(
+     *       // ... abilities you'd like the Actor to have
+     *     );
+     *   }
+     * }
+     *
+     * engage(new Actors());
+     * ```
+     *
+     * ### Using with Mocha test runner
+     *
+     * ```ts
+     * import { beforeEach } from 'mocha'
+     *
+     * beforeEach(() => engage(new Actors()))
+     * ```
+     *
+     * ### Using with Jasmine test runner
+     *
+     * ```ts
+     * import 'jasmine'
+     *
+     * beforeEach(() => engage(new Actors()))
+     * ```
+     *
+     * ### Using with Cucumber.js test runner
+     *
+     * ```ts
+     * import { Before } from '@cucumber/cucumber'
+     *
+     * Before(() => engage(new Actors()))
+     * ```
+     *
+     * ## Learn more
+     * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+     * - [`Cast`](https://serenity-js.org/api/core/class/Cast/)
+     * - [`engage`](https://serenity-js.org/api/core/function/engage/)
+     *
+     * @param actors
+     */
+    engage(actors) {
+        this.stage.engage(actors);
+    }
+    /**
+     * Instantiates or retrieves an [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+     * called `name` if one has already been instantiated.
+     *
+     * For your convenience, use [`actorCalled`](https://serenity-js.org/api/core/function/actorCalled/) function instead.
+     *
+     * ## Usage with Mocha
+     *
+     * ```typescript
+     *   import { describe, it } from 'mocha';
+     *   import { actorCalled } from '@serenity-js/core';
+     *
+     *   describe('Feature', () => {
+     *
+     *      it('should have some behaviour', () =>
+     *          actorCalled('James').attemptsTo(
+     *              // ... activities
+     *          ))
+     *   })
+     * ```
+     *
+     * ## Usage with Jasmine
+     *
+     * ```typescript
+     *   import 'jasmine';
+     *   import { actorCalled } from '@serenity-js/core';
+     *
+     *   describe('Feature', () => {
+     *
+     *      it('should have some behaviour', () =>
+     *          actorCalled('James').attemptsTo(
+     *              // ... activities
+     *          ))
+     *   })
+     * ```
+     *
+     * ## Usage with Cucumber
+     *
+     * ```typescript
+     * import { actorCalled } from '@serenity-js/core';
+     * import { Given } from '@cucumber/cucumber';
+     *
+     * Given(/(.*?) is a registered user/, (name: string) =>
+     *   actorCalled(name).attemptsTo(
+     *     // ... activities
+     *   ))
+     * ```
+     *
+     * ## Learn more
+     *
+     * - [`engage`](https://serenity-js.org/api/core/function/engage/)
+     * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+     * - [`Cast`](https://serenity-js.org/api/core/class/Cast/)
+     * - [`actorCalled`](https://serenity-js.org/api/core/function/actorCalled/)
+     *
+     * @param name
+     *  The name of the actor to instantiate or retrieve
+     */
+    theActorCalled(name) {
+        return this.stage.actor(name);
+    }
+    /**
+     * Retrieves an actor who was last instantiated or retrieved
+     * using [`Serenity.theActorCalled`](https://serenity-js.org/api/core/class/Serenity/#theActorCalled).
+     *
+     * This function is particularly useful when automating Cucumber scenarios.
+     *
+     * For your convenience, use [`actorInTheSpotlight`](https://serenity-js.org/api/core/function/actorInTheSpotlight/) function instead.
+     *
+     * ## Usage with Cucumber
+     *
+     * ```ts
+     * import { actorCalled } from '@serenity-js/core';
+     * import { Given, When } from '@cucumber/cucumber';
+     *
+     * Given(/(.*?) is a registered user/, (name: string) =>
+     *   actorCalled(name).attemptsTo(
+     *     // ... activities
+     *   ))
+     *
+     * When(/(?:he|she|they) browse their recent orders/, () =>
+     *   actorInTheSpotlight().attemptsTo(
+     *     // ... activities
+     *   ))
+     * ```
+     *
+     * ## Learn more
+     *
+     * - [`engage`](https://serenity-js.org/api/core/function/engage/)
+     * - [`actorCalled`](https://serenity-js.org/api/core/function/actorCalled/)
+     * - [`actorInTheSpotlight`](https://serenity-js.org/api/core/function/actorInTheSpotlight/)
+     * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+     * - [`Cast`](https://serenity-js.org/api/core/class/Cast/)
+     */
+    theActorInTheSpotlight() {
+        return this.stage.theActorInTheSpotlight();
+    }
+    announce(...events) {
+        this.stage.announce(...events);
+    }
+    currentTime() {
+        return this.stage.currentTime();
+    }
+    assignNewSceneId() {
+        return this.stage.assignNewSceneId();
+    }
+    currentSceneId() {
+        return this.stage.currentSceneId();
+    }
+    assignNewActivityId(activityDetails) {
+        return this.stage.assignNewActivityId(activityDetails);
+    }
+    createError(errorType, options) {
+        return this.stage.createError(errorType, options);
+    }
+    /**
+     * @package
+     */
+    waitForNextCue() {
+        return this.stage.waitForNextCue();
+    }
+    cwd() {
+        return this.workingDirectory;
+    }
+}
+//# sourceMappingURL=Serenity.js.map

package/esm/Serenity.js.map

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

package/esm/adapter/OutputStream.d.ts

@@ -0,0 +1,15 @@
+/**
+ * An output stream to be injected into [stage crew member builders](https://serenity-js.org/api/core/interface/StageCrewMemberBuilder/)
+ * configured via [`SerenityConfig.crew`](https://serenity-js.org/api/core/class/SerenityConfig/#crew).
+ *
+ * ## Learn more
+ * - [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMemberBuilder/)
+ * - [`Serenity.configure`](https://serenity-js.org/api/core/class/Serenity/#configure)
+ * - [`SerenityConfig.crew`](https://serenity-js.org/api/core/class/SerenityConfig/#crew)
+ *
+ * @group Integration
+ */
+export interface OutputStream {
+    write(content: string): void;
+}
+//# sourceMappingURL=OutputStream.d.ts.map

package/esm/adapter/OutputStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutputStream.d.ts","sourceRoot":"","sources":["../../src/adapter/OutputStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IACzB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC"}

package/esm/adapter/OutputStream.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=OutputStream.js.map

package/esm/adapter/OutputStream.js.map

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

package/esm/adapter/TestRunnerAdapter.d.ts

@@ -0,0 +1,33 @@
+import type { Outcome } from '../model/index.js';
+/**
+ * Describes an adapter needed to run a given type of tests programmatically
+ *
+ * @group Integration
+ */
+export interface TestRunnerAdapter {
+    /**
+     * Loads test scenarios.
+     */
+    load(pathsToScenarios: string[]): Promise<void>;
+    /**
+     * Returns the number of loaded scenarios
+     *
+     * @throws [`LogicError`](https://serenity-js.org/api/core/class/LogicError/)
+     *  If called before `load`
+     */
+    scenarioCount(): number;
+    /**
+     * Runs loaded test scenarios.
+     *
+     * @throws [`LogicError`](https://serenity-js.org/api/core/class/LogicError/)
+     *  If called before `load`
+     */
+    run(): Promise<void>;
+    /**
+     * Scenario success threshold for this test runner.
+     */
+    successThreshold(): Outcome | {
+        Code: number;
+    };
+}
+//# sourceMappingURL=TestRunnerAdapter.d.ts.map

package/esm/adapter/TestRunnerAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestRunnerAdapter.d.ts","sourceRoot":"","sources":["../../src/adapter/TestRunnerAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAE9B;;OAEG;IACH,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,aAAa,IAAI,MAAM,CAAC;IAExB;;;;;OAKG;IACH,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAErB;;OAEG;IACH,gBAAgB,IAAI,OAAO,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD"}

package/esm/adapter/TestRunnerAdapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TestRunnerAdapter.js.map

package/esm/adapter/TestRunnerAdapter.js.map

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

package/esm/adapter/index.d.ts

@@ -0,0 +1,3 @@
+export * from './OutputStream.js';
+export * from './TestRunnerAdapter.js';
+//# sourceMappingURL=index.d.ts.map

package/esm/adapter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}

package/esm/adapter/index.js

@@ -0,0 +1,3 @@
+export * from './OutputStream.js';
+export * from './TestRunnerAdapter.js';
+//# sourceMappingURL=index.js.map

package/esm/adapter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}