@serenity-js/core 3.41.2 → 3.42.0

package/esm/errors/model/OperationInterruptedError.d.ts

@@ -0,0 +1,20 @@
+import type { JSONObject } from 'tiny-types';
+import { RuntimeError } from './RuntimeError.js';
+/**
+ * Thrown to indicate that a [scheduled operation](https://serenity-js.org/api/core/class/Scheduler/)
+ * has been stopped before it was completed.
+ *
+ * @group Errors
+ */
+export declare class OperationInterruptedError extends RuntimeError {
+    static fromJSON(serialised: JSONObject): OperationInterruptedError;
+    /**
+     * @param message
+     *  Human-readable description of the error
+     *
+     * @param [cause]
+     *  The root cause of this [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/), if any
+     */
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=OperationInterruptedError.d.ts.map

package/esm/errors/model/OperationInterruptedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationInterruptedError.d.ts","sourceRoot":"","sources":["../../../src/errors/model/OperationInterruptedError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,YAAY;IAEvD,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,yBAAyB;IAWlE;;;;;;OAMG;gBAEC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK;CAIpB"}

package/esm/errors/model/OperationInterruptedError.js

@@ -0,0 +1,26 @@
+import { ErrorSerialiser } from '../ErrorSerialiser.js';
+import { RuntimeError } from './RuntimeError.js';
+/**
+ * Thrown to indicate that a [scheduled operation](https://serenity-js.org/api/core/class/Scheduler/)
+ * has been stopped before it was completed.
+ *
+ * @group Errors
+ */
+export class OperationInterruptedError extends RuntimeError {
+    static fromJSON(serialised) {
+        const error = new OperationInterruptedError(serialised.message, ErrorSerialiser.deserialise(serialised.cause));
+        error.stack = serialised.stack;
+        return error;
+    }
+    /**
+     * @param message
+     *  Human-readable description of the error
+     *
+     * @param [cause]
+     *  The root cause of this [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/), if any
+     */
+    constructor(message, cause) {
+        super(OperationInterruptedError, message, cause);
+    }
+}
+//# sourceMappingURL=OperationInterruptedError.js.map

package/esm/errors/model/OperationInterruptedError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationInterruptedError.js","sourceRoot":"","sources":["../../../src/errors/model/OperationInterruptedError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,OAAO,yBAA0B,SAAQ,YAAY;IAEvD,MAAM,CAAC,QAAQ,CAAC,UAAsB;QAClC,MAAM,KAAK,GAAG,IAAI,yBAAyB,CACvC,UAAU,CAAC,OAAiB,EAC5B,eAAe,CAAC,WAAW,CAAC,UAAU,CAAC,KAA2B,CAAC,CACtE,CAAC;QAEF,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,KAAe,CAAC;QAEzC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACH,YACI,OAAe,EACf,KAAa;QAEb,KAAK,CAAC,yBAAyB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;CACJ"}

package/esm/errors/model/RuntimeError.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Base class for custom errors that may occur during execution of a test scenario.
+ *
+ * ## Defining a custom error
+ *
+ * ```ts
+ * import { RuntimeError } from '@serenity-js/core'
+ *
+ * export class CustomError extends RuntimeError {
+ *   constructor(message: string, cause?: Error) {
+ *       super(CustomError, message, cause);
+ *   }
+ * }
+ * ```
+ *
+ * ## Wrapping a sync error
+ *
+ * ```ts
+ * try {
+ *     operationThatMightThrowAnError();
+ * } catch(error) {
+ *     // catch and re-throw
+ *     throw new CustomError('operationThatMightThrowAnError has failed', error);
+ * }
+ * ```
+ *
+ * ## Wrapping an async error
+ *
+ * ```ts
+ * operationThatMightRejectAPromise()
+ *   .catch(error => {
+ *     // catch and re-throw
+ *     throw new CustomError('operationThatMightThrowAnError has failed', error)
+ *   })
+ * ```
+ *
+ * ## Registering a custom error with [`ErrorSerialiser`](https://serenity-js.org/api/core/class/ErrorSerialiser/)
+ *
+ * ```ts
+ * import { RuntimeError } from '@serenity-js/core'
+ * import { ErrorSerialiser } from '@serenity-js/core/io'
+ *
+ * export class CustomError extends RuntimeError {
+ *
+ *    static fromJSON(serialised: JSONObject): CustomError {
+ *         const error = new CustomError(
+ *             serialised.message as string,
+ *             ErrorSerialiser.deserialise(serialised.cause as string | undefined),
+ *         );
+ *
+ *         error.stack = serialised.stack as string;
+ *
+ *         return error;
+ *     }
+ *
+ *   constructor(message: string, cause?: Error) {
+ *       super(CustomError, message, cause);
+ *   }
+ * }
+ *
+ * ErrorSerialiser.registerErrorTypes(CustomError)
+ * ```
+ *
+ * @group Errors
+ */
+export declare abstract class RuntimeError extends Error {
+    readonly cause?: Error;
+    /**
+     * Symbol used to brand RuntimeError instances for cross-module instanceof checks.
+     * This addresses the dual-package hazard where the same class loaded from
+     * both ESM and CJS creates distinct constructor functions.
+     */
+    private static readonly TYPE_BRAND;
+    /**
+     * Custom instanceof check that works across module boundaries.
+     * This addresses the dual-package hazard where the same class loaded from
+     * both ESM and CJS creates distinct constructor functions.
+     *
+     * The check walks up the prototype chain of the instance and compares
+     * constructor names, which remain consistent across module boundaries.
+     */
+    static [Symbol.hasInstance](instance: unknown): boolean;
+    /**
+     * @param type - Constructor function used to instantiate a subclass of a RuntimeError
+     * @param message - Human-readable description of the error
+     * @param [cause] - The root cause of this [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/), if any
+     */
+    protected constructor(type: new (...args: any[]) => RuntimeError, message: string, cause?: Error);
+    /**
+     * Human-readable description of the error
+     */
+    toString(): string;
+    toJSON(): object;
+}
+//# sourceMappingURL=RuntimeError.d.ts.map

package/esm/errors/model/RuntimeError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeError.d.ts","sourceRoot":"","sources":["../../../src/errors/model/RuntimeError.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,8BAAsB,YAAa,SAAQ,KAAK;aAqDxB,KAAK,CAAC,EAAE,KAAK;IAnDjC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAgD;IAElF;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO;IA4BvD;;;;OAIG;IACH,SAAS,aACL,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,YAAY,EAC1C,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK;IAyBjC;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,MAAM;CAGnB"}

package/esm/errors/model/RuntimeError.js

@@ -0,0 +1,138 @@
+import { TinyType } from 'tiny-types';
+/**
+ * Base class for custom errors that may occur during execution of a test scenario.
+ *
+ * ## Defining a custom error
+ *
+ * ```ts
+ * import { RuntimeError } from '@serenity-js/core'
+ *
+ * export class CustomError extends RuntimeError {
+ *   constructor(message: string, cause?: Error) {
+ *       super(CustomError, message, cause);
+ *   }
+ * }
+ * ```
+ *
+ * ## Wrapping a sync error
+ *
+ * ```ts
+ * try {
+ *     operationThatMightThrowAnError();
+ * } catch(error) {
+ *     // catch and re-throw
+ *     throw new CustomError('operationThatMightThrowAnError has failed', error);
+ * }
+ * ```
+ *
+ * ## Wrapping an async error
+ *
+ * ```ts
+ * operationThatMightRejectAPromise()
+ *   .catch(error => {
+ *     // catch and re-throw
+ *     throw new CustomError('operationThatMightThrowAnError has failed', error)
+ *   })
+ * ```
+ *
+ * ## Registering a custom error with [`ErrorSerialiser`](https://serenity-js.org/api/core/class/ErrorSerialiser/)
+ *
+ * ```ts
+ * import { RuntimeError } from '@serenity-js/core'
+ * import { ErrorSerialiser } from '@serenity-js/core/io'
+ *
+ * export class CustomError extends RuntimeError {
+ *
+ *    static fromJSON(serialised: JSONObject): CustomError {
+ *         const error = new CustomError(
+ *             serialised.message as string,
+ *             ErrorSerialiser.deserialise(serialised.cause as string | undefined),
+ *         );
+ *
+ *         error.stack = serialised.stack as string;
+ *
+ *         return error;
+ *     }
+ *
+ *   constructor(message: string, cause?: Error) {
+ *       super(CustomError, message, cause);
+ *   }
+ * }
+ *
+ * ErrorSerialiser.registerErrorTypes(CustomError)
+ * ```
+ *
+ * @group Errors
+ */
+export class RuntimeError extends Error {
+    cause;
+    /**
+     * Symbol used to brand RuntimeError instances for cross-module instanceof checks.
+     * This addresses the dual-package hazard where the same class loaded from
+     * both ESM and CJS creates distinct constructor functions.
+     */
+    static TYPE_BRAND = Symbol.for('@serenity-js/core/RuntimeError');
+    /**
+     * Custom instanceof check that works across module boundaries.
+     * This addresses the dual-package hazard where the same class loaded from
+     * both ESM and CJS creates distinct constructor functions.
+     *
+     * The check walks up the prototype chain of the instance and compares
+     * constructor names, which remain consistent across module boundaries.
+     */
+    static [Symbol.hasInstance](instance) {
+        if (instance === null || typeof instance !== 'object') {
+            return false;
+        }
+        // First, verify this is a RuntimeError instance using the brand
+        if (instance[RuntimeError.TYPE_BRAND] !== true) {
+            return false;
+        }
+        // When checking against the base RuntimeError class, any branded instance qualifies
+        if (this.name === 'RuntimeError') {
+            return true;
+        }
+        // For subclass checks, walk the prototype chain and compare by name
+        // This works across ESM/CJS boundaries where constructor references differ
+        let proto = Object.getPrototypeOf(instance);
+        while (proto !== null) {
+            if (proto.constructor?.name === this.name) {
+                return true;
+            }
+            proto = Object.getPrototypeOf(proto);
+        }
+        return false;
+    }
+    /**
+     * @param type - Constructor function used to instantiate a subclass of a RuntimeError
+     * @param message - Human-readable description of the error
+     * @param [cause] - The root cause of this [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/), if any
+     */
+    constructor(type, message, cause) {
+        const errorMessage = message || '';
+        const isMultiline = errorMessage.includes('\n');
+        const causeAlreadyIncluded = cause?.message && errorMessage.includes(cause.message);
+        super(isMultiline || causeAlreadyIncluded
+            ? errorMessage
+            : errorMessage + (cause && cause?.message ? `; ${cause.message}` : ''));
+        this.cause = cause;
+        Object.setPrototypeOf(this, type.prototype);
+        this.name = this.constructor.name;
+        // Brand the instance for cross-module instanceof checks
+        this[RuntimeError.TYPE_BRAND] = true;
+        Error.captureStackTrace(this, type);
+        if (cause) {
+            this.stack = `${this.stack}\nCaused by: ${cause.stack}`;
+        }
+    }
+    /**
+     * Human-readable description of the error
+     */
+    toString() {
+        return `${this.constructor.name}: ${this.message}`;
+    }
+    toJSON() {
+        return TinyType.prototype.toJSON.apply(this);
+    }
+}
+//# sourceMappingURL=RuntimeError.js.map

package/esm/errors/model/RuntimeError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeError.js","sourceRoot":"","sources":["../../../src/errors/model/RuntimeError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,MAAM,OAAgB,YAAa,SAAQ,KAAK;IAqDxB;IAnDpB;;;;OAIG;IACK,MAAM,CAAU,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAElF;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAiB;QACzC,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACpD,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,gEAAgE;QAChE,IAAK,QAAgB,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;YACtD,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,oFAAoF;QACpF,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,oEAAoE;QACpE,2EAA2E;QAC3E,IAAI,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC5C,OAAO,KAAK,KAAK,IAAI,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;gBACxC,OAAO,IAAI,CAAC;YAChB,CAAC;YACD,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,YACI,IAA0C,EAC1C,OAAe,EACC,KAAa;QAE7B,MAAM,YAAY,GAAG,OAAO,IAAI,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,oBAAoB,GAAG,KAAK,EAAE,OAAO,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEpF,KAAK,CACD,WAAW,IAAI,oBAAoB;YAC/B,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,YAAY,GAAG,CAAC,KAAK,IAAI,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAM,KAAK,CAAC,OAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAC/E,CAAC;QAVc,UAAK,GAAL,KAAK,CAAQ;QAY7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAElC,wDAAwD;QACvD,IAAY,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;QAE9C,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAEpC,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,KAAK,GAAG,GAAI,IAAI,CAAC,KAAM,gBAAiB,KAAK,CAAC,KAAM,EAAE,CAAC;QAChE,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO,GAAI,IAAI,CAAC,WAAW,CAAC,IAAK,KAAM,IAAI,CAAC,OAAQ,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM;QACF,OAAO,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAChD,CAAC"}

package/esm/errors/model/TestCompromisedError.d.ts

@@ -0,0 +1,31 @@
+import type { JSONObject } from 'tiny-types';
+import { RuntimeError } from './RuntimeError.js';
+/**
+ * Thrown to indicate that the test can't be performed due to an issue with a downstream dependency.
+ * For example, it makes no sense to run a full-stack integration test if we already know that
+ * the database server is down.
+ *
+ * ## Throwing a TestCompromisedError from a custom Interaction
+ *
+ * ```ts
+ * import { Interaction } from '@serenity-js/core';
+ *
+ * const SetUpTestDatabase = () =>
+ *   Interaction.where(`#actor sets up a test database`, actor => {
+ *     return SomeCustomDatabaseSpecificAbility.as(actor).setUpTestDatabase().catch(error => {
+ *       throw new TestCompromisedError('Could not set up the test database', error)
+ *     })
+ * })
+ * ```
+ *
+ * @group Errors
+ */
+export declare class TestCompromisedError extends RuntimeError {
+    static fromJSON(serialised: JSONObject): TestCompromisedError;
+    /**
+     * @param message - Human-readable description of the error
+     * @param [cause] - The root cause of this [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/), if any
+     */
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=TestCompromisedError.d.ts.map

package/esm/errors/model/TestCompromisedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestCompromisedError.d.ts","sourceRoot":"","sources":["../../../src/errors/model/TestCompromisedError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IAElD,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,oBAAoB;IAW7D;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG7C"}

package/esm/errors/model/TestCompromisedError.js

@@ -0,0 +1,37 @@
+import { ErrorSerialiser } from '../ErrorSerialiser.js';
+import { RuntimeError } from './RuntimeError.js';
+/**
+ * Thrown to indicate that the test can't be performed due to an issue with a downstream dependency.
+ * For example, it makes no sense to run a full-stack integration test if we already know that
+ * the database server is down.
+ *
+ * ## Throwing a TestCompromisedError from a custom Interaction
+ *
+ * ```ts
+ * import { Interaction } from '@serenity-js/core';
+ *
+ * const SetUpTestDatabase = () =>
+ *   Interaction.where(`#actor sets up a test database`, actor => {
+ *     return SomeCustomDatabaseSpecificAbility.as(actor).setUpTestDatabase().catch(error => {
+ *       throw new TestCompromisedError('Could not set up the test database', error)
+ *     })
+ * })
+ * ```
+ *
+ * @group Errors
+ */
+export class TestCompromisedError extends RuntimeError {
+    static fromJSON(serialised) {
+        const error = new TestCompromisedError(serialised.message, ErrorSerialiser.deserialise(serialised.cause));
+        error.stack = serialised.stack;
+        return error;
+    }
+    /**
+     * @param message - Human-readable description of the error
+     * @param [cause] - The root cause of this [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/), if any
+     */
+    constructor(message, cause) {
+        super(TestCompromisedError, message, cause);
+    }
+}
+//# sourceMappingURL=TestCompromisedError.js.map

package/esm/errors/model/TestCompromisedError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestCompromisedError.js","sourceRoot":"","sources":["../../../src/errors/model/TestCompromisedError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IAElD,MAAM,CAAC,QAAQ,CAAC,UAAsB;QAClC,MAAM,KAAK,GAAG,IAAI,oBAAoB,CAClC,UAAU,CAAC,OAAiB,EAC5B,eAAe,CAAC,WAAW,CAAC,UAAU,CAAC,KAA2B,CAAC,CACtE,CAAC;QAEF,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,KAAe,CAAC;QAEzC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,YAAY,OAAe,EAAE,KAAa;QACtC,KAAK,CAAC,oBAAoB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;CACJ"}

package/esm/errors/model/TimeoutExpiredError.d.ts

@@ -0,0 +1,20 @@
+import type { JSONObject } from 'tiny-types';
+import { RuntimeError } from './RuntimeError.js';
+/**
+ * Thrown to indicate that an [`Interaction`](https://serenity-js.org/api/core/class/Interaction/), a [`Task`](https://serenity-js.org/api/core/class/Task/) or a test scenario
+ * took longer to execute than the expected timeout.
+ *
+ * @group Errors
+ */
+export declare class TimeoutExpiredError extends RuntimeError {
+    static fromJSON(serialised: JSONObject): TimeoutExpiredError;
+    /**
+     * @param message
+     *  Human-readable description of the error
+     *
+     * @param [cause]
+     *  The root cause of this [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/), if any
+     */
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=TimeoutExpiredError.d.ts.map

package/esm/errors/model/TimeoutExpiredError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeoutExpiredError.d.ts","sourceRoot":"","sources":["../../../src/errors/model/TimeoutExpiredError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IAEjD,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,mBAAmB;IAW5D;;;;;;OAMG;gBAEC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK;CAIpB"}

package/esm/errors/model/TimeoutExpiredError.js

@@ -0,0 +1,26 @@
+import { ErrorSerialiser } from '../ErrorSerialiser.js';
+import { RuntimeError } from './RuntimeError.js';
+/**
+ * Thrown to indicate that an [`Interaction`](https://serenity-js.org/api/core/class/Interaction/), a [`Task`](https://serenity-js.org/api/core/class/Task/) or a test scenario
+ * took longer to execute than the expected timeout.
+ *
+ * @group Errors
+ */
+export class TimeoutExpiredError extends RuntimeError {
+    static fromJSON(serialised) {
+        const error = new TimeoutExpiredError(serialised.message, ErrorSerialiser.deserialise(serialised.cause));
+        error.stack = serialised.stack;
+        return error;
+    }
+    /**
+     * @param message
+     *  Human-readable description of the error
+     *
+     * @param [cause]
+     *  The root cause of this [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/), if any
+     */
+    constructor(message, cause) {
+        super(TimeoutExpiredError, message, cause);
+    }
+}
+//# sourceMappingURL=TimeoutExpiredError.js.map

package/esm/errors/model/TimeoutExpiredError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeoutExpiredError.js","sourceRoot":"","sources":["../../../src/errors/model/TimeoutExpiredError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IAEjD,MAAM,CAAC,QAAQ,CAAC,UAAsB;QAClC,MAAM,KAAK,GAAG,IAAI,mBAAmB,CACjC,UAAU,CAAC,OAAiB,EAC5B,eAAe,CAAC,WAAW,CAAC,UAAU,CAAC,KAA2B,CAAC,CACtE,CAAC;QAEF,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,KAAe,CAAC;QAEzC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACH,YACI,OAAe,EACf,KAAa;QAEb,KAAK,CAAC,mBAAmB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;CACJ"}

package/esm/errors/model/UnknownError.d.ts

@@ -0,0 +1,16 @@
+import type { JSONObject } from 'tiny-types';
+import { RuntimeError } from './RuntimeError.js';
+/**
+ * Thrown to indicate that an unknown error has occurred.
+ *
+ * @group Errors
+ */
+export declare class UnknownError extends RuntimeError {
+    static fromJSON(serialised: JSONObject): UnknownError;
+    /**
+     * @param message - Human-readable description of the error
+     * @param [cause] - The root cause of this [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/), if any
+     */
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=UnknownError.d.ts.map

package/esm/errors/model/UnknownError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnknownError.d.ts","sourceRoot":"","sources":["../../../src/errors/model/UnknownError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAE1C,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,YAAY;IAWrD;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG7C"}

package/esm/errors/model/UnknownError.js

@@ -0,0 +1,22 @@
+import { ErrorSerialiser } from '../ErrorSerialiser.js';
+import { RuntimeError } from './RuntimeError.js';
+/**
+ * Thrown to indicate that an unknown error has occurred.
+ *
+ * @group Errors
+ */
+export class UnknownError extends RuntimeError {
+    static fromJSON(serialised) {
+        const error = new UnknownError(serialised.message, ErrorSerialiser.deserialise(serialised.cause));
+        error.stack = serialised.stack;
+        return error;
+    }
+    /**
+     * @param message - Human-readable description of the error
+     * @param [cause] - The root cause of this [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/), if any
+     */
+    constructor(message, cause) {
+        super(UnknownError, message, cause);
+    }
+}
+//# sourceMappingURL=UnknownError.js.map

package/esm/errors/model/UnknownError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnknownError.js","sourceRoot":"","sources":["../../../src/errors/model/UnknownError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,OAAO,YAAa,SAAQ,YAAY;IAE1C,MAAM,CAAC,QAAQ,CAAC,UAAsB;QAClC,MAAM,KAAK,GAAG,IAAI,YAAY,CAC1B,UAAU,CAAC,OAAiB,EAC5B,eAAe,CAAC,WAAW,CAAC,UAAU,CAAC,KAA2B,CAAC,CACtE,CAAC;QAEF,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,KAAe,CAAC;QAEzC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,YAAY,OAAe,EAAE,KAAa;QACtC,KAAK,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;CACJ"}

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

@@ -0,0 +1,11 @@
+export * from './AssertionError.js';
+export * from './ConfigurationError.js';
+export * from './ImplementationPendingError.js';
+export * from './ListItemNotFoundError.js';
+export * from './LogicError.js';
+export * from './OperationInterruptedError.js';
+export * from './RuntimeError.js';
+export * from './TestCompromisedError.js';
+export * from './TimeoutExpiredError.js';
+export * from './UnknownError.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/model/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC"}

package/esm/errors/model/index.js

@@ -0,0 +1,11 @@
+export * from './AssertionError.js';
+export * from './ConfigurationError.js';
+export * from './ImplementationPendingError.js';
+export * from './ListItemNotFoundError.js';
+export * from './LogicError.js';
+export * from './OperationInterruptedError.js';
+export * from './RuntimeError.js';
+export * from './TestCompromisedError.js';
+export * from './TimeoutExpiredError.js';
+export * from './UnknownError.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/model/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC"}

package/esm/events/ActivityFinished.d.ts

@@ -0,0 +1,16 @@
+import type { ActivityDetails, CorrelationId, Outcome } from '../model/index.js';
+import type { Timestamp } from '../screenplay/index.js';
+import { DomainEvent } from './DomainEvent.js';
+/**
+ * Emitted when an [`Activity`](https://serenity-js.org/api/core/class/Activity/) is finished.
+ *
+ * @group Events
+ */
+export declare abstract class ActivityFinished extends DomainEvent {
+    readonly sceneId: CorrelationId;
+    readonly activityId: CorrelationId;
+    readonly details: ActivityDetails;
+    readonly outcome: Outcome;
+    constructor(sceneId: CorrelationId, activityId: CorrelationId, details: ActivityDetails, outcome: Outcome, timestamp?: Timestamp);
+}
+//# sourceMappingURL=ActivityFinished.d.ts.map

package/esm/events/ActivityFinished.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityFinished.d.ts","sourceRoot":"","sources":["../../src/events/ActivityFinished.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;GAIG;AACH,8BAAsB,gBAAiB,SAAQ,WAAW;aAElC,OAAO,EAAE,aAAa;aACtB,UAAU,EAAE,aAAa;aACzB,OAAO,EAAE,eAAe;aACxB,OAAO,EAAE,OAAO;gBAHhB,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,aAAa,EACzB,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,OAAO,EAChC,SAAS,CAAC,EAAE,SAAS;CAQ5B"}

package/esm/events/ActivityFinished.js

@@ -0,0 +1,25 @@
+import { ensure, isDefined } from 'tiny-types';
+import { DomainEvent } from './DomainEvent.js';
+/**
+ * Emitted when an [`Activity`](https://serenity-js.org/api/core/class/Activity/) is finished.
+ *
+ * @group Events
+ */
+export class ActivityFinished extends DomainEvent {
+    sceneId;
+    activityId;
+    details;
+    outcome;
+    constructor(sceneId, activityId, details, outcome, timestamp) {
+        super(timestamp);
+        this.sceneId = sceneId;
+        this.activityId = activityId;
+        this.details = details;
+        this.outcome = outcome;
+        ensure('sceneId', sceneId, isDefined());
+        ensure('activityId', activityId, isDefined());
+        ensure('details', details, isDefined());
+        ensure('outcome', outcome, isDefined());
+    }
+}
+//# sourceMappingURL=ActivityFinished.js.map

package/esm/events/ActivityFinished.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityFinished.js","sourceRoot":"","sources":["../../src/events/ActivityFinished.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,OAAgB,gBAAiB,SAAQ,WAAW;IAElC;IACA;IACA;IACA;IAJpB,YACoB,OAAsB,EACtB,UAAyB,EACzB,OAAwB,EACxB,OAAgB,EAChC,SAAqB;QAErB,KAAK,CAAC,SAAS,CAAC,CAAC;QAND,YAAO,GAAP,OAAO,CAAe;QACtB,eAAU,GAAV,UAAU,CAAe;QACzB,YAAO,GAAP,OAAO,CAAiB;QACxB,YAAO,GAAP,OAAO,CAAS;QAIhC,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC;CACJ"}

package/esm/events/ActivityRelatedArtifactArchived.d.ts

@@ -0,0 +1,16 @@
+import type { JSONObject } from 'tiny-types';
+import { Path } from '../io/index.js';
+import type { ArtifactType } from '../model/index.js';
+import { CorrelationId, Name } from '../model/index.js';
+import { Timestamp } from '../screenplay/index.js';
+import { ArtifactArchived } from './ArtifactArchived.js';
+/**
+ * @group Events
+ */
+export declare class ActivityRelatedArtifactArchived extends ArtifactArchived {
+    readonly activityId: CorrelationId;
+    static fromJSON(o: JSONObject): ActivityRelatedArtifactArchived;
+    constructor(sceneId: CorrelationId, activityId: CorrelationId, name: Name, type: ArtifactType, path: Path, artifactTimestamp: Timestamp, timestamp?: Timestamp);
+    toJSON(): JSONObject;
+}
+//# sourceMappingURL=ActivityRelatedArtifactArchived.d.ts.map

package/esm/events/ActivityRelatedArtifactArchived.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityRelatedArtifactArchived.d.ts","sourceRoot":"","sources":["../../src/events/ActivityRelatedArtifactArchived.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAC,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAY,aAAa,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,gBAAgB;aAe7C,UAAU,EAAE,aAAa;IAd7C,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,+BAA+B;gBAa3D,OAAO,EAAE,aAAa,EACN,UAAU,EAAE,aAAa,EACzC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,IAAI,EACV,iBAAiB,EAAE,SAAS,EAC5B,SAAS,CAAC,EAAE,SAAS;IAMzB,MAAM,IAAI,UAAU;CAWvB"}

package/esm/events/ActivityRelatedArtifactArchived.js

@@ -0,0 +1,34 @@
+import { ensure, isDefined } from 'tiny-types';
+import { Path } from '../io/index.js';
+import { Artifact, CorrelationId, Name } from '../model/index.js';
+import { Timestamp } from '../screenplay/index.js';
+import { ArtifactArchived } from './ArtifactArchived.js';
+// todo: there should be two types of events here:
+//  - ActivityArtifactGenerated
+//  - SceneArtifactGenerated
+/**
+ * @group Events
+ */
+export class ActivityRelatedArtifactArchived extends ArtifactArchived {
+    activityId;
+    static fromJSON(o) {
+        return new ActivityRelatedArtifactArchived(CorrelationId.fromJSON(o.sceneId), CorrelationId.fromJSON(o.activityId), Name.fromJSON(o.name), Artifact.ofType(o.type), Path.fromJSON(o.path), Timestamp.fromJSON(o.artifactTimestamp), Timestamp.fromJSON(o.timestamp));
+    }
+    constructor(sceneId, activityId, name, type, path, artifactTimestamp, timestamp) {
+        super(sceneId, name, type, path, artifactTimestamp, timestamp);
+        this.activityId = activityId;
+        ensure('activityId', activityId, isDefined());
+    }
+    toJSON() {
+        return {
+            sceneId: this.sceneId.toJSON(),
+            activityId: this.activityId.toJSON(),
+            name: this.name.toJSON(),
+            type: this.type.name,
+            path: this.path.toJSON(),
+            artifactTimestamp: this.artifactTimestamp.toJSON(),
+            timestamp: this.timestamp.toJSON(),
+        };
+    }
+}
+//# sourceMappingURL=ActivityRelatedArtifactArchived.js.map

package/esm/events/ActivityRelatedArtifactArchived.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityRelatedArtifactArchived.js","sourceRoot":"","sources":["../../src/events/ActivityRelatedArtifactArchived.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,kDAAkD;AAClD,+BAA+B;AAC/B,4BAA4B;AAE5B;;GAEG;AACH,MAAM,OAAO,+BAAgC,SAAQ,gBAAgB;IAe7C;IAdpB,MAAM,CAAC,QAAQ,CAAC,CAAa;QACzB,OAAO,IAAI,+BAA+B,CACtC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAiB,CAAC,EAC3C,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAoB,CAAC,EAC9C,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAc,CAAC,EAC/B,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAc,CAAC,EACjC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAc,CAAC,EAC/B,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAA2B,CAAC,EACjD,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAmB,CAAC,CAC5C,CAAC;IACN,CAAC;IAED,YACI,OAAsB,EACN,UAAyB,EACzC,IAAU,EACV,IAAkB,EAClB,IAAU,EACV,iBAA4B,EAC5B,SAAqB;QAErB,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,CAAC,CAAC;QAP/C,eAAU,GAAV,UAAU,CAAe;QAQzC,MAAM,CAAC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,MAAM;QACF,OAAO;YACH,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAC9B,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE;YACpC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YACxB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YACxB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE;YAClD,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;SACrC,CAAC;IACN,CAAC;CACJ"}

package/esm/events/ActivityRelatedArtifactGenerated.d.ts

@@ -0,0 +1,13 @@
+import type { JSONObject } from 'tiny-types';
+import { Artifact, CorrelationId, Name } from '../model/index.js';
+import { Timestamp } from '../screenplay/index.js';
+import { ArtifactGenerated } from './ArtifactGenerated.js';
+/**
+ * @group Events
+ */
+export declare class ActivityRelatedArtifactGenerated extends ArtifactGenerated {
+    readonly activityId: CorrelationId;
+    static fromJSON(o: JSONObject): ActivityRelatedArtifactGenerated;
+    constructor(sceneId: CorrelationId, activityId: CorrelationId, name: Name, artifact: Artifact, timestamp?: Timestamp);
+}
+//# sourceMappingURL=ActivityRelatedArtifactGenerated.d.ts.map