@serenity-js/webdriverio 2.32.5 → 3.0.0-rc.0

package/lib/screenplay/models/WebdriverIOPageElement.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebdriverIOPageElement = void 0;
+const web_1 = require("@serenity-js/web");
+class WebdriverIOPageElement extends web_1.PageElement {
+    of(parent) {
+        return new WebdriverIOPageElement(() => parent.nativeElement(), this.locator);
+    }
+    async clearValue() {
+        const element = await this.nativeElement();
+        return element.clearValue();
+    }
+    async click() {
+        const element = await this.nativeElement();
+        return element.click();
+    }
+    async doubleClick() {
+        const element = await this.nativeElement();
+        return element.doubleClick();
+    }
+    async enterValue(value) {
+        const element = await this.nativeElement();
+        return element.addValue(value);
+    }
+    async scrollIntoView() {
+        const element = await this.nativeElement();
+        return element.scrollIntoView();
+    }
+    async hoverOver() {
+        const element = await this.nativeElement();
+        return element.moveTo();
+    }
+    async rightClick() {
+        const element = await this.nativeElement();
+        return element.click({ button: 'right' });
+    }
+    async attribute(name) {
+        const element = await this.nativeElement();
+        return element.getAttribute(name);
+    }
+    async text() {
+        const element = await this.nativeElement();
+        return element.getText();
+    }
+    async value() {
+        const element = await this.nativeElement();
+        return element.getValue();
+    }
+    async isActive() {
+        const element = await this.nativeElement();
+        return element.isFocused();
+    }
+    async isClickable() {
+        const element = await this.nativeElement();
+        return element.isClickable();
+    }
+    async isDisplayed() {
+        const element = await this.nativeElement();
+        return element.isDisplayed();
+    }
+    async isEnabled() {
+        const element = await this.nativeElement();
+        return element.isEnabled();
+    }
+    async isPresent() {
+        const element = await this.nativeElement();
+        return element.isExisting();
+    }
+    async isSelected() {
+        const element = await this.nativeElement();
+        return element.isSelected();
+    }
+}
+exports.WebdriverIOPageElement = WebdriverIOPageElement;
+//# sourceMappingURL=WebdriverIOPageElement.js.map

package/lib/screenplay/models/WebdriverIOPageElement.js.map

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

package/lib/screenplay/models/WebdriverIOPageElements.d.ts

@@ -0,0 +1,15 @@
+import { PageElement, PageElements } from '@serenity-js/web';
+import * as wdio from 'webdriverio';
+import { WebdriverIONativeElementRoot } from './WebdriverIONativeElementRoot';
+import { WebdriverIOPageElement } from './WebdriverIOPageElement';
+export declare class WebdriverIOPageElements extends PageElements<WebdriverIONativeElementRoot, wdio.ElementArray, wdio.Element<'async'>> {
+    of(parent: PageElement<WebdriverIONativeElementRoot, wdio.Element<'async'>>): WebdriverIOPageElements;
+    count(): Promise<number>;
+    first(): Promise<WebdriverIOPageElement>;
+    last(): Promise<WebdriverIOPageElement>;
+    get(index: number): Promise<WebdriverIOPageElement>;
+    private elementAt;
+    map<O>(fn: (element: PageElement, index?: number, elements?: PageElements) => Promise<O> | O): Promise<O[]>;
+    filter(fn: (element: PageElement, index?: number) => Promise<boolean> | boolean): WebdriverIOPageElements;
+    forEach(fn: (element: PageElement, index?: number, elements?: PageElements) => Promise<void> | void): Promise<void>;
+}

package/lib/screenplay/models/WebdriverIOPageElements.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebdriverIOPageElements = void 0;
+const core_1 = require("@serenity-js/core");
+const web_1 = require("@serenity-js/web");
+const WebdriverIOPageElement_1 = require("./WebdriverIOPageElement");
+class WebdriverIOPageElements extends web_1.PageElements {
+    of(parent) {
+        return new WebdriverIOPageElements(() => parent.nativeElement(), this.locator);
+    }
+    async count() {
+        const elements = await this.nativeElementList();
+        return elements.length;
+    }
+    first() {
+        return this.elementAt(0);
+    }
+    async last() {
+        const elements = await this.nativeElementList();
+        const index = elements.length - 1;
+        return this.elementAt(index);
+    }
+    get(index) {
+        return this.elementAt(index);
+    }
+    async elementAt(index) {
+        const elements = await this.nativeElementList();
+        if (!elements[index]) {
+            throw new core_1.LogicError(`There's no item at index ${index}`);
+        }
+        return new WebdriverIOPageElement_1.WebdriverIOPageElement(this.context, () => elements[index]);
+    }
+    async map(fn) {
+        const elements = await this.nativeElementList();
+        return Promise.all(elements.map((element, index) => fn(new WebdriverIOPageElement_1.WebdriverIOPageElement(this.context, () => element), index, this)));
+    }
+    filter(fn) {
+        return new WebdriverIOPageElements(this.context, async (context) => {
+            const elements = await this.locator(context);
+            const matching = await Promise.all(elements.map(async (nativeElement, index) => {
+                const element = new WebdriverIOPageElement_1.WebdriverIOPageElement(this.context, () => nativeElement);
+                const matches = await fn(element, index);
+                return matches
+                    ? nativeElement
+                    : undefined;
+            }));
+            const results = matching.filter((element) => {
+                return element !== undefined;
+            });
+            results.selector = elements.selector;
+            results.parent = elements.parent;
+            results.foundWith = elements.foundWith;
+            results.props = elements.props;
+            return results;
+        });
+    }
+    async forEach(fn) {
+        const elements = await this.nativeElementList();
+        return elements.reduce((previous, element, index) => {
+            return previous.then(() => fn(new WebdriverIOPageElement_1.WebdriverIOPageElement(this.context, () => element), index, this));
+        }, Promise.resolve());
+    }
+}
+exports.WebdriverIOPageElements = WebdriverIOPageElements;
+//# sourceMappingURL=WebdriverIOPageElements.js.map

package/lib/screenplay/models/WebdriverIOPageElements.js.map

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

package/lib/screenplay/models/index.d.ts

@@ -0,0 +1,6 @@
+export * from './WebdriverIOCookie';
+export * from './WebdriverIOModalDialog';
+export * from './WebdriverIONativeElementRoot';
+export * from './WebdriverIOPage';
+export * from './WebdriverIOPageElement';
+export * from './WebdriverIOPageElements';

package/lib/{input → screenplay/models}/index.js

@@ -10,5 +10,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./Key"), exports);
+__exportStar(require("./WebdriverIOCookie"), exports);
+__exportStar(require("./WebdriverIOModalDialog"), exports);
+__exportStar(require("./WebdriverIONativeElementRoot"), exports);
+__exportStar(require("./WebdriverIOPage"), exports);
+__exportStar(require("./WebdriverIOPageElement"), exports);
+__exportStar(require("./WebdriverIOPageElements"), exports);
 //# sourceMappingURL=index.js.map

package/lib/screenplay/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,sDAAoC;AACpC,2DAAyC;AACzC,iEAA+C;AAC/C,oDAAkC;AAClC,2DAAyC;AACzC,4DAA0C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/webdriverio",
-  "version": "2.32.5",
+  "version": "3.0.0-rc.0",
   "description": "Serenity/JS reporter and Screenplay Pattern library for WebdriverIO",
   "author": {
     "name": "Jan Molak",
@@ -33,12 +33,7 @@
     "clean": "rimraf .nyc_output lib target",
     "lint": "eslint --ext ts --config ../../.eslintrc.js .",
     "lint:fix": "npm run lint -- --fix",
-    "test": "npm run test:mocha && npm run test:wdio",
-    "test:mocha": "nyc --report-dir ../../target/coverage/webdriverio/mocha mocha --config ../../.mocharc.yml 'spec/adapter/**/*.spec.*'",
-    "test:wdio": "cross-env PORT=8080 start-server-and-test test:wdio:start-server http://localhost:8080 test:wdio:run",
-    "test:wdio:start-server": "static-content-server",
-    "test:wdio:run": "nyc --report-dir ../../target/coverage/webdriverio/wdio wdio ./spec/wdio.conf.ts",
-    "wdio": "wdio ./spec/wdio.conf.ts",
+    "test": "nyc --report-dir ../../target/coverage/webdriverio/mocha mocha --config ../../.mocharc.yml 'spec/adapter/**/*.spec.*'",
     "compile": "tsc --project tsconfig.json",
     "site": "esdoc -c .esdoc.js"
   },
@@ -50,11 +45,12 @@
     "url": "https://github.com/serenity-js/serenity-js/issues"
   },
   "engines": {
-    "node": "^12 || ^14 || ^16",
+    "node": "^14 || ^16",
     "npm": "^6 || ^7 || ^8"
   },
   "dependencies": {
-    "@serenity-js/core": "2.32.5",
+    "@serenity-js/core": "3.0.0-rc.0",
+    "@serenity-js/web": "3.0.0-rc.0",
     "@wdio/reporter": "^7.16.3",
     "@wdio/types": "^7.16.3",
     "deepmerge": "^4.2.2",
@@ -62,10 +58,11 @@
     "tiny-types": "^1.16.1"
   },
   "peerDependencies": {
-    "@serenity-js/cucumber": "^2.29.0",
-    "@serenity-js/jasmine": "^2.29.0",
-    "@serenity-js/mocha": "^2.29.0",
-    "@wdio/cli": "^7.16.10"
+    "@serenity-js/cucumber": "^2.32.5",
+    "@serenity-js/jasmine": "^2.32.5",
+    "@serenity-js/mocha": "^2.32.5",
+    "@wdio/cli": "^7.16.10",
+    "webdriverio": "^7.16.10"
   },
   "peerDependenciesMeta": {
     "@serenity-js/cucumber": {
@@ -81,13 +78,6 @@
   "devDependencies": {
     "@documentation/esdoc-template": "2.0.0",
     "@integration/testing-tools": "2.0.0",
-    "@integration/web-testing-tools": "2.0.0",
-    "@serenity-js/assertions": "2.32.5",
-    "@serenity-js/console-reporter": "2.32.5",
-    "@serenity-js/cucumber": "2.32.5",
-    "@serenity-js/jasmine": "2.32.5",
-    "@serenity-js/mocha": "2.32.5",
-    "@serenity-js/rest": "2.32.5",
     "@types/mocha": "^9.0.0",
     "@wdio/cli": "^7.16.10",
     "@wdio/devtools-service": "^7.16.10",
@@ -122,5 +112,5 @@
     "cache": true,
     "all": false
   },
-  "gitHead": "d6dce465bdafee180a8f2af2a27b676c1654c853"
+  "gitHead": "a63381d088cc068bc3edcbd1eb59a7e609cb6a8c"
 }

package/src/adapter/WebdriverIOFrameworkAdapter.ts

@@ -44,6 +44,8 @@ export class WebdriverIOFrameworkAdapter {
         ]));
 
         this.notifier = new WebdriverIONotifier(
+            config,
+            capabilities,
             reporter,
             this.adapter.successThreshold(),
             cid,

package/src/adapter/WebdriverIONotifier.ts

@@ -1,7 +1,8 @@
 import { LogicError, Stage, StageCrewMember } from '@serenity-js/core';
-import { DomainEvent, SceneFinished, SceneStarts, TestSuiteFinished, TestSuiteStarts } from '@serenity-js/core/lib/events';
+import { AsyncOperationAttempted, AsyncOperationCompleted, DomainEvent, SceneFinished, SceneStarts, TestRunFinishes, TestSuiteFinished, TestSuiteStarts } from '@serenity-js/core/lib/events';
 import {
     CorrelationId,
+    Description,
     ExecutionCompromised,
     ExecutionFailedWithAssertionError,
     ExecutionFailedWithError,
@@ -12,20 +13,35 @@ import {
     ProblemIndication,
     TestSuiteDetails,
 } from '@serenity-js/core/lib/model';
-import { Suite } from '@wdio/reporter/build/stats/suite';
-import { Test } from '@wdio/reporter/build/stats/test';
+import { Suite as suiteStats } from '@wdio/reporter/build/stats/suite';
+import { Test as testStats } from '@wdio/reporter/build/stats/test';
+import { RemoteCapability } from '@wdio/types/build/Capabilities';
+import * as frameworks from '@wdio/types/build/Frameworks';
 import type { EventEmitter } from 'events';
 import { match } from 'tiny-types';
 
+import { WebdriverIOConfig } from './WebdriverIOConfig';
+
 /**
  * @package
  */
 export class WebdriverIONotifier implements StageCrewMember {
 
+    /**
+     * We don't have access to the "context" object produced by Mocha,
+     * and can't assume that other test runners have a similar concept.
+     * Since, at the time of writing, none of the WebdriverIO rely on this parameter
+     * using a dummy seems to be sufficient.
+     * @private
+     */
+    private static dummmyContext = {};
+
     private readonly events = new EventLog();
     private readonly suites: TestSuiteDetails[] = [];
 
     constructor(
+        private readonly config: WebdriverIOConfig,
+        private readonly capabilities: RemoteCapability,
         private readonly reporter: EventEmitter,
         private readonly successThreshold: Outcome | { Code: number },
         private readonly cid: string,
@@ -46,28 +62,42 @@ export class WebdriverIONotifier implements StageCrewMember {
             .when(TestSuiteFinished,        WebdriverIONotifier.prototype.onTestSuiteFinished.bind(this))
             .when(SceneStarts,              WebdriverIONotifier.prototype.onSceneStarts.bind(this))
             .when(SceneFinished,            WebdriverIONotifier.prototype.onSceneFinished.bind(this))
+            .when(TestRunFinishes,          WebdriverIONotifier.prototype.onTestRunFinishes.bind(this))
             .else(() => void 0);
     }
 
+    private onTestRunFinishes(): Promise<any> {
+        return this.invokeHooks('after', this.config.after, [this.failures, this.capabilities, this.specs]);
+    }
+
     failureCount(): number {
         return this.failures;
     }
 
-    private onTestSuiteStarts(started: TestSuiteStarts) {
+    private onTestSuiteStarts(started: TestSuiteStarts): Promise<any> {
         this.events.record(started.details.correlationId, started);
-        this.reporter.emit('suite:start', this.suiteStartEventFrom(started));
+
+        const suite = this.suiteStartEventFrom(started);
+
+        this.reporter.emit('suite:start', suite);
 
         this.suites.push(started.details);
+
+        return this.invokeHooks('beforeSuite', this.config.beforeSuite, [suite as any]);    // todo: correct types
     }
 
-    private onTestSuiteFinished(finished: TestSuiteFinished) {
+    private onTestSuiteFinished(finished: TestSuiteFinished): Promise<any> {
         this.suites.pop();
 
         const started = this.events.getByCorrelationId<TestSuiteStarts>(finished.details.correlationId);
-        this.reporter.emit('suite:end', this.suiteEndEventFrom(started, finished));
+        const suite = this.suiteEndEventFrom(started, finished);
+
+        this.reporter.emit('suite:end', suite);
+
+        return this.invokeHooks('afterSuite', this.config.afterSuite, [suite as any]);  // todo: correct types
     }
 
-    private suiteStartEventFrom(started: TestSuiteStarts): Suite {
+    private suiteStartEventFrom(started: TestSuiteStarts): suiteStats & frameworks.Suite {
         return {
             type:       'suite:start',
             uid:        started.details.correlationId.value,
@@ -85,7 +115,7 @@ export class WebdriverIONotifier implements StageCrewMember {
         return this.suites.map(suite => suite.name.value).concat(name).join(' ');
     }
 
-    private suiteEndEventFrom(started: TestSuiteStarts, finished: TestSuiteFinished): Suite {
+    private suiteEndEventFrom(started: TestSuiteStarts, finished: TestSuiteFinished): suiteStats & frameworks.Suite {
         return {
             ...this.suiteStartEventFrom(started),
             type:       'suite:end',
@@ -99,6 +129,8 @@ export class WebdriverIONotifier implements StageCrewMember {
         this.events.record(started.sceneId, started);
 
         this.reporter.emit(test.type, test);
+
+        return this.invokeHooks('beforeTest', this.config.beforeTest, [ this.testFrom(started), WebdriverIONotifier.dummmyContext ]);
     }
 
     private onSceneFinished(finished: SceneFinished) {
@@ -108,37 +140,59 @@ export class WebdriverIONotifier implements StageCrewMember {
         }
 
         const started     = this.events.getByCorrelationId<SceneStarts>(finished.sceneId);
+        let testEnd: testStats;
 
         if (this.willBeRetried(finished.outcome)) {
-            const testResult  = this.testEndEventFrom(started, finished);
+            testEnd  = this.testEndEventFrom(started, finished);
 
             const type = 'test:retry';
 
             this.reporter.emit(type, {
-                ...testResult,
+                ...testEnd,
                 type,
                 error:  this.errorFrom(finished.outcome),
             });
 
         } else {
 
-            const testResult  = this.testResultEventFrom(started, finished);
-            this.reporter.emit(testResult.type, testResult);
+            const testResultEvent  = this.testResultEventFrom(started, finished);
+            this.reporter.emit(testResultEvent.type, testResultEvent);
 
-            const testEnd     = this.testEndEventFrom(started, finished);
+            testEnd     = this.testEndEventFrom(started, finished);
             this.reporter.emit(testEnd.type, testEnd);
         }
+
+        return this.invokeHooks('afterTest', this.config.afterTest, [ this.testFrom(started), WebdriverIONotifier.dummmyContext, this.testResultFrom(started, finished) ]);
     }
 
     private willBeRetried(outcome: Outcome): outcome is ExecutionIgnored {
         return outcome instanceof ExecutionIgnored;
     }
 
-    private testStartEventFrom(started: SceneStarts): Test {
-        const title = started.details.name.value
+    private testShortTitleFrom(started: SceneStarts): string {
+        return started.details.name.value
             .replace(new RegExp(`^.*?(${ this.parentSuiteName() })`), '')
             .trim();
+    }
+
+    private testFrom(started: SceneStarts): frameworks.Test {
+        const
+            title           = this.testShortTitleFrom(started);
 
+        return {
+            ctx:        WebdriverIONotifier.dummmyContext,
+            file:       started.details.location.path.value,
+            fullName:   this.suiteNamesConcatenatedWith(title),
+            fullTitle:  this.suiteNamesConcatenatedWith(title),
+            parent:     this.parentSuiteName(),
+            pending:    false,
+            title,
+            type:       'test'  // I _think_ it's either 'test' or 'hook' - https://github.com/mochajs/mocha/blob/0ea732c1169c678ef116c3eb452cc94758fff150/lib/test.js#L31
+        }
+    }
+
+    private testStartEventFrom(started: SceneStarts): testStats {
+        const title = this.testShortTitleFrom(started);
         return {
             type:       'test:start',
             title,
@@ -156,7 +210,95 @@ export class WebdriverIONotifier implements StageCrewMember {
         return this.suites[this.suites.length - 1]?.name.value || '';
     }
 
-    private testEndEventFrom(started: SceneStarts, finished: SceneFinished): Test {
+    /**
+     * test status is 'passed' | 'pending' | 'skipped' | 'failed' | 'broken' | 'canceled'
+     * Since this is not documented, we're mimicking other WebdriverIO reporters, for example:
+     *   https://github.com/webdriverio/webdriverio/blob/7415f3126e15a733b51721492e4995ceafae6046/packages/wdio-allure-reporter/src/constants.ts#L3-L9
+     *
+     * @param started
+     * @param finished
+     * @private
+     */
+    private testResultFrom(started: SceneStarts, finished: SceneFinished): frameworks.TestResult {
+        const duration = finished.timestamp.diff(started.timestamp).inMilliseconds();
+        const defaultRetries = { attempts: 0, limit: 0 };
+
+        const passedOrFailed = (outcome: Outcome): boolean =>
+            this.whenSuccessful<boolean>(outcome, true, false);
+
+        return match<Outcome, frameworks.TestResult>(finished.outcome)
+            .when(ExecutionCompromised, (outcome: ExecutionCompromised) => {
+                const error = this.errorFrom(outcome);
+                return {
+                    duration,
+                    error,
+                    exception: error.message,
+                    passed: passedOrFailed(outcome),
+                    status: 'broken',
+                    retries: defaultRetries
+                }
+            })
+            .when(ExecutionFailedWithError, (outcome: ExecutionFailedWithError) => {
+                const error = this.errorFrom(outcome);
+                return {
+                    duration,
+                    error,
+                    exception: error.message,
+                    passed: passedOrFailed(outcome),
+                    status: 'broken',
+                    retries: defaultRetries
+                }
+            })
+            .when(ExecutionFailedWithAssertionError, (outcome: ExecutionFailedWithAssertionError) => {
+                const error = this.errorFrom(outcome);
+                return {
+                    duration,
+                    error,
+                    exception: error.message,
+                    passed: passedOrFailed(outcome),
+                    status: 'failed',
+                    retries: defaultRetries
+                }
+            })
+            .when(ImplementationPending, (outcome: ImplementationPending) => {
+                const error = this.errorFrom(outcome);
+                return {
+                    duration,
+                    error,
+                    exception: error.message,
+                    passed: passedOrFailed(outcome),
+                    status: 'pending',
+                    retries: defaultRetries
+                }
+            })
+            .when(ExecutionIgnored, (outcome: ExecutionIgnored) => {
+                const error = this.errorFrom(outcome);
+                return {
+                    duration,
+                    error,
+                    exception: error.message,
+                    passed: passedOrFailed(outcome),
+                    status: 'canceled',         // fixme: mark as canceled for now for the lack of a better alternative;
+                    retries: defaultRetries     //  consider capturing info about retries from Mocha and putting it on the ExecutionIgnored event so we can pass it on
+                }
+            })
+            .when(ExecutionSkipped, (outcome: ExecutionSkipped) => ({
+                duration,
+                exception: '',
+                passed: passedOrFailed(outcome),
+                status: 'skipped',
+                retries: defaultRetries
+            }))
+            .else(() => ({
+                duration,
+                exception: '',
+                passed: true,
+                status: 'passed',
+                retries: defaultRetries
+            }));
+    }
+
+    private testEndEventFrom(started: SceneStarts, finished: SceneFinished): testStats {
         const duration = finished.timestamp.diff(started.timestamp).inMilliseconds();
         return {
             ...this.testStartEventFrom(started),
@@ -165,15 +307,19 @@ export class WebdriverIONotifier implements StageCrewMember {
         };
     }
 
-    private testResultEventFrom(started: SceneStarts, finished: SceneFinished): Test {
+    private whenSuccessful<O>(outcome: Outcome, resultWhenSuccessful: O, resultWhenNotSuccessful: O): O {
+        return ! outcome.isWorseThan(this.successThreshold) && (outcome instanceof ProblemIndication)
+            ? resultWhenSuccessful
+            : resultWhenNotSuccessful
+    }
+
+    private testResultEventFrom(started: SceneStarts, finished: SceneFinished): testStats {
         const test = this.testEndEventFrom(started, finished)
 
-        const unlessSuccessful = (outcome: Outcome, type: Test['type']) =>
-            ! outcome.isWorseThan(this.successThreshold) && (outcome instanceof ProblemIndication)
-                ? 'test:pass'
-                : type;
+        const unlessSuccessful = (outcome: Outcome, type: testStats['type']) =>
+            this.whenSuccessful<testStats['type']>(outcome, 'test:pass', type);
 
-        return match<Outcome, Test>(finished.outcome)
+        return match<Outcome, testStats>(finished.outcome)
             .when(ExecutionCompromised, (outcome: ExecutionCompromised) => ({
                 ...test,
                 type:   unlessSuccessful(outcome, 'test:fail'),
@@ -231,6 +377,62 @@ export class WebdriverIONotifier implements StageCrewMember {
             actual:     error.actual
         }
     }
+
+    /**
+     * @see https://github.com/webdriverio/webdriverio/blob/main/packages/wdio-utils/src/shim.ts
+     * @param hookName
+     * @param hookFunctions
+     * @param args
+     * @private
+     */
+    private invokeHooks<Result, InnerArguments extends any[]>(
+        hookName: string,
+        hookFunctions: ((...parameters: InnerArguments) => Promise<Result> | Result) | Array<((...parameters: InnerArguments) => Result)>,
+        args: InnerArguments
+    ): Promise<Array<Result | Error>> {
+
+        const hooks = ! Array.isArray(hookFunctions)
+            ? [ hookFunctions ]
+            : hookFunctions;
+
+        const asyncOperationId = CorrelationId.create();
+
+        this.stage.announce(new AsyncOperationAttempted(
+            new Description(`[WebdriverIONotifier#invokeHooks] Invoking ${ hookName } hook`),
+            asyncOperationId,
+        ));
+
+        return Promise.all(hooks.map((hook) => new Promise<Result | Error>((resolve) => {
+            let result
+
+            try {
+                result = hook(...args);
+            } catch (error) {
+                return resolve(error);
+            }
+
+            /**
+             * if a promise is returned make sure we don't have a catch handler
+             * so in case of a rejection it won't cause the hook to fail
+             */
+            if (result && typeof result.then === 'function') {
+                return result.then(resolve, (error: Error) => {
+                    resolve(error);
+                })
+            }
+
+            resolve(result);
+        }))).
+        then(results => {
+
+            this.stage.announce(new AsyncOperationCompleted(
+                new Description(`[WebdriverIONotifier#invokeHooks] Invoking ${ hookName } hook completed`),
+                asyncOperationId,
+            ));
+
+            return results;
+        });
+    }
 }
 
 class EventLog {

package/src/index.ts

@@ -12,7 +12,4 @@ const adapterFactory = new WebdriverIOFrameworkAdapterFactory(
 export default adapterFactory;
 
 export { WebdriverIOConfig } from './adapter';
-export * from './expectations';
-export * from './input';
 export * from './screenplay';
-export * from './stage';