@jaredwray/mockhttp 1.5.1 → 1.6.0

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
@@ -2867,17 +2898,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.0"
 	},
 	consumes: ["application/json"],
 	produces: ["application/json"]

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jaredwray/mockhttp",
-	"version": "1.5.1",
+	"version": "1.6.0",
 	"description": "Mock Http - Easy way to mock http with httpbin replacement",
 	"type": "module",
 	"main": "dist/index.mjs",