@jaredwray/mockhttp 0.0.1

package/LICENSE

@@ -0,0 +1,19 @@
+MIT License & © Jared Wray
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+![public/logo.svg](public/logo.svg)
+
+[![tests](https://github.com/jaredwray/mockhttp/actions/workflows/tests.yaml/badge.svg)](https://github.com/jaredwray/mockhttp/actions/workflows/tests.yaml)
+[![GitHub license](https://img.shields.io/github/license/jaredwray/mockhttp)](https://github.com/jaredwray/mockhttp/blob/master/LICENSE)
+[![codecov](https://codecov.io/gh/jaredwray/mockhttp/graph/badge.svg?token=eqtqoA3olU)](https://codecov.io/gh/jaredwray/mockhttp)
+[![npm](https://img.shields.io/npm/dm/mockhttp)](https://npmjs.com/package/mockhttp)
+[![npm](https://img.shields.io/npm/v/mockhttp)](https://npmjs.com/package/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`.
+
+# Deploy via Docker
+```bash
+docker run -d -p 8080:8080 jaredwray/mockhttp
+```
+
+# Deploy via NodeJS
+```bash
+npm install @jaredwray/mockhttp --save
+```
+
+then run `mockhttp` in your code.
+
+```javascript
+import { mockhttp } from '@jaredwray/mockhttp';
+mockhttp.start(); // start the server
+const response = await fetch('http://localhost:8080/ip');
+mockhttp.stop(); // stop the server
+```
+
+# 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. It is globally available has some limitations on it to prevent abuse but many people will not see it. It is ran via [Cloudflare](https://cloudflare.com) and [Google Cloud Run](https://cloud.google.com/run/) across 7 regions globally.
+
+# Contributing
+
+Please read our [CODE OF CONDUCT](CODE_OF_CONDUCT.md) and [CONTRIBUTING](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
+
+# License
+
+[MIT License & © Jared Wray](LICENSE)

package/dist/fastify-config.js

@@ -0,0 +1,12 @@
+export const fastifyConfig = {
+    logger: {
+        transport: {
+            target: 'pino-pretty',
+            options: {
+                colorize: true,
+                translateTime: true,
+                ignore: 'pid,hostname',
+            },
+        },
+    },
+};

package/dist/index.js

@@ -0,0 +1,48 @@
+import process from 'node:process';
+import path from 'node:path';
+import Fastify from 'fastify';
+import fastifyStatic from '@fastify/static';
+import { fastifySwagger } from '@fastify/swagger';
+import { indexRoute } from './routes/index-route.js';
+import { fastifyConfig } from './fastify-config.js';
+import { fastifySwaggerConfig, registerSwaggerUi } from './swagger.js';
+import { ipRoute, headersRoute, userAgentRoute } from './routes/request-inspection/index.js';
+import { getRoute, postRoute, deleteRoute, putRoute, patchRoute, } from './routes/http-methods/index.js';
+import { statusCodeRoute } from './routes/status-codes/index.js';
+// eslint-disable-next-line new-cap
+const fastify = Fastify(fastifyConfig);
+await fastify.register(fastifyStatic, {
+    root: path.resolve('./public'),
+});
+// Set up Swagger for API documentation
+await fastify.register(fastifySwagger, fastifySwaggerConfig);
+// Register Swagger UI
+await registerSwaggerUi(fastify);
+// Register the index / home page route
+await fastify.register(indexRoute);
+// Register the HTTP method routes
+await fastify.register(getRoute);
+await fastify.register(postRoute);
+await fastify.register(deleteRoute);
+await fastify.register(putRoute);
+await fastify.register(patchRoute);
+// Register the request inspection routes
+await fastify.register(ipRoute);
+await fastify.register(headersRoute);
+await fastify.register(userAgentRoute);
+// Register the status code routes
+await fastify.register(statusCodeRoute);
+// Start the Fastify server
+export const start = async () => {
+    try {
+        await fastify.listen({ port: 3000, host: '127.0.0.1' });
+        fastify.log.info('Server is running at http://localhost:3000');
+    }
+    catch (error) {
+        /* c8 ignore next 4 */
+        fastify.log.error(error);
+        // eslint-disable-next-line unicorn/no-process-exit
+        process.exit(1);
+    }
+};
+await start();

package/dist/routes/delete-route.js

@@ -0,0 +1,27 @@
+const deleteSchema = {
+    description: 'Handles a DELETE request and returns request information',
+    body: {
+        type: 'object',
+        additionalProperties: true,
+        description: 'The body of the DELETE request',
+    },
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                method: { type: 'string' },
+                headers: { type: 'object', additionalProperties: { type: 'string' } },
+                body: { type: 'object', additionalProperties: true },
+            },
+            required: ['method', 'headers', 'body'],
+        },
+    },
+};
+export const deleteRoute = (fastify) => {
+    fastify.delete('/delete', { schema: deleteSchema }, async (request) => ({
+        method: 'DELETE',
+        headers: request.headers,
+        body: request.body,
+    }));
+};

package/dist/routes/get-route.js

@@ -0,0 +1,34 @@
+export const getSchema = {
+    description: 'Returns request information for GET requests',
+    querystring: {
+        type: 'object',
+        additionalProperties: true,
+        properties: {},
+        description: 'Query parameters sent in the request',
+    },
+    headers: {
+        type: 'object',
+        additionalProperties: true,
+        properties: {},
+        description: 'Headers sent in the request',
+    },
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                method: { type: 'string' },
+                headers: { type: 'object', additionalProperties: { type: 'string' } },
+                queryParams: { type: 'object', additionalProperties: { type: 'string' } },
+            },
+            required: ['method', 'headers', 'queryParams'],
+        },
+    },
+};
+export const getRoute = (fastify) => {
+    fastify.get('/get', { schema: getSchema }, async (request, _reply) => ({
+        method: 'GET',
+        headers: request.headers,
+        queryParams: request.query,
+    }));
+};

package/dist/routes/http-methods/delete.js

@@ -0,0 +1,28 @@
+const deleteSchema = {
+    description: 'Handles a DELETE request and returns request information',
+    tags: ['HTTP Methods'],
+    body: {
+        type: 'object',
+        additionalProperties: true,
+        description: 'The body of the DELETE request',
+    },
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                method: { type: 'string' },
+                headers: { type: 'object', additionalProperties: { type: 'string' } },
+                body: { type: 'object', additionalProperties: true },
+            },
+            required: ['method', 'headers', 'body'],
+        },
+    },
+};
+export const deleteRoute = (fastify) => {
+    fastify.delete('/delete', { schema: deleteSchema }, async (request) => ({
+        method: 'DELETE',
+        headers: request.headers,
+        body: request.body,
+    }));
+};

package/dist/routes/http-methods/get.js

@@ -0,0 +1,35 @@
+export const getSchema = {
+    description: 'Returns request information for GET requests',
+    tags: ['HTTP Methods'],
+    querystring: {
+        type: 'object',
+        additionalProperties: true,
+        properties: {},
+        description: 'Query parameters sent in the request',
+    },
+    headers: {
+        type: 'object',
+        additionalProperties: true,
+        properties: {},
+        description: 'Headers sent in the request',
+    },
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                method: { type: 'string' },
+                headers: { type: 'object', additionalProperties: { type: 'string' } },
+                queryParams: { type: 'object', additionalProperties: { type: 'string' } },
+            },
+            required: ['method', 'headers', 'queryParams'],
+        },
+    },
+};
+export const getRoute = (fastify) => {
+    fastify.get('/get', { schema: getSchema }, async (request, _reply) => ({
+        method: 'GET',
+        headers: request.headers,
+        queryParams: request.query,
+    }));
+};

package/dist/routes/http-methods/index.js

@@ -0,0 +1,5 @@
+export { getRoute } from './get.js';
+export { postRoute } from './post.js';
+export { deleteRoute } from './delete.js';
+export { putRoute } from './put.js';
+export { patchRoute } from './patch.js';

package/dist/routes/http-methods/patch.js

@@ -0,0 +1,28 @@
+const patchSchema = {
+    description: 'Handles a PATCH request and returns request information',
+    tags: ['HTTP Methods'],
+    body: {
+        type: 'object',
+        additionalProperties: true,
+        description: 'The body of the PATCH request',
+    },
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                method: { type: 'string' },
+                headers: { type: 'object', additionalProperties: { type: 'string' } },
+                body: { type: 'object', additionalProperties: true },
+            },
+            required: ['method', 'headers', 'body'],
+        },
+    },
+};
+export const patchRoute = (fastify) => {
+    fastify.patch('/patch', { schema: patchSchema }, async (request) => ({
+        method: 'PATCH',
+        headers: request.headers,
+        body: request.body,
+    }));
+};

package/dist/routes/http-methods/post.js

@@ -0,0 +1,28 @@
+const postSchema = {
+    description: 'Handles a POST request and returns request information',
+    tags: ['HTTP Methods'],
+    body: {
+        type: 'object',
+        additionalProperties: true,
+        description: 'The body of the POST request',
+    },
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                method: { type: 'string' },
+                headers: { type: 'object', additionalProperties: { type: 'string' } },
+                body: { type: 'object', additionalProperties: true },
+            },
+            required: ['method', 'headers', 'body'],
+        },
+    },
+};
+export const postRoute = (fastify) => {
+    fastify.post('/post', { schema: postSchema }, async (request) => ({
+        method: 'POST',
+        headers: request.headers,
+        body: request.body,
+    }));
+};

package/dist/routes/http-methods/put.js

@@ -0,0 +1,28 @@
+const putSchema = {
+    description: 'Handles a PUT request and returns request information',
+    tags: ['HTTP Methods'],
+    body: {
+        type: 'object',
+        additionalProperties: true,
+        description: 'The body of the PUT request',
+    },
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                method: { type: 'string' },
+                headers: { type: 'object', additionalProperties: { type: 'string' } },
+                body: { type: 'object', additionalProperties: true },
+            },
+            required: ['method', 'headers', 'body'],
+        },
+    },
+};
+export const putRoute = (fastify) => {
+    fastify.put('/put', { schema: putSchema }, async (request) => ({
+        method: 'PUT',
+        headers: request.headers,
+        body: request.body,
+    }));
+};

package/dist/routes/index-route.js

@@ -0,0 +1,67 @@
+export const indexRoute = (fastify) => {
+    fastify.get('/', { schema: { hide: true } }, async (_request, reply) => {
+        const redocHtml = `
+	<!doctype html>
+<html>
+  <head>
+    <title>{ mockhttp } </title>
+    <meta charset="utf-8" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1" />
+      <style>
+      :root {
+  --scalar-custom-header-height: 70px;
+}
+.custom-header {
+  height: var(--scalar-custom-header-height);
+  background-color: var(--scalar-background-1);
+  box-shadow: inset 0 -1px 0 var(--scalar-border-color);
+  color: var(--scalar-color-1);
+  font-size: var(--scalar-font-size-2);
+  padding: 0 18px;
+  position: sticky;
+  justify-content: space-between;
+  top: 0;
+  z-index: 100;
+}
+.custom-header,
+.custom-header nav {
+  display: flex;
+  align-items: center;
+  gap: 18px;
+}
+
+.custom-header img {
+  height: var(--scalar-custom-header-height);
+  object-fit: contain;
+}
+
+.custom-header a:hover {
+  color: var(--scalar-color-2);
+}
+
+.github-corner {
+  fill: var(--scalar-border-color) !important;
+}
+
+      </style>
+  </head>
+  <body>
+  <header class="custom-header scalar-app">
+    <img src="/logo.svg" alt="{ mockhttp }" />
+    <a href="https://github.com/jaredwray/mockhttp" class="github-corner" aria-label="View source on GitHub">
+      <svg width="70" height="70" viewBox="0 0 250 250" style="color:#fff; position: absolute; top: 0; border: 0; right: 0;" aria-hidden="true"><path d="M0,0 L115,115 L130,115 L142,142 L250,250 L250,0 Z"></path><path d="M128.3,109.0 C113.8,99.7 119.0,89.6 119.0,89.6 C122.0,82.7 120.5,78.6 120.5,78.6 C119.2,72.0 123.4,76.3 123.4,76.3 C127.3,80.9 125.5,87.3 125.5,87.3 C122.9,97.6 130.6,101.9 134.4,103.2" fill="currentColor" style="transform-origin: 130px 106px;" class="octo-arm"></path><path d="M115.0,115.0 C114.9,115.1 118.7,116.5 119.8,115.4 L133.7,101.6 C136.9,99.2 139.9,98.4 142.2,98.6 C133.8,88.0 127.5,74.4 143.8,58.0 C148.5,53.4 154.0,51.2 159.7,51.0 C160.3,49.4 163.2,43.6 171.4,40.1 C171.4,40.1 176.1,42.5 178.8,56.2 C183.1,58.6 187.2,61.8 190.9,65.4 C194.5,69.0 197.7,73.2 200.1,77.6 C213.8,80.2 216.3,84.9 216.3,84.9 C212.7,93.1 206.9,96.0 205.4,96.6 C205.1,102.4 203.0,107.8 198.3,112.5 C181.9,128.9 168.3,122.5 157.7,114.1 C157.9,116.9 156.7,120.9 152.7,124.9 L141.0,136.5 C139.8,137.7 141.6,141.9 141.8,141.8 Z" fill="currentColor" class="octo-body"></path></svg></a><style>.github-corner:hover .octo-arm{animation:octocat-wave 560ms ease-in-out}@keyframes octocat-wave{0%,100%{transform:rotate(0)}20%,60%{transform:rotate(-25deg)}40%,80%{transform:rotate(10deg)}}@media (max-width:500px){.github-corner:hover .octo-arm{animation:none}.github-corner .octo-arm{animation:octocat-wave 560ms ease-in-out}}</style>
+  </header>
+
+    <script
+      id="api-reference"
+      data-url="/docs/json"></script>
+
+    <script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"></script>
+  </body>
+</html>
+`;
+        await reply.type('text/html').send(redocHtml);
+    });
+};

package/dist/routes/ip-route.js

@@ -0,0 +1,25 @@
+const ipSchema = {
+    description: 'Returns the IP address of the client',
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                ip: { type: 'string', description: 'The IP address of the client' },
+            },
+            required: ['ip'],
+        },
+    },
+};
+export const ipRoute = (fastify) => {
+    fastify.get('/ip', { schema: ipSchema }, async (request) => {
+        const cloudflareIp = request.headers['cf-connecting-ip'];
+        const forwardedIp = request.headers['x-forwarded-for'];
+        const remoteIp = request.ip;
+        // Determine the client's IP address, considering Cloudflare and other proxies
+        const ip = cloudflareIp ?? (typeof forwardedIp === 'string' ? forwardedIp.split(',')[0].trim() : remoteIp);
+        return {
+            ip,
+        };
+    });
+};

package/dist/routes/post-route.js

@@ -0,0 +1,27 @@
+const postSchema = {
+    description: 'Handles a POST request and returns request information',
+    body: {
+        type: 'object',
+        additionalProperties: true,
+        description: 'The body of the POST request',
+    },
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                method: { type: 'string' },
+                headers: { type: 'object', additionalProperties: { type: 'string' } },
+                body: { type: 'object', additionalProperties: true },
+            },
+            required: ['method', 'headers', 'body'],
+        },
+    },
+};
+export const postRoute = (fastify) => {
+    fastify.post('/post', { schema: postSchema }, async (request) => ({
+        method: 'POST',
+        headers: request.headers,
+        body: request.body,
+    }));
+};

package/dist/routes/put-route.js

@@ -0,0 +1,27 @@
+const putSchema = {
+    description: 'Handles a PUT request and returns request information',
+    body: {
+        type: 'object',
+        additionalProperties: true,
+        description: 'The body of the PUT request',
+    },
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                method: { type: 'string' },
+                headers: { type: 'object', additionalProperties: { type: 'string' } },
+                body: { type: 'object', additionalProperties: true },
+            },
+            required: ['method', 'headers', 'body'],
+        },
+    },
+};
+export const putRoute = (fastify) => {
+    fastify.put('/put', { schema: putSchema }, async (request) => ({
+        method: 'PUT',
+        headers: request.headers,
+        body: request.body,
+    }));
+};

package/dist/routes/request-inspection/headers.js

@@ -0,0 +1,26 @@
+const headersSchema = {
+    description: 'Returns all headers of the client request',
+    tags: ['Request Inspection'],
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                headers: {
+                    type: 'object',
+                    additionalProperties: { type: 'string' },
+                    description: 'All headers of the client request',
+                },
+            },
+            required: ['headers'],
+        },
+    },
+};
+export const headersRoute = (fastify) => {
+    fastify.get('/headers', { schema: headersSchema }, async (request) => {
+        const headers = request.headers;
+        return {
+            headers,
+        };
+    });
+};

package/dist/routes/request-inspection/index.js

@@ -0,0 +1,3 @@
+export { ipRoute } from './ip.js';
+export { headersRoute } from './headers.js';
+export { userAgentRoute } from './user-agent.js';

package/dist/routes/request-inspection/ip.js

@@ -0,0 +1,26 @@
+const ipSchema = {
+    description: 'Returns the IP address of the client',
+    tags: ['Request Inspection'],
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                ip: { type: 'string', description: 'The IP address of the client' },
+            },
+            required: ['ip'],
+        },
+    },
+};
+export const ipRoute = (fastify) => {
+    fastify.get('/ip', { schema: ipSchema }, async (request) => {
+        const cloudflareIp = request.headers['cf-connecting-ip'];
+        const forwardedIp = request.headers['x-forwarded-for'];
+        const remoteIp = request.ip;
+        // Determine the client's IP address, considering Cloudflare and other proxies
+        const ip = cloudflareIp ?? (typeof forwardedIp === 'string' ? forwardedIp.split(',')[0].trim() : remoteIp);
+        return {
+            ip,
+        };
+    });
+};

package/dist/routes/request-inspection/user-agent.js

@@ -0,0 +1,25 @@
+const userAgentSchema = {
+    description: 'Returns the User-Agent header of the client request',
+    tags: ['Request Inspection'],
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                userAgent: {
+                    type: 'string',
+                    description: 'The User-Agent header of the client request',
+                },
+            },
+            required: ['userAgent'],
+        },
+    },
+};
+export const userAgentRoute = (fastify) => {
+    fastify.get('/user-agent', { schema: userAgentSchema }, async (request) => {
+        const userAgent = request.headers['user-agent'];
+        return {
+            userAgent,
+        };
+    });
+};

package/dist/routes/status-codes/get.js

@@ -0,0 +1,29 @@
+const statusSchema = {
+    description: 'Returns a response with the provided status code',
+    tags: ['Status Codes'],
+    params: {
+        type: 'object',
+        properties: {
+            code: { type: 'string', description: 'HTTP status code to be returned' },
+        },
+        required: ['code'],
+    },
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                status: { type: 'string' },
+            },
+        },
+    },
+};
+export const getStatusCodeRoute = (fastify) => {
+    fastify.get('/status/:code', { schema: statusSchema }, async (request, reply) => {
+        const { code } = request.params;
+        await reply.code(Number(code));
+        return {
+            status: `Response with status code ${code}`,
+        };
+    });
+};

package/dist/routes/status-codes/index.js

@@ -0,0 +1,102 @@
+import { randomInt } from 'node:crypto';
+const statusCodes = [
+    { code: 100, message: 'Continue' },
+    { code: 101, message: 'Switching Protocols' },
+    { code: 102, message: 'Processing' },
+    { code: 103, message: 'Early Hints' },
+    { code: 200, message: 'OK' },
+    { code: 201, message: 'Created' },
+    { code: 202, message: 'Accepted' },
+    { code: 203, message: 'Non-Authoritative Information' },
+    { code: 204, message: 'No Content' },
+    { code: 205, message: 'Reset Content' },
+    { code: 206, message: 'Partial Content' },
+    { code: 207, message: 'Multi-Status' },
+    { code: 208, message: 'Already Reported' },
+    { code: 226, message: 'IM Used' },
+    { code: 300, message: 'Multiple Choices' },
+    { code: 301, message: 'Moved Permanently' },
+    { code: 302, message: 'Found' },
+    { code: 303, message: 'See Other' },
+    { code: 304, message: 'Not Modified' },
+    { code: 305, message: 'Use Proxy' },
+    { code: 306, message: 'Switch Proxy' },
+    { code: 307, message: 'Temporary Redirect' },
+    { code: 308, message: 'Permanent Redirect' },
+    { code: 400, message: 'Bad Request' },
+    { code: 401, message: 'Unauthorized' },
+    { code: 402, message: 'Payment Required' },
+    { code: 403, message: 'Forbidden' },
+    { code: 404, message: 'Not Found' },
+    { code: 405, message: 'Method Not Allowed' },
+    { code: 406, message: 'Not Acceptable' },
+    { code: 407, message: 'Proxy Authentication Required' },
+    { code: 408, message: 'Request Timeout' },
+    { code: 409, message: 'Conflict' },
+    { code: 410, message: 'Gone' },
+    { code: 411, message: 'Length Required' },
+    { code: 412, message: 'Precondition Failed' },
+    { code: 413, message: 'Payload Too Large' },
+    { code: 414, message: 'URI Too Long' },
+    { code: 415, message: 'Unsupported Media Type' },
+    { code: 416, message: 'Range Not Satisfiable' },
+    { code: 417, message: 'Expectation Failed' },
+    { code: 418, message: 'I\'m a teapot' },
+    { code: 421, message: 'Misdirected Request' },
+    { code: 422, message: 'Unprocessable Entity' },
+    { code: 423, message: 'Locked' },
+    { code: 424, message: 'Failed Dependency' },
+    { code: 425, message: 'Too Early' },
+    { code: 426, message: 'Upgrade Required' },
+    { code: 428, message: 'Precondition Required' },
+    { code: 429, message: 'Too Many Requests' },
+    { code: 431, message: 'Request Header Fields Too Large' },
+    { code: 451, message: 'Unavailable For Legal Reasons' },
+    { code: 500, message: 'Internal Server Error' },
+    { code: 501, message: 'Not Implemented' },
+    { code: 502, message: 'Bad Gateway' },
+    { code: 503, message: 'Service Unavailable' },
+    { code: 504, message: 'Gateway Timeout' },
+    { code: 505, message: 'HTTP Version Not Supported' },
+    { code: 506, message: 'Variant Also Negotiates' },
+    { code: 507, message: 'Insufficient Storage' },
+    { code: 508, message: 'Loop Detected' },
+    { code: 510, message: 'Not Extended' },
+    { code: 511, message: 'Network Authentication Required' },
+];
+const statusSchema = {
+    description: 'Return status code or random status code if more than one are given ',
+    tags: ['Status Codes'],
+    params: {
+        type: 'object',
+        properties: {
+            code: { type: 'string', description: 'HTTP status code to be returned' },
+        },
+    },
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                status: { type: 'string' },
+            },
+        },
+    },
+};
+export const statusCodeRoute = (fastify) => {
+    const handler = async (request, reply) => {
+        let { code } = request.params;
+        // Check if the code is a valid HTTP status code, otherwise pick a random one
+        if (!code || !statusCodes.map(status => status.code).includes(Number(code))) {
+            code = statusCodes[randomInt(0, statusCodes.length)].code.toString();
+        }
+        await reply.code(Number(code)).send({
+            status: `Response with status code ${code}`,
+        });
+    };
+    fastify.get('/status/:code?', { schema: statusSchema }, handler);
+    fastify.post('/status/:code?', { schema: statusSchema }, handler);
+    fastify.put('/status/:code?', { schema: statusSchema }, handler);
+    fastify.patch('/status/:code?', { schema: statusSchema }, handler);
+    fastify.delete('/status/:code?', { schema: statusSchema }, handler);
+};

package/dist/routes/status-route.js

@@ -0,0 +1,28 @@
+const statusSchema = {
+    description: 'Returns a response with the provided status code',
+    params: {
+        type: 'object',
+        properties: {
+            code: { type: 'string', description: 'HTTP status code to be returned' },
+        },
+        required: ['code'],
+    },
+    response: {
+        // eslint-disable-next-line  @typescript-eslint/naming-convention
+        200: {
+            type: 'object',
+            properties: {
+                status: { type: 'string' },
+            },
+        },
+    },
+};
+export const statusRoute = (fastify) => {
+    fastify.get('/status/:code', { schema: statusSchema }, async (request, reply) => {
+        const { code } = request.params;
+        await reply.code(Number(code));
+        return {
+            status: `Response with status code ${code}`,
+        };
+    });
+};

package/dist/swagger.js

@@ -0,0 +1,34 @@
+import { fastifySwaggerUi } from '@fastify/swagger-ui';
+export const fastifySwaggerConfig = {
+    swagger: {
+        info: {
+            title: 'Mock HTTP API',
+            description: 'A replacement for httpbin built using Fastify and Typescript',
+            version: '1.0.0',
+        },
+        consumes: ['application/json'],
+        produces: ['application/json'],
+    },
+};
+export const registerSwaggerUi = async (fastify) => {
+    await fastify.register(fastifySwaggerUi, {
+        routePrefix: '/docs',
+        uiConfig: {
+            docExpansion: 'none',
+            deepLinking: false,
+        },
+        uiHooks: {
+            /* c8 ignore next 6 */
+            onRequest(_request, _reply, next) {
+                next();
+            },
+            preHandler(_request, _reply, next) {
+                next();
+            },
+        },
+        // eslint-disable-next-line @typescript-eslint/naming-convention
+        staticCSP: true,
+        transformSpecification: (swaggerObject, _request, _reply) => swaggerObject,
+        transformSpecificationClone: true,
+    });
+};

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@jaredwray/mockhttp",
+  "version": "0.0.1",
+  "description": "Mock Http - Easy way to mock http with httpbin replacement",
+  "type": "module",
+  "main": "dist/index.js",
+  "directories": {
+    "test": "test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jaredwray/mockhttp.git"
+  },
+  "keywords": [
+    "mock",
+    "http",
+    "httpbin",
+    "test"
+  ],
+  "author": "Jared Wray <me@jaredwray.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/jaredwray/mockhttp/issues"
+  },
+  "homepage": "https://github.com/jaredwray/mockhttp#readme",
+  "devDependencies": {
+    "@vitest/coverage-v8": "^2.1.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.5",
+    "xo": "^0.59.3"
+  },
+  "dependencies": {
+    "@fastify/static": "^8.0.3",
+    "@fastify/swagger": "^9.4.0",
+    "@fastify/swagger-ui": "^5.1.0",
+    "fastify": "^5.1.0",
+    "pino": "^9.5.0",
+    "pino-pretty": "^13.0.0"
+  },
+  "files": [
+    "dist",
+    "public",
+    "LICENCE"
+  ],
+  "scripts": {
+    "test": "xo --fix && vitest run --coverage",
+    "dev": "xo --fix && npx tsx src/index.ts --watch",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  }
+}

package/public/favicon.svg

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Layer_1" xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0 0 73.01 55.68">
+  <!-- Generator: Adobe Illustrator 29.1.0, SVG Export Plug-In . SVG Version: 2.1.0 Build 142)  -->
+  <defs>
+    <style>
+      .st0 {
+        fill: #231f20;
+      }
+    </style>
+  </defs>
+  <path class="st0" d="M19.83,43.94c-2.09-.04-5.87-.9-5.87-5.18,0-2.59.22-4.64.22-6.91,0-1.94-.72-3.56-4.28-3.82v-1.22c3.56-.22,4.28-1.48,4.28-3.78s-.22-3.74-.22-6.05c0-4.28,3.64-5.26,5.87-5.36l.04,1.04c-2.81.5-3.31,2.09-3.31,3.89,0,2.3.25,3.64.25,5.87,0,2.59-1.84,4.46-4.07,4.93v.14c2.12.5,4.07,2.12,4.07,4.97,0,2.34-.25,4.25-.25,6.44,0,1.94.61,3.49,3.31,4l-.04,1.04Z"/>
+  <path class="st0" d="M42.4,37.5v-1.01c2.12-.22,2.38-.36,2.38-2.88v-6.01c0-2.56-.86-4.18-3.1-4.18-1.37,0-2.63.76-4,1.87.04.43.11.86.11,1.55v6.98c0,2.27.32,2.45,2.3,2.66v1.01h-7.7v-1.01c2.23-.22,2.56-.36,2.56-2.74v-6.19c0-2.66-.83-4.14-3.02-4.14-1.44,0-2.84.97-3.96,1.87v8.46c0,2.38.25,2.52,2.3,2.74v1.01h-7.74v-1.01c2.38-.22,2.59-.36,2.59-2.74v-7.45c0-2.3-.14-2.45-2.16-2.81v-.9c1.69-.25,3.38-.72,5-1.44v2.92c.76-.58,1.51-1.19,2.66-1.87.9-.58,1.69-.94,2.84-.94,1.73,0,3.2,1.08,3.92,2.95,1.01-.79,1.94-1.4,2.84-2.02.79-.5,1.8-.94,2.84-.94,2.81,0,4.54,2.02,4.54,5.54v6.95c0,2.41.22,2.52,2.27,2.74v1.01h-7.49Z"/>
+  <path class="st0" d="M52.48,11.62c2.12,0,5.9.9,5.9,5.15,0,2.63-.25,4.07-.25,6.34,0,1.91.76,3.6,4.32,3.78v1.22c-3.53.25-4.32,1.51-4.32,3.82s.25,4.32.25,6.62c0,4.28-3.71,5.36-5.9,5.4v-1.04c2.77-.5,3.31-2.05,3.31-3.92,0-2.3-.29-4.21-.29-6.44,0-2.63,1.87-4.46,4.07-4.97v-.14c-2.12-.47-4.07-2.34-4.07-4.93,0-2.09.29-3.67.29-5.87,0-1.94-.61-3.46-3.31-3.96v-1.04Z"/>
+</svg>

package/public/logo.svg

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Layer_1" xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0 0 214.77 71.59">
+  <!-- Generator: Adobe Illustrator 29.1.0, SVG Export Plug-In . SVG Version: 2.1.0 Build 142)  -->
+  <defs>
+    <style>
+      .st0 {
+        fill: #231f20;
+      }
+    </style>
+  </defs>
+  <path class="st0" d="M27.21,51.33c-2.09-.04-5.87-.9-5.87-5.18,0-2.59.22-4.64.22-6.91,0-1.94-.72-3.56-4.28-3.82v-1.22c3.56-.22,4.28-1.48,4.28-3.78s-.22-3.74-.22-6.05c0-4.28,3.64-5.26,5.87-5.36l.04,1.04c-2.81.5-3.31,2.09-3.31,3.89,0,2.3.25,3.64.25,5.87,0,2.59-1.84,4.46-4.07,4.93v.14c2.12.5,4.07,2.12,4.07,4.97,0,2.34-.25,4.25-.25,6.44,0,1.94.61,3.49,3.31,4l-.04,1.04Z"/>
+  <path class="st0" d="M58.17,44.89v-1.01c2.12-.22,2.38-.36,2.38-2.88v-6.01c0-2.56-.86-4.18-3.1-4.18-1.37,0-2.63.76-4,1.87.04.43.11.86.11,1.55v6.98c0,2.27.32,2.45,2.3,2.66v1.01h-7.7v-1.01c2.23-.22,2.56-.36,2.56-2.74v-6.19c0-2.66-.83-4.14-3.02-4.14-1.44,0-2.84.97-3.96,1.87v8.46c0,2.38.25,2.52,2.3,2.74v1.01h-7.74v-1.01c2.38-.22,2.59-.36,2.59-2.74v-7.45c0-2.3-.14-2.45-2.16-2.81v-.9c1.69-.25,3.38-.72,5-1.44v2.92c.76-.58,1.51-1.19,2.66-1.87.9-.58,1.69-.94,2.84-.94,1.73,0,3.2,1.08,3.92,2.95,1.01-.79,1.94-1.4,2.84-2.02.79-.5,1.8-.94,2.84-.94,2.81,0,4.54,2.02,4.54,5.54v6.95c0,2.41.22,2.52,2.27,2.74v1.01h-7.49Z"/>
+  <path class="st0" d="M75.85,28.65c4.5,0,7.85,3.42,7.85,8.06,0,5.83-4.32,8.6-7.85,8.6-4.97,0-7.99-4-7.99-8.03,0-5.87,4.57-8.64,7.99-8.64ZM75.42,29.88c-2.2,0-4.18,2.12-4.18,6.3,0,4.57,2.02,7.88,4.97,7.88,2.23,0,4.1-1.62,4.1-6.55,0-4.21-1.73-7.63-4.9-7.63Z"/>
+  <path class="st0" d="M100,41.65c-1.58,2.09-4,3.67-6.15,3.67-4.57,0-7.27-3.71-7.27-7.56,0-2.84,1.22-5.22,3.64-7.06,1.91-1.48,4.07-2.05,5.47-2.05,1.62,0,2.81.5,3.35.97.5.4.58.65.58,1.04,0,.86-.9,1.62-1.3,1.62-.18,0-.32-.07-.68-.36-1.12-1.01-2.34-1.51-3.64-1.51-2.38,0-4.46,2.02-4.46,5.76-.04,5,3.38,6.66,5.47,6.66,1.51,0,2.74-.4,4.39-1.98l.61.79Z"/>
+  <path class="st0" d="M119.3,44.89c-1.94,0-4.07.04-4.82.07-.22-.25-5.87-6.95-6.08-7.16-.5-.58-.72-.76-1.04-.76-.14,0-.43,0-.65.07v4c0,2.41.18,2.56,2.52,2.77v1.01h-7.96v-1.01c2.41-.22,2.59-.47,2.59-2.77v-17.21c0-2.34-.25-2.41-2.48-2.74v-.94c1.87-.18,4.03-.72,5.33-1.22v17.17c1.08-.25,1.76-.68,2.3-1.26.83-.83,2.16-2.45,2.77-3.35.76-1.04.47-1.33-1.26-1.48v-1.01l7.42-.32v.97c-2.52.4-3.24.68-4.79,2.3-.68.72-2.3,2.56-3.06,3.49.72,1.01,4.39,5.18,5.58,6.44,1.73,1.73,2.23,1.84,3.64,1.91v1.01Z"/>
+  <path class="st0" d="M129.34,44.89v-1.01c2.09-.22,2.38-.4,2.38-2.77v-5.9c0-2.99-1.15-4.5-3.56-4.46-1.37,0-2.81.68-3.82,1.87v8.5c0,2.34.29,2.56,2.45,2.77v1.01h-7.85v-1.01c2.09-.18,2.56-.36,2.56-2.77v-17.35c0-1.91-.11-2.38-2.52-2.59v-.94c1.91-.18,4.07-.72,5.36-1.22v12.27c1.3-1.3,3.28-2.63,5.22-2.63,2.95,0,5,1.84,5,6.16v6.33c0,2.38.29,2.56,2.38,2.74v1.01h-7.6Z"/>
+  <path class="st0" d="M145.79,44.85c-.61.32-1.19.47-1.55.47-2.3,0-3.53-1.4-3.53-4.28v-10.47h-2.48l-.14-.43.97-1.04h1.66v-3.02c.68-.72,1.73-1.66,2.41-2.38l.54.07c-.07,1.51-.11,3.6-.11,5.33h4.1c.32.36.22,1.15-.22,1.48h-3.89v9.21c0,2.92,1.15,3.46,2.09,3.46.86,0,1.69-.32,2.2-.58l.32.94-2.38,1.26Z"/>
+  <path class="st0" d="M156.34,44.85c-.61.32-1.19.47-1.55.47-2.3,0-3.53-1.4-3.53-4.28v-10.47h-2.48l-.14-.43.97-1.04h1.66v-3.02c.68-.72,1.73-1.66,2.41-2.38l.54.07c-.07,1.51-.11,3.6-.11,5.33h4.1c.32.36.22,1.15-.22,1.48h-3.89v9.21c0,2.92,1.15,3.46,2.09,3.46.86,0,1.69-.32,2.2-.58l.32.94-2.38,1.26Z"/>
+  <path class="st0" d="M159.62,29.84c1.69-.25,3.56-.86,5.22-1.55v2.88c.11-.07,2.99-1.73,3.13-1.8.86-.47,1.62-.72,2.09-.72,3.96,0,6.37,3.31,6.37,6.88,0,5.47-4.32,8.93-9.04,9.79-1.08-.04-2.05-.36-2.56-.65v4.86c0,2.66.29,2.88,3.06,3.13v1.01h-8.53v-1.01c2.34-.25,2.63-.43,2.63-2.84v-16.38c0-2.16-.07-2.3-2.38-2.63v-.97ZM164.84,42.15c.83.83,2.23,1.4,3.42,1.4,3.13,0,5.15-2.63,5.15-6.66s-2.27-6.08-4.82-6.08c-1.26,0-2.77.83-3.74,1.55v9.79Z"/>
+  <path class="st0" d="M187.91,19.01c2.12,0,5.9.9,5.9,5.15,0,2.63-.25,4.07-.25,6.33,0,1.91.76,3.6,4.32,3.78v1.22c-3.53.25-4.32,1.51-4.32,3.82s.25,4.32.25,6.62c0,4.28-3.71,5.36-5.9,5.4v-1.04c2.77-.5,3.31-2.05,3.31-3.92,0-2.3-.29-4.21-.29-6.44,0-2.63,1.87-4.46,4.07-4.97v-.14c-2.12-.47-4.07-2.34-4.07-4.93,0-2.09.29-3.67.29-5.87,0-1.94-.61-3.46-3.31-3.96v-1.04Z"/>
+</svg>