@jaredwray/mockhttp 2.1.0 → 3.0.0

package/dist/index.mjs

@@ -13,195 +13,10 @@ import Fastify from "fastify";
 import { Hookified } from "hookified";
 import * as crypto$1 from "node:crypto";
 import crypto, { randomBytes, randomInt, randomUUID, timingSafeEqual } from "node:crypto";
+import Keyv from "keyv";
 import { Buffer as Buffer$1 } from "node:buffer";
 import { brotliCompressSync, deflateSync, gzipSync } from "node:zlib";
 import { escape } from "html-escaper";
-//#region src/bin-store.ts
-/**
-* In-memory implementation of {@link BinStore} backed by two Maps. State is
-* lost when the process exits.
-*/
-var InMemoryBinStore = class {
-	_bins = /* @__PURE__ */ new Map();
-	_requests = /* @__PURE__ */ new Map();
-	createBin(bin) {
-		this._bins.set(bin.id, bin);
-		this._requests.set(bin.id, []);
-	}
-	getBin(id) {
-		return this._bins.get(id);
-	}
-	listBins() {
-		return [...this._bins.values()];
-	}
-	deleteBin(id) {
-		this._requests.delete(id);
-		return this._bins.delete(id);
-	}
-	addRequest(binId, req, max) {
-		const bin = this._bins.get(binId);
-		const list = this._requests.get(binId);
-		if (!bin || !list) return;
-		list.unshift(req);
-		while (list.length > max && list.length > 0) list.pop();
-		bin.requestCount = list.length;
-	}
-	getRequests(binId) {
-		return [...this._requests.get(binId) ?? []];
-	}
-	getRequest(binId, reqId) {
-		return this._requests.get(binId)?.find((r) => r.id === reqId);
-	}
-	clearRequests(binId) {
-		const bin = this._bins.get(binId);
-		if (!bin) return;
-		this._requests.set(binId, []);
-		bin.requestCount = 0;
-	}
-	cleanupExpired(now) {
-		const removed = [];
-		for (const [id, bin] of this._bins) if (Date.parse(bin.expiresAt) <= now) {
-			this._bins.delete(id);
-			this._requests.delete(id);
-			removed.push(id);
-		}
-		return removed;
-	}
-};
-//#endregion
-//#region src/bin-manager.ts
-const DEFAULT_TTL_MS = 864e5;
-const DEFAULT_MAX_REQUESTS = 100;
-const DEFAULT_MAX_BODY_SIZE = 1048576;
-const DEFAULT_ID_LENGTH = 12;
-const DEFAULT_CLEANUP_INTERVAL_MS = 6e4;
-/**
-* Manages request bins: ephemeral URL endpoints that capture incoming HTTP
-* requests so they can be inspected later.
-*/
-var BinManager = class {
-	_store;
-	_defaultTtlMs;
-	_maxRequestsPerBin;
-	_maxBodySize;
-	_idLength;
-	_cleanupIntervalMs;
-	_cleanupTimer;
-	constructor(options) {
-		this._store = options?.store ?? new InMemoryBinStore();
-		this._defaultTtlMs = options?.defaultTtlMs ?? DEFAULT_TTL_MS;
-		this._maxRequestsPerBin = Math.max(0, options?.maxRequestsPerBin ?? DEFAULT_MAX_REQUESTS);
-		this._maxBodySize = options?.maxBodySize ?? DEFAULT_MAX_BODY_SIZE;
-		this._idLength = options?.idLength ?? DEFAULT_ID_LENGTH;
-		this._cleanupIntervalMs = options?.cleanupIntervalMs ?? DEFAULT_CLEANUP_INTERVAL_MS;
-	}
-	/** Underlying storage backend. */
-	get store() {
-		return this._store;
-	}
-	/** Maximum captured body size in bytes. */
-	get maxBodySize() {
-		return this._maxBodySize;
-	}
-	/** Maximum number of requests retained per bin. */
-	get maxRequestsPerBin() {
-		return this._maxRequestsPerBin;
-	}
-	/** Default bin lifetime in milliseconds. */
-	get defaultTtlMs() {
-		return this._defaultTtlMs;
-	}
-	/** Create a new bin with the configured TTL. */
-	createBin() {
-		const id = this.generateId();
-		const now = Date.now();
-		const bin = {
-			id,
-			createdAt: new Date(now).toISOString(),
-			expiresAt: new Date(now + this._defaultTtlMs).toISOString(),
-			requestCount: 0
-		};
-		this._store.createBin(bin);
-		return bin;
-	}
-	/**
-	* Look up a bin by id. Returns `undefined` if the bin does not exist or
-	* has expired (in which case it is also lazily removed).
-	*/
-	getBin(id) {
-		const bin = this._store.getBin(id);
-		if (!bin) return;
-		if (Date.parse(bin.expiresAt) <= Date.now()) {
-			this._store.deleteBin(id);
-			return;
-		}
-		return bin;
-	}
-	/** List all non-expired bins. */
-	listBins() {
-		const now = Date.now();
-		const result = [];
-		for (const bin of this._store.listBins()) {
-			if (Date.parse(bin.expiresAt) <= now) {
-				this._store.deleteBin(bin.id);
-				continue;
-			}
-			result.push(bin);
-		}
-		return result;
-	}
-	/** Delete a bin. Returns true if the bin existed. */
-	deleteBin(id) {
-		return this._store.deleteBin(id);
-	}
-	/**
-	* Record an incoming request against a bin. Returns the stored
-	* {@link CapturedRequest}, or `undefined` if the bin does not exist or is
-	* expired.
-	*/
-	recordRequest(binId, raw) {
-		if (!this.getBin(binId)) return;
-		const captured = {
-			...raw,
-			id: this.generateId(),
-			binId,
-			capturedAt: (/* @__PURE__ */ new Date()).toISOString()
-		};
-		this._store.addRequest(binId, captured, this._maxRequestsPerBin);
-		return captured;
-	}
-	/** List captured requests for a bin (newest first). */
-	getRequests(binId) {
-		return this._store.getRequests(binId);
-	}
-	/** Look up a single captured request. */
-	getRequest(binId, reqId) {
-		return this._store.getRequest(binId, reqId);
-	}
-	/** Clear all captured requests in a bin. */
-	clearRequests(binId) {
-		this._store.clearRequests(binId);
-	}
-	/** Start the periodic cleanup of expired bins. */
-	start() {
-		if (this._cleanupTimer) return;
-		this._cleanupTimer = setInterval(() => {
-			this._store.cleanupExpired(Date.now());
-		}, this._cleanupIntervalMs);
-		this._cleanupTimer.unref?.();
-	}
-	/** Stop the periodic cleanup. Idempotent. */
-	stop() {
-		if (this._cleanupTimer) {
-			clearInterval(this._cleanupTimer);
-			this._cleanupTimer = void 0;
-		}
-	}
-	generateId() {
-		return randomUUID().replaceAll("-", "").slice(0, this._idLength);
-	}
-};
-//#endregion
 //#region src/certificate.ts
 function encodeLength(length) {
 	if (length < 128) return Buffer.from([length]);
@@ -478,6 +293,181 @@ function getFastifyConfig(logging = true) {
 	};
 }
 //#endregion
+//#region src/mock-http-bins.ts
+const DEFAULT_TTL_MS = 864e5;
+const DEFAULT_MAX_REQUESTS = 100;
+const DEFAULT_MAX_BODY_SIZE = 131072;
+const DEFAULT_ID_LENGTH = 12;
+const BIN_KEY_PREFIX = "bin:";
+/**
+* Stores request bins in Keyv.
+* The default store is `new Keyv()`, which keeps data in memory.
+*/
+var MockHttpBins = class {
+	_keyv;
+	_defaultTtlMs;
+	_maxRequestsPerBin;
+	_maxBodySize;
+	_idLength;
+	_locks = /* @__PURE__ */ new Map();
+	constructor(options) {
+		this._keyv = options?.keyv ?? new Keyv();
+		this._defaultTtlMs = options?.defaultTtlMs ?? DEFAULT_TTL_MS;
+		this._maxRequestsPerBin = Math.max(0, options?.maxRequestsPerBin ?? DEFAULT_MAX_REQUESTS);
+		this._maxBodySize = options?.maxBodySize ?? DEFAULT_MAX_BODY_SIZE;
+		this._idLength = options?.idLength ?? DEFAULT_ID_LENGTH;
+	}
+	/** Keyv instance that stores the bins. */
+	get keyv() {
+		return this._keyv;
+	}
+	/** Maximum captured body size in bytes. */
+	get maxBodySize() {
+		return this._maxBodySize;
+	}
+	/** Maximum number of requests in one bin. */
+	get maxRequestsPerBin() {
+		return this._maxRequestsPerBin;
+	}
+	/** Default bin lifetime in milliseconds. */
+	get defaultTtlMs() {
+		return this._defaultTtlMs;
+	}
+	/**
+	* Create a new bin with the configured lifetime.
+	* Throws when Keyv does not store the bin.
+	*/
+	async createBin() {
+		const id = this.generateId();
+		const now = Date.now();
+		const bin = {
+			id,
+			createdAt: new Date(now).toISOString(),
+			expiresAt: new Date(now + this._defaultTtlMs).toISOString(),
+			requestCount: 0
+		};
+		await this.save({
+			bin,
+			requests: []
+		});
+		return bin;
+	}
+	/**
+	* Look up a bin by id.
+	* Returns `undefined` when the bin does not exist or Keyv has expired it.
+	* A failed read also returns `undefined` when the Keyv instance has an `error` listener.
+	*/
+	async getBin(id) {
+		return (await this._keyv.get(this.binKey(id)))?.bin;
+	}
+	/**
+	* List the bins that Keyv still holds.
+	* Throws when the Keyv store has no iterator.
+	* When the Keyv instance has an `error` listener, a failed walk returns the bins read before the error.
+	*/
+	async listBins() {
+		if (!this.canIterate()) throw new Error("MockHttpBins: the configured Keyv store does not support iteration; listBins() is unavailable");
+		const bins = [];
+		for await (const [key, value] of this._keyv.iterator()) if (key.startsWith(BIN_KEY_PREFIX)) bins.push(value.bin);
+		return bins;
+	}
+	/**
+	* Delete a bin. Returns true when the bin existed.
+	* The delete waits for captures already queued for that bin, so a capture cannot write the bin back.
+	*/
+	async deleteBin(id) {
+		return this.enqueue(id, () => this._keyv.delete(this.binKey(id)));
+	}
+	/**
+	* Record a request for a bin.
+	* Returns `undefined` when the bin does not exist.
+	* Throws when Keyv does not store the capture.
+	*/
+	async recordRequest(binId, raw) {
+		const captured = {
+			...raw,
+			id: this.generateId(),
+			binId,
+			capturedAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		return await this.enqueue(binId, () => this.appendRequest(binId, captured)) ? captured : void 0;
+	}
+	/** List captured requests for a bin, newest first. */
+	async getRequests(binId) {
+		return [...(await this._keyv.get(this.binKey(binId)))?.requests ?? []];
+	}
+	/** Look up one captured request. */
+	async getRequest(binId, reqId) {
+		return (await this._keyv.get(this.binKey(binId)))?.requests.find((request) => request.id === reqId);
+	}
+	/**
+	* Remove captured requests and keep the bin.
+	* Returns false when the bin does not exist.
+	* Throws when Keyv does not store the change.
+	*/
+	async clearRequests(binId) {
+		return this.enqueue(binId, async () => {
+			const doc = await this._keyv.get(this.binKey(binId));
+			if (!doc) return false;
+			doc.requests = [];
+			doc.bin.requestCount = 0;
+			await this.save(doc);
+			return true;
+		});
+	}
+	/** Keyv 6 yields nothing when the store has no iterator. Listing must fail instead. */
+	canIterate() {
+		return typeof this._keyv.store.iterator === "function";
+	}
+	/** Returns false when the bin does not exist. */
+	async appendRequest(binId, captured) {
+		const doc = await this._keyv.get(this.binKey(binId));
+		if (!doc) return false;
+		doc.requests.unshift(captured);
+		while (doc.requests.length > this._maxRequestsPerBin) doc.requests.pop();
+		doc.bin.requestCount = doc.requests.length;
+		await this.save(doc);
+		return true;
+	}
+	/**
+	* Write a bin document with a TTL from its lifetime.
+	* Keyv returns false or throws when the write fails. Both cases throw here.
+	*/
+	async save(doc) {
+		const message = `MockHttpBins: could not save bin ${doc.bin.id}`;
+		let saved;
+		try {
+			saved = await this._keyv.set(this.binKey(doc.bin.id), doc, this.ttlFor(doc.bin));
+		} catch (cause) {
+			throw new Error(message, { cause });
+		}
+		if (!saved) throw new Error(message);
+	}
+	/**
+	* Run writes for one bin in order.
+	* A failed write does not block the next write for that bin.
+	*/
+	enqueue(id, fn) {
+		const run = (this._locks.get(id) ?? Promise.resolve()).then(fn);
+		const settled = run.then(() => void 0, () => void 0);
+		this._locks.set(id, settled);
+		settled.finally(() => {
+			if (this._locks.get(id) === settled) this._locks.delete(id);
+		});
+		return run;
+	}
+	/** Keyv keeps a key without a TTL forever, so the TTL never drops below 1 ms. */
+	ttlFor(bin) {
+		return Math.max(1, Date.parse(bin.expiresAt) - Date.now());
+	}
+	binKey(id) {
+		return `${BIN_KEY_PREFIX}${id}`;
+	}
+	generateId() {
+		return randomUUID().replaceAll("-", "").slice(0, this._idLength);
+	}
+};
+//#endregion
 //#region src/routes/anything/index.ts
 const anythingSchema = {
 	description: "Will return anything that you send it",
@@ -907,9 +897,9 @@ const captureSchema = {
 const TEXT_CONTENT_TYPE_REGEX = /^(text\/|application\/(json|xml|x-www-form-urlencoded|javascript))/i;
 /**
 * Create a Fastify plugin that registers the catch-all bin capture endpoint
-* at `/b/:id` and `/b/:id/*`, with the provided {@link BinManager} injected.
+* at `/b/:id` and `/b/:id/*`, with the provided {@link MockHttpBins} injected.
 */
-const binsCaptureRoute = (binManager) => {
+const binsCaptureRoute = (bins) => {
 	return (fastify) => {
 		fastify.removeAllContentTypeParsers();
 		fastify.addContentTypeParser("*", { parseAs: "buffer" }, (_request, body, done) => {
@@ -918,10 +908,9 @@ const binsCaptureRoute = (binManager) => {
 		const handler = async (request, reply) => {
 			const { id } = request.params;
 			const rest = request.params["*"] ?? "";
-			if (!binManager.getBin(id)) return reply.code(404).send({ error: "bin_not_found" });
 			const raw = request.body;
 			const bodySize = raw?.length ?? 0;
-			const max = binManager.maxBodySize;
+			const max = bins.maxBodySize;
 			const truncated = bodySize > max;
 			const slice = raw && raw.length > 0 ? raw.subarray(0, max) : void 0;
 			const contentTypeHeader = request.headers["content-type"];
@@ -942,7 +931,7 @@ const binsCaptureRoute = (binManager) => {
 			const prefix = `/b/${id}`;
 			const url = request.url.slice(prefix.length) || "/";
 			const path = rest ? `/${rest}` : "/";
-			const captured = binManager.recordRequest(id, {
+			const captured = await bins.recordRequest(id, {
 				method: request.method,
 				url,
 				path,
@@ -955,11 +944,11 @@ const binsCaptureRoute = (binManager) => {
 				bodyEncoding,
 				truncated
 			});
+			if (!captured) return reply.code(404).send({ error: "bin_not_found" });
 			return reply.code(200).send({
 				ok: true,
 				binId: id,
-				/* v8 ignore next -- @preserve */
-				requestId: captured?.id ?? ""
+				requestId: captured.id
 			});
 		};
 		const opts = {
@@ -1174,12 +1163,12 @@ const clearRequestsSchema = {
 };
 /**
 * Create a Fastify plugin that registers bin management endpoints, with the
-* provided {@link BinManager} injected.
+* provided {@link MockHttpBins} injected.
 */
-const binsManagementRoute = (binManager) => {
+const binsManagementRoute = (bins) => {
 	return (fastify) => {
 		fastify.post("/bins", { schema: createBinSchema }, async (request, _reply) => {
-			const bin = binManager.createBin();
+			const bin = await bins.createBin();
 			/* v8 ignore next -- @preserve */
 			const host = request.headers.host ?? request.hostname;
 			return {
@@ -1187,29 +1176,28 @@ const binsManagementRoute = (binManager) => {
 				url: `${request.protocol}://${host}/b/${bin.id}`
 			};
 		});
-		fastify.get("/bins", { schema: listBinsSchema }, async (_request, _reply) => ({ bins: binManager.listBins() }));
+		fastify.get("/bins", { schema: listBinsSchema }, async (_request, _reply) => ({ bins: await bins.listBins() }));
 		fastify.get("/bins/:id", { schema: getBinSchema }, async (request, reply) => {
-			const bin = binManager.getBin(request.params.id);
+			const bin = await bins.getBin(request.params.id);
 			if (!bin) return reply.code(404).send({ error: "bin_not_found" });
 			return bin;
 		});
 		fastify.get("/bins/:id/requests", { schema: listRequestsSchema }, async (request, reply) => {
-			if (!binManager.getBin(request.params.id)) return reply.code(404).send({ error: "bin_not_found" });
-			return { requests: binManager.getRequests(request.params.id) };
+			if (!await bins.getBin(request.params.id)) return reply.code(404).send({ error: "bin_not_found" });
+			return { requests: await bins.getRequests(request.params.id) };
 		});
 		fastify.get("/bins/:id/requests/:reqId", { schema: getRequestSchema }, async (request, reply) => {
-			if (!binManager.getBin(request.params.id)) return reply.code(404).send({ error: "bin_not_found" });
-			const captured = binManager.getRequest(request.params.id, request.params.reqId);
+			if (!await bins.getBin(request.params.id)) return reply.code(404).send({ error: "bin_not_found" });
+			const captured = await bins.getRequest(request.params.id, request.params.reqId);
 			if (!captured) return reply.code(404).send({ error: "request_not_found" });
 			return captured;
 		});
 		fastify.delete("/bins/:id/requests", { schema: clearRequestsSchema }, async (request, reply) => {
-			if (!binManager.getBin(request.params.id)) return reply.code(404).send({ error: "bin_not_found" });
-			binManager.clearRequests(request.params.id);
+			if (!await bins.clearRequests(request.params.id)) return reply.code(404).send({ error: "bin_not_found" });
 			return reply.code(204).send();
 		});
 		fastify.delete("/bins/:id", { schema: deleteBinSchema }, async (request, reply) => {
-			if (!binManager.deleteBin(request.params.id)) return reply.code(404).send({ error: "bin_not_found" });
+			if (!await bins.deleteBin(request.params.id)) return reply.code(404).send({ error: "bin_not_found" });
 			return reply.code(204).send();
 		});
 	};
@@ -3367,7 +3355,7 @@ A simple HTTP server that can be used to mock HTTP responses for testing purpose
 
 [mockhttp.org](https://mockhttp.org) is a free hosted instance of this codebase for testing. It runs on a Cloudflare Worker (no containers): documentation is served from Workers Assets, and mock APIs such as \`/get\` and \`/post\` run in the Worker. The service is globally available and rate-limited (1000 requests per minute per IP) to prevent abuse.
 `,
-	version: "2.1.0"
+	version: "3.0.0"
 } } };
 const withLocalServer = (spec) => {
 	spec.servers = [{
@@ -3502,7 +3490,6 @@ var MockHttp = class extends Hookified {
 	_siteDistPath = defaultSiteDistPath;
 	_logging = true;
 	_pluginTimeout;
-	_startBins = true;
 	_httpBin = {
 		httpMethods: true,
 		redirects: true,
@@ -3528,7 +3515,7 @@ var MockHttp = class extends Hookified {
 	_httpsCredentials;
 	_server;
 	_taps = new TapManager();
-	_bins = new BinManager();
+	_bins = new MockHttpBins();
 	constructor(options) {
 		super(options?.hookOptions);
 		if (options?.port) this._port = options.port;
@@ -3545,7 +3532,6 @@ var MockHttp = class extends Hookified {
 		}
 		if (options?.logging !== void 0) this._logging = options.logging;
 		if (options?.pluginTimeout !== void 0) this._pluginTimeout = options.pluginTimeout;
-		if (options?.startBins !== void 0) this._startBins = options.startBins;
 		if (options?.http2 !== void 0) this._http2 = options.http2;
 		if (options?.http1 !== void 0) this._http1 = options.http1;
 		if (options?.https !== void 0) {
@@ -3679,20 +3665,6 @@ var MockHttp = class extends Hookified {
 		this._pluginTimeout = pluginTimeout;
 	}
 	/**
-	* Whether to start the request-bin cleanup timer during `initialize()`.
-	* @default true
-	*/
-	get startBins() {
-		return this._startBins;
-	}
-	/**
-	* Whether to start the request-bin cleanup timer during `initialize()`.
-	* @default true
-	*/
-	set startBins(startBins) {
-		this._startBins = startBins;
-	}
-	/**
 	* HTTPS configuration. Set to true to auto-generate a self-signed certificate,
 	* or provide an HttpsOptions object with cert/key or auto-generation options.
 	*/
@@ -3798,13 +3770,13 @@ var MockHttp = class extends Hookified {
 		this._taps = taps;
 	}
 	/**
-	* The BinManager instance for managing request bins.
+	* The MockHttpBins instance for request bins.
 	*/
 	get bins() {
 		return this._bins;
 	}
 	/**
-	* The BinManager instance for managing request bins.
+	* The MockHttpBins instance for request bins.
 	*/
 	set bins(bins) {
 		this._bins = bins;
@@ -3874,10 +3846,7 @@ var MockHttp = class extends Hookified {
 			if (auth) await this.registerAuthRoutes();
 			if (images) await this.registerImageRoutes();
 			if (dynamicData) await this.registerDynamicDataRoutes();
-			if (bins) {
-				await this.registerBinRoutes();
-				if (this._startBins) this._bins.start();
-			}
+			if (bins) await this.registerBinRoutes();
 			if (this._apiDocs) await this.registerSite();
 		} catch (error) {
 			/* v8 ignore next -- @preserve */
@@ -3908,7 +3877,6 @@ var MockHttp = class extends Hookified {
 	* Close the Fastify server.
 	*/
 	async close() {
-		this._bins.stop();
 		if (this._server) await this._server.close();
 	}
 	/**
@@ -4111,4 +4079,4 @@ const start = async () => {
 /* v8 ignore next -- @preserve */
 if (import.meta.url === `file://${process$1.argv[1]}`) await start();
 //#endregion
-export { BinManager, InMemoryBinStore, MockHttp as default, MockHttp as mockhttp, generateCertificate, generateCertificateFiles, start };
+export { MockHttpBins, MockHttp as default, MockHttp as mockhttp, generateCertificate, generateCertificateFiles, start };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@jaredwray/mockhttp",
-  "version": "2.1.0",
+  "version": "3.0.0",
   "description": "Mock Http - Easy way to mock http with httpbin replacement",
   "type": "module",
   "main": "dist/index.mjs",
   "types": "dist/index.d.mts",
   "engines": {
-    "node": ">=22.18.0"
+    "node": ">=22.19.0"
   },
   "directories": {
     "test": "test"
@@ -39,29 +39,32 @@
   },
   "homepage": "https://github.com/jaredwray/mockhttp#readme",
   "devDependencies": {
-    "@biomejs/biome": "^2.5.13",
-    "@swc/core": "^1.16.2",
+    "@biomejs/biome": "^2.5.15",
+    "@swc/core": "^1.16.18",
     "@types/html-escaper": "^3.0.4",
-    "@vitest/coverage-v8": "^5.0.0",
-    "docula": "^3.0.0",
+    "@vitest/coverage-v8": "^5.0.3",
+    "docula": "^3.0.1",
     "rimraf": "^6.1.3",
-    "tsdown": "^0.23.0",
-    "tsx": "^4.23.13",
+    "tsdown": "^0.23.1",
+    "tsx": "^4.23.15",
     "typescript": "7.0.2",
-    "vitest": "^5.0.0"
+    "vite": "^8.3.4",
+    "vitest": "^5.0.3"
   },
   "dependencies": {
-    "@fastify/cookie": "^11.1.2",
-    "@fastify/helmet": "^13.1.1",
-    "@fastify/rate-limit": "^11.2.0",
-    "@fastify/static": "^10.1.3",
-    "@fastify/swagger": "^9.8.1",
+    "@fastify/cookie": "^11.1.3",
+    "@fastify/helmet": "^13.1.2",
+    "@fastify/rate-limit": "^11.2.1",
+    "@fastify/static": "^10.1.6",
+    "@fastify/swagger": "^9.9.2",
+    "@keyv/mongo": "^6.1.0",
     "detect-port": "^2.1.0",
-    "fastify": "^5.12.4",
-    "hookified": "^3.0.3",
+    "fastify": "^5.12.5",
+    "hookified": "^3.0.4",
     "html-escaper": "^3.0.3",
-    "pino": "^10.3.1",
-    "pino-pretty": "^13.1.3"
+    "keyv": "^6.1.0",
+    "pino": "^10.4.0",
+    "pino-pretty": "^13.2.0"
   },
   "files": [
     "dist",

package/site/dist/api/index.html

@@ -732,7 +732,7 @@
     <main class="api-content">
       <section class="api-info">
         <h1 class="api-info__title">Mock HTTP API</h1>
-        <span class="api-info__version">v2.1.0</span>
+        <span class="api-info__version">v3.0.0</span>
         <div class="api-info__description"><p>A simple HTTP server that can be used to mock HTTP responses for testing purposes. Inspired by <a href="https://httpbin.org/">httpbin</a> and built using <code>nodejs</code> and <code>fastify</code> with the idea of running it via <a href="https://mockhttp.org">https://mockhttp.org</a>, via docker <code>jaredwray/mockhttp</code>, or nodejs <code>npm install @jaredwray/mockhttp</code>.</p>
 <ul>
 <li><a href="https://github.com/jaredwray/mockhttp">GitHub Repository</a></li>
@@ -15066,7 +15066,7 @@ data &#x3D; response.json()</code></pre>
       &quot;remoteAddress&quot;: &quot;string&quot;,
       &quot;contentType&quot;: &quot;string&quot;,
       &quot;bodySize&quot;: 0,
-      &quot;body&quot;: null,
+      &quot;body&quot;: &quot;string&quot;,
       &quot;bodyEncoding&quot;: &quot;utf8&quot;,
       &quot;truncated&quot;: true,
       &quot;capturedAt&quot;: &quot;string&quot;
@@ -15409,7 +15409,7 @@ data &#x3D; response.json()</code></pre>
                     </div>
                     <div class="api-schema-prop">
                       <span class="api-schema-prop-name">body</span>
-                      <span class="api-schema-prop-type">null,string</span>
+                      <span class="api-schema-prop-type">string</span>
                       <span class="api-schema-prop-desc"></span>
                     </div>
                     <div class="api-schema-prop">
@@ -15445,7 +15445,7 @@ data &#x3D; response.json()</code></pre>
   &quot;remoteAddress&quot;: &quot;string&quot;,
   &quot;contentType&quot;: &quot;string&quot;,
   &quot;bodySize&quot;: 0,
-  &quot;body&quot;: null,
+  &quot;body&quot;: &quot;string&quot;,
   &quot;bodyEncoding&quot;: &quot;utf8&quot;,
   &quot;truncated&quot;: true,
   &quot;capturedAt&quot;: &quot;string&quot;
@@ -17716,7 +17716,7 @@ data &#x3D; response.json()</code></pre>
     <a href="https://docula.org/" target="_blank" rel="noopener noreferrer" class="footer__link" aria-label="Docula">
       <svg class="footer__bat" xmlns="http://www.w3.org/2000/svg" viewBox="70 110 360 205" fill="currentColor"><path d="M420,173c-16.76-18-72.78-36.65-131.59-30.58A160.15,160.15,0,0,0,269,120.55c-3.78,4.52-11.15,9.45-19,9.45s-15.23-4.93-19-9.45a160.15,160.15,0,0,0-19.4,21.83C152.78,136.31,96.76,154.94,80,173c48.86,5.86,79.5,34.09,79.5,72.06,52.37,0,77,28,90.5,59.94C263.54,273,288.13,245,340.5,245,340.5,207,371.14,178.8,420,173Z"/><circle cx="239.19" cy="145.36" r="3.32" fill="#fff"/><circle cx="260.81" cy="145.36" r="3.32" fill="#fff"/></svg>
     </a>
-    <span class="footer__updated">updated: 2026-10-03</span>
+    <span class="footer__updated">updated: 2026-10-20</span>
   </footer>
   <script src="/css/highlight/highlight.min.js"></script>
   <script>