@jaredwray/mockhttp 1.5.1 → 1.6.1

package/README.md

@@ -8,11 +8,11 @@
 [![Docker Pulls](https://img.shields.io/docker/pulls/jaredwray/mockhttp)](https://hub.docker.com/r/jaredwray/mockhttp)
 [![mockhttp.org](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fjaredwray.com%2Fapi%2Fmockhttp-traffic&query=%24.message&label=mockhttp.org)](https://mockhttp.org)
 
-A simple HTTP server that can be used to mock HTTP responses for testing purposes. Inspired by [httpbin](https://httpbin.org/) and built using `nodejs` and `fastify` with the idea of running it via https://mockhttp.org, via docker `jaredwray/mockhttp`, or nodejs `npm install jaredwray/mockhttp`.
+A simple HTTP server that can be used to mock HTTP responses for testing purposes. Inspired by [httpbin](https://httpbin.org/) and built using `nodejs` and `fastify` with the idea of running it via https://mockhttp.org, via docker `jaredwray/mockhttp`, or nodejs `npm install @jaredwray/mockhttp`.
 
 # Features
 * All the features of [httpbin](https://httpbin.org/)
-* Taps - Inject custom responses for testing and develepment
+* Taps - Inject custom responses for testing and development
 * `@fastify/helmet` built in by default
 * Built with `nodejs`, `typescript`, and `fastify`
 * Deploy via `docker` or `nodejs`
@@ -30,6 +30,7 @@ A simple HTTP server that can be used to mock HTTP responses for testing purpose
 - [Response Injection (Tap Feature)](#response-injection-tap-feature)
 - [Rate Limiting](#rate-limiting)
 - [Logging](#logging)
+- [Flexible URL Matching](#flexible-url-matching)
 - [API Reference](#api-reference)
 - [About mockhttp.org](#about-mockhttporg)
 - [Contributing](#contributing)
@@ -608,6 +609,21 @@ You can also disable logging via the `LOGGING` environment variable:
 LOGGING=false node your-app.js
 ```
 
+# Flexible URL Matching
+
+MockHttp ignores trailing path segments that come after the parsable portion of a URL. This is useful when a client appends extra data to a known endpoint — instead of returning 404, MockHttp serves the closest matching route.
+
+For example, all of these are served by `/status/:code`:
+
+```
+GET /status/429
+GET /status/429/
+GET /status/429/foo
+GET /status/429/foo/bar
+```
+
+The rewrite preserves the query string and only triggers when a more specific route exists; URLs whose first path segment doesn't correspond to a registered route still return 404.
+
 # API Reference
 
 ## MockHttp Class

package/dist/index.mjs

@@ -246,16 +246,47 @@ async function generateCertificateFiles(options) {
 }
 //#endregion
 //#region src/fastify-config.ts
+function isSpecificMatch(route) {
+	if (!route) return false;
+	const params = route.params;
+	return params === void 0 || params["*"] === void 0;
+}
+function rewriteUrl(req) {
+	const originalUrl = req.url ?? "/";
+	const method = req.method;
+	if (!method) return originalUrl;
+	const queryIdx = originalUrl.indexOf("?");
+	const path = queryIdx >= 0 ? originalUrl.slice(0, queryIdx) : originalUrl;
+	const query = queryIdx >= 0 ? originalUrl.slice(queryIdx) : "";
+	if (isSpecificMatch(this.findRoute({
+		method,
+		url: path
+	}))) return originalUrl;
+	const segments = path.split("/").filter(Boolean);
+	while (segments.length >= 1) {
+		const candidatePath = `/${segments.join("/")}`;
+		if (candidatePath !== path && isSpecificMatch(this.findRoute({
+			method,
+			url: candidatePath
+		}))) return candidatePath + query;
+		if (segments.length === 1) break;
+		segments.pop();
+	}
+	return originalUrl;
+}
 function getFastifyConfig(logging = true) {
-	return { logger: logging ? { transport: {
-		target: "pino-pretty",
-		options: {
-			colorize: true,
-			translateTime: true,
-			ignore: "pid,hostname",
-			singleLine: true
-		}
-	} } : false };
+	return {
+		logger: logging ? { transport: {
+			target: "pino-pretty",
+			options: {
+				colorize: true,
+				translateTime: true,
+				ignore: "pid,hostname",
+				singleLine: true
+			}
+		} } : false,
+		rewriteUrl
+	};
 }
 //#endregion
 //#region src/routes/anything/index.ts
@@ -328,6 +359,7 @@ const anythingRoute = (fastify) => {
 	};
 	const noValidation = {
 		schema: anythingSchema,
+		/* v8 ignore next -- @preserve */
 		validatorCompiler: () => () => true
 	};
 	fastify.get("/anything", noValidation, handler);
@@ -869,6 +901,7 @@ const delayRoute = (fastify) => {
 		/* v8 ignore next -- @preserve */
 		const host = request.headers.host || "localhost";
 		return {
+			/* v8 ignore next -- @preserve */
 			args: request.query || {},
 			data: "",
 			files: {},
@@ -1176,6 +1209,7 @@ const streamRoute = (fastify) => {
 		for (let i = 0; i < lines; i++) {
 			const data = {
 				id: i,
+				/* v8 ignore next -- @preserve */
 				args: request.query || {},
 				headers: request.headers,
 				origin: request.ip,
@@ -2867,17 +2901,17 @@ const fastifySwaggerConfig = { openapi: {
 	info: {
 		title: "Mock HTTP API",
 		description: `
-A simple HTTP server that can be used to mock HTTP responses for testing purposes. Inspired by [httpbin](https://httpbin.org/) and built using \`nodejs\` and \`fastify\` with the idea of running it via https://mockhttp.org, via docker \`jaredwray/mockhttp\`, or nodejs \`npm install jaredwray/mockhttp\`.
+A simple HTTP server that can be used to mock HTTP responses for testing purposes. Inspired by [httpbin](https://httpbin.org/) and built using \`nodejs\` and \`fastify\` with the idea of running it via https://mockhttp.org, via docker \`jaredwray/mockhttp\`, or nodejs \`npm install @jaredwray/mockhttp\`.
 
 * [GitHub Repository](https://github.com/jaredwray/mockhttp)
 * [Docker Image](https://hub.docker.com/r/jaredwray/mockhttp)
-* [NPM Package](https://www.npmjs.com/package/jaredwray/mockhttp)
+* [NPM Package](https://www.npmjs.com/package/@jaredwray/mockhttp)
 
 # About mockhttp.org 
 
 [mockhttp.org](https://mockhttp.org) is a free service that runs this codebase and allows you to use it for testing purposes. It is a simple way to mock HTTP responses for testing purposes. Ran via [Cloudflare](https://cloudflare.com) and [Google Cloud Run](https://cloud.google.com/run/) across 7 regions globally and can do millions of requests per second.
 `,
-		version: "1.5.1"
+		version: "1.6.1"
 	},
 	consumes: ["application/json"],
 	produces: ["application/json"]
@@ -2890,14 +2924,17 @@ const registerSwaggerUi = async (fastify) => {
 			deepLinking: false
 		},
 		uiHooks: {
+			/* v8 ignore next -- @preserve */
 			onRequest(_request, _reply, next) {
 				next();
 			},
+			/* v8 ignore next -- @preserve */
 			preHandler(_request, _reply, next) {
 				next();
 			}
 		},
 		staticCSP: true,
+		/* v8 ignore next -- @preserve */
 		transformSpecification: (swaggerObject, _request, _reply) => swaggerObject,
 		transformSpecificationClone: true
 	});

package/package.json

@@ -1,10 +1,14 @@
 {
 	"name": "@jaredwray/mockhttp",
-	"version": "1.5.1",
+	"version": "1.6.1",
 	"description": "Mock Http - Easy way to mock http with httpbin replacement",
 	"type": "module",
 	"main": "dist/index.mjs",
 	"types": "dist/index.d.mts",
+	"packageManager": "pnpm@11.1.3",
+	"engines": {
+		"node": ">=22.18.0"
+	},
 	"directories": {
 		"test": "test"
 	},
@@ -53,27 +57,27 @@
 	},
 	"homepage": "https://github.com/jaredwray/mockhttp#readme",
 	"devDependencies": {
-		"@biomejs/biome": "^2.4.11",
-		"@swc/core": "^1.15.24",
+		"@biomejs/biome": "^2.4.15",
+		"@swc/core": "^1.15.33",
 		"@types/html-escaper": "^3.0.4",
-		"@vitest/coverage-v8": "^4.1.4",
+		"@vitest/coverage-v8": "^4.1.6",
 		"rimraf": "^6.1.3",
-		"tsdown": "^0.21.7",
+		"tsdown": "^0.22.0",
 		"tsx": "^4.21.0",
-		"typescript": "6.0.2",
-		"vitest": "^4.1.4"
+		"typescript": "6.0.3",
+		"vitest": "^4.1.6"
 	},
 	"dependencies": {
 		"@fastify/cookie": "^11.0.2",
 		"@fastify/helmet": "^13.0.2",
 		"@fastify/rate-limit": "^10.3.0",
-		"@fastify/static": "^9.1.0",
+		"@fastify/static": "^9.1.3",
 		"@fastify/swagger": "^9.7.0",
-		"@fastify/swagger-ui": "^5.2.5",
-		"@scalar/api-reference": "^1.52.1",
+		"@fastify/swagger-ui": "^5.2.6",
+		"@scalar/api-reference": "^1.55.3",
 		"detect-port": "^2.1.0",
-		"fastify": "^5.8.4",
-		"hookified": "^2.1.1",
+		"fastify": "^5.8.5",
+		"hookified": "^2.2.0",
 		"html-escaper": "^3.0.3",
 		"pino": "^10.3.1",
 		"pino-pretty": "^13.1.3"
@@ -82,18 +86,5 @@
 		"dist",
 		"public",
 		"LICENCE"
-	],
-	"pnpm": {
-		"overrides": {
-			"set-cookie-parser": "2.7.2"
-		},
-		"onlyBuiltDependencies": [
-			"@swc/core",
-			"core-js",
-			"esbuild",
-			"protobufjs",
-			"unrs-resolver",
-			"vue-demi"
-		]
-	}
+	]
 }