@jaredwray/mockhttp 1.4.0 → 1.5.0

package/README.md

@@ -26,6 +26,7 @@ A simple HTTP server that can be used to mock HTTP responses for testing purpose
 - [Deploy via Docker Compose](#deploy-via-docker-compose)
 - [Deploy via NodeJS](#deploy-via-nodejs)
 - [HTTPS Support](#https-support)
+- [HTTP/2 Support](#http2-support)
 - [Response Injection (Tap Feature)](#response-injection-tap-feature)
 - [Rate Limiting](#rate-limiting)
 - [Logging](#logging)
@@ -197,6 +198,55 @@ const result = await generateCertificateFiles({
 | `validityDays` | number | `365` | Certificate validity period in days |
 | `keySize` | number | `2048` | RSA key size in bits |
 
+# HTTP/2 Support
+
+MockHttp supports HTTP/2 in two modes:
+- **h2** — HTTP/2 over TLS (used by browsers), enabled with both `http2: true` and `https: true`
+- **h2c** — HTTP/2 cleartext (no TLS), enabled with just `http2: true`, useful for service-to-service testing
+
+## HTTP/2 over TLS (h2)
+
+```javascript
+import { MockHttp } from '@jaredwray/mockhttp';
+
+const mock = new MockHttp({ http2: true, https: true });
+await mock.start();
+
+console.log(mock.http2); // true
+console.log(mock.isHttps); // true
+
+const response = await mock.server.inject({ method: 'GET', url: '/get' });
+console.log(response.statusCode); // 200
+
+await mock.close();
+```
+
+By default, HTTP/1.1 clients can still connect via ALPN negotiation (`http1` defaults to `true`). To disable HTTP/1.1 fallback:
+
+```javascript
+const mock = new MockHttp({ http2: true, https: true, http1: false });
+await mock.start();
+```
+
+## HTTP/2 Cleartext (h2c)
+
+```javascript
+const mock = new MockHttp({ http2: true });
+await mock.start();
+
+console.log(mock.http2); // true
+
+await mock.close();
+```
+
+> **Note:** Browsers do not support h2c. This mode is useful for testing gRPC or service-to-service communication.
+
+## HTTP/2 via Environment Variable
+
+```bash
+HTTP2=true node your-app.js
+```
+
 # Response Injection (Tap Feature)
 
 The injection/tap feature allows you to "tap into" the request flow and inject custom responses for specific requests. This is particularly useful for:
@@ -589,6 +639,8 @@ new MockHttp(options?)
     - `auth?`: boolean - Enable authentication routes (default: true)
     - `images?`: boolean - Enable image routes (default: true)
   - `https?`: boolean | HttpsOptions - Enable HTTPS with auto-generated or custom certificates (default: undefined/disabled)
+  - `http2?`: boolean - Enable HTTP/2 support (default: false)
+  - `http1?`: boolean - Allow HTTP/1.1 fallback when using HTTP/2 with HTTPS (default: true)
   - `hookOptions?`: HookifiedOptions - Hookified options
 
 ### Properties
@@ -603,6 +655,8 @@ new MockHttp(options?)
 - `httpBin`: HttpBinOptions - Get/set httpbin route options
 - `https`: HttpsOptions | undefined - Get/set HTTPS configuration
 - `isHttps`: boolean - Whether the server is running with HTTPS
+- `http2`: boolean - Get/set HTTP/2 support
+- `http1`: boolean - Get/set HTTP/1.1 fallback for HTTP/2 with HTTPS
 - `server`: FastifyInstance - Get/set the Fastify server instance
 - `taps`: TapManager - Get/set the TapManager instance
 

package/dist/index.d.ts

@@ -251,6 +251,18 @@ type MockHttpOptions = {
      * or provide an object with cert/key strings/paths or auto-generation options.
      */
     https?: boolean | HttpsOptions;
+    /**
+     * Whether to enable HTTP/2 support. When used with `https`, enables h2 (HTTP/2 over TLS).
+     * When used without `https`, enables h2c (HTTP/2 cleartext).
+     * Defaults to false.
+     */
+    http2?: boolean;
+    /**
+     * Whether to allow HTTP/1.1 fallback when using HTTP/2 with HTTPS (ALPN negotiation).
+     * Only applies when both `http2` and `https` are enabled.
+     * Defaults to true.
+     */
+    http1?: boolean;
 };
 declare class MockHttp extends Hookified {
     private _port;
@@ -261,6 +273,8 @@ declare class MockHttp extends Hookified {
     private _logging;
     private _httpBin;
     private _rateLimit?;
+    private _http2;
+    private _http1;
     private _https;
     private _httpsCredentials;
     private _server;
@@ -340,6 +354,26 @@ declare class MockHttp extends Hookified {
      * Whether the server is running in HTTPS mode.
      */
     get isHttps(): boolean;
+    /**
+     * Whether HTTP/2 support is enabled.
+     * @default false
+     */
+    get http2(): boolean;
+    /**
+     * Whether HTTP/2 support is enabled.
+     * @default false
+     */
+    set http2(http2: boolean);
+    /**
+     * Whether to allow HTTP/1.1 fallback when using HTTP/2 with HTTPS.
+     * @default true
+     */
+    get http1(): boolean;
+    /**
+     * Whether to allow HTTP/1.1 fallback when using HTTP/2 with HTTPS.
+     * @default true
+     */
+    set http1(http1: boolean);
     /**
      * HTTP Bin options. Defaults to all enabled.
      */

package/dist/index.js

@@ -3832,7 +3832,7 @@ import { fastifySwaggerUi } from "@fastify/swagger-ui";
 // package.json
 var package_default = {
   name: "@jaredwray/mockhttp",
-  version: "1.4.0",
+  version: "1.5.0",
   description: "Mock Http - Easy way to mock http with httpbin replacement",
   type: "module",
   main: "dist/index.js",
@@ -3883,15 +3883,15 @@ var package_default = {
   },
   homepage: "https://github.com/jaredwray/mockhttp#readme",
   devDependencies: {
-    "@biomejs/biome": "^2.3.14",
-    "@swc/core": "^1.15.11",
+    "@biomejs/biome": "^2.4.7",
+    "@swc/core": "^1.15.18",
     "@types/html-escaper": "^3.0.4",
-    "@vitest/coverage-v8": "^4.0.18",
-    rimraf: "^6.1.2",
+    "@vitest/coverage-v8": "^4.1.0",
+    rimraf: "^6.1.3",
     tsup: "^8.5.1",
     tsx: "^4.21.0",
     typescript: "^5.9.3",
-    vitest: "^4.0.18"
+    vitest: "^4.1.0"
   },
   dependencies: {
     "@fastify/cookie": "^11.0.2",
@@ -3900,10 +3900,10 @@ var package_default = {
     "@fastify/static": "^9.0.0",
     "@fastify/swagger": "^9.7.0",
     "@fastify/swagger-ui": "^5.2.5",
-    "@scalar/api-reference": "^1.44.16",
+    "@scalar/api-reference": "^1.48.7",
     "detect-port": "^2.1.0",
-    fastify: "^5.7.4",
-    hookified: "^1.15.1",
+    fastify: "^5.8.2",
+    hookified: "^2.1.0",
     "html-escaper": "^3.0.3",
     pino: "^10.3.1",
     "pino-pretty": "^13.1.3"
@@ -4124,6 +4124,8 @@ var MockHttp = class extends Hookified {
       "::1"
     ]
   };
+  _http2 = false;
+  _http1 = true;
   _https;
   _httpsCredentials;
   _server = Fastify();
@@ -4155,6 +4157,12 @@ var MockHttp = class extends Hookified {
     if (options?.logging !== void 0) {
       this._logging = options.logging;
     }
+    if (options?.http2 !== void 0) {
+      this._http2 = options.http2;
+    }
+    if (options?.http1 !== void 0) {
+      this._http1 = options.http1;
+    }
     if (options?.https !== void 0) {
       if (options.https === true) {
         this._https = {
@@ -4280,6 +4288,34 @@ var MockHttp = class extends Hookified {
     return this._httpsCredentials !== void 0;
   }
   /**
+  * Whether HTTP/2 support is enabled.
+  * @default false
+  */
+  get http2() {
+    return this._http2;
+  }
+  /**
+  * Whether HTTP/2 support is enabled.
+  * @default false
+  */
+  set http2(http2) {
+    this._http2 = http2;
+  }
+  /**
+  * Whether to allow HTTP/1.1 fallback when using HTTP/2 with HTTPS.
+  * @default true
+  */
+  get http1() {
+    return this._http1;
+  }
+  /**
+  * Whether to allow HTTP/1.1 fallback when using HTTP/2 with HTTPS.
+  * @default true
+  */
+  set http1(http1) {
+    this._http1 = http1;
+  }
+  /**
   * HTTP Bin options. Defaults to all enabled.
   */
   get httpBin() {
@@ -4345,17 +4381,23 @@ var MockHttp = class extends Hookified {
       if (this._server) {
         await this._server.close();
       }
+      const fastifyOptions = {
+        ...getFastifyConfig(this._logging)
+      };
+      if (this._http2) {
+        fastifyOptions.http2 = true;
+      }
       if (this._httpsCredentials) {
-        this._server = Fastify({
-          ...getFastifyConfig(this._logging),
-          https: {
-            key: this._httpsCredentials.key,
-            cert: this._httpsCredentials.cert
-          }
-        });
-      } else {
-        this._server = Fastify(getFastifyConfig(this._logging));
+        const httpsOptions = {
+          key: this._httpsCredentials.key,
+          cert: this._httpsCredentials.cert
+        };
+        if (this._http2) {
+          httpsOptions.allowHTTP1 = this._http1;
+        }
+        fastifyOptions.https = httpsOptions;
       }
+      this._server = Fastify(fastifyOptions);
       this._server.addHook("onRequest", async (request, reply) => {
         const matchedTap = this._taps.matchRequest(request);
         if (matchedTap) {
@@ -4646,6 +4688,9 @@ var start = /* @__PURE__ */ __name(async () => {
   if (process2.env.LOGGING === "false") {
     mockHttp.logging = false;
   }
+  if (process2.env.HTTP2 === "true") {
+    mockHttp.http2 = true;
+  }
   await mockHttp.start();
   return mockHttp;
 }, "start");

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jaredwray/mockhttp",
-	"version": "1.4.0",
+	"version": "1.5.0",
 	"description": "Mock Http - Easy way to mock http with httpbin replacement",
 	"type": "module",
 	"main": "dist/index.js",
@@ -51,15 +51,15 @@
 	},
 	"homepage": "https://github.com/jaredwray/mockhttp#readme",
 	"devDependencies": {
-		"@biomejs/biome": "^2.3.14",
-		"@swc/core": "^1.15.11",
+		"@biomejs/biome": "^2.4.7",
+		"@swc/core": "^1.15.18",
 		"@types/html-escaper": "^3.0.4",
-		"@vitest/coverage-v8": "^4.0.18",
-		"rimraf": "^6.1.2",
+		"@vitest/coverage-v8": "^4.1.0",
+		"rimraf": "^6.1.3",
 		"tsup": "^8.5.1",
 		"tsx": "^4.21.0",
 		"typescript": "^5.9.3",
-		"vitest": "^4.0.18"
+		"vitest": "^4.1.0"
 	},
 	"dependencies": {
 		"@fastify/cookie": "^11.0.2",
@@ -68,10 +68,10 @@
 		"@fastify/static": "^9.0.0",
 		"@fastify/swagger": "^9.7.0",
 		"@fastify/swagger-ui": "^5.2.5",
-		"@scalar/api-reference": "^1.44.16",
+		"@scalar/api-reference": "^1.48.7",
 		"detect-port": "^2.1.0",
-		"fastify": "^5.7.4",
-		"hookified": "^1.15.1",
+		"fastify": "^5.8.2",
+		"hookified": "^2.1.0",
 		"html-escaper": "^3.0.3",
 		"pino": "^10.3.1",
 		"pino-pretty": "^13.1.3"