@hellaweb3/wiremock-testcontainers-nodejs 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chris Anatalio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+<!--suppress HtmlDeprecatedAttribute -->
+<div align="center">
+
+<h1>WireMock Testcontainers Node.js</h1>
+
+<p>A library for easily using WireMock with Testcontainers in Node.js applications.</p>
+
+<a href="https://github.com/hella-web3/wiremock-testcontainers-nodejs/actions/workflows/main.yml">
+    <img alt="Build Status" src="https://github.com/hella-web3/wiremock-testcontainers-nodejs/actions/workflows/main.yml/badge.svg" />
+</a>
+
+<a href="https://www.npmjs.com/package/@hellaweb3/wiremock-testcontainers-nodejs">
+<img alt="npm version" src="https://img.shields.io/npm/v/%40hellaweb3%2Fwiremock-testcontainers-nodejs" />
+</a>
+
+<a href="https://www.npmjs.com/package/@hellaweb3/wiremock-testcontainers-nodejs">
+<img alt="npm downloads" src="https://img.shields.io/npm/dm/%40hellaweb3%2Fwiremock-testcontainers-nodejs" />
+</a>
+
+</div>
+
+## Description
+
+`wiremock-testcontainers-nodejs` spins up a [WireMock](https://wiremock.org/)
+instance with [Testcontainers](https://node.testcontainers.org/). It provides a
+fluent API to configure and start WireMock
+containers, including support for loading mappings and files from recorded
+Wiremock sessions.
+
+## Installation
+
+```bash
+pnpm add -D @hellaweb3/wiremock-testcontainers-nodejs testcontainers
+```
+
+## Usage
+
+### Basic Example
+
+Assuming you placed your mappings in `test/__mocks__/wiremock`,
+
+```typescript
+import { WiremockContainer } from "@hellaweb3/wiremock-testcontainers-nodejs";
+
+describe("E2E Test", () => {
+  let container;
+
+  beforeAll(async () => {
+    container = await new WiremockContainer()
+      .withMappings("./test/__mocks__/wiremock")
+      .start();
+  }, 60000);
+
+  afterAll(async () => {
+    await container.stop();
+  });
+
+  it("should interact with WireMock", async () => {
+    const url = container.rpcUrl;
+    // Your test logic here
+  });
+});
+```
+
+### With Mappings and Files
+
+WireMock uses a specific directory structure for mappings and static files. This
+library makes it easy to mount these into the container.
+
+**Project structure:**
+
+```
+test/
+└── __mocks__/
+    └── wiremock/
+        ├── mappings/
+        │   └── my-mapping.json
+        └── __files/
+            └── some-data.json
+```
+
+```typescript
+import { WiremockContainer } from "@hellaweb3/wiremock-testcontainers-nodejs";
+
+const container = await new WiremockContainer()
+  .withMappings("./test/__mocks__/wiremock")
+  .start();
+```
+
+## API
+
+### `WiremockContainer`
+
+- `constructor(image?: string)`: Create a new container. Defaults to
+  `wiremock/wiremock`.
+- `withMappings(directory: string)`: Mounts `mappings` and `__files` from the
+  specified local directory to the container.
+- `start()`: Starts the container and returns a `StartedWiremockContainer`.
+
+### `StartedWiremockContainer`
+
+- `rpcUrl`: Returns the base URL of the running WireMock instance (e.g.,
+  `http://localhost:32768`).
+- `stop()`: Stops the container (inherited from Testcontainers).
+
+## Best Practices
+
+1. **Test Isolation**: Start a new container for each test suite (or even each
+   test if performance allows) to ensure a clean state.
+2. **Mapping Organization**: Keep your mappings organized in a dedicated
+   directory structure that mirrors your API endpoints.
+3. **Timeouts**: Docker container startup can sometimes exceed the default test
+   runner timeout (e.g., 5s in Jest). Always set a higher timeout for
+   `beforeAll` hooks that start containers.
+4. **Resource Management**: Always ensure `container.stop()` is called in an
+   `afterAll` or `afterEach` block to prevent orphaned containers.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,76 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var testcontainers = require('testcontainers');
+
+/**
+ * A Testcontainer for Wiremock.
+ *
+ * @example
+ * ```typescript
+ * const container = await new WiremockContainer().start();
+ * ```
+ */ class WiremockContainer extends testcontainers.GenericContainer {
+    /**
+   * Creates a new WiremockContainer.
+   * @example
+   * ```typescript
+   * const container = await new WiremockContainer().start();
+   * ```
+   * @param image The docker image to use. Defaults to "wiremock/wiremock".
+   */ constructor(image = "wiremock/wiremock"){
+        super(image);
+        this.withExposedPorts(8080);
+        this.withWaitStrategy(testcontainers.Wait.forListeningPorts());
+    }
+    /**
+   * Adds mappings to the Wiremock container.
+   * @example
+   * ```typescript
+   * const container = await new WiremockContainer()
+   *   .withMappings("./test/__mocks__/wiremock")
+   *   .start();
+   * ```
+   * @param directory The directory containing the mappings and __files.
+   */ withMappings(directory) {
+        this.withCopyDirectoriesToContainer([
+            {
+                source: `${directory}/__files`,
+                target: "/home/wiremock/__files"
+            }
+        ]);
+        this.withCopyDirectoriesToContainer([
+            {
+                source: `${directory}/mappings`,
+                target: "/home/wiremock/mappings"
+            }
+        ]);
+        return this;
+    }
+    /**
+   * Starts the container and returns a {@link StartedWiremockContainer}.
+   * @returns A promise that resolves to the started container.
+   */ async start() {
+        const startedContainer = await super.start();
+        return new StartedWiremockContainer(startedContainer, `http://${startedContainer.getHost()}:${startedContainer.getMappedPort(8080)}`);
+    }
+}
+/**
+ * A started Wiremock container with helper methods for interacting with the node.
+ */ class StartedWiremockContainer extends testcontainers.AbstractStartedContainer {
+    /**
+   * Creates a new StartedWiremockContainer.
+   * @param startedTestContainer The underlying TestContainer.
+   * @param url The URL of the started container.
+   */ constructor(startedTestContainer, url){
+        super(startedTestContainer);
+        this._rpcUrl = url;
+    }
+    /**
+   * Gets the URL of the Wiremock node.
+   */ get rpcUrl() {
+        return this._rpcUrl;
+    }
+}
+
+exports.StartedWiremockContainer = StartedWiremockContainer;
+exports.WiremockContainer = WiremockContainer;

package/dist/index.d.cts

@@ -0,0 +1,56 @@
+import { AbstractStartedContainer, StartedTestContainer, GenericContainer } from 'testcontainers';
+
+/**
+ * A Testcontainer for Wiremock.
+ *
+ * @example
+ * ```typescript
+ * const container = await new WiremockContainer().start();
+ * ```
+ */
+declare class WiremockContainer extends GenericContainer {
+    /**
+     * Creates a new WiremockContainer.
+     * @example
+     * ```typescript
+     * const container = await new WiremockContainer().start();
+     * ```
+     * @param image The docker image to use. Defaults to "wiremock/wiremock".
+     */
+    constructor(image?: string);
+    /**
+     * Adds mappings to the Wiremock container.
+     * @example
+     * ```typescript
+     * const container = await new WiremockContainer()
+     *   .withMappings("./test/__mocks__/wiremock")
+     *   .start();
+     * ```
+     * @param directory The directory containing the mappings and __files.
+     */
+    withMappings(directory: string): this;
+    /**
+     * Starts the container and returns a {@link StartedWiremockContainer}.
+     * @returns A promise that resolves to the started container.
+     */
+    start(): Promise<StartedWiremockContainer>;
+}
+/**
+ * A started Wiremock container with helper methods for interacting with the node.
+ */
+declare class StartedWiremockContainer extends AbstractStartedContainer {
+    private readonly _rpcUrl;
+    /**
+     * Creates a new StartedWiremockContainer.
+     * @param startedTestContainer The underlying TestContainer.
+     * @param url The URL of the started container.
+     */
+    constructor(startedTestContainer: StartedTestContainer, url: string);
+    /**
+     * Gets the URL of the Wiremock node.
+     */
+    get rpcUrl(): string;
+}
+
+export { StartedWiremockContainer, WiremockContainer };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sources":["../src/index.ts"],"sourcesContent":["import {\n  AbstractStartedContainer,\n  GenericContainer,\n  StartedTestContainer,\n  Wait,\n} from \"testcontainers\";\n\n/**\n * A Testcontainer for Wiremock.\n *\n * @example\n * ```typescript\n * const container = await new WiremockContainer().start();\n * ```\n */\nexport class WiremockContainer extends GenericContainer {\n  /**\n   * Creates a new WiremockContainer.\n   * @example\n   * ```typescript\n   * const container = await new WiremockContainer().start();\n   * ```\n   * @param image The docker image to use. Defaults to \"wiremock/wiremock\".\n   */\n  constructor(image: string = \"wiremock/wiremock\") {\n    super(image);\n    this.withExposedPorts(8080);\n    this.withWaitStrategy(Wait.forListeningPorts());\n  }\n\n  /**\n   * Adds mappings to the Wiremock container.\n   * @example\n   * ```typescript\n   * const container = await new WiremockContainer()\n   *   .withMappings(\"./test/__mocks__/wiremock\")\n   *   .start();\n   * ```\n   * @param directory The directory containing the mappings and __files.\n   */\n  public withMappings(directory: string) {\n    this.withCopyDirectoriesToContainer([{\n      source: `${directory}/__files`,\n      target: \"/home/wiremock/__files\",\n    }]);\n    this.withCopyDirectoriesToContainer([{\n      source: `${directory}/mappings`,\n      target: \"/home/wiremock/mappings\",\n    }]);\n\n    return this;\n  }\n\n  /**\n   * Starts the container and returns a {@link StartedWiremockContainer}.\n   * @returns A promise that resolves to the started container.\n   */\n  public override async start(): Promise<StartedWiremockContainer> {\n    const startedContainer = await super.start();\n    return new StartedWiremockContainer(\n      startedContainer,\n      `http://${startedContainer.getHost()}:${startedContainer.getMappedPort(8080)}`,\n    );\n  }\n}\n\n/**\n * A started Wiremock container with helper methods for interacting with the node.\n */\nexport class StartedWiremockContainer extends AbstractStartedContainer {\n  private readonly _rpcUrl;\n\n  /**\n   * Creates a new StartedWiremockContainer.\n   * @param startedTestContainer The underlying TestContainer.\n   * @param url The URL of the started container.\n   */\n  constructor(startedTestContainer: StartedTestContainer, url: string) {\n    super(startedTestContainer);\n    this._rpcUrl = url;\n  }\n\n  /**\n   * Gets the URL of the Wiremock node.\n   */\n  get rpcUrl() {\n    return this._rpcUrl;\n  }\n}\n"],"names":[],"mappings":";;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,iBAAA,SAAA,gBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,aAAA,OAAA,CAAA,wBAAA;AACA;AACA;AACA;AACA;AACO,cAAA,wBAAA,SAAA,wBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA,sCAAA,oBAAA;AACA;AACA;AACA;AACA;AACA;;;;"}

package/dist/index.d.ts

@@ -0,0 +1,56 @@
+import { AbstractStartedContainer, StartedTestContainer, GenericContainer } from 'testcontainers';
+
+/**
+ * A Testcontainer for Wiremock.
+ *
+ * @example
+ * ```typescript
+ * const container = await new WiremockContainer().start();
+ * ```
+ */
+declare class WiremockContainer extends GenericContainer {
+    /**
+     * Creates a new WiremockContainer.
+     * @example
+     * ```typescript
+     * const container = await new WiremockContainer().start();
+     * ```
+     * @param image The docker image to use. Defaults to "wiremock/wiremock".
+     */
+    constructor(image?: string);
+    /**
+     * Adds mappings to the Wiremock container.
+     * @example
+     * ```typescript
+     * const container = await new WiremockContainer()
+     *   .withMappings("./test/__mocks__/wiremock")
+     *   .start();
+     * ```
+     * @param directory The directory containing the mappings and __files.
+     */
+    withMappings(directory: string): this;
+    /**
+     * Starts the container and returns a {@link StartedWiremockContainer}.
+     * @returns A promise that resolves to the started container.
+     */
+    start(): Promise<StartedWiremockContainer>;
+}
+/**
+ * A started Wiremock container with helper methods for interacting with the node.
+ */
+declare class StartedWiremockContainer extends AbstractStartedContainer {
+    private readonly _rpcUrl;
+    /**
+     * Creates a new StartedWiremockContainer.
+     * @param startedTestContainer The underlying TestContainer.
+     * @param url The URL of the started container.
+     */
+    constructor(startedTestContainer: StartedTestContainer, url: string);
+    /**
+     * Gets the URL of the Wiremock node.
+     */
+    get rpcUrl(): string;
+}
+
+export { StartedWiremockContainer, WiremockContainer };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sources":["../src/index.ts"],"sourcesContent":["import {\n  AbstractStartedContainer,\n  GenericContainer,\n  StartedTestContainer,\n  Wait,\n} from \"testcontainers\";\n\n/**\n * A Testcontainer for Wiremock.\n *\n * @example\n * ```typescript\n * const container = await new WiremockContainer().start();\n * ```\n */\nexport class WiremockContainer extends GenericContainer {\n  /**\n   * Creates a new WiremockContainer.\n   * @example\n   * ```typescript\n   * const container = await new WiremockContainer().start();\n   * ```\n   * @param image The docker image to use. Defaults to \"wiremock/wiremock\".\n   */\n  constructor(image: string = \"wiremock/wiremock\") {\n    super(image);\n    this.withExposedPorts(8080);\n    this.withWaitStrategy(Wait.forListeningPorts());\n  }\n\n  /**\n   * Adds mappings to the Wiremock container.\n   * @example\n   * ```typescript\n   * const container = await new WiremockContainer()\n   *   .withMappings(\"./test/__mocks__/wiremock\")\n   *   .start();\n   * ```\n   * @param directory The directory containing the mappings and __files.\n   */\n  public withMappings(directory: string) {\n    this.withCopyDirectoriesToContainer([{\n      source: `${directory}/__files`,\n      target: \"/home/wiremock/__files\",\n    }]);\n    this.withCopyDirectoriesToContainer([{\n      source: `${directory}/mappings`,\n      target: \"/home/wiremock/mappings\",\n    }]);\n\n    return this;\n  }\n\n  /**\n   * Starts the container and returns a {@link StartedWiremockContainer}.\n   * @returns A promise that resolves to the started container.\n   */\n  public override async start(): Promise<StartedWiremockContainer> {\n    const startedContainer = await super.start();\n    return new StartedWiremockContainer(\n      startedContainer,\n      `http://${startedContainer.getHost()}:${startedContainer.getMappedPort(8080)}`,\n    );\n  }\n}\n\n/**\n * A started Wiremock container with helper methods for interacting with the node.\n */\nexport class StartedWiremockContainer extends AbstractStartedContainer {\n  private readonly _rpcUrl;\n\n  /**\n   * Creates a new StartedWiremockContainer.\n   * @param startedTestContainer The underlying TestContainer.\n   * @param url The URL of the started container.\n   */\n  constructor(startedTestContainer: StartedTestContainer, url: string) {\n    super(startedTestContainer);\n    this._rpcUrl = url;\n  }\n\n  /**\n   * Gets the URL of the Wiremock node.\n   */\n  get rpcUrl() {\n    return this._rpcUrl;\n  }\n}\n"],"names":[],"mappings":";;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,iBAAA,SAAA,gBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,aAAA,OAAA,CAAA,wBAAA;AACA;AACA;AACA;AACA;AACO,cAAA,wBAAA,SAAA,wBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA,sCAAA,oBAAA;AACA;AACA;AACA;AACA;AACA;;;;"}

package/dist/index.js

@@ -0,0 +1,73 @@
+import { GenericContainer, Wait, AbstractStartedContainer } from 'testcontainers';
+
+/**
+ * A Testcontainer for Wiremock.
+ *
+ * @example
+ * ```typescript
+ * const container = await new WiremockContainer().start();
+ * ```
+ */ class WiremockContainer extends GenericContainer {
+    /**
+   * Creates a new WiremockContainer.
+   * @example
+   * ```typescript
+   * const container = await new WiremockContainer().start();
+   * ```
+   * @param image The docker image to use. Defaults to "wiremock/wiremock".
+   */ constructor(image = "wiremock/wiremock"){
+        super(image);
+        this.withExposedPorts(8080);
+        this.withWaitStrategy(Wait.forListeningPorts());
+    }
+    /**
+   * Adds mappings to the Wiremock container.
+   * @example
+   * ```typescript
+   * const container = await new WiremockContainer()
+   *   .withMappings("./test/__mocks__/wiremock")
+   *   .start();
+   * ```
+   * @param directory The directory containing the mappings and __files.
+   */ withMappings(directory) {
+        this.withCopyDirectoriesToContainer([
+            {
+                source: `${directory}/__files`,
+                target: "/home/wiremock/__files"
+            }
+        ]);
+        this.withCopyDirectoriesToContainer([
+            {
+                source: `${directory}/mappings`,
+                target: "/home/wiremock/mappings"
+            }
+        ]);
+        return this;
+    }
+    /**
+   * Starts the container and returns a {@link StartedWiremockContainer}.
+   * @returns A promise that resolves to the started container.
+   */ async start() {
+        const startedContainer = await super.start();
+        return new StartedWiremockContainer(startedContainer, `http://${startedContainer.getHost()}:${startedContainer.getMappedPort(8080)}`);
+    }
+}
+/**
+ * A started Wiremock container with helper methods for interacting with the node.
+ */ class StartedWiremockContainer extends AbstractStartedContainer {
+    /**
+   * Creates a new StartedWiremockContainer.
+   * @param startedTestContainer The underlying TestContainer.
+   * @param url The URL of the started container.
+   */ constructor(startedTestContainer, url){
+        super(startedTestContainer);
+        this._rpcUrl = url;
+    }
+    /**
+   * Gets the URL of the Wiremock node.
+   */ get rpcUrl() {
+        return this._rpcUrl;
+    }
+}
+
+export { StartedWiremockContainer, WiremockContainer };

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@hellaweb3/wiremock-testcontainers-nodejs",
+  "description": "A Node.js library for using WireMock with Testcontainers, providing a fluent API for easy setup and integration testing.",
+  "homepage": "https://github.com/hella-web3/wiremock-testcontainers-nodejs#readme",
+  "repository": "https://github.com/hella-web3/wiremock-testcontainers-nodejs",
+  "bugs": "https://github.com/hella-web3/wiremock-testcontainers-nodejs/issues",
+  "keywords": [
+    "testcontainers",
+    "wiremock",
+    "testing",
+    "mock",
+    "api"
+  ],
+  "version": "0.1.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Chris Anatalio",
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "dev": "tsdx dev",
+    "build": "tsdx build",
+    "test": "jest --colors --injectGlobals",
+    "lint": "tsdx lint",
+    "typecheck": "tsc --noEmit",
+    "prepack": "pnpm build",
+    "prepublishOnly": "pnpm run build",
+    "check": "pnpm build && pnpm typecheck && pnpm lint && pnpm test"
+  },
+  "dependencies": {
+    "testcontainers": "^11.11.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.0.10",
+    "bunchee": "^6.9.4",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "tsdx": "^2.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "jest": {
+    "collectCoverageFrom": [
+      "**/*.(t|j)s"
+    ],
+    "coverageDirectory": "../coverage",
+    "coveragePathIgnorePatterns": [
+      "app.module.ts",
+      "main.ts",
+      ".*\\.module\\.ts",
+      ".*\\.dto\\.ts"
+    ],
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "rootDir": ".",
+    "testEnvironment": "node",
+    "testRegex": "test/.*\\.test\\.ts$",
+    "transform": {
+      "^.+\\.(t|j)s$": "ts-jest"
+    }
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

package/src/index.ts

@@ -0,0 +1,89 @@
+import {
+  AbstractStartedContainer,
+  GenericContainer,
+  StartedTestContainer,
+  Wait,
+} from "testcontainers";
+
+/**
+ * A Testcontainer for Wiremock.
+ *
+ * @example
+ * ```typescript
+ * const container = await new WiremockContainer().start();
+ * ```
+ */
+export class WiremockContainer extends GenericContainer {
+  /**
+   * Creates a new WiremockContainer.
+   * @example
+   * ```typescript
+   * const container = await new WiremockContainer().start();
+   * ```
+   * @param image The docker image to use. Defaults to "wiremock/wiremock".
+   */
+  constructor(image: string = "wiremock/wiremock") {
+    super(image);
+    this.withExposedPorts(8080);
+    this.withWaitStrategy(Wait.forListeningPorts());
+  }
+
+  /**
+   * Adds mappings to the Wiremock container.
+   * @example
+   * ```typescript
+   * const container = await new WiremockContainer()
+   *   .withMappings("./test/__mocks__/wiremock")
+   *   .start();
+   * ```
+   * @param directory The directory containing the mappings and __files.
+   */
+  public withMappings(directory: string) {
+    this.withCopyDirectoriesToContainer([{
+      source: `${directory}/__files`,
+      target: "/home/wiremock/__files",
+    }]);
+    this.withCopyDirectoriesToContainer([{
+      source: `${directory}/mappings`,
+      target: "/home/wiremock/mappings",
+    }]);
+
+    return this;
+  }
+
+  /**
+   * Starts the container and returns a {@link StartedWiremockContainer}.
+   * @returns A promise that resolves to the started container.
+   */
+  public override async start(): Promise<StartedWiremockContainer> {
+    const startedContainer = await super.start();
+    return new StartedWiremockContainer(
+      startedContainer,
+      `http://${startedContainer.getHost()}:${startedContainer.getMappedPort(8080)}`,
+    );
+  }
+}
+
+/**
+ * A started Wiremock container with helper methods for interacting with the node.
+ */
+export class StartedWiremockContainer extends AbstractStartedContainer {
+  private readonly _rpcUrl;
+
+  /**
+   * Creates a new StartedWiremockContainer.
+   * @param startedTestContainer The underlying TestContainer.
+   * @param url The URL of the started container.
+   */
+  constructor(startedTestContainer: StartedTestContainer, url: string) {
+    super(startedTestContainer);
+    this._rpcUrl = url;
+  }
+
+  /**
+   * Gets the URL of the Wiremock node.
+   */
+  get rpcUrl() {
+    return this._rpcUrl;
+  }
+}