@hellaweb3/wiremock-testcontainers-nodejs 0.2.1 → 0.3.0

package/dist/index.js

@@ -1,192 +1 @@
-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);
-}
-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 };
+import{t as getRuntime}from"./runtime-ChyDTLYb.js";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";const PACKAGE_NAME=/^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/u;function fail(message){throw new Error(message)}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(`/`));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 runtime=getRuntime();const startedContainer=runtime?await runtime.start(this.#startRequest()):await super.start();return new StartedWiremockContainer(startedContainer,`http://${startedContainer.getHost()}:${startedContainer.getMappedPort(8080)}`)}#startRequest(){return{image:this.imageName.string,name:this.createOpts.name,command:[...this.createOpts.Cmd??[]],environment:{...this.environment},directories:this.directoriesToCopy.map(({source,target})=>({source,target})),files:this.filesToCopy.map(({source,target})=>({source,target})),contents:this.contentsToCopy.map(({content,target})=>({content,target}))}}#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}};const ADMIN_PATH=`/__admin`;var StartedWiremockContainer=class extends AbstractStartedContainer{#rpcUrl;constructor(startedTestContainer,url){super(startedTestContainer);this.#rpcUrl=url}get rpcUrl(){return this.#rpcUrl}getUrl(path=``){if(path===``)return this.#rpcUrl;const suffix=path.startsWith(`/`)||path.startsWith(`?`)?path:`/${path}`;return`${this.#rpcUrl}${suffix}`}getAdminUrl(){return`${this.#rpcUrl}${ADMIN_PATH}`}getMappingUrl(){return`${this.getAdminUrl()}/mappings`}async isRunning(){try{const health=await fetch(`${this.getAdminUrl()}/health`);if(health.status!==404)return health.ok;return(await fetch(this.getMappingUrl())).ok}catch{return false}}async waitUntilReady(options={}){const{timeout=3e4,interval=250}=options;const deadline=Date.now()+timeout;const poll=async()=>{if(await this.isRunning())return;if(Date.now()>=deadline)throw new Error(`WireMock at ${this.#rpcUrl} was not ready within ${timeout}ms`);await new Promise(_resolve=>setTimeout(_resolve,interval));return poll()};await poll()}async reset(){await this.#admin(`POST`,`/reset`)}async resetRequests(){await this.#admin(`DELETE`,`/requests`)}async countRequests(request){const{count}=await(await this.#admin(`POST`,`/requests/count`,request)).json();return count}async findRequests(request){const{requests}=await(await this.#admin(`POST`,`/requests/find`,request)).json();return requests??[]}async#admin(method,path,body){const response=await fetch(`${this.getAdminUrl()}${path}`,{method,...body===void 0?{}:{headers:{"Content-Type":`application/json`},body:JSON.stringify(body)}});if(!response.ok){const detail=await response.text().catch(()=>``);throw new Error(`WireMock admin request ${method} ${ADMIN_PATH}${path} failed with ${response.status} ${response.statusText}${detail?`: ${detail}`:``}`)}return response}};export{StartedWiremockContainer,WiremockContainer};

package/dist/no-docker.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const require_runtime=require("./runtime-6blQsklJ.cjs");let node_fs=require("node:fs");let node_path=require("node:path");let node_module=require("node:module");let node_child_process=require("node:child_process");let node_crypto=require("node:crypto");let node_events=require("node:events");let node_net=require("node:net");let node_os=require("node:os");let node_stream=require("node:stream");let node_stream_consumers=require("node:stream/consumers");const NO_DOCKER_ENV=`WIREMOCK_NO_DOCKER`;const CI_VARIABLES=[`CI`,`CONTINUOUS_INTEGRATION`,`GITHUB_ACTIONS`,`GITLAB_CI`,`CIRCLECI`,`BUILDKITE`,`JENKINS_URL`,`TF_BUILD`,`TEAMCITY_VERSION`,`BITBUCKET_BUILD_NUMBER`,`CODEBUILD_BUILD_ID`];const WIREMOCK_HOME=`/home/wiremock`;const WIREMOCK_PORT=8080;const HOST=`127.0.0.1`;const POLL_INTERVAL=25;const FAST_START=[`-XX:+IgnoreUnrecognizedVMOptions`,`-XX:TieredStopAtLevel=1`];const GRACEFUL_EXIT=143;const STALE_RECORDING=36e5;function detectCI(env=process.env){return CI_VARIABLES.find(name=>{const value=env[name]?.trim().toLowerCase();return value!==void 0&&value!==``&&value!==`false`&&value!==`0`})}function isNoDockerRequested(env=process.env){const value=env[NO_DOCKER_ENV]?.trim().toLowerCase();return value===`1`||value===`true`}function installNoDockerRuntime(options={}){const env=options.env??process.env;const ci=detectCI(env);if(ci)throw new Error(`--no-docker must not be used in CI/CD (detected ${ci}=${env[ci]}): it does not run WireMock in a container. Run the E2E suite with Docker instead.`);const runtime=new NoDockerRuntime({jar:resolveJar(options.jar??env.WIREMOCK_JAR),java:options.java??env.WIREMOCK_JAVA??(env.JAVA_HOME?(0,node_path.join)(env.JAVA_HOME,`bin`,`java`):`java`),startupTimeout:options.startupTimeout??6e4,cacheDir:options.cacheDir??(0,node_path.join)((0,node_os.tmpdir)(),`wiremock-testcontainers`),log:options.log??(message=>process.emitWarning(message,{code:`WIREMOCK_NO_DOCKER`}))});require_runtime.n(runtime);return()=>{if(require_runtime.t()===runtime)require_runtime.n(void 0)}}function resolveJar(explicit){if(explicit){const jar=(0,node_path.resolve)(explicit);if(!(0,node_fs.existsSync)(jar))throw new Error(`--no-docker: WireMock JAR "${jar}" does not exist`);return jar}let build;try{build=(0,node_path.join)((0,node_path.dirname)((0,node_module.createRequire)((0,node_path.join)(process.cwd(),`noop.js`)).resolve(`wiremock/package.json`)),`build`)}catch{throw new Error('--no-docker: no WireMock standalone JAR found – install the "wiremock" npm package (e.g. `npm i -D wiremock`) or set WIREMOCK_JAR to a wiremock-standalone-*.jar')}const name=(0,node_fs.existsSync)(build)?(0,node_fs.readdirSync)(build).find(file=>/^wiremock-standalone-.+\.jar$/u.test(file)):void 0;if(!name)throw new Error(`--no-docker: the "wiremock" npm package contains no wiremock-standalone-*.jar in "${build}"`);return(0,node_path.join)(build,name)}function classData(cacheDir,jar,java){if(cacheDir===false)return void 0;try{(0,node_fs.mkdirSync)(cacheDir,{recursive:true});const{size,mtimeMs}=(0,node_fs.statSync)(jar);const key=(0,node_crypto.createHash)(`sha256`).update(`${jar}\0${size}\0${mtimeMs}\0${java}`).digest(`hex`).slice(0,16);const path=(0,node_path.join)(cacheDir,`wiremock-${key}.jsa`);if((0,node_fs.existsSync)(path))return{path};for(const file of(0,node_fs.readdirSync)(cacheDir)){const stale=(0,node_path.join)(cacheDir,file);if(file.endsWith(`.tmp`)&&Date.now()-(0,node_fs.statSync)(stale).mtimeMs>STALE_RECORDING)(0,node_fs.rmSync)(stale,{force:true})}return{path,recording:`${path}.${(0,node_crypto.randomUUID)()}.tmp`}}catch{return}}var NoDockerRuntime=class{#config;constructor(config){this.#config=config}async start(request){const root=(0,node_fs.mkdtempSync)((0,node_path.join)((0,node_os.tmpdir)(),`wiremock-no-docker-`));try{await materialize(request,root);const home=(0,node_path.join)(root,WIREMOCK_HOME);for(const dir of[`mappings`,`__files`])(0,node_fs.mkdirSync)((0,node_path.join)(home,dir),{recursive:true});const container=new NoDockerContainer(request,this.#config,root,home,await freePort());await container.launch();this.#config.log(container.describe());return container}catch(error){(0,node_fs.rmSync)(root,{recursive:true,force:true});throw error}}};async function materialize(request,root){const at=target=>{const path=(0,node_path.join)(root,target);(0,node_fs.mkdirSync)((0,node_path.dirname)(path),{recursive:true});return path};for(const{source,target}of request.directories)(0,node_fs.cpSync)(source,at(target),{recursive:true});for(const{source,target}of request.files)(0,node_fs.copyFileSync)(source,at(target));const contents=await Promise.all(request.contents.map(async({content,target})=>({target,bytes:content instanceof node_stream.Readable?await(0,node_stream_consumers.buffer)(content):content})));for(const{target,bytes}of contents)(0,node_fs.writeFileSync)(at(target),bytes)}function freePort(){return new Promise((_resolve,_reject)=>{const server=(0,node_net.createServer)();server.once(`error`,_reject);server.listen(0,HOST,()=>{const{port}=server.address();server.close(()=>_resolve(port))})})}async function isHealthy(url){try{const health=await fetch(`${url}/__admin/health`);if(health.status!==404)return health.ok;return(await fetch(`${url}/__admin/mappings`)).ok}catch{return false}}const split=value=>value?.split(/\s+/u).filter(Boolean)??[];const live=/* @__PURE__ */ new Set;let exitHookInstalled=false;const killOnExit=child=>{live.add(child);if(exitHookInstalled)return;exitHookInstalled=true;process.once(`exit`,()=>{for(const process of live)process.kill(`SIGKILL`)})};const unsupported=method=>/* @__PURE__ */ new Error(`${method}() is not supported with --no-docker: WireMock runs as a local JVM process, not in a container`);var NoDockerContainer=class{#request;#config;#root;#home;#port;#id=`no-docker-${(0,node_crypto.randomUUID)()}`;#child;#classData;#spawnError;#output=``;constructor(request,config,root,home,port){this.#request=request;this.#config=config;this.#root=root;this.#home=home;this.#port=port}async launch(){const{environment,command}=this.#request;const data=this.#classData=classData(this.#config.cacheDir,this.#config.jar,this.#config.java);const args=[...FAST_START,...data?[data.recording?`-XX:ArchiveClassesAtExit=${data.recording}`:`-XX:SharedArchiveFile=${data.path}`]:[],...split(environment.JAVA_OPTS),`-jar`,this.#config.jar,`--port`,String(this.#port),`--bind-address`,HOST,`--root-dir`,this.#home,...command,...split(environment.WIREMOCK_OPTIONS)];this.#output=``;this.#spawnError=void 0;const child=(0,node_child_process.spawn)(this.#config.java,args,{env:{...process.env,...environment},stdio:[`ignore`,`pipe`,`pipe`]});this.#child=child;child.once(`error`,error=>{this.#spawnError=error});const record=chunk=>{this.#output=(this.#output+chunk.toString()).slice(-65536)};child.stdout?.on(`data`,record);child.stderr?.on(`data`,record);killOnExit(child);try{await this.#waitUntilHealthy(child)}catch(error){await this.#terminate();throw error}if(data&&!data.recording&&/\[warning\]\[cds/u.test(this.#output))(0,node_fs.rmSync)(data.path,{force:true})}async#waitUntilHealthy(child){const deadline=Date.now()+this.#config.startupTimeout;const output=()=>this.#output.trim()?`\n--- WireMock output ---\n${this.#output.trim()}`:``;const poll=async()=>{if(this.#spawnError){const missing=this.#spawnError.code===`ENOENT`;throw new Error(missing?`--no-docker: Java executable "${this.#config.java}" not found – WireMock's standalone JAR needs a Java 11+ runtime; install one or set WIREMOCK_JAVA / JAVA_HOME`:`--no-docker: could not start "${this.#config.java}": ${this.#spawnError.message}`,{cause:this.#spawnError})}if(child.exitCode!==null||child.signalCode!==null)throw new Error(`--no-docker: WireMock exited during start-up (${child.signalCode??`exit code ${child.exitCode}`})${output()}`);if(await isHealthy(this.#url))return;if(Date.now()>=deadline)throw new Error(`--no-docker: WireMock was not healthy within ${this.#config.startupTimeout}ms${output()}`);await new Promise(_resolve=>setTimeout(_resolve,POLL_INTERVAL));return poll()};await poll()}async#terminate(){const child=this.#child;const recording=this.#classData?.recording;live.delete(child);if(child?.pid&&child.exitCode===null&&child.signalCode===null){const exited=(0,node_events.once)(child,`exit`);child.kill(recording?`SIGTERM`:`SIGKILL`);const timer=setTimeout(()=>child.kill(`SIGKILL`),1e4);await exited;clearTimeout(timer)}if(!recording)return;try{if(child?.exitCode===GRACEFUL_EXIT&&(0,node_fs.existsSync)(recording))(0,node_fs.renameSync)(recording,this.#classData.path)}catch{}(0,node_fs.rmSync)(recording,{force:true});this.#classData=void 0}get#url(){return`http://${HOST}:${this.#port}`}describe(){const version=/wiremock-standalone-(.+)\.jar$/u.exec(this.#config.jar)?.[1]??`unknown`;const{image}=this.#request;const tag=image.slice(image.lastIndexOf(`:`)+1);const pinned=/^(\d+\.\d+\.\d+)/u.exec(tag)?.[1];const mismatch=pinned&&pinned!==version?` The image tag "${tag}" differs from the JAR version ${version}.`:``;return`--no-docker: "${this.#request.image}" is NOT running in a container – WireMock ${version} standalone (local JVM, pid ${this.#child?.pid}) serves ${this.#url} instead.${mismatch} Local development only; never use --no-docker in CI/CD.`}async stop(){await this.#terminate();(0,node_fs.rmSync)(this.#root,{recursive:true,force:true});const id=this.#id;return{getId:()=>id,copyArchiveFromContainer:async()=>Promise.reject(unsupported(`copyArchiveFromContainer`))}}async restart(){await this.#terminate();await this.launch()}async[Symbol.asyncDispose](){await this.stop()}getHost(){return HOST}getHostname(){return this.getName()}getFirstMappedPort(){return this.#port}getMappedPort(port,protocol=`tcp`){const key=typeof port===`number`?`${port}/${protocol}`:port;if(key!==`${WIREMOCK_PORT}/tcp`)throw new Error(`No port mapping found for "${key}"`);return this.#port}getName(){return this.#request.name??`wiremock-no-docker-${this.#port}`}getLabels(){return{}}getId(){return this.#id}getNetworkNames(){return[]}async logs(){return node_stream.Readable.from([this.#output])}getNetworkId(){throw unsupported(`getNetworkId`)}getIpAddress(){throw unsupported(`getIpAddress`)}async commit(){throw unsupported(`commit`)}async exec(){throw unsupported(`exec`)}async copyArchiveFromContainer(){throw unsupported(`copyArchiveFromContainer`)}async copyArchiveToContainer(){throw unsupported(`copyArchiveToContainer`)}async copyDirectoriesToContainer(){throw unsupported(`copyDirectoriesToContainer`)}async copyFilesToContainer(){throw unsupported(`copyFilesToContainer`)}async copyContentToContainer(){throw unsupported(`copyContentToContainer`)}};exports.NO_DOCKER_ENV=NO_DOCKER_ENV;exports.detectCI=detectCI;exports.installNoDockerRuntime=installNoDockerRuntime;exports.isNoDockerRequested=isNoDockerRequested;

package/dist/no-docker.d.cts

@@ -0,0 +1,45 @@
+/**
+ * `--no-docker` harness – **local development only**: serves every `WiremockContainer` from a
+ * local WireMock standalone JVM instead of Docker. Refuses to run in CI/CD and warns on every
+ * start. Needs Java 11+ and a WireMock JAR (e.g. the `wiremock` npm package).
+ * @example
+ * ```typescript
+ * // Vitest/Jest setup file, registered only when `WIREMOCK_NO_DOCKER=1`
+ * import { installNoDockerRuntime } from "@hellaweb3/wiremock-testcontainers-nodejs/no-docker";
+ * installNoDockerRuntime();
+ * ```
+ * @module
+ */
+/** Set to `1` by the `--no-docker` flag. */
+export declare const NO_DOCKER_ENV = "WIREMOCK_NO_DOCKER";
+type Environment = Readonly<Record<string, string | undefined>>;
+/** Options for {@link installNoDockerRuntime}. */
+export interface NoDockerOptions {
+  /** WireMock standalone JAR. Default: `$WIREMOCK_JAR`, else the `wiremock` npm package's. */
+  readonly jar?: string;
+  /** Java executable. Default: `$WIREMOCK_JAVA`, `$JAVA_HOME/bin/java`, else `java`. */
+  readonly java?: string;
+  /** Milliseconds to wait for WireMock to be healthy. Default `60_000`. */
+  readonly startupTimeout?: number;
+  /** Receives the per-start warning. Default: `process.emitWarning`. */
+  readonly log?: (message: string) => void;
+  /**
+   * Cache for the class-data archive that halves JVM start-up after the first run; `false`
+   * disables it. Default: `<os tmpdir>/wiremock-testcontainers`.
+   */
+  readonly cacheDir?: string | false;
+  /** Source of the CI/CD check and the defaults above. Default: `process.env`. */
+  readonly env?: Environment;
+}
+/** The CI/CD variable set in `env`, if any. */
+export declare function detectCI(env?: Environment): string | undefined;
+/** Whether {@link NO_DOCKER_ENV} is `1` or `true`. */
+export declare function isNoDockerRequested(env?: Environment): boolean;
+/**
+ * Serves every `WiremockContainer` started from now on from a local WireMock JVM: its mappings,
+ * files and command are materialised into a temp directory, WireMock listens on a free port of
+ * `127.0.0.1`. Container-only features (`exec`, networks, …) throw.
+ * @returns A function that uninstalls it.
+ * @throws In CI/CD, or if no WireMock JAR is found.
+ */
+export declare function installNoDockerRuntime(options?: NoDockerOptions): () => void;

package/dist/no-docker.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `--no-docker` harness – **local development only**: serves every `WiremockContainer` from a
+ * local WireMock standalone JVM instead of Docker. Refuses to run in CI/CD and warns on every
+ * start. Needs Java 11+ and a WireMock JAR (e.g. the `wiremock` npm package).
+ * @example
+ * ```typescript
+ * // Vitest/Jest setup file, registered only when `WIREMOCK_NO_DOCKER=1`
+ * import { installNoDockerRuntime } from "@hellaweb3/wiremock-testcontainers-nodejs/no-docker";
+ * installNoDockerRuntime();
+ * ```
+ * @module
+ */
+/** Set to `1` by the `--no-docker` flag. */
+export declare const NO_DOCKER_ENV = "WIREMOCK_NO_DOCKER";
+type Environment = Readonly<Record<string, string | undefined>>;
+/** Options for {@link installNoDockerRuntime}. */
+export interface NoDockerOptions {
+  /** WireMock standalone JAR. Default: `$WIREMOCK_JAR`, else the `wiremock` npm package's. */
+  readonly jar?: string;
+  /** Java executable. Default: `$WIREMOCK_JAVA`, `$JAVA_HOME/bin/java`, else `java`. */
+  readonly java?: string;
+  /** Milliseconds to wait for WireMock to be healthy. Default `60_000`. */
+  readonly startupTimeout?: number;
+  /** Receives the per-start warning. Default: `process.emitWarning`. */
+  readonly log?: (message: string) => void;
+  /**
+   * Cache for the class-data archive that halves JVM start-up after the first run; `false`
+   * disables it. Default: `<os tmpdir>/wiremock-testcontainers`.
+   */
+  readonly cacheDir?: string | false;
+  /** Source of the CI/CD check and the defaults above. Default: `process.env`. */
+  readonly env?: Environment;
+}
+/** The CI/CD variable set in `env`, if any. */
+export declare function detectCI(env?: Environment): string | undefined;
+/** Whether {@link NO_DOCKER_ENV} is `1` or `true`. */
+export declare function isNoDockerRequested(env?: Environment): boolean;
+/**
+ * Serves every `WiremockContainer` started from now on from a local WireMock JVM: its mappings,
+ * files and command are materialised into a temp directory, WireMock listens on a free port of
+ * `127.0.0.1`. Container-only features (`exec`, networks, …) throw.
+ * @returns A function that uninstalls it.
+ * @throws In CI/CD, or if no WireMock JAR is found.
+ */
+export declare function installNoDockerRuntime(options?: NoDockerOptions): () => void;

package/dist/no-docker.js

@@ -0,0 +1 @@
+import{n as setRuntime,t as getRuntime}from"./runtime-ChyDTLYb.js";import{createRequire}from"node:module";import{copyFileSync,cpSync,existsSync,mkdirSync,mkdtempSync,readdirSync,renameSync,rmSync,statSync,writeFileSync}from"node:fs";import{dirname,join,resolve}from"node:path";import{spawn}from"node:child_process";import{createHash,randomUUID}from"node:crypto";import{once}from"node:events";import{createServer}from"node:net";import{tmpdir}from"node:os";import{Readable}from"node:stream";import{buffer}from"node:stream/consumers";const NO_DOCKER_ENV=`WIREMOCK_NO_DOCKER`;const CI_VARIABLES=[`CI`,`CONTINUOUS_INTEGRATION`,`GITHUB_ACTIONS`,`GITLAB_CI`,`CIRCLECI`,`BUILDKITE`,`JENKINS_URL`,`TF_BUILD`,`TEAMCITY_VERSION`,`BITBUCKET_BUILD_NUMBER`,`CODEBUILD_BUILD_ID`];const WIREMOCK_HOME=`/home/wiremock`;const WIREMOCK_PORT=8080;const HOST=`127.0.0.1`;const POLL_INTERVAL=25;const FAST_START=[`-XX:+IgnoreUnrecognizedVMOptions`,`-XX:TieredStopAtLevel=1`];const GRACEFUL_EXIT=143;const STALE_RECORDING=36e5;function detectCI(env=process.env){return CI_VARIABLES.find(name=>{const value=env[name]?.trim().toLowerCase();return value!==void 0&&value!==``&&value!==`false`&&value!==`0`})}function isNoDockerRequested(env=process.env){const value=env[NO_DOCKER_ENV]?.trim().toLowerCase();return value===`1`||value===`true`}function installNoDockerRuntime(options={}){const env=options.env??process.env;const ci=detectCI(env);if(ci)throw new Error(`--no-docker must not be used in CI/CD (detected ${ci}=${env[ci]}): it does not run WireMock in a container. Run the E2E suite with Docker instead.`);const runtime=new NoDockerRuntime({jar:resolveJar(options.jar??env.WIREMOCK_JAR),java:options.java??env.WIREMOCK_JAVA??(env.JAVA_HOME?join(env.JAVA_HOME,`bin`,`java`):`java`),startupTimeout:options.startupTimeout??6e4,cacheDir:options.cacheDir??join(tmpdir(),`wiremock-testcontainers`),log:options.log??(message=>process.emitWarning(message,{code:`WIREMOCK_NO_DOCKER`}))});setRuntime(runtime);return()=>{if(getRuntime()===runtime)setRuntime(void 0)}}function resolveJar(explicit){if(explicit){const jar=resolve(explicit);if(!existsSync(jar))throw new Error(`--no-docker: WireMock JAR "${jar}" does not exist`);return jar}let build;try{build=join(dirname(createRequire(join(process.cwd(),`noop.js`)).resolve(`wiremock/package.json`)),`build`)}catch{throw new Error('--no-docker: no WireMock standalone JAR found – install the "wiremock" npm package (e.g. `npm i -D wiremock`) or set WIREMOCK_JAR to a wiremock-standalone-*.jar')}const name=existsSync(build)?readdirSync(build).find(file=>/^wiremock-standalone-.+\.jar$/u.test(file)):void 0;if(!name)throw new Error(`--no-docker: the "wiremock" npm package contains no wiremock-standalone-*.jar in "${build}"`);return join(build,name)}function classData(cacheDir,jar,java){if(cacheDir===false)return void 0;try{mkdirSync(cacheDir,{recursive:true});const{size,mtimeMs}=statSync(jar);const key=createHash(`sha256`).update(`${jar}\0${size}\0${mtimeMs}\0${java}`).digest(`hex`).slice(0,16);const path=join(cacheDir,`wiremock-${key}.jsa`);if(existsSync(path))return{path};for(const file of readdirSync(cacheDir)){const stale=join(cacheDir,file);if(file.endsWith(`.tmp`)&&Date.now()-statSync(stale).mtimeMs>STALE_RECORDING)rmSync(stale,{force:true})}return{path,recording:`${path}.${randomUUID()}.tmp`}}catch{return}}var NoDockerRuntime=class{#config;constructor(config){this.#config=config}async start(request){const root=mkdtempSync(join(tmpdir(),`wiremock-no-docker-`));try{await materialize(request,root);const home=join(root,WIREMOCK_HOME);for(const dir of[`mappings`,`__files`])mkdirSync(join(home,dir),{recursive:true});const container=new NoDockerContainer(request,this.#config,root,home,await freePort());await container.launch();this.#config.log(container.describe());return container}catch(error){rmSync(root,{recursive:true,force:true});throw error}}};async function materialize(request,root){const at=target=>{const path=join(root,target);mkdirSync(dirname(path),{recursive:true});return path};for(const{source,target}of request.directories)cpSync(source,at(target),{recursive:true});for(const{source,target}of request.files)copyFileSync(source,at(target));const contents=await Promise.all(request.contents.map(async({content,target})=>({target,bytes:content instanceof Readable?await buffer(content):content})));for(const{target,bytes}of contents)writeFileSync(at(target),bytes)}function freePort(){return new Promise((_resolve,_reject)=>{const server=createServer();server.once(`error`,_reject);server.listen(0,HOST,()=>{const{port}=server.address();server.close(()=>_resolve(port))})})}async function isHealthy(url){try{const health=await fetch(`${url}/__admin/health`);if(health.status!==404)return health.ok;return(await fetch(`${url}/__admin/mappings`)).ok}catch{return false}}const split=value=>value?.split(/\s+/u).filter(Boolean)??[];const live=/* @__PURE__ */ new Set;let exitHookInstalled=false;const killOnExit=child=>{live.add(child);if(exitHookInstalled)return;exitHookInstalled=true;process.once(`exit`,()=>{for(const process of live)process.kill(`SIGKILL`)})};const unsupported=method=>/* @__PURE__ */ new Error(`${method}() is not supported with --no-docker: WireMock runs as a local JVM process, not in a container`);var NoDockerContainer=class{#request;#config;#root;#home;#port;#id=`no-docker-${randomUUID()}`;#child;#classData;#spawnError;#output=``;constructor(request,config,root,home,port){this.#request=request;this.#config=config;this.#root=root;this.#home=home;this.#port=port}async launch(){const{environment,command}=this.#request;const data=this.#classData=classData(this.#config.cacheDir,this.#config.jar,this.#config.java);const args=[...FAST_START,...data?[data.recording?`-XX:ArchiveClassesAtExit=${data.recording}`:`-XX:SharedArchiveFile=${data.path}`]:[],...split(environment.JAVA_OPTS),`-jar`,this.#config.jar,`--port`,String(this.#port),`--bind-address`,HOST,`--root-dir`,this.#home,...command,...split(environment.WIREMOCK_OPTIONS)];this.#output=``;this.#spawnError=void 0;const child=spawn(this.#config.java,args,{env:{...process.env,...environment},stdio:[`ignore`,`pipe`,`pipe`]});this.#child=child;child.once(`error`,error=>{this.#spawnError=error});const record=chunk=>{this.#output=(this.#output+chunk.toString()).slice(-65536)};child.stdout?.on(`data`,record);child.stderr?.on(`data`,record);killOnExit(child);try{await this.#waitUntilHealthy(child)}catch(error){await this.#terminate();throw error}if(data&&!data.recording&&/\[warning\]\[cds/u.test(this.#output))rmSync(data.path,{force:true})}async#waitUntilHealthy(child){const deadline=Date.now()+this.#config.startupTimeout;const output=()=>this.#output.trim()?`\n--- WireMock output ---\n${this.#output.trim()}`:``;const poll=async()=>{if(this.#spawnError){const missing=this.#spawnError.code===`ENOENT`;throw new Error(missing?`--no-docker: Java executable "${this.#config.java}" not found – WireMock's standalone JAR needs a Java 11+ runtime; install one or set WIREMOCK_JAVA / JAVA_HOME`:`--no-docker: could not start "${this.#config.java}": ${this.#spawnError.message}`,{cause:this.#spawnError})}if(child.exitCode!==null||child.signalCode!==null)throw new Error(`--no-docker: WireMock exited during start-up (${child.signalCode??`exit code ${child.exitCode}`})${output()}`);if(await isHealthy(this.#url))return;if(Date.now()>=deadline)throw new Error(`--no-docker: WireMock was not healthy within ${this.#config.startupTimeout}ms${output()}`);await new Promise(_resolve=>setTimeout(_resolve,POLL_INTERVAL));return poll()};await poll()}async#terminate(){const child=this.#child;const recording=this.#classData?.recording;live.delete(child);if(child?.pid&&child.exitCode===null&&child.signalCode===null){const exited=once(child,`exit`);child.kill(recording?`SIGTERM`:`SIGKILL`);const timer=setTimeout(()=>child.kill(`SIGKILL`),1e4);await exited;clearTimeout(timer)}if(!recording)return;try{if(child?.exitCode===GRACEFUL_EXIT&&existsSync(recording))renameSync(recording,this.#classData.path)}catch{}rmSync(recording,{force:true});this.#classData=void 0}get#url(){return`http://${HOST}:${this.#port}`}describe(){const version=/wiremock-standalone-(.+)\.jar$/u.exec(this.#config.jar)?.[1]??`unknown`;const{image}=this.#request;const tag=image.slice(image.lastIndexOf(`:`)+1);const pinned=/^(\d+\.\d+\.\d+)/u.exec(tag)?.[1];const mismatch=pinned&&pinned!==version?` The image tag "${tag}" differs from the JAR version ${version}.`:``;return`--no-docker: "${this.#request.image}" is NOT running in a container – WireMock ${version} standalone (local JVM, pid ${this.#child?.pid}) serves ${this.#url} instead.${mismatch} Local development only; never use --no-docker in CI/CD.`}async stop(){await this.#terminate();rmSync(this.#root,{recursive:true,force:true});const id=this.#id;return{getId:()=>id,copyArchiveFromContainer:async()=>Promise.reject(unsupported(`copyArchiveFromContainer`))}}async restart(){await this.#terminate();await this.launch()}async[Symbol.asyncDispose](){await this.stop()}getHost(){return HOST}getHostname(){return this.getName()}getFirstMappedPort(){return this.#port}getMappedPort(port,protocol=`tcp`){const key=typeof port===`number`?`${port}/${protocol}`:port;if(key!==`${WIREMOCK_PORT}/tcp`)throw new Error(`No port mapping found for "${key}"`);return this.#port}getName(){return this.#request.name??`wiremock-no-docker-${this.#port}`}getLabels(){return{}}getId(){return this.#id}getNetworkNames(){return[]}async logs(){return Readable.from([this.#output])}getNetworkId(){throw unsupported(`getNetworkId`)}getIpAddress(){throw unsupported(`getIpAddress`)}async commit(){throw unsupported(`commit`)}async exec(){throw unsupported(`exec`)}async copyArchiveFromContainer(){throw unsupported(`copyArchiveFromContainer`)}async copyArchiveToContainer(){throw unsupported(`copyArchiveToContainer`)}async copyDirectoriesToContainer(){throw unsupported(`copyDirectoriesToContainer`)}async copyFilesToContainer(){throw unsupported(`copyFilesToContainer`)}async copyContentToContainer(){throw unsupported(`copyContentToContainer`)}};export{NO_DOCKER_ENV,detectCI,installNoDockerRuntime,isNoDockerRequested};

package/dist/runtime-6blQsklJ.cjs

@@ -0,0 +1 @@
+const RUNTIME_KEY=Symbol.for(`@hellaweb3/wiremock-testcontainers-nodejs/runtime`);const registry=globalThis;const getRuntime=()=>registry[RUNTIME_KEY];const setRuntime=runtime=>{if(runtime)registry[RUNTIME_KEY]=runtime;else delete registry[RUNTIME_KEY]};Object.defineProperty(exports,"n",{enumerable:true,get:function(){return setRuntime}});Object.defineProperty(exports,"t",{enumerable:true,get:function(){return getRuntime}});

package/dist/runtime-ChyDTLYb.js

@@ -0,0 +1 @@
+const RUNTIME_KEY=Symbol.for(`@hellaweb3/wiremock-testcontainers-nodejs/runtime`);const registry=globalThis;const getRuntime=()=>registry[RUNTIME_KEY];const setRuntime=runtime=>{if(runtime)registry[RUNTIME_KEY]=runtime;else delete registry[RUNTIME_KEY]};export{setRuntime as n,getRuntime as t};

package/package.json

@@ -14,18 +14,14 @@
     "mock",
     "api"
   ],
-  "version": "0.2.1",
+  "version": "0.3.0",
   "publishConfig": {
     "access": "public"
   },
   "license": "MIT",
   "author": "Chris Anatalio",
   "files": [
-    "dist",
-    "!dist/*.js.map",
-    "src",
-    "README.md",
-    "LICENSE"
+    "dist"
   ],
   "type": "module",
   "sideEffects": false,
@@ -43,20 +39,39 @@
         "default": "./dist/index.cjs"
       }
     },
+    "./no-docker": {
+      "import": {
+        "types": "./dist/no-docker.d.ts",
+        "default": "./dist/no-docker.js"
+      },
+      "require": {
+        "types": "./dist/no-docker.d.cts",
+        "default": "./dist/no-docker.cjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "testcontainers": "^12.2.1"
+    "testcontainers": "^12.2.0"
+  },
+  "peerDependencies": {
+    "wiremock": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "wiremock": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@arethetypeswrong/core": "^0.18.5",
     "@types/node": "^26.6.6",
     "@vitest/coverage-v8": "^5.1.0",
-    "oxlint": "^1.93.0",
+    "oxlint": "^1.92.0",
     "publint": "^0.3.25",
-    "tsdown": "^0.23.7",
+    "tsdown": "0.23.0",
     "typescript": "^7.0.2",
-    "vitest": "^5.1.0"
+    "vitest": "^5.1.0",
+    "wiremock": "^3.13.2"
   },
   "engines": {
     "node": ">=22.22"
@@ -66,10 +81,12 @@
     "build": "tsdown",
     "test": "vitest run",
     "test:unit": "vitest run test/unit",
-    "test:e2e": "vitest run test/index.test.ts",
+    "test:e2e": "node scripts/test-e2e.mjs",
     "test:coverage": "vitest run --coverage",
     "lint": "oxlint --deny-warnings",
     "typecheck": "tsc --noEmit",
-    "check": "pnpm build && pnpm typecheck && pnpm lint && pnpm test:coverage"
+    "check": "pnpm build && pnpm typecheck && pnpm lint && pnpm test:coverage",
+    "examples:setup": "pnpm build && npm link && cd examples && npm install && npm run link:library",
+    "examples:e2e": "pnpm examples:setup && cd examples && npm run typecheck && npm test"
   }
 }

package/dist/index.d.cts.map

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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/src/index.ts

@@ -1,210 +0,0 @@
-import { existsSync, readFileSync, statSync } from "node:fs";
-import { basename, join, posix, resolve } from "node:path";
-import {
-  AbstractStartedContainer,
-  GenericContainer,
-  type StartedTestContainer,
-  Wait,
-} from "testcontainers";
-import {
-  containerName,
-  fail,
-  inlineJson,
-  isRecord,
-  listFiles,
-  resolveFile,
-  stubIds,
-  stubIdsOf,
-  within,
-  type WiremockMappingSource,
-  type WiremockStaticFile,
-} from "./sources";
-
-export type {
-  WiremockFileSource,
-  WiremockMappingSource,
-  WiremockPath,
-  WiremockStaticFile,
-  WiremockStubMapping,
-} from "./sources";
-
-const MAPPINGS = "/home/wiremock/mappings";
-const FILES = "/home/wiremock/__files";
-const INLINE = "inline JSON";
-
-/** A file a registration places in the container. */
-interface Claim {
-  readonly target: string;
-  /** The absolute source path, or {@link INLINE}. */
-  readonly origin: string;
-  readonly ids?: readonly 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();
- * ```
- */
-export class WiremockContainer extends GenericContainer {
-  /** Container path → origin of every registered file. */
-  #origins = new Map<string, string>();
-  /** Stub id → container path declaring it: WireMock refuses to start with duplicates. */
-  #stubIds = new Map<string, string>();
-
-  /**
-   * 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 `mappings/` and, optionally, `__files/`.
-   * @throws If `mappings/` is not a directory in `directory`, or a file would overwrite an earlier registration.
-   */
-  public withMappings(directory: string): this {
-    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`);
-      // `__files/` is optional: mappings may define their response bodies inline.
-      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;
-  }
-
-  /**
-   * 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.
-   */
-  public withMapping(name: string, source: WiremockMappingSource): this {
-    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;
-  }
-
-  /**
-   * 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.
-   */
-  public withFiles(...files: WiremockStaticFile[]): this {
-    within("WiremockContainer.withFiles", () => {
-      const claims = files.map((file) => {
-        const origin = resolveFile(file);
-        const name = isRecord(file) && file.name !== undefined ? 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;
-  }
-
-  /**
-   * 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)}`,
-    );
-  }
-
-  /**
-   * Records `claims` – all or nothing – unless one would overwrite a file from another origin or
-   * reuse a stub id. Returns the claims not already registered from the same file.
-   */
-  #claim<T extends Claim>(claims: readonly T[]): T[] {
-    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;
-  }
-}
-
-/**
- * A started Wiremock container with helper methods for interacting with the node.
- */
-export class StartedWiremockContainer extends AbstractStartedContainer {
-  readonly #rpcUrl: string;
-
-  /**
-   * 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(): string {
-    return this.#rpcUrl;
-  }
-}