@hellaweb3/wiremock-testcontainers-nodejs 0.1.3 → 0.2.0

package/dist/index.d.cts

@@ -1,56 +1,113 @@
-import { AbstractStartedContainer, StartedTestContainer, GenericContainer } from 'testcontainers';
-
+import { AbstractStartedContainer, GenericContainer, StartedTestContainer } from "testcontainers";
+/** A path (relative to the working directory) or a `file:` URL. */
+type WiremockPath = string | URL;
 /**
- * A Testcontainer for Wiremock.
+ * A fixture file: a local path or `file:` URL, `{ file }`, a file inside an installed npm
+ * package `{ package, file }` (its `exports` are ignored), or a file next to a module
+ * `{ module: import.meta.url | __filename | __dirname, file }`.
+ */
+type WiremockFileSource = WiremockPath | {
+  readonly file: WiremockPath;
+} | {
+  readonly package: string;
+  readonly file: string;
+} | {
+  readonly module: WiremockPath;
+  readonly file: string;
+};
+/** A WireMock stub; fields besides `request` and `response` are passed through. */
+interface WiremockStubMapping {
+  readonly request: object;
+  readonly response: object;
+  readonly [field: string]: unknown;
+}
+/** A file source, or inline JSON: a string, a stub or `{ mappings: [...] }`. */
+type WiremockMappingSource = WiremockFileSource | {
+  readonly json: string | WiremockStubMapping | {
+    readonly mappings: readonly WiremockStubMapping[];
+  };
+};
+/** A file source; object forms may set `name`, the path below `__files/` (default: the base name). */
+type WiremockStaticFile = WiremockPath | (Exclude<WiremockFileSource, WiremockPath> & {
+  readonly name?: string;
+});
+/**
+ * A Testcontainer for Wiremock. Stubs are registered with {@link withMappings} (a directory),
+ * {@link withMapping} (one named stub) and {@link withFiles} (response bodies), in any
+ * combination. Registrations are validated immediately and may not overwrite one another.
  *
  * @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>;
+export declare class WiremockContainer extends GenericContainer {
+  #private;
+  /**
+   * 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 `mappings/` and, optionally, `__files/`.
+   * @throws If `mappings/` is not a directory in `directory`, or a file would overwrite an earlier registration.
+   */
+  withMappings(directory: string): this;
+  /**
+   * Registers one stub at `mappings/<name>.json`, validated and copied byte-for-byte.
+   * @example
+   * ```typescript
+   * new WiremockContainer()
+   *   .withMapping("cards", "./test/fixtures/cards.json")
+   *   .withMapping("user", { package: "@acme/fixtures", file: "wiremock/user.json" })
+   *   .withMapping("balance", { module: import.meta.url, file: "./balance.json" })
+   *   .withMapping("ping", { json: { request: { url: "/ping" }, response: { status: 200 } } });
+   * ```
+   * @param name File name below `mappings/`, may contain `/`; `.json` is appended unless present.
+   * @throws If the name or source is invalid, the source is not a WireMock mapping, or it would overwrite an earlier registration.
+   */
+  withMapping(name: string, source: WiremockMappingSource): this;
+  /**
+   * Registers response bodies at `__files/<name>` (default: the base name), copied as-is.
+   * @example
+   * ```typescript
+   * new WiremockContainer().withFiles("./test/fixtures/body.json", { file: "./logo.png", name: "img/logo.png" });
+   * ```
+   * @throws If a source or name is invalid, or a file would overwrite an earlier registration; nothing is registered then.
+   */
+  withFiles(...files: WiremockStaticFile[]): this;
+  /**
+   * Starts the container and returns a {@link StartedWiremockContainer}.
+   * @returns A promise that resolves to the started container.
+   */
+  override 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 declare class StartedWiremockContainer extends AbstractStartedContainer {
+  #private;
+  /**
+   * 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
+export type { WiremockFileSource, WiremockMappingSource, WiremockPath, WiremockStaticFile, WiremockStubMapping };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +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;;;;"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/sources.ts","../src/index.ts"],"mappings":";;KAMY,wBAAwB;;;;;;KAOxB,qBACR;WACW,MAAM;;WACN;WAA0B;;WAC1B,QAAQ;WAAuB;;;UAG7B;WACN;WACA;;;;KAKC,wBACR;WACW,eAAe;aAAiC,mBAAmB;;;;KAGtE,qBAAqB,gBAAgB,QAAQ,oBAAoB;WAA2B;;;;;;;;;;;;qBCoB3F,0BAA0B;;;;;;;;;;EAcrC,YAAY;;;;;;;;;;;;EAiBZ,aAAoB;;;;;;;;;;;;;;EAmCpB,YAAmB,cAAc,QAAQ;;;;;;;;;EAqBzC,aAAoB,OAAO;;;;;WAgBL,SAAS,QAAQ;;;;;qBAmC5B,iCAAiC;;;;;;;EAQ5C,YAAY,sBAAsB,sBAAsB;;;;MAQpD"}

package/dist/index.d.ts

@@ -1,56 +1,113 @@
-import { AbstractStartedContainer, StartedTestContainer, GenericContainer } from 'testcontainers';
-
+import { AbstractStartedContainer, GenericContainer, StartedTestContainer } from "testcontainers";
+/** A path (relative to the working directory) or a `file:` URL. */
+type WiremockPath = string | URL;
 /**
- * A Testcontainer for Wiremock.
+ * A fixture file: a local path or `file:` URL, `{ file }`, a file inside an installed npm
+ * package `{ package, file }` (its `exports` are ignored), or a file next to a module
+ * `{ module: import.meta.url | __filename | __dirname, file }`.
+ */
+type WiremockFileSource = WiremockPath | {
+  readonly file: WiremockPath;
+} | {
+  readonly package: string;
+  readonly file: string;
+} | {
+  readonly module: WiremockPath;
+  readonly file: string;
+};
+/** A WireMock stub; fields besides `request` and `response` are passed through. */
+interface WiremockStubMapping {
+  readonly request: object;
+  readonly response: object;
+  readonly [field: string]: unknown;
+}
+/** A file source, or inline JSON: a string, a stub or `{ mappings: [...] }`. */
+type WiremockMappingSource = WiremockFileSource | {
+  readonly json: string | WiremockStubMapping | {
+    readonly mappings: readonly WiremockStubMapping[];
+  };
+};
+/** A file source; object forms may set `name`, the path below `__files/` (default: the base name). */
+type WiremockStaticFile = WiremockPath | (Exclude<WiremockFileSource, WiremockPath> & {
+  readonly name?: string;
+});
+/**
+ * A Testcontainer for Wiremock. Stubs are registered with {@link withMappings} (a directory),
+ * {@link withMapping} (one named stub) and {@link withFiles} (response bodies), in any
+ * combination. Registrations are validated immediately and may not overwrite one another.
  *
  * @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>;
+export declare class WiremockContainer extends GenericContainer {
+  #private;
+  /**
+   * 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 `mappings/` and, optionally, `__files/`.
+   * @throws If `mappings/` is not a directory in `directory`, or a file would overwrite an earlier registration.
+   */
+  withMappings(directory: string): this;
+  /**
+   * Registers one stub at `mappings/<name>.json`, validated and copied byte-for-byte.
+   * @example
+   * ```typescript
+   * new WiremockContainer()
+   *   .withMapping("cards", "./test/fixtures/cards.json")
+   *   .withMapping("user", { package: "@acme/fixtures", file: "wiremock/user.json" })
+   *   .withMapping("balance", { module: import.meta.url, file: "./balance.json" })
+   *   .withMapping("ping", { json: { request: { url: "/ping" }, response: { status: 200 } } });
+   * ```
+   * @param name File name below `mappings/`, may contain `/`; `.json` is appended unless present.
+   * @throws If the name or source is invalid, the source is not a WireMock mapping, or it would overwrite an earlier registration.
+   */
+  withMapping(name: string, source: WiremockMappingSource): this;
+  /**
+   * Registers response bodies at `__files/<name>` (default: the base name), copied as-is.
+   * @example
+   * ```typescript
+   * new WiremockContainer().withFiles("./test/fixtures/body.json", { file: "./logo.png", name: "img/logo.png" });
+   * ```
+   * @throws If a source or name is invalid, or a file would overwrite an earlier registration; nothing is registered then.
+   */
+  withFiles(...files: WiremockStaticFile[]): this;
+  /**
+   * Starts the container and returns a {@link StartedWiremockContainer}.
+   * @returns A promise that resolves to the started container.
+   */
+  override 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 declare class StartedWiremockContainer extends AbstractStartedContainer {
+  #private;
+  /**
+   * 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
+export type { WiremockFileSource, WiremockMappingSource, WiremockPath, WiremockStaticFile, WiremockStubMapping };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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;;;;"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/sources.ts","../src/index.ts"],"mappings":";;KAMY,wBAAwB;;;;;;KAOxB,qBACR;WACW,MAAM;;WACN;WAA0B;;WAC1B,QAAQ;WAAuB;;;UAG7B;WACN;WACA;;;;KAKC,wBACR;WACW,eAAe;aAAiC,mBAAmB;;;;KAGtE,qBAAqB,gBAAgB,QAAQ,oBAAoB;WAA2B;;;;;;;;;;;;qBCoB3F,0BAA0B;;;;;;;;;;EAcrC,YAAY;;;;;;;;;;;;EAiBZ,aAAoB;;;;;;;;;;;;;;EAmCpB,YAAmB,cAAc,QAAQ;;;;;;;;;EAqBzC,aAAoB,OAAO;;;;;WAgBL,SAAS,QAAQ;;;;;qBAmC5B,iCAAiC;;;;;;;EAQ5C,YAAY,sBAAsB,sBAAsB;;;;MAQpD"}

package/dist/index.js

@@ -1,73 +1,192 @@
-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)}`);
-    }
+import { createRequire } from "node:module";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { basename, dirname, join, posix, relative, resolve, sep } from "node:path";
+import { AbstractStartedContainer, GenericContainer, Wait } from "testcontainers";
+import { fileURLToPath } from "node:url";
+// src/sources.ts
+const PACKAGE_NAME = /^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/u;
+function fail(message) {
+	throw new Error(message);
 }
-/**
- * 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;
-    }
+function within(context, fn) {
+	try {
+		return fn();
+	} catch (error) {
+		throw new Error(`${context}: ${error.message}`, { cause: error });
+	}
 }
-
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const show = (value) => value instanceof URL ? value.href : JSON.stringify(value) ?? String(value);
+const text = (value, field) => typeof value === "string" && value.trim() !== "" ? value : fail(`"${field}" must be a non-empty string, got ${show(value)}`);
+const toPath = (value, field) => {
+	if (!(value instanceof URL) && !text(value, field).startsWith("file:")) return resolve(value);
+	try {
+		return fileURLToPath(value);
+	} catch {
+		return fail(`"${field}" must be a path or a file: URL, got ${show(value)}`);
+	}
+};
+const existingFile = (path) => {
+	const stats = statSync(path, { throwIfNoEntry: false });
+	return stats?.isFile() ? path : fail(`"${path}" ${stats ? "is not a file" : "does not exist"}`);
+};
+const packageRoot = (name) => {
+	if (!PACKAGE_NAME.test(name)) fail(`"${name}" is not a valid npm package name`);
+	return (createRequire(join(process.cwd(), "noop.js")).resolve.paths(name) ?? []).map((dir) => join(dir, name)).find((dir) => existsSync(join(dir, "package.json"))) ?? fail(`package "${name}" is not installed (searched from "${process.cwd()}")`);
+};
+function resolveFile(source) {
+	if (typeof source === "string" || source instanceof URL) return existingFile(toPath(source, "source"));
+	if (!isRecord(source)) return fail(`unsupported source ${show(source)}; expected a path, a file: URL, { file }, { package, file } or { module, file }`);
+	const { file, package: pkg, module } = source;
+	if (pkg !== void 0 && module !== void 0) fail("a source may set \"package\" or \"module\", not both");
+	if (pkg !== void 0) {
+		const root = packageRoot(text(pkg, "package"));
+		const path = resolve(root, text(file, "file"));
+		return relative(root, path).split(sep)[0] === ".." ? fail(`"${String(file)}" must point to a file inside package "${pkg}"`) : existingFile(path);
+	}
+	if (module === void 0) return existingFile(toPath(file, "file"));
+	const anchor = toPath(module, "module");
+	return existingFile(resolve(statSync(anchor, { throwIfNoEntry: false })?.isDirectory() ? anchor : dirname(anchor), text(file, "file")));
+}
+const containerName = (name) => {
+	const value = text(name, "name");
+	return value.split("/").some((part) => [
+		"",
+		".",
+		".."
+	].includes(part) || /[\\\0]/u.test(part)) ? fail(`name "${value}" must be a relative path using "/" separators, without empty, "." or ".." segments`) : value;
+};
+const inlineJson = (json) => typeof json === "string" ? json : JSON.stringify(json, null, 2) ?? fail("\"json\" must be a JSON string or an object");
+const parseJson = (json) => {
+	try {
+		return JSON.parse(json);
+	} catch (error) {
+		return fail(`invalid JSON (${error.message})`);
+	}
+};
+function stubIds(json) {
+	const value = parseJson(json);
+	const many = isRecord(value) && "mappings" in value;
+	const stubs = many ? value.mappings : [value];
+	if (!Array.isArray(stubs) || stubs.length === 0) fail("\"mappings\" must be a non-empty array of stub mappings");
+	return stubs.flatMap((stub, index) => {
+		if (!isRecord(stub) || !isRecord(stub.request) || !isRecord(stub.response)) fail(`${many ? `mappings[${index}]` : "the mapping"} is not a WireMock stub mapping ("request" and "response" objects are required)`);
+		const id = stub.id ?? stub.uuid;
+		return typeof id === "string" ? [id] : [];
+	});
+}
+const stubIdsOf = (path) => {
+	try {
+		return path.endsWith(".json") ? stubIds(readFileSync(path, "utf8")) : [];
+	} catch {
+		return [];
+	}
+};
+const listFiles = (dir) => readdirSync(dir, {
+	recursive: true,
+	withFileTypes: true
+}).filter((entry) => !entry.isDirectory()).map((entry) => relative(dir, join(entry.parentPath, entry.name)).split(sep).join("/"));
+// src/index.ts
+const MAPPINGS = "/home/wiremock/mappings";
+const FILES = "/home/wiremock/__files";
+const INLINE = "inline JSON";
+var WiremockContainer = class extends GenericContainer {
+	#origins = /* @__PURE__ */ new Map();
+	#stubIds = /* @__PURE__ */ new Map();
+	constructor(image = "wiremock/wiremock") {
+		super(image);
+		this.withExposedPorts(8080);
+		this.withWaitStrategy(Wait.forListeningPorts());
+	}
+	withMappings(directory) {
+		within("WiremockContainer.withMappings", () => {
+			const mappings = join(directory, "mappings");
+			if (!existsSync(mappings)) fail(`"${mappings}" does not exist`);
+			if (!statSync(mappings).isDirectory()) fail(`"${mappings}" is not a directory`);
+			const files = join(directory, "__files");
+			const dirs = [{
+				source: mappings,
+				target: MAPPINGS
+			}, ...existsSync(files) ? [{
+				source: files,
+				target: FILES
+			}] : []];
+			this.#claim(dirs.flatMap(({ source, target }) => listFiles(source).map((name) => ({
+				target: posix.join(target, name),
+				origin: resolve(source, name),
+				ids: target === MAPPINGS ? stubIdsOf(join(source, name)) : []
+			}))));
+			this.withCopyDirectoriesToContainer(dirs);
+		});
+		return this;
+	}
+	withMapping(name, source) {
+		within(`WiremockContainer.withMapping("${name}")`, () => {
+			const file = containerName(name);
+			const target = posix.join(MAPPINGS, file.endsWith(".json") ? file : `${file}.json`);
+			const inline = isRecord(source) && "json" in source;
+			const origin = inline ? INLINE : resolveFile(source);
+			const content = inline ? inlineJson(source.json) : readFileSync(origin);
+			const ids = within(origin, () => stubIds(content.toString()));
+			this.withCopyContentToContainer(this.#claim([{
+				target,
+				origin,
+				ids
+			}]).map(() => ({
+				content,
+				target
+			})));
+		});
+		return this;
+	}
+	withFiles(...files) {
+		within("WiremockContainer.withFiles", () => {
+			const claims = files.map((file) => {
+				const origin = resolveFile(file);
+				const name = isRecord(file) && file.name !== void 0 ? containerName(file.name) : basename(origin);
+				return {
+					target: posix.join(FILES, name),
+					origin
+				};
+			});
+			this.withCopyFilesToContainer(this.#claim(claims).map(({ origin, target }) => ({
+				source: origin,
+				target
+			})));
+		});
+		return this;
+	}
+	async start() {
+		const startedContainer = await super.start();
+		return new StartedWiremockContainer(startedContainer, `http://${startedContainer.getHost()}:${startedContainer.getMappedPort(8080)}`);
+	}
+	#claim(claims) {
+		const origins = new Map(this.#origins);
+		const owners = new Map(this.#stubIds);
+		const fresh = claims.filter(({ target, origin, ids = [] }) => {
+			const existing = origins.get(target);
+			if (existing === origin && origin !== INLINE) return false;
+			if (existing) fail(`"${target}" is already registered from ${existing}; registering ${origin} would overwrite it`);
+			for (const id of ids) {
+				const owner = owners.get(id);
+				if (owner) fail(`stub id "${id}" in ${origin} is already used by "${owner}"; WireMock refuses to start with duplicate stub ids`);
+				owners.set(id, target);
+			}
+			origins.set(target, origin);
+			return true;
+		});
+		[this.#origins, this.#stubIds] = [origins, owners];
+		return fresh;
+	}
+};
+var StartedWiremockContainer = class extends AbstractStartedContainer {
+	#rpcUrl;
+	constructor(startedTestContainer, url) {
+		super(startedTestContainer);
+		this.#rpcUrl = url;
+	}
+	get rpcUrl() {
+		return this.#rpcUrl;
+	}
+};
 export { StartedWiremockContainer, WiremockContainer };