@serenity-js/core 3.41.2 → 3.42.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/core",
-  "version": "3.41.2",
+  "version": "3.42.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",
@@ -16,8 +16,275 @@
     "access": "public",
     "provenance": true
   },
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "type": "module",
+  "module": "./esm/index.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./esm/index.d.ts",
+        "default": "./esm/index.js"
+      },
+      "require": {
+        "types": "./lib/index.d.ts",
+        "default": "./lib/index.js"
+      }
+    },
+    "./adapter": {
+      "import": {
+        "types": "./esm/adapter/index.d.ts",
+        "default": "./esm/adapter/index.js"
+      },
+      "require": {
+        "types": "./lib/adapter/index.d.ts",
+        "default": "./lib/adapter/index.js"
+      }
+    },
+    "./config": {
+      "import": {
+        "types": "./esm/config/index.d.ts",
+        "default": "./esm/config/index.js"
+      },
+      "require": {
+        "types": "./lib/config/index.d.ts",
+        "default": "./lib/config/index.js"
+      }
+    },
+    "./errors": {
+      "import": {
+        "types": "./esm/errors/index.d.ts",
+        "default": "./esm/errors/index.js"
+      },
+      "require": {
+        "types": "./lib/errors/index.d.ts",
+        "default": "./lib/errors/index.js"
+      }
+    },
+    "./events": {
+      "import": {
+        "types": "./esm/events/index.d.ts",
+        "default": "./esm/events/index.js"
+      },
+      "require": {
+        "types": "./lib/events/index.d.ts",
+        "default": "./lib/events/index.js"
+      }
+    },
+    "./io": {
+      "import": {
+        "types": "./esm/io/index.d.ts",
+        "default": "./esm/io/index.js"
+      },
+      "require": {
+        "types": "./lib/io/index.d.ts",
+        "default": "./lib/io/index.js"
+      }
+    },
+    "./model": {
+      "import": {
+        "types": "./esm/model/index.d.ts",
+        "default": "./esm/model/index.js"
+      },
+      "require": {
+        "types": "./lib/model/index.d.ts",
+        "default": "./lib/model/index.js"
+      }
+    },
+    "./screenplay": {
+      "import": {
+        "types": "./esm/screenplay/index.d.ts",
+        "default": "./esm/screenplay/index.js"
+      },
+      "require": {
+        "types": "./lib/screenplay/index.d.ts",
+        "default": "./lib/screenplay/index.js"
+      }
+    },
+    "./stage": {
+      "import": {
+        "types": "./esm/stage/index.d.ts",
+        "default": "./esm/stage/index.js"
+      },
+      "require": {
+        "types": "./lib/stage/index.d.ts",
+        "default": "./lib/stage/index.js"
+      }
+    },
+    "./lib/adapter": {
+      "import": {
+        "types": "./esm/adapter/index.d.ts",
+        "default": "./esm/adapter/index.js"
+      },
+      "require": {
+        "types": "./lib/adapter/index.d.ts",
+        "default": "./lib/adapter/index.js"
+      }
+    },
+    "./lib/config": {
+      "import": {
+        "types": "./esm/config/index.d.ts",
+        "default": "./esm/config/index.js"
+      },
+      "require": {
+        "types": "./lib/config/index.d.ts",
+        "default": "./lib/config/index.js"
+      }
+    },
+    "./lib/errors": {
+      "import": {
+        "types": "./esm/errors/index.d.ts",
+        "default": "./esm/errors/index.js"
+      },
+      "require": {
+        "types": "./lib/errors/index.d.ts",
+        "default": "./lib/errors/index.js"
+      }
+    },
+    "./lib/events": {
+      "import": {
+        "types": "./esm/events/index.d.ts",
+        "default": "./esm/events/index.js"
+      },
+      "require": {
+        "types": "./lib/events/index.d.ts",
+        "default": "./lib/events/index.js"
+      }
+    },
+    "./lib/io": {
+      "import": {
+        "types": "./esm/io/index.d.ts",
+        "default": "./esm/io/index.js"
+      },
+      "require": {
+        "types": "./lib/io/index.d.ts",
+        "default": "./lib/io/index.js"
+      }
+    },
+    "./lib/model": {
+      "import": {
+        "types": "./esm/model/index.d.ts",
+        "default": "./esm/model/index.js"
+      },
+      "require": {
+        "types": "./lib/model/index.d.ts",
+        "default": "./lib/model/index.js"
+      }
+    },
+    "./lib/screenplay": {
+      "import": {
+        "types": "./esm/screenplay/index.d.ts",
+        "default": "./esm/screenplay/index.js"
+      },
+      "require": {
+        "types": "./lib/screenplay/index.d.ts",
+        "default": "./lib/screenplay/index.js"
+      }
+    },
+    "./lib/stage": {
+      "import": {
+        "types": "./esm/stage/index.d.ts",
+        "default": "./esm/stage/index.js"
+      },
+      "require": {
+        "types": "./lib/stage/index.d.ts",
+        "default": "./lib/stage/index.js"
+      }
+    },
+    "./lib/adapter/index.js": {
+      "import": {
+        "types": "./esm/adapter/index.d.ts",
+        "default": "./esm/adapter/index.js"
+      },
+      "require": {
+        "types": "./lib/adapter/index.d.ts",
+        "default": "./lib/adapter/index.js"
+      }
+    },
+    "./lib/config/index.js": {
+      "import": {
+        "types": "./esm/config/index.d.ts",
+        "default": "./esm/config/index.js"
+      },
+      "require": {
+        "types": "./lib/config/index.d.ts",
+        "default": "./lib/config/index.js"
+      }
+    },
+    "./lib/errors/index.js": {
+      "import": {
+        "types": "./esm/errors/index.d.ts",
+        "default": "./esm/errors/index.js"
+      },
+      "require": {
+        "types": "./lib/errors/index.d.ts",
+        "default": "./lib/errors/index.js"
+      }
+    },
+    "./lib/events/index.js": {
+      "import": {
+        "types": "./esm/events/index.d.ts",
+        "default": "./esm/events/index.js"
+      },
+      "require": {
+        "types": "./lib/events/index.d.ts",
+        "default": "./lib/events/index.js"
+      }
+    },
+    "./lib/io/index.js": {
+      "import": {
+        "types": "./esm/io/index.d.ts",
+        "default": "./esm/io/index.js"
+      },
+      "require": {
+        "types": "./lib/io/index.d.ts",
+        "default": "./lib/io/index.js"
+      }
+    },
+    "./lib/model/index.js": {
+      "import": {
+        "types": "./esm/model/index.d.ts",
+        "default": "./esm/model/index.js"
+      },
+      "require": {
+        "types": "./lib/model/index.d.ts",
+        "default": "./lib/model/index.js"
+      }
+    },
+    "./lib/screenplay/index.js": {
+      "import": {
+        "types": "./esm/screenplay/index.d.ts",
+        "default": "./esm/screenplay/index.js"
+      },
+      "require": {
+        "types": "./lib/screenplay/index.d.ts",
+        "default": "./lib/screenplay/index.js"
+      }
+    },
+    "./lib/stage/index.js": {
+      "import": {
+        "types": "./esm/stage/index.d.ts",
+        "default": "./esm/stage/index.js"
+      },
+      "require": {
+        "types": "./lib/stage/index.d.ts",
+        "default": "./lib/stage/index.js"
+      }
+    },
+    "./lib/*.js": "./lib/*.js",
+    "./lib/*": "./lib/*",
+    "./esm/adapter": "./esm/adapter/index.js",
+    "./esm/config": "./esm/config/index.js",
+    "./esm/errors": "./esm/errors/index.js",
+    "./esm/events": "./esm/events/index.js",
+    "./esm/io": "./esm/io/index.js",
+    "./esm/model": "./esm/model/index.js",
+    "./esm/screenplay": "./esm/screenplay/index.js",
+    "./esm/stage": "./esm/stage/index.js",
+    "./esm/*.js": "./esm/*.js",
+    "./esm/*": "./esm/*.js",
+    "./package.json": "./package.json"
+  },
   "keywords": [
     "automation",
     "integration",
@@ -33,8 +300,12 @@
   "scripts": {
     "clean": "rimraf target",
     "test": "c8 npm run test:no-coverage",
-    "test:no-coverage": "mocha --config ../../.mocharc.yml --spec='spec/**/*.spec.*'",
-    "compile": "rimraf lib && tsc --project tsconfig.build.json"
+    "test:no-coverage": "mocha --config .mocharc.yml --spec='spec/**/*.spec.*'",
+    "compile": "npm run compile:clean && npm run compile:esm && npm run compile:cjs-package && npm run compile:cjs",
+    "compile:clean": "rimraf lib esm",
+    "compile:esm": "tsc --project tsconfig-esm.build.json",
+    "compile:cjs-package": "node -e \"require('fs').mkdirSync('lib', { recursive: true }); require('fs').writeFileSync('lib/package.json', '{ \\\"type\\\": \\\"commonjs\\\" }')\"",
+    "compile:cjs": "tsc --project tsconfig-cjs.build.json"
   },
   "dependencies": {
     "@paralleldrive/cuid2": "2.3.1",
@@ -45,7 +316,7 @@
     "filenamify": "4.3.0",
     "graceful-fs": "4.2.11",
     "semver": "7.7.4",
-    "tiny-types": "1.24.3",
+    "tiny-types": "2.0.5",
     "upath": "2.0.1",
     "validate-npm-package-name": "7.0.2"
   },
@@ -74,5 +345,5 @@
   "engines": {
     "node": "^20 || ^22 || ^24"
   },
-  "gitHead": "adcfe0c84d167de23a9194d755a90a2fb2b8112d"
+  "gitHead": "a415b0066807d7bab9f34b1ceef66a26156aafe1"
 }

package/src/Serenity.ts

@@ -1,19 +1,19 @@
 import { ensure, isInstanceOf } from 'tiny-types';
 
-import type { OutputStream } from './adapter';
-import type { SerenityConfig } from './config';
-import type { ErrorOptions, RuntimeError } from './errors';
-import { ConfigurationError, ErrorFactory, NoOpDiffFormatter } from './errors';
-import type { DomainEvent, EmitsDomainEvents } from './events';
-import { ClassDescriptionParser, ClassLoader, d, FileSystem, has, ModuleLoader, Path } from './io';
-import { type ActivityDetails, CorrelationId, type CorrelationIdFactory } from './model';
-import type { Actor, Timestamp } from './screenplay';
-import { Clock, Duration } from './screenplay';
-import type { StageCrewMember, StageCrewMemberBuilder } from './stage';
-import type { Cast } from './stage/Cast';
-import { Extras } from './stage/Extras';
-import { Stage } from './stage/Stage';
-import { StageManager } from './stage/StageManager';
+import type { OutputStream } from './adapter/index.js';
+import type { SerenityConfig } from './config/index.js';
+import type { ErrorOptions, RuntimeError } from './errors/index.js';
+import { ConfigurationError, ErrorFactory, NoOpDiffFormatter } from './errors/index.js';
+import type { DomainEvent, EmitsDomainEvents } from './events/index.js';
+import { ClassDescriptionParser, ClassLoader, d, FileSystem, has, ModuleLoader, Path } from './io/index.js';
+import { type ActivityDetails, CorrelationId, type CorrelationIdFactory } from './model/index.js';
+import type { Actor, Timestamp } from './screenplay/index.js';
+import { Clock, Duration } from './screenplay/index.js';
+import type { Cast } from './stage/Cast.js';
+import { Extras } from './stage/Extras.js';
+import type { StageCrewMember, StageCrewMemberBuilder } from './stage/index.js';
+import { Stage } from './stage/Stage.js';
+import { StageManager } from './stage/StageManager.js';
 
 /**
  * @group Serenity

package/src/adapter/TestRunnerAdapter.ts

@@ -1,4 +1,4 @@
-import type { Outcome } from '../model';
+import type { Outcome } from '../model/index.js';
 
 /**
  * Describes an adapter needed to run a given type of tests programmatically

package/src/adapter/index.ts

@@ -1,2 +1,2 @@
-export * from './OutputStream';
-export * from './TestRunnerAdapter';
+export * from './OutputStream.js';
+export * from './TestRunnerAdapter.js';

package/src/config/SerenityConfig.ts

@@ -1,8 +1,8 @@
-import type { OutputStream } from '../adapter';
-import type { DiffFormatter } from '../errors';
-import type { Duration } from '../screenplay';
-import type { Cast, StageCrewMember, StageCrewMemberBuilder } from '../stage';
-import type { ClassDescription } from './ClassDescription';
+import type { OutputStream } from '../adapter/index.js';
+import type { DiffFormatter } from '../errors/index.js';
+import type { Duration } from '../screenplay/index.js';
+import type { Cast, StageCrewMember, StageCrewMemberBuilder } from '../stage/index.js';
+import type { ClassDescription } from './ClassDescription.js';
 
 /**
  * Describes the configuration object accepted by the [`configure`](https://serenity-js.org/api/core/function/configure/) function.

package/src/config/index.ts

@@ -1,2 +1,2 @@
-export * from './ClassDescription';
-export * from './SerenityConfig';
+export * from './ClassDescription.js';
+export * from './SerenityConfig.js';

package/src/errors/ErrorFactory.ts

@@ -2,14 +2,14 @@ import { types } from 'node:util';
 
 import type { ArrayChange, Change } from 'diff';
 import { diffArrays, diffJson } from 'diff';
-import { equal } from 'tiny-types/lib/objects';
-
-import { inspected, ValueInspector } from '../io';
-import { Unanswered } from '../screenplay/questions/Unanswered';
-import type { DiffFormatter } from './diff';
-import { AnsiDiffFormatter } from './diff/AnsiDiffFormatter';
-import type { ErrorOptions } from './ErrorOptions';
-import type { RuntimeError } from './model';
+import { equal } from 'tiny-types/lib/objects/equal.js';
+
+import { inspected, ValueInspector } from '../io/index.js';
+import { Unanswered } from '../screenplay/questions/Unanswered.js';
+import { AnsiDiffFormatter } from './diff/AnsiDiffFormatter.js';
+import type { DiffFormatter } from './diff/index.js';
+import type { ErrorOptions } from './ErrorOptions.js';
+import type { RuntimeError } from './model/index.js';
 
 /**
  * Generates Serenity/JS [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/) objects based

package/src/errors/ErrorOptions.ts

@@ -1,5 +1,5 @@
-import type { FileSystemLocation } from '../io';
-import type { ExpectationDetails } from '../screenplay';
+import type { FileSystemLocation } from '../io/index.js';
+import type { ExpectationDetails } from '../screenplay/index.js';
 
 /**
  * @group Errors

package/src/errors/ErrorStackParser.ts

@@ -1,4 +1,5 @@
-import * as parser from 'error-stack-parser';
+import type { StackFrame } from 'error-stack-parser';
+import parser from 'error-stack-parser';
 
 /**
  * A thin wrapper around error-stack-parser module
@@ -9,7 +10,7 @@ import * as parser from 'error-stack-parser';
  * @group Errors
  */
 export class ErrorStackParser {
-    parse(error: Error): parser.StackFrame[] {
+    parse(error: Error): StackFrame[] {
         return parser.parse(error);
     }
 }

package/src/errors/RaiseErrors.ts

@@ -1,7 +1,7 @@
-import { Ability } from '../screenplay/abilities/Ability';
-import type { Stage } from '../stage/Stage';
-import type { ErrorOptions } from './ErrorOptions';
-import type { RuntimeError } from './model/RuntimeError';
+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/)

package/src/errors/diff/AnsiDiffFormatter.ts

@@ -1,7 +1,9 @@
 import type { Chalk, Options } from 'chalk';    // eslint-disable-line unicorn/import-style
-import { Instance as ChalkInstance } from 'chalk';   // eslint-disable-line unicorn/import-style
+import chalk from 'chalk';    
 
-import type { DiffFormatter } from './DiffFormatter';
+const ChalkInstance = chalk.Instance;
+
+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)

package/src/errors/diff/NoOpDiffFormatter.ts

@@ -1,4 +1,4 @@
-import type { DiffFormatter } from './DiffFormatter';
+import type { DiffFormatter } from './DiffFormatter.js';
 
 /**
  * A no-op [`DiffFormatter`](https://serenity-js.org/api/core/interface/DiffFormatter/) that produces output identical to input.

package/src/errors/diff/index.ts

@@ -1,3 +1,3 @@
-export * from './AnsiDiffFormatter';
-export * from './DiffFormatter';
-export * from './NoOpDiffFormatter';
+export * from './AnsiDiffFormatter.js';
+export * from './DiffFormatter.js';
+export * from './NoOpDiffFormatter.js';

package/src/errors/index.ts

@@ -1,6 +1,6 @@
 /* eslint-disable simple-import-sort/imports */
-import { AssertionError, ConfigurationError, ImplementationPendingError, LogicError, OperationInterruptedError, TestCompromisedError, TimeoutExpiredError, UnknownError } from './model';
-import { ErrorSerialiser } from './ErrorSerialiser';
+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
@@ -15,13 +15,13 @@ ErrorSerialiser.registerErrorTypes(
     UnknownError,
 );
 
-export * from './diff';
-export * from './model';
+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';
-export { ErrorStackParser } from './ErrorStackParser';
-export { ErrorFactory } from './ErrorFactory';
-export { ErrorOptions } from './ErrorOptions';
-export * from './RaiseErrors';
+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';
 /* eslint-enable simple-import-sort/exports */

package/src/errors/model/AssertionError.ts

@@ -1,7 +1,7 @@
 import type { JSONObject } from 'tiny-types';
 
-import { ErrorSerialiser } from '../ErrorSerialiser';
-import { RuntimeError } from './RuntimeError';
+import { ErrorSerialiser } from '../ErrorSerialiser.js';
+import { RuntimeError } from './RuntimeError.js';
 
 /**
  * Thrown to indicate that an assertion has failed.

package/src/errors/model/ConfigurationError.ts

@@ -1,7 +1,7 @@
 import type { JSONObject } from 'tiny-types';
 
-import { ErrorSerialiser } from '../ErrorSerialiser';
-import { RuntimeError } from './RuntimeError';
+import { ErrorSerialiser } from '../ErrorSerialiser.js';
+import { RuntimeError } from './RuntimeError.js';
 
 /**
  * Thrown to indicate that a test framework or test suite configuration error occurred.

package/src/errors/model/ImplementationPendingError.ts

@@ -1,7 +1,7 @@
 import type { JSONObject } from 'tiny-types';
 
-import { ErrorSerialiser } from '../ErrorSerialiser';
-import { RuntimeError } from './RuntimeError';
+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

package/src/errors/model/ListItemNotFoundError.ts

@@ -1,7 +1,7 @@
 import type { JSONObject } from 'tiny-types';
 
-import { ErrorSerialiser } from '../ErrorSerialiser';
-import { RuntimeError } from './RuntimeError';
+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

package/src/errors/model/LogicError.ts

@@ -1,7 +1,7 @@
 import type { JSONObject } from 'tiny-types';
 
-import { ErrorSerialiser } from '../ErrorSerialiser';
-import { RuntimeError } from './RuntimeError';
+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

package/src/errors/model/OperationInterruptedError.ts

@@ -1,7 +1,7 @@
 import type { JSONObject } from 'tiny-types';
 
-import { ErrorSerialiser } from '../ErrorSerialiser';
-import { RuntimeError } from './RuntimeError';
+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/)

package/src/errors/model/RuntimeError.ts

@@ -40,7 +40,7 @@ import { TinyType } from 'tiny-types';
  *
  * ```ts
  * import { RuntimeError } from '@serenity-js/core'
- * import { ErrorSerialiser } from '@serenity-js/core/lib/io'
+ * import { ErrorSerialiser } from '@serenity-js/core/io'
  *
  * export class CustomError extends RuntimeError {
  *
@@ -67,6 +67,49 @@ import { TinyType } from 'tiny-types';
  */
 export abstract class RuntimeError extends 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 = 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: unknown): boolean {
+        if (instance === null || typeof instance !== 'object') {
+            return false;
+        }
+
+        // First, verify this is a RuntimeError instance using the brand
+        if ((instance as any)[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
@@ -90,6 +133,9 @@ export abstract class RuntimeError extends Error {
         Object.setPrototypeOf(this, type.prototype);
         this.name = this.constructor.name;
 
+        // Brand the instance for cross-module instanceof checks
+        (this as any)[RuntimeError.TYPE_BRAND] = true;
+
         Error.captureStackTrace(this, type);
 
         if (cause) {

package/src/errors/model/TestCompromisedError.ts

@@ -1,7 +1,7 @@
 import type { JSONObject } from 'tiny-types';
 
-import { ErrorSerialiser } from '../ErrorSerialiser';
-import { RuntimeError } from './RuntimeError';
+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.