@serenity-js/core 3.41.2 → 3.42.0

package/esm/errors/RaiseErrors.d.ts

@@ -0,0 +1,57 @@
+import { Ability } from '../screenplay/abilities/Ability.js';
+import type { Stage } from '../stage/Stage.js';
+import type { ErrorOptions } from './ErrorOptions.js';
+import type { RuntimeError } from './model/RuntimeError.js';
+/**
+ * An [`Ability`](https://serenity-js.org/api/core/class/Ability/) that enables an [`Actor`](https://serenity-js.org/api/core/class/Actor/) to create a Serenity/JS [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/)
+ * from within a custom [`Interaction`](https://serenity-js.org/api/core/class/Interaction/).
+ *
+ * The stack trace of an error created this way includes the filesystem location pointing to where the interaction was invoked,
+ * which makes debugging any failures easier.
+ *
+ * :::info Pro tip
+ * The ability to `RaiseErrors` is given to all Serenity/JS actors by default, so you don't need to configure it explicitly.
+ * :::
+ *
+ * ## Raising an error
+ *
+ * ```typescript
+ * import { Interaction, LogicError, RaiseErrors, the } from '@serenity-js/core'
+ * import isPathInside from 'is-path-inside'
+ * import { unlink } from 'fs/promises'
+ *
+ * const RemoveFile = (pathToFile: string) =>
+ *   Interaction.where(the`#actor removes a file at ${ pathToFile }`, async actor => {
+ *
+ *     if (! isPathInside(pathToFile, process.cwd())) {
+ *
+ *       throw RaiseErrors.as(actor).create(LogicError, {
+ *         message: `Removing files outside the current working directory is not allowed`
+ *         diff: {
+ *           expected: process.cwd(),
+ *           actual: pathToFile,
+ *         }
+ *       })
+ *     }
+ *
+ *     await unlink(pathToFile);
+ *   })
+ * ```
+ *
+ * ## Learn more
+ * - [`ErrorOptions`](https://serenity-js.org/api/core/interface/ErrorOptions/)
+ * - [`ErrorFactory`](https://serenity-js.org/api/core/class/ErrorFactory/)
+ * - [`AssertionError`](https://serenity-js.org/api/core/class/AssertionError/)
+ * - [`ConfigurationError`](https://serenity-js.org/api/core/class/ConfigurationError/)
+ * - [`LogicError`](https://serenity-js.org/api/core/class/LogicError/)
+ * - [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/)
+ * - [`TestCompromisedError`](https://serenity-js.org/api/core/class/TestCompromisedError/)
+ *
+ * @group Errors
+ */
+export declare class RaiseErrors extends Ability {
+    private readonly stage;
+    constructor(stage: Stage);
+    create<RE extends RuntimeError>(errorType: new (...args: any[]) => RE, options: ErrorOptions): RE;
+}
+//# sourceMappingURL=RaiseErrors.d.ts.map

package/esm/errors/RaiseErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RaiseErrors.d.ts","sourceRoot":"","sources":["../../src/errors/RaiseErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,WAAY,SAAQ,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAIzC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,EAAE;CAGpG"}

package/esm/errors/RaiseErrors.js

@@ -0,0 +1,59 @@
+import { Ability } from '../screenplay/abilities/Ability.js';
+/**
+ * An [`Ability`](https://serenity-js.org/api/core/class/Ability/) that enables an [`Actor`](https://serenity-js.org/api/core/class/Actor/) to create a Serenity/JS [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/)
+ * from within a custom [`Interaction`](https://serenity-js.org/api/core/class/Interaction/).
+ *
+ * The stack trace of an error created this way includes the filesystem location pointing to where the interaction was invoked,
+ * which makes debugging any failures easier.
+ *
+ * :::info Pro tip
+ * The ability to `RaiseErrors` is given to all Serenity/JS actors by default, so you don't need to configure it explicitly.
+ * :::
+ *
+ * ## Raising an error
+ *
+ * ```typescript
+ * import { Interaction, LogicError, RaiseErrors, the } from '@serenity-js/core'
+ * import isPathInside from 'is-path-inside'
+ * import { unlink } from 'fs/promises'
+ *
+ * const RemoveFile = (pathToFile: string) =>
+ *   Interaction.where(the`#actor removes a file at ${ pathToFile }`, async actor => {
+ *
+ *     if (! isPathInside(pathToFile, process.cwd())) {
+ *
+ *       throw RaiseErrors.as(actor).create(LogicError, {
+ *         message: `Removing files outside the current working directory is not allowed`
+ *         diff: {
+ *           expected: process.cwd(),
+ *           actual: pathToFile,
+ *         }
+ *       })
+ *     }
+ *
+ *     await unlink(pathToFile);
+ *   })
+ * ```
+ *
+ * ## Learn more
+ * - [`ErrorOptions`](https://serenity-js.org/api/core/interface/ErrorOptions/)
+ * - [`ErrorFactory`](https://serenity-js.org/api/core/class/ErrorFactory/)
+ * - [`AssertionError`](https://serenity-js.org/api/core/class/AssertionError/)
+ * - [`ConfigurationError`](https://serenity-js.org/api/core/class/ConfigurationError/)
+ * - [`LogicError`](https://serenity-js.org/api/core/class/LogicError/)
+ * - [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/)
+ * - [`TestCompromisedError`](https://serenity-js.org/api/core/class/TestCompromisedError/)
+ *
+ * @group Errors
+ */
+export class RaiseErrors extends Ability {
+    stage;
+    constructor(stage) {
+        super();
+        this.stage = stage;
+    }
+    create(errorType, options) {
+        return this.stage.createError(errorType, options);
+    }
+}
+//# sourceMappingURL=RaiseErrors.js.map

package/esm/errors/RaiseErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RaiseErrors.js","sourceRoot":"","sources":["../../src/errors/RaiseErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAK7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,OAAO,WAAY,SAAQ,OAAO;IACP;IAA7B,YAA6B,KAAY;QACrC,KAAK,EAAE,CAAC;QADiB,UAAK,GAAL,KAAK,CAAO;IAEzC,CAAC;IAED,MAAM,CAA0B,SAAqC,EAAE,OAAqB;QACxF,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;CACJ"}

package/esm/errors/diff/AnsiDiffFormatter.d.ts

@@ -0,0 +1,28 @@
+import type { Options } from 'chalk';
+import type { DiffFormatter } from './DiffFormatter.js';
+/**
+ * A [`DiffFormatter`](https://serenity-js.org/api/core/interface/DiffFormatter/) that uses [ANSI escape codes](https://en.wikipedia.org/wiki/ANSI_escape_code)
+ * to format the output.
+ *
+ * @group Errors
+ */
+export declare class AnsiDiffFormatter implements DiffFormatter {
+    private readonly chalk;
+    /**
+     * Instantiates an `AnsiDiffFormatter`, configured with colour support options for [Chalk](https://github.com/chalk/chalk).
+     * When no `chalkOptions` object is provided, Chalk will auto-detect colour support automatically based on the execution environment.
+     *
+     * Available colour support levels:
+     * - `0` - All colours disabled.
+     * - `1` - Basic 16 colours support.
+     * - `2` - ANSI 256 colours support.
+     * - `3` - Truecolor - 16 million colours support.
+     *
+     * @param chalkOptions
+     */
+    constructor(chalkOptions?: Options);
+    expected(line: string): string;
+    received(line: string): string;
+    unchanged(line: string): string;
+}
+//# sourceMappingURL=AnsiDiffFormatter.d.ts.map

package/esm/errors/diff/AnsiDiffFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnsiDiffFormatter.d.ts","sourceRoot":"","sources":["../../../src/errors/diff/AnsiDiffFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,OAAO,EAAE,MAAM,OAAO,CAAC;AAK5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAE9B;;;;;;;;;;;OAWG;gBACS,YAAY,CAAC,EAAE,OAAO;IAIlC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGlC"}

package/esm/errors/diff/AnsiDiffFormatter.js

@@ -0,0 +1,36 @@
+import chalk from 'chalk';
+const ChalkInstance = chalk.Instance;
+/**
+ * A [`DiffFormatter`](https://serenity-js.org/api/core/interface/DiffFormatter/) that uses [ANSI escape codes](https://en.wikipedia.org/wiki/ANSI_escape_code)
+ * to format the output.
+ *
+ * @group Errors
+ */
+export class AnsiDiffFormatter {
+    chalk;
+    /**
+     * Instantiates an `AnsiDiffFormatter`, configured with colour support options for [Chalk](https://github.com/chalk/chalk).
+     * When no `chalkOptions` object is provided, Chalk will auto-detect colour support automatically based on the execution environment.
+     *
+     * Available colour support levels:
+     * - `0` - All colours disabled.
+     * - `1` - Basic 16 colours support.
+     * - `2` - ANSI 256 colours support.
+     * - `3` - Truecolor - 16 million colours support.
+     *
+     * @param chalkOptions
+     */
+    constructor(chalkOptions) {
+        this.chalk = new ChalkInstance(chalkOptions);
+    }
+    expected(line) {
+        return this.chalk.green(line);
+    }
+    received(line) {
+        return this.chalk.red(line);
+    }
+    unchanged(line) {
+        return line;
+    }
+}
+//# sourceMappingURL=AnsiDiffFormatter.js.map

package/esm/errors/diff/AnsiDiffFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnsiDiffFormatter.js","sourceRoot":"","sources":["../../../src/errors/diff/AnsiDiffFormatter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC;AAIrC;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACT,KAAK,CAAQ;IAE9B;;;;;;;;;;;OAWG;IACH,YAAY,YAAsB;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC;IACjD,CAAC;IAED,QAAQ,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,QAAQ,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,SAAS,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ"}

package/esm/errors/diff/DiffFormatter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Formats text representing expected, received, and unchanged lines of a diff
+ * produced by the [`ErrorFactory`](https://serenity-js.org/api/core/class/ErrorFactory/), so that they can be presented to a developer
+ * in a visually distinctive way.
+ *
+ * @group Errors
+ */
+export interface DiffFormatter {
+    expected(line: string): string;
+    received(line: string): string;
+    unchanged(line: string): string;
+}
+//# sourceMappingURL=DiffFormatter.d.ts.map

package/esm/errors/diff/DiffFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiffFormatter.d.ts","sourceRoot":"","sources":["../../../src/errors/diff/DiffFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACnC"}

package/esm/errors/diff/DiffFormatter.js

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

package/esm/errors/diff/DiffFormatter.js.map

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

package/esm/errors/diff/NoOpDiffFormatter.d.ts

@@ -0,0 +1,12 @@
+import type { DiffFormatter } from './DiffFormatter.js';
+/**
+ * A no-op [`DiffFormatter`](https://serenity-js.org/api/core/interface/DiffFormatter/) that produces output identical to input.
+ *
+ * @group Errors
+ */
+export declare class NoOpDiffFormatter implements DiffFormatter {
+    expected(line: string): string;
+    received(line: string): string;
+    unchanged(line: string): string;
+}
+//# sourceMappingURL=NoOpDiffFormatter.d.ts.map

package/esm/errors/diff/NoOpDiffFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoOpDiffFormatter.d.ts","sourceRoot":"","sources":["../../../src/errors/diff/NoOpDiffFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGlC"}

package/esm/errors/diff/NoOpDiffFormatter.js

@@ -0,0 +1,17 @@
+/**
+ * A no-op [`DiffFormatter`](https://serenity-js.org/api/core/interface/DiffFormatter/) that produces output identical to input.
+ *
+ * @group Errors
+ */
+export class NoOpDiffFormatter {
+    expected(line) {
+        return line;
+    }
+    received(line) {
+        return line;
+    }
+    unchanged(line) {
+        return line;
+    }
+}
+//# sourceMappingURL=NoOpDiffFormatter.js.map

package/esm/errors/diff/NoOpDiffFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoOpDiffFormatter.js","sourceRoot":"","sources":["../../../src/errors/diff/NoOpDiffFormatter.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAC1B,QAAQ,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,QAAQ,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,SAAS,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ"}

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

@@ -0,0 +1,4 @@
+export * from './AnsiDiffFormatter.js';
+export * from './DiffFormatter.js';
+export * from './NoOpDiffFormatter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/diff/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/esm/errors/diff/index.js

@@ -0,0 +1,4 @@
+export * from './AnsiDiffFormatter.js';
+export * from './DiffFormatter.js';
+export * from './NoOpDiffFormatter.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/diff/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/esm/errors/index.d.ts

@@ -0,0 +1,8 @@
+export * from './diff/index.js';
+export * from './model/index.js';
+export { ErrorSerialiser } from './ErrorSerialiser.js';
+export { ErrorStackParser } from './ErrorStackParser.js';
+export { ErrorFactory } from './ErrorFactory.js';
+export type { ErrorOptions } from './ErrorOptions.js';
+export * from './RaiseErrors.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAiBA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,cAAc,kBAAkB,CAAC"}

package/esm/errors/index.js

@@ -0,0 +1,15 @@
+/* eslint-disable simple-import-sort/imports */
+import { AssertionError, ConfigurationError, ImplementationPendingError, LogicError, OperationInterruptedError, TestCompromisedError, TimeoutExpiredError, UnknownError } from './model/index.js';
+import { ErrorSerialiser } from './ErrorSerialiser.js';
+/* eslint-enable simple-import-sort/imports */
+// todo: export ErrorSerialiser as an instance to avoid static method calls
+ErrorSerialiser.registerErrorTypes(AssertionError, ConfigurationError, ImplementationPendingError, LogicError, OperationInterruptedError, TestCompromisedError, TimeoutExpiredError, UnknownError);
+export * from './diff/index.js';
+export * from './model/index.js';
+/* eslint-disable simple-import-sort/exports -- Keep this directive: export order matters to avoid circular dependency (ErrorFactory -> io -> screenplay/Question -> errors -> ErrorStackParser). Do not auto-fix. */
+export { ErrorSerialiser } from './ErrorSerialiser.js';
+export { ErrorStackParser } from './ErrorStackParser.js';
+export { ErrorFactory } from './ErrorFactory.js';
+export * from './RaiseErrors.js';
+/* eslint-enable simple-import-sort/exports */
+//# sourceMappingURL=index.js.map

package/esm/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,UAAU,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAClM,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,8CAA8C;AAE9C,2EAA2E;AAC3E,eAAe,CAAC,kBAAkB,CAC9B,cAAc,EACd,kBAAkB,EAClB,0BAA0B,EAC1B,UAAU,EACV,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,CACf,CAAC;AAEF,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAEjC,qNAAqN;AACrN,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,cAAc,kBAAkB,CAAC;AACjC,8CAA8C"}

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

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

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

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

package/esm/errors/model/AssertionError.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"AssertionError.js","sourceRoot":"","sources":["../../../src/errors/model/AssertionError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,YAAY;IAE5C,MAAM,CAAC,QAAQ,CAAC,UAAsB;QAClC,MAAM,KAAK,GAAG,IAAI,cAAc,CAC5B,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,cAAc,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;CACJ"}

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

@@ -0,0 +1,16 @@
+import type { JSONObject } from 'tiny-types';
+import { RuntimeError } from './RuntimeError.js';
+/**
+ * Thrown to indicate that a test framework or test suite configuration error occurred.
+ *
+ * @group Errors
+ */
+export declare class ConfigurationError extends RuntimeError {
+    static fromJSON(serialised: JSONObject): ConfigurationError;
+    /**
+     * @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=ConfigurationError.d.ts.map

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

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

package/esm/errors/model/ConfigurationError.js

@@ -0,0 +1,22 @@
+import { ErrorSerialiser } from '../ErrorSerialiser.js';
+import { RuntimeError } from './RuntimeError.js';
+/**
+ * Thrown to indicate that a test framework or test suite configuration error occurred.
+ *
+ * @group Errors
+ */
+export class ConfigurationError extends RuntimeError {
+    static fromJSON(serialised) {
+        const error = new ConfigurationError(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(ConfigurationError, message, cause);
+    }
+}
+//# sourceMappingURL=ConfigurationError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigurationError.js","sourceRoot":"","sources":["../../../src/errors/model/ConfigurationError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAEhD,MAAM,CAAC,QAAQ,CAAC,UAAsB;QAClC,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAChC,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,kBAAkB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;CACJ"}

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

@@ -0,0 +1,37 @@
+import type { JSONObject } from 'tiny-types';
+import { RuntimeError } from './RuntimeError.js';
+/**
+ * Thrown to indicate that the [`Actor`](https://serenity-js.org/api/core/class/Actor/) attempted to perform
+ * a [`Task`](https://serenity-js.org/api/core/class/Task/) or [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) that hasn't been implemented yet.
+ *
+ * ## A pending Task
+ *
+ * ```ts
+ * import { Task } from '@serenity-js/core'
+ *
+ * // A pending Task is one that encapsulates no other activities
+ * const Authenticate = () =>
+ *   Task.where(`#actor authenticates with the service up a test database` )
+ * ```
+ *
+ * ## A pending Interaction
+ *
+ * ```ts
+ * import { Interaction } from '@serenity-js/core'
+ *
+ * // A pending Interaction is one that doesn't perform any action
+ * const DoubleClick = () =>
+ *   Interaction.where(`#actor double-clicks`)
+ * ```
+ *
+ * @group Errors
+ */
+export declare class ImplementationPendingError extends RuntimeError {
+    static fromJSON(serialised: JSONObject): ImplementationPendingError;
+    /**
+     * @param {string} message - Human-readable description of the error
+     * @param {Error} [cause] - The root cause of this [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/), if any
+     */
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=ImplementationPendingError.d.ts.map

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

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

package/esm/errors/model/ImplementationPendingError.js

@@ -0,0 +1,43 @@
+import { ErrorSerialiser } from '../ErrorSerialiser.js';
+import { RuntimeError } from './RuntimeError.js';
+/**
+ * Thrown to indicate that the [`Actor`](https://serenity-js.org/api/core/class/Actor/) attempted to perform
+ * a [`Task`](https://serenity-js.org/api/core/class/Task/) or [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) that hasn't been implemented yet.
+ *
+ * ## A pending Task
+ *
+ * ```ts
+ * import { Task } from '@serenity-js/core'
+ *
+ * // A pending Task is one that encapsulates no other activities
+ * const Authenticate = () =>
+ *   Task.where(`#actor authenticates with the service up a test database` )
+ * ```
+ *
+ * ## A pending Interaction
+ *
+ * ```ts
+ * import { Interaction } from '@serenity-js/core'
+ *
+ * // A pending Interaction is one that doesn't perform any action
+ * const DoubleClick = () =>
+ *   Interaction.where(`#actor double-clicks`)
+ * ```
+ *
+ * @group Errors
+ */
+export class ImplementationPendingError extends RuntimeError {
+    static fromJSON(serialised) {
+        const error = new ImplementationPendingError(serialised.message, ErrorSerialiser.deserialise(serialised.cause));
+        error.stack = serialised.stack;
+        return error;
+    }
+    /**
+     * @param {string} message - Human-readable description of the error
+     * @param {Error} [cause] - The root cause of this [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/), if any
+     */
+    constructor(message, cause) {
+        super(ImplementationPendingError, message, cause);
+    }
+}
+//# sourceMappingURL=ImplementationPendingError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ImplementationPendingError.js","sourceRoot":"","sources":["../../../src/errors/model/ImplementationPendingError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,0BAA2B,SAAQ,YAAY;IAExD,MAAM,CAAC,QAAQ,CAAC,UAAsB;QAClC,MAAM,KAAK,GAAG,IAAI,0BAA0B,CACxC,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,0BAA0B,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;CACJ"}

package/esm/errors/model/ListItemNotFoundError.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
+ * can't be executed due to no items are found in a list.
+ *
+ * For example, it's not possible to get the first() or the last() item of a list
+ * if the list is empty.
+ *
+ * @group Errors
+ */
+export declare class ListItemNotFoundError extends RuntimeError {
+    static fromJSON(serialised: JSONObject): ListItemNotFoundError;
+    /**
+     * @param message - Human-readable description of the error
+     * @param [cause] - The root cause of this [`ListItemNotFoundError`](https://serenity-js.org/api/core/class/ListItemNotFoundError/), if any
+     */
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=ListItemNotFoundError.d.ts.map

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

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

package/esm/errors/model/ListItemNotFoundError.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
+ * can't be executed due to no items are found in a list.
+ *
+ * For example, it's not possible to get the first() or the last() item of a list
+ * if the list is empty.
+ *
+ * @group Errors
+ */
+export class ListItemNotFoundError extends RuntimeError {
+    static fromJSON(serialised) {
+        const error = new ListItemNotFoundError(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 [`ListItemNotFoundError`](https://serenity-js.org/api/core/class/ListItemNotFoundError/), if any
+     */
+    constructor(message, cause) {
+        super(ListItemNotFoundError, message, cause);
+    }
+}
+//# sourceMappingURL=ListItemNotFoundError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ListItemNotFoundError.js","sourceRoot":"","sources":["../../../src/errors/model/ListItemNotFoundError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IAEnD,MAAM,CAAC,QAAQ,CAAC,UAAsB;QAClC,MAAM,KAAK,GAAG,IAAI,qBAAqB,CACnC,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,qBAAqB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;CACJ"}

package/esm/errors/model/LogicError.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
+ * can't be executed due to a logical error.
+ *
+ * For example, it's not possible to assert on the last HTTP Response if the request
+ * hasn't been performed yet.
+ *
+ * @group Errors
+ */
+export declare class LogicError extends RuntimeError {
+    static fromJSON(serialised: JSONObject): LogicError;
+    /**
+     * @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=LogicError.d.ts.map

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

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

package/esm/errors/model/LogicError.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
+ * can't be executed due to a logical error.
+ *
+ * For example, it's not possible to assert on the last HTTP Response if the request
+ * hasn't been performed yet.
+ *
+ * @group Errors
+ */
+export class LogicError extends RuntimeError {
+    static fromJSON(serialised) {
+        const error = new LogicError(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(LogicError, message, cause);
+    }
+}
+//# sourceMappingURL=LogicError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LogicError.js","sourceRoot":"","sources":["../../../src/errors/model/LogicError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,OAAO,UAAW,SAAQ,YAAY;IAExC,MAAM,CAAC,QAAQ,CAAC,UAAsB;QAClC,MAAM,KAAK,GAAG,IAAI,UAAU,CACxB,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,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;CACJ"}