@serenity-js/core 3.4.2 → 3.5.0

package/src/events/AsyncOperationAborted.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { CorrelationId, Description } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/AsyncOperationAttempted.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { CorrelationId, Description, Name } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/AsyncOperationCompleted.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { CorrelationId } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/AsyncOperationFailed.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { ErrorSerialiser } from '../errors';
 import { CorrelationId } from '../model';

package/src/events/BusinessRuleDetected.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { BusinessRule, CorrelationId, ScenarioDetails } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/EmitsDomainEvents.ts

@@ -1,11 +1,10 @@
-import { ActivityDetails, CorrelationId } from '../model';
-import { Timestamp } from '../screenplay';
-import { DomainEvent } from './DomainEvent';
+import type { ActivityDetails, CorrelationId } from '../model';
+import type { TellsTime } from '../screenplay';
+import type { DomainEvent } from './DomainEvent';
 
-export interface EmitsDomainEvents {
+export interface EmitsDomainEvents extends TellsTime {
     currentSceneId(): CorrelationId;
     assignNewActivityId(details: ActivityDetails): CorrelationId;
     announce(event: DomainEvent): void;
-    currentTime(): Timestamp;
     waitForNextCue(): Promise<void>,
 }

package/src/events/FeatureNarrativeDetected.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { CorrelationId, Description } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/InteractionFinished.ts

@@ -1,6 +1,7 @@
-import { JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
 
-import { ActivityDetails, CorrelationId, Outcome, SerialisedOutcome } from '../model';
+import type { SerialisedOutcome } from '../model';
+import { ActivityDetails, CorrelationId, Outcome } from '../model';
 import { Timestamp } from '../screenplay';
 import { ActivityFinished } from './ActivityFinished';
 

package/src/events/InteractionStarts.ts

@@ -1,4 +1,4 @@
-import { JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
 
 import { ActivityDetails, CorrelationId } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/RetryableSceneDetected.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { CorrelationId } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/SceneBackgroundDetected.ts

@@ -1,7 +1,8 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { CorrelationId, Description, Name } from '../model';
-import { Timestamp } from '../screenplay';
+import type { Timestamp } from '../screenplay';
 import { DomainEvent } from './DomainEvent';
 
 /**

package/src/events/SceneDescriptionDetected.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { CorrelationId, Description } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/SceneFinished.ts

@@ -1,6 +1,8 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
-import { CorrelationId, Outcome, ScenarioDetails, SerialisedOutcome } from '../model';
+import type { SerialisedOutcome } from '../model';
+import { CorrelationId, Outcome, ScenarioDetails } from '../model';
 import { Timestamp } from '../screenplay';
 import { DomainEvent } from './DomainEvent';
 

package/src/events/SceneFinishes.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { CorrelationId } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/SceneParametersDetected.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { CorrelationId, ScenarioDetails, ScenarioParameters } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/SceneSequenceDetected.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { CorrelationId, ScenarioDetails } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/SceneStarts.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { CorrelationId, ScenarioDetails } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/SceneTagged.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { CorrelationId, Tag } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/SceneTemplateDetected.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { CorrelationId, Description } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/TaskFinished.ts

@@ -1,6 +1,7 @@
-import { JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
 
-import { ActivityDetails, CorrelationId, Outcome, SerialisedOutcome } from '../model';
+import type { SerialisedOutcome } from '../model';
+import { ActivityDetails, CorrelationId, Outcome } from '../model';
 import { Timestamp } from '../screenplay';
 import { ActivityFinished } from './ActivityFinished';
 

package/src/events/TaskStarts.ts

@@ -1,4 +1,4 @@
-import { JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
 
 import { ActivityDetails, CorrelationId } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/TestRunFinished.ts

@@ -1,6 +1,7 @@
-import { JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
 
-import { Outcome, SerialisedOutcome } from '../model';
+import type { SerialisedOutcome } from '../model';
+import { Outcome } from '../model';
 import { Timestamp } from '../screenplay';
 import { DomainEvent } from './DomainEvent';
 

package/src/events/TestRunnerDetected.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { CorrelationId, Name } from '../model';
 import { Timestamp } from '../screenplay';

package/src/events/TestSuiteFinished.ts

@@ -1,6 +1,8 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
-import { Outcome, SerialisedOutcome, TestSuiteDetails } from '../model';
+import type { SerialisedOutcome} from '../model';
+import { Outcome, TestSuiteDetails } from '../model';
 import { Timestamp } from '../screenplay';
 import { DomainEvent } from './DomainEvent';
 

package/src/events/TestSuiteStarts.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
+import { ensure, isDefined } from 'tiny-types';
 
 import { TestSuiteDetails } from '../model';
 import { Timestamp } from '../screenplay';

package/src/instance.ts

@@ -1,7 +1,8 @@
-import { SerenityConfig } from './config';
-import { Actor, Clock } from './screenplay';
+import type { SerenityConfig } from './config';
+import type { Actor} from './screenplay';
+import { Clock } from './screenplay';
 import { Serenity } from './Serenity';
-import { Cast } from './stage';
+import type { Cast } from './stage';
 
 const clock = new Clock();
 

package/src/io/FileSystem.ts

@@ -1,6 +1,6 @@
 import { createId } from '@paralleldrive/cuid2';
-import * as nodeFS from 'fs';
-import { WriteFileOptions } from 'fs';
+import type * as nodeFS from 'fs';
+import type { WriteFileOptions } from 'fs';
 import * as gracefulFS from 'graceful-fs';
 import * as nodeOS from 'os';
 import { promisify } from 'util';

package/src/io/FileSystemLocation.ts

@@ -1,4 +1,5 @@
-import { JSONObject, TinyType } from 'tiny-types';
+import type { JSONObject} from 'tiny-types';
+import { TinyType } from 'tiny-types';
 
 import { Path } from './Path';
 

package/src/io/format.ts

@@ -1,4 +1,4 @@
-import { Answerable } from '../screenplay';
+import type { Answerable } from '../screenplay';
 import { stringified } from './stringified';
 
 /**

package/src/io/inspected.ts

@@ -1,4 +1,5 @@
-import { inspect, InspectOptions } from 'util';
+import type { InspectOptions } from 'util';
+import { inspect } from 'util';
 
 export function inspected(value: unknown, options: InspectOptions = {}): string {
     return inspect(value, {

package/src/io/loader/ClassDescriptionParser.ts

@@ -1,9 +1,9 @@
 import validate from 'validate-npm-package-name';
 
-import { ClassDescription } from '../../config';
+import type { ClassDescription } from '../../config';
 import { ConfigurationError } from '../../errors';
 import { d } from '../format';
-import { ClassDescriptor } from './ClassDescriptor';
+import type { ClassDescriptor } from './ClassDescriptor';
 
 export class ClassDescriptionParser {
     private static validClassNamePattern = /^[A-Za-z]\w+$/;

package/src/io/loader/ClassDescriptor.ts

@@ -1,4 +1,4 @@
-import { JSONValue } from 'tiny-types';
+import type { JSONValue } from 'tiny-types';
 
 export interface ClassDescriptor {
     moduleId: string;

package/src/io/loader/ClassLoader.ts

@@ -1,8 +1,8 @@
-import { ClassDescription } from '../../config';
+import type { ClassDescription } from '../../config';
 import { ConfigurationError } from '../../errors';
 import { d } from '../format';
-import { ClassDescriptionParser } from './ClassDescriptionParser';
-import { ModuleLoader } from './ModuleLoader';
+import type { ClassDescriptionParser } from './ClassDescriptionParser';
+import type { ModuleLoader } from './ModuleLoader';
 
 export class ClassLoader {
     constructor(

package/src/io/stringified.ts

@@ -1,6 +1,6 @@
 import { inspect } from 'util';
 
-import { Answerable } from '../screenplay/Answerable';
+import type { Answerable } from '../screenplay/Answerable';
 import { Question } from '../screenplay/Question';
 
 const indentationPrefix = '  ';

package/src/model/ActivityDetails.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject, TinyType } from 'tiny-types';
+import type { JSONObject} from 'tiny-types';
+import { ensure, isDefined, TinyType } from 'tiny-types';
 
 import { FileSystemLocation } from '../io/FileSystemLocation';
 import { Name } from './Name';

package/src/model/Artifact.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, isString, JSONObject, Predicate, TinyType } from 'tiny-types';
+import type { JSONObject} from 'tiny-types';
+import { ensure, isDefined, isString, Predicate, TinyType } from 'tiny-types';
 
 import { LogicError } from '../errors';
 import * as artifacts from './artifacts';

package/src/model/BusinessRule.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject, TinyType } from 'tiny-types';
+import type { JSONObject} from 'tiny-types';
+import { ensure, isDefined, TinyType } from 'tiny-types';
 
 import { Description } from './Description';
 import { Name } from './Name';

package/src/model/ScenarioDetails.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject, TinyType } from 'tiny-types';
+import type { JSONObject} from 'tiny-types';
+import { ensure, isDefined, TinyType } from 'tiny-types';
 
 import { FileSystemLocation } from '../io';
 import { Category } from './Category';

package/src/model/ScenarioParameters.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, JSONObject, TinyType } from 'tiny-types';
+import type { JSONObject} from 'tiny-types';
+import { ensure, isDefined, TinyType } from 'tiny-types';
 
 import { Description } from './Description';
 import { Name } from './Name';

package/src/model/TestSuiteDetails.ts

@@ -1,4 +1,5 @@
-import { JSONObject, TinyType } from 'tiny-types';
+import type { JSONObject} from 'tiny-types';
+import { TinyType } from 'tiny-types';
 
 import { FileSystemLocation } from '../io';
 import { CorrelationId } from './CorrelationId';

package/src/model/artifacts/HTTPRequestResponse.ts

@@ -1,4 +1,4 @@
-import { JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
 
 import { JSONData } from './JSONData';
 

package/src/model/artifacts/JSONData.ts

@@ -1,4 +1,4 @@
-import { JSONValue } from 'tiny-types';
+import type { JSONValue } from 'tiny-types';
 
 import { Artifact } from '../Artifact';
 

package/src/model/artifacts/TestReport.ts

@@ -1,4 +1,4 @@
-import { JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
 
 import { Artifact } from '../Artifact';
 

package/src/model/outcomes.ts

@@ -1,7 +1,9 @@
 /* eslint-disable @typescript-eslint/explicit-module-boundary-types,unicorn/prefer-math-trunc */
-import { JSONObject, match, TinyType } from 'tiny-types';
+import type { JSONObject} from 'tiny-types';
+import { match, TinyType } from 'tiny-types';
 
-import { AssertionError, ErrorSerialiser } from '../errors';
+import type { AssertionError} from '../errors';
+import { ErrorSerialiser } from '../errors';
 
 export interface SerialisedOutcome extends JSONObject {
     code:    number;

package/src/model/tags/BrowserTag.ts

@@ -1,4 +1,4 @@
-import { JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
 
 import { Tag } from './Tag';
 

package/src/model/tags/ExecutionRetriedTag.ts

@@ -1,4 +1,4 @@
-import { JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
 
 import { Tag } from './Tag';
 

package/src/model/tags/PlatformTag.ts

@@ -1,4 +1,4 @@
-import { JSONObject } from 'tiny-types';
+import type { JSONObject } from 'tiny-types';
 
 import { Tag } from './Tag';
 

package/src/model/tags/Tag.ts

@@ -1,4 +1,5 @@
-import { ensure, isDefined, isGreaterThan, isString, JSONObject, property, TinyType } from 'tiny-types';
+import type { JSONObject} from 'tiny-types';
+import { ensure, isDefined, isGreaterThan, isString, property, TinyType } from 'tiny-types';
 
 import * as TagTypes from './index';
 

package/src/model/tags/Tags.ts

@@ -1,6 +1,7 @@
 import { match } from 'tiny-types';
 
-import { ArbitraryTag, IssueTag, ManualTag, Tag } from './';
+import type { Tag } from './';
+import { ArbitraryTag, IssueTag, ManualTag } from './';
 
 /**
  * @package

package/src/screenplay/Activity.ts

@@ -2,9 +2,9 @@ import path from 'path';
 
 import { ErrorStackParser } from '../errors';
 import { FileSystemLocation, Path } from '../io';
-import { UsesAbilities } from './abilities';
-import { PerformsActivities } from './activities';
-import { AnswersQuestions } from './questions';
+import type { UsesAbilities } from './abilities';
+import type { PerformsActivities } from './activities';
+import type { AnswersQuestions } from './questions';
 
 /**
  * **Activities** represents {@apilink Task|tasks} and {@apilink Interaction|interactions} to be performed by an {@apilink Actor|actor}.

package/src/screenplay/Actor.ts

@@ -1,23 +1,27 @@
 import { ConfigurationError, TestCompromisedError } from '../errors';
 import { ActivityRelatedArtifactGenerated } from '../events';
 import { typeOf } from '../io';
-import { Artifact, Name, } from '../model';
-import { Stage } from '../stage';
-import {
-    Ability,
+import type { Artifact} from '../model';
+import { Name, } from '../model';
+import type { Stage } from '../stage';
+import type {
     AbilityType,
-    AnswerQuestions,
     CanHaveAbilities,
     Discardable,
     Initialisable,
-    PerformActivities,
     UsesAbilities
 } from './abilities';
-import { PerformsActivities } from './activities';
-import { Activity } from './Activity';
-import { Answerable } from './Answerable';
-import { CollectsArtifacts } from './artifacts';
-import { AnswersQuestions } from './questions';
+import {
+    Ability,
+    AnswerQuestions,
+    PerformActivities
+} from './abilities';
+import type { PerformsActivities } from './activities';
+import type { Activity } from './Activity';
+import type { Answerable } from './Answerable';
+import type { CollectsArtifacts } from './artifacts';
+import type { AnswersQuestions } from './questions';
+import type { TellsTime, Timestamp } from './time';
 
 /**
  * **Actors** represent **people** and **external systems** interacting with the system under test.
@@ -82,7 +86,9 @@ export class Actor implements PerformsActivities,
     UsesAbilities,
     CanHaveAbilities<Actor>,
     AnswersQuestions,
-    CollectsArtifacts {
+    CollectsArtifacts,
+    TellsTime
+{
     private readonly abilities: Map<AbilityType<Ability>, Ability> = new Map<AbilityType<Ability>, Ability>();
 
     constructor(
@@ -183,6 +189,13 @@ export class Actor implements PerformsActivities,
         ));
     }
 
+    /**
+     * Returns current time.
+     */
+    currentTime(): Timestamp {
+        return this.stage.currentTime();
+    }
+
     /**
      * Instructs the actor to invoke {@apilink Discardable.discard} method on any
      * {@apilink Discardable} {@apilink Ability} it's been configured with.

package/src/screenplay/Answerable.ts

@@ -1,4 +1,4 @@
-import { Question } from './Question';
+import type { Question } from './Question';
 
 /**
  * A union type that provides a convenient way to represent any value

package/src/screenplay/Answered.ts

@@ -1,4 +1,4 @@
-import { Question } from './Question';
+import type { Question } from './Question';
 
 /**
  * Describes the type of answer a given {@apilink Answerable} would

package/src/screenplay/Interaction.ts

@@ -1,7 +1,7 @@
-import { UsesAbilities } from './abilities';
+import type { UsesAbilities } from './abilities';
 import { Activity } from './Activity';
-import { CollectsArtifacts } from './artifacts';
-import { AnswersQuestions } from './questions';
+import type { CollectsArtifacts } from './artifacts';
+import type { AnswersQuestions } from './questions';
 
 /**
  * **Interactions** are low-level {@apilink Activity|activities} that encapsulate

package/src/screenplay/Optional.ts

@@ -1,4 +1,4 @@
-import { Answerable } from './Answerable';
+import type { Answerable } from './Answerable';
 
 /**
  * `Optional` is a container object, which holds a value that may or may not be "present",

package/src/screenplay/Question.ts

@@ -3,14 +3,14 @@ import * as util from 'util'; // eslint-disable-line unicorn/import-style
 
 import { LogicError } from '../errors';
 import { f, inspectedObject } from '../io';
-import { UsesAbilities } from './abilities';
-import { Answerable } from './Answerable';
+import type { UsesAbilities } from './abilities';
+import type { Answerable } from './Answerable';
 import { Interaction } from './Interaction';
-import { Optional } from './Optional';
-import { AnswersQuestions } from './questions/AnswersQuestions';
+import type { Optional } from './Optional';
+import type { AnswersQuestions } from './questions/AnswersQuestions';
 import { Unanswered } from './questions/Unanswered';
-import { RecursivelyAnswered } from './RecursivelyAnswered';
-import { WithAnswerableProperties } from './WithAnswerableProperties';
+import type { RecursivelyAnswered } from './RecursivelyAnswered';
+import type { WithAnswerableProperties } from './WithAnswerableProperties';
 
 /**
  * **Questions** describe how {@apilink Actor|actors} should query the system under test or the test environment to retrieve some information.

package/src/screenplay/RecursivelyAnswered.ts

@@ -1,4 +1,4 @@
-import { Question } from './Question';
+import type { Question } from './Question';
 
 /**
  * Describes a recursively resolved plain JavaScript {@apilink WithAnswerableProperties}.

package/src/screenplay/Task.ts

@@ -1,5 +1,5 @@
 import { ImplementationPendingError } from '../errors';
-import { PerformsActivities } from './activities';
+import type { PerformsActivities } from './activities';
 import { Activity } from './Activity';
 
 /**

package/src/screenplay/WithAnswerableProperties.ts

@@ -1,5 +1,5 @@
-import { Answerable } from './Answerable';
-import { Question } from './Question';
+import type { Answerable } from './Answerable';
+import type { Question } from './Question';
 
 /**
  * Describes a plain JavaScript object with {@apilink Answerable} properties.

package/src/screenplay/abilities/Ability.ts

@@ -1,5 +1,5 @@
-import { AbilityType } from './AbilityType';
-import { UsesAbilities } from './UsesAbilities';
+import type { AbilityType } from './AbilityType';
+import type { UsesAbilities } from './UsesAbilities';
 
 /**
  * **Abilities** enable {@apilink Actor|actors}

package/src/screenplay/abilities/AbilityType.ts

@@ -1,4 +1,4 @@
-import { Ability } from './Ability';
+import type { Ability } from './Ability';
 
 /**
  * An interface describing the static access method that every {@apilink Ability} class