@serenity-js/core 3.37.2 → 3.38.0

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.38.0](https://github.com/serenity-js/serenity-js/compare/v3.37.2...v3.38.0) (2026-01-29)
+
+
+### Features
+
+* **core:** event SceneFinishes includes the outcome of the test scenario ([37cc14e](https://github.com/serenity-js/serenity-js/commit/37cc14ee48a746592e0b9e9f430a2416b150db3e)), closes [#3005](https://github.com/serenity-js/serenity-js/issues/3005)
+* **webdriverio:** support afterTest hooks ([a79c83c](https://github.com/serenity-js/serenity-js/commit/a79c83cf0d2b975f9d7831dbf8cbe6dc1cc4935d)), closes [#3005](https://github.com/serenity-js/serenity-js/issues/3005)
+
+
+
+
+
 ## [3.37.2](https://github.com/serenity-js/serenity-js/compare/v3.37.1...v3.37.2) (2026-01-23)
 
 

package/lib/events/SceneFinishes.d.ts

@@ -1,5 +1,5 @@
 import type { JSONObject } from 'tiny-types';
-import { CorrelationId } from '../model';
+import { CorrelationId, Outcome } from '../model';
 import { Timestamp } from '../screenplay';
 import { DomainEvent } from './DomainEvent';
 /**
@@ -7,11 +7,16 @@ import { DomainEvent } from './DomainEvent';
  * Triggers any clean-up operations that might be required, such as discarding of
  * the [discardable](https://serenity-js.org/api/core/interface/Discardable/) abilities.
  *
+ * The `outcome` property contains the test outcome determined so far, before any cleanup operations.
+ * This allows stage crew members like the WebdriverIO notifier to invoke hooks with the test result
+ * before `waitForNextCue()` is called.
+ *
  * @group Events
  */
 export declare class SceneFinishes extends DomainEvent {
     readonly sceneId: CorrelationId;
+    readonly outcome: Outcome;
     static fromJSON(o: JSONObject): SceneFinishes;
-    constructor(sceneId: CorrelationId, timestamp?: Timestamp);
+    constructor(sceneId: CorrelationId, outcome: Outcome, timestamp?: Timestamp);
 }
 //# sourceMappingURL=SceneFinishes.d.ts.map

package/lib/events/SceneFinishes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SceneFinishes.d.ts","sourceRoot":"","sources":["../../src/events/SceneFinishes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,WAAW;aAStB,OAAO,EAAE,aAAa;IAR1C,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,aAAa;gBAQzB,OAAO,EAAE,aAAa,EACtC,SAAS,CAAC,EAAE,SAAS;CAK5B"}
+{"version":3,"file":"SceneFinishes.d.ts","sourceRoot":"","sources":["../../src/events/SceneFinishes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,OAAO,EAAE,aAAa,EAAuB,OAAO,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,WAAW;aAYtB,OAAO,EAAE,aAAa;aACtB,OAAO,EAAE,OAAO;IAZpC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,aAAa;gBAWzB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,OAAO,EAChC,SAAS,CAAC,EAAE,SAAS;CAM5B"}

package/lib/events/SceneFinishes.js

@@ -10,17 +10,26 @@ const DomainEvent_1 = require("./DomainEvent");
  * Triggers any clean-up operations that might be required, such as discarding of
  * the [discardable](https://serenity-js.org/api/core/interface/Discardable/) abilities.
  *
+ * The `outcome` property contains the test outcome determined so far, before any cleanup operations.
+ * This allows stage crew members like the WebdriverIO notifier to invoke hooks with the test result
+ * before `waitForNextCue()` is called.
+ *
  * @group Events
  */
 class SceneFinishes extends DomainEvent_1.DomainEvent {
     sceneId;
+    outcome;
     static fromJSON(o) {
-        return new SceneFinishes(model_1.CorrelationId.fromJSON(o.sceneId), screenplay_1.Timestamp.fromJSON(o.timestamp));
+        return new SceneFinishes(model_1.CorrelationId.fromJSON(o.sceneId), o.outcome
+            ? model_1.Outcome.fromJSON(o.outcome)
+            : new model_1.ExecutionSuccessful(), screenplay_1.Timestamp.fromJSON(o.timestamp));
     }
-    constructor(sceneId, timestamp) {
+    constructor(sceneId, outcome, timestamp) {
         super(timestamp);
         this.sceneId = sceneId;
+        this.outcome = outcome;
         (0, tiny_types_1.ensure)('sceneId', sceneId, (0, tiny_types_1.isDefined)());
+        (0, tiny_types_1.ensure)('outcome', outcome, (0, tiny_types_1.isDefined)());
     }
 }
 exports.SceneFinishes = SceneFinishes;

package/lib/events/SceneFinishes.js.map

@@ -1 +1 @@
-{"version":3,"file":"SceneFinishes.js","sourceRoot":"","sources":["../../src/events/SceneFinishes.ts"],"names":[],"mappings":";;;AACA,2CAA+C;AAE/C,oCAAyC;AACzC,8CAA0C;AAC1C,+CAA4C;AAE5C;;;;;;GAMG;AACH,MAAa,aAAc,SAAQ,yBAAW;IAStB;IARpB,MAAM,CAAC,QAAQ,CAAC,CAAa;QACzB,OAAO,IAAI,aAAa,CACpB,qBAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAiB,CAAC,EAC3C,sBAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAmB,CAAC,CAC5C,CAAC;IACN,CAAC;IAED,YACoB,OAAsB,EACtC,SAAqB;QAErB,KAAK,CAAC,SAAS,CAAC,CAAC;QAHD,YAAO,GAAP,OAAO,CAAe;QAItC,IAAA,mBAAM,EAAC,SAAS,EAAE,OAAO,EAAE,IAAA,sBAAS,GAAE,CAAC,CAAC;IAC5C,CAAC;CACJ;AAfD,sCAeC"}
+{"version":3,"file":"SceneFinishes.js","sourceRoot":"","sources":["../../src/events/SceneFinishes.ts"],"names":[],"mappings":";;;AACA,2CAA+C;AAG/C,oCAAuE;AACvE,8CAA0C;AAC1C,+CAA4C;AAE5C;;;;;;;;;;GAUG;AACH,MAAa,aAAc,SAAQ,yBAAW;IAYtB;IACA;IAZpB,MAAM,CAAC,QAAQ,CAAC,CAAa;QACzB,OAAO,IAAI,aAAa,CACpB,qBAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAiB,CAAC,EAC3C,CAAC,CAAC,OAAO;YACL,CAAC,CAAC,eAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAA4B,CAAC;YAClD,CAAC,CAAC,IAAI,2BAAmB,EAAE,EAC/B,sBAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAmB,CAAC,CAC5C,CAAC;IACN,CAAC;IAED,YACoB,OAAsB,EACtB,OAAgB,EAChC,SAAqB;QAErB,KAAK,CAAC,SAAS,CAAC,CAAC;QAJD,YAAO,GAAP,OAAO,CAAe;QACtB,YAAO,GAAP,OAAO,CAAS;QAIhC,IAAA,mBAAM,EAAC,SAAS,EAAE,OAAO,EAAE,IAAA,sBAAS,GAAE,CAAC,CAAC;QACxC,IAAA,mBAAM,EAAC,SAAS,EAAE,OAAO,EAAE,IAAA,sBAAS,GAAE,CAAC,CAAC;IAC5C,CAAC;CACJ;AApBD,sCAoBC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/core",
-  "version": "3.37.2",
+  "version": "3.38.0",
   "description": "The core Serenity/JS framework, providing the Screenplay Pattern interfaces, as well as the test reporting and integration infrastructure",
   "author": {
     "name": "Jan Molak",
@@ -74,5 +74,5 @@
   "engines": {
     "node": "^20 || ^22 || ^24"
   },
-  "gitHead": "5544cfdbfd7f3c4d3bb4e492b5d2f233eb5e3a79"
+  "gitHead": "d86152afd35fb815038b3a153e8c53a0b023e4b3"
 }

package/src/events/SceneFinishes.ts

@@ -1,7 +1,8 @@
 import type { JSONObject } from 'tiny-types';
 import { ensure, isDefined } from 'tiny-types';
 
-import { CorrelationId } from '../model';
+import type { SerialisedOutcome } from '../model';
+import { CorrelationId, ExecutionSuccessful, Outcome } from '../model';
 import { Timestamp } from '../screenplay';
 import { DomainEvent } from './DomainEvent';
 
@@ -10,21 +11,30 @@ import { DomainEvent } from './DomainEvent';
  * Triggers any clean-up operations that might be required, such as discarding of
  * the [discardable](https://serenity-js.org/api/core/interface/Discardable/) abilities.
  *
+ * The `outcome` property contains the test outcome determined so far, before any cleanup operations.
+ * This allows stage crew members like the WebdriverIO notifier to invoke hooks with the test result
+ * before `waitForNextCue()` is called.
+ *
  * @group Events
  */
 export class SceneFinishes extends DomainEvent {
     static fromJSON(o: JSONObject): SceneFinishes {
         return new SceneFinishes(
             CorrelationId.fromJSON(o.sceneId as string),
+            o.outcome
+                ? Outcome.fromJSON(o.outcome as SerialisedOutcome)
+                : new ExecutionSuccessful(),
             Timestamp.fromJSON(o.timestamp as string),
         );
     }
 
     constructor(
         public readonly sceneId: CorrelationId,
+        public readonly outcome: Outcome,
         timestamp?: Timestamp,
     ) {
         super(timestamp);
         ensure('sceneId', sceneId, isDefined());
+        ensure('outcome', outcome, isDefined());
     }
 }