@jaredwray/mockhttp 2.1.0 → 3.0.0

package/site/dist/docs/bins/index.html

@@ -35,7 +35,7 @@
   </script>
   <title>MockHTTP - Bins</title>
   <script type="application/ld+json">
-{"@context":"https://schema.org","@type":"TechArticle","headline":"Bins","description":"","url":"https://mockhttp.org/docs/bins/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-03","keywords":[]}
+{"@context":"https://schema.org","@type":"TechArticle","headline":"Bins","description":"","url":"https://mockhttp.org/docs/bins/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-20","keywords":[]}
 </script>
 </head>
 
@@ -330,7 +330,7 @@ here is stored against bin <code>:id</code></li>
 <li><a href="#configuration">Configuration</a>
 <ul>
 <li><a href="#defaults">Defaults</a></li>
-<li><a href="#pluggable-storage">Pluggable Storage</a></li>
+<li><a href="#storage">Storage</a></li>
 </ul>
 </li>
 </ul>
@@ -514,11 +514,11 @@ curl -s <span class="hljs-string">"http://localhost:3000/bins/<span class="hljs-
   | jq -r <span class="hljs-string">'.requests[0].body'</span> | <span class="hljs-built_in">base64</span> -d > recovered.png
 </code></pre>
 <h3 id="truncation">Truncation</h3>
-<p>Bodies larger than <code>maxBodySize</code> (1 MiB by default) are cut off and flagged:</p>
+<p>Bodies larger than <code>maxBodySize</code> (128 KiB by default) are cut off and flagged:</p>
 <pre><code class="hljs language-javascript"><span class="hljs-comment">// In test setup</span>
-<span class="hljs-keyword">import</span> { <span class="hljs-title class_">MockHttp</span>, <span class="hljs-title class_">BinManager</span> } <span class="hljs-keyword">from</span> <span class="hljs-string">'@jaredwray/mockhttp'</span>;
+<span class="hljs-keyword">import</span> { <span class="hljs-title class_">MockHttp</span>, <span class="hljs-title class_">MockHttpBins</span> } <span class="hljs-keyword">from</span> <span class="hljs-string">'@jaredwray/mockhttp'</span>;
 <span class="hljs-keyword">const</span> mock = <span class="hljs-keyword">new</span> <span class="hljs-title class_">MockHttp</span>();
-mock.<span class="hljs-property">bins</span> = <span class="hljs-keyword">new</span> <span class="hljs-title class_">BinManager</span>({ <span class="hljs-attr">maxBodySize</span>: <span class="hljs-number">1024</span> }); <span class="hljs-comment">// 1 KiB cap</span>
+mock.<span class="hljs-property">bins</span> = <span class="hljs-keyword">new</span> <span class="hljs-title class_">MockHttpBins</span>({ <span class="hljs-attr">maxBodySize</span>: <span class="hljs-number">1024</span> }); <span class="hljs-comment">// 1 KiB cap</span>
 <span class="hljs-keyword">await</span> mock.<span class="hljs-title function_">start</span>();
 </code></pre>
 <pre><code class="hljs language-bash"><span class="hljs-comment"># Send 5000 bytes to a bin with a 1 KiB cap</span>
@@ -550,21 +550,20 @@ curl -s <span class="hljs-string">"http://localhost:3000/bins/<span class="hljs-
 <span class="hljs-comment"># "/event/105"</span>
 </code></pre>
 <h2 id="programmatic-access">Programmatic Access</h2>
-<p>The bin manager is exposed on the <code>MockHttp</code> instance as <code>mock.bins</code>. This
-makes it easy to drive bins from a test suite without going through HTTP:</p>
+<p>Use <code>mock.bins</code> to control request bins from a test. You do not need an HTTP call:</p>
 <pre><code class="hljs language-javascript"><span class="hljs-keyword">import</span> { <span class="hljs-title class_">MockHttp</span> } <span class="hljs-keyword">from</span> <span class="hljs-string">'@jaredwray/mockhttp'</span>;
 
 <span class="hljs-keyword">const</span> mock = <span class="hljs-keyword">new</span> <span class="hljs-title class_">MockHttp</span>({ <span class="hljs-attr">logging</span>: <span class="hljs-literal">false</span> });
 <span class="hljs-keyword">await</span> mock.<span class="hljs-title function_">start</span>();
 
 <span class="hljs-comment">// Create a bin</span>
-<span class="hljs-keyword">const</span> bin = mock.<span class="hljs-property">bins</span>.<span class="hljs-title function_">createBin</span>();
+<span class="hljs-keyword">const</span> bin = <span class="hljs-keyword">await</span> mock.<span class="hljs-property">bins</span>.<span class="hljs-title function_">createBin</span>();
 <span class="hljs-variable language_">console</span>.<span class="hljs-title function_">log</span>(<span class="hljs-string">`Webhook target: http://localhost:<span class="hljs-subst">${mock.port}</span>/b/<span class="hljs-subst">${bin.id}</span>`</span>);
 
 <span class="hljs-comment">// ... point your code-under-test at that URL ...</span>
 
 <span class="hljs-comment">// Read captured requests (newest first)</span>
-<span class="hljs-keyword">const</span> requests = mock.<span class="hljs-property">bins</span>.<span class="hljs-title function_">getRequests</span>(bin.<span class="hljs-property">id</span>);
+<span class="hljs-keyword">const</span> requests = <span class="hljs-keyword">await</span> mock.<span class="hljs-property">bins</span>.<span class="hljs-title function_">getRequests</span>(bin.<span class="hljs-property">id</span>);
 <span class="hljs-variable language_">console</span>.<span class="hljs-title function_">log</span>(<span class="hljs-string">`Captured <span class="hljs-subst">${requests.length}</span> requests`</span>);
 
 <span class="hljs-keyword">for</span> (<span class="hljs-keyword">const</span> req <span class="hljs-keyword">of</span> requests) {
@@ -572,8 +571,8 @@ makes it easy to drive bins from a test suite without going through HTTP:</p>
 }
 
 <span class="hljs-comment">// Clean up</span>
-mock.<span class="hljs-property">bins</span>.<span class="hljs-title function_">deleteBin</span>(bin.<span class="hljs-property">id</span>);
-<span class="hljs-keyword">await</span> mock.<span class="hljs-title function_">close</span>(); <span class="hljs-comment">// also stops the bin cleanup timer</span>
+<span class="hljs-keyword">await</span> mock.<span class="hljs-property">bins</span>.<span class="hljs-title function_">deleteBin</span>(bin.<span class="hljs-property">id</span>);
+<span class="hljs-keyword">await</span> mock.<span class="hljs-title function_">close</span>();
 </code></pre>
 <h3 id="using-bins-in-a-vitest-test">Using Bins in a Vitest Test</h3>
 <pre><code class="hljs language-typescript"><span class="hljs-keyword">import</span> { afterAll, beforeAll, expect, test } <span class="hljs-keyword">from</span> <span class="hljs-string">'vitest'</span>;
@@ -591,14 +590,14 @@ mock.<span class="hljs-property">bins</span>.<span class="hljs-title function_">
 });
 
 <span class="hljs-title function_">test</span>(<span class="hljs-string">'my SDK sends the right webhook payload'</span>, <span class="hljs-title function_">async</span> () => {
-  <span class="hljs-keyword">const</span> bin = mock.<span class="hljs-property">bins</span>.<span class="hljs-title function_">createBin</span>();
+  <span class="hljs-keyword">const</span> bin = <span class="hljs-keyword">await</span> mock.<span class="hljs-property">bins</span>.<span class="hljs-title function_">createBin</span>();
   <span class="hljs-keyword">const</span> webhookUrl = <span class="hljs-string">`http://localhost:<span class="hljs-subst">${mock.port}</span>/b/<span class="hljs-subst">${bin.id}</span>`</span>;
 
   <span class="hljs-comment">// Drive your SDK at the bin</span>
   <span class="hljs-keyword">await</span> mySdk.<span class="hljs-title function_">notify</span>(webhookUrl, { <span class="hljs-attr">event</span>: <span class="hljs-string">'user.created'</span>, <span class="hljs-attr">id</span>: <span class="hljs-number">42</span> });
 
   <span class="hljs-comment">// Assert on what actually arrived</span>
-  <span class="hljs-keyword">const</span> [captured] = mock.<span class="hljs-property">bins</span>.<span class="hljs-title function_">getRequests</span>(bin.<span class="hljs-property">id</span>);
+  <span class="hljs-keyword">const</span> [captured] = <span class="hljs-keyword">await</span> mock.<span class="hljs-property">bins</span>.<span class="hljs-title function_">getRequests</span>(bin.<span class="hljs-property">id</span>);
   <span class="hljs-title function_">expect</span>(captured.<span class="hljs-property">method</span>).<span class="hljs-title function_">toBe</span>(<span class="hljs-string">'POST'</span>);
   <span class="hljs-title function_">expect</span>(captured.<span class="hljs-property">contentType</span>).<span class="hljs-title function_">toBe</span>(<span class="hljs-string">'application/json'</span>);
   <span class="hljs-title function_">expect</span>(<span class="hljs-title class_">JSON</span>.<span class="hljs-title function_">parse</span>(captured.<span class="hljs-property">body</span>!)).<span class="hljs-title function_">toEqual</span>({
@@ -614,16 +613,15 @@ mock.<span class="hljs-property">bins</span>.<span class="hljs-title function_">
   <span class="hljs-attr">httpBin</span>: { <span class="hljs-attr">bins</span>: <span class="hljs-literal">false</span> },
 });
 </code></pre>
-<p>To tune limits, replace the default <code>BinManager</code> before starting:</p>
-<pre><code class="hljs language-javascript"><span class="hljs-keyword">import</span> { <span class="hljs-title class_">MockHttp</span>, <span class="hljs-title class_">BinManager</span> } <span class="hljs-keyword">from</span> <span class="hljs-string">'@jaredwray/mockhttp'</span>;
+<p>To change the limits, replace the default <code>MockHttpBins</code> before you start the server:</p>
+<pre><code class="hljs language-javascript"><span class="hljs-keyword">import</span> { <span class="hljs-title class_">MockHttp</span>, <span class="hljs-title class_">MockHttpBins</span> } <span class="hljs-keyword">from</span> <span class="hljs-string">'@jaredwray/mockhttp'</span>;
 
 <span class="hljs-keyword">const</span> mock = <span class="hljs-keyword">new</span> <span class="hljs-title class_">MockHttp</span>();
-mock.<span class="hljs-property">bins</span> = <span class="hljs-keyword">new</span> <span class="hljs-title class_">BinManager</span>({
+mock.<span class="hljs-property">bins</span> = <span class="hljs-keyword">new</span> <span class="hljs-title class_">MockHttpBins</span>({
   <span class="hljs-attr">defaultTtlMs</span>: <span class="hljs-number">60</span> * <span class="hljs-number">60</span> * <span class="hljs-number">1000</span>,    <span class="hljs-comment">// 1 hour (default: 24h)</span>
   <span class="hljs-attr">maxRequestsPerBin</span>: <span class="hljs-number">500</span>,           <span class="hljs-comment">// (default: 100)</span>
-  <span class="hljs-attr">maxBodySize</span>: <span class="hljs-number">5</span> * <span class="hljs-number">1024</span> * <span class="hljs-number">1024</span>,     <span class="hljs-comment">// 5 MiB (default: 1 MiB)</span>
+  <span class="hljs-attr">maxBodySize</span>: <span class="hljs-number">512</span> * <span class="hljs-number">1024</span>,          <span class="hljs-comment">// 512 KiB (default: 128 KiB)</span>
   <span class="hljs-attr">idLength</span>: <span class="hljs-number">16</span>,                     <span class="hljs-comment">// (default: 12)</span>
-  <span class="hljs-attr">cleanupIntervalMs</span>: <span class="hljs-number">30</span> * <span class="hljs-number">1000</span>,     <span class="hljs-comment">// sweep every 30s (default: 60s)</span>
 });
 
 <span class="hljs-keyword">await</span> mock.<span class="hljs-title function_">start</span>();
@@ -641,7 +639,7 @@ mock.<span class="hljs-property">bins</span> = <span class="hljs-keyword">new</s
 <tr>
 <td><code>defaultTtlMs</code></td>
 <td><code>86400000</code> (24h)</td>
-<td>Bin lifetime. Expired bins return 404 and are lazily removed.</td>
+<td>Bin lifetime, set as the Keyv TTL. An expired bin returns 404.</td>
 </tr>
 <tr>
 <td><code>maxRequestsPerBin</code></td>
@@ -650,7 +648,7 @@ mock.<span class="hljs-property">bins</span> = <span class="hljs-keyword">new</s
 </tr>
 <tr>
 <td><code>maxBodySize</code></td>
-<td><code>1048576</code> (1 MiB)</td>
+<td><code>131072</code> (128 KiB)</td>
 <td>Larger bodies are truncated; <code>truncated: true</code> is set on the capture.</td>
 </tr>
 <tr>
@@ -659,40 +657,29 @@ mock.<span class="hljs-property">bins</span> = <span class="hljs-keyword">new</s
 <td>Length of generated bin and request ids.</td>
 </tr>
 <tr>
-<td><code>cleanupIntervalMs</code></td>
-<td><code>60000</code> (1 min)</td>
-<td>How often expired bins are swept. The timer is <code>unref()</code>'d so it never keeps the process alive.</td>
+<td><code>keyv</code></td>
+<td><code>new Keyv()</code></td>
+<td>Keyv store for bins. The default keeps bins in memory.</td>
 </tr>
 </tbody>
 </table>
-<h3 id="pluggable-storage">Pluggable Storage</h3>
-<p><code>BinManager</code> accepts a <code>store: BinStore</code> so you can plug in alternative
-backends (Redis, SQLite, etc.) without changing the rest of the codebase. The
-default <code>InMemoryBinStore</code> keeps state in process memory.</p>
-<pre><code class="hljs language-typescript"><span class="hljs-keyword">import</span> {
-  <span class="hljs-title class_">BinManager</span>,
-  <span class="hljs-title class_">InMemoryBinStore</span>,
-  <span class="hljs-keyword">type</span> <span class="hljs-title class_">Bin</span>,
-  <span class="hljs-keyword">type</span> <span class="hljs-title class_">BinStore</span>,
-  <span class="hljs-keyword">type</span> <span class="hljs-title class_">CapturedRequest</span>,
-} <span class="hljs-keyword">from</span> <span class="hljs-string">'@jaredwray/mockhttp'</span>;
-
-<span class="hljs-keyword">class</span> <span class="hljs-title class_">RedisBinStore</span> <span class="hljs-keyword">implements</span> <span class="hljs-title class_">BinStore</span> {
-  <span class="hljs-title function_">createBin</span>(<span class="hljs-attr">bin</span>: <span class="hljs-title class_">Bin</span>): <span class="hljs-built_in">void</span> { <span class="hljs-comment">/* SET bin:${bin.id} ... */</span> }
-  <span class="hljs-title function_">getBin</span>(<span class="hljs-attr">id</span>: <span class="hljs-built_in">string</span>): <span class="hljs-title class_">Bin</span> | <span class="hljs-literal">undefined</span> { <span class="hljs-comment">/* GET ... */</span> }
-  <span class="hljs-title function_">listBins</span>(): <span class="hljs-title class_">Bin</span>[] { <span class="hljs-comment">/* SCAN ... */</span> }
-  <span class="hljs-title function_">deleteBin</span>(<span class="hljs-attr">id</span>: <span class="hljs-built_in">string</span>): <span class="hljs-built_in">boolean</span> { <span class="hljs-comment">/* DEL ... */</span> }
-  <span class="hljs-title function_">addRequest</span>(<span class="hljs-attr">binId</span>: <span class="hljs-built_in">string</span>, <span class="hljs-attr">req</span>: <span class="hljs-title class_">CapturedRequest</span>, <span class="hljs-attr">max</span>: <span class="hljs-built_in">number</span>): <span class="hljs-built_in">void</span> {
-    <span class="hljs-comment">/* LPUSH bin:${binId}:requests + LTRIM to max */</span>
-  }
-  <span class="hljs-title function_">getRequests</span>(<span class="hljs-attr">binId</span>: <span class="hljs-built_in">string</span>): <span class="hljs-title class_">CapturedRequest</span>[] { <span class="hljs-comment">/* LRANGE ... */</span> }
-  <span class="hljs-title function_">getRequest</span>(<span class="hljs-attr">binId</span>: <span class="hljs-built_in">string</span>, <span class="hljs-attr">reqId</span>: <span class="hljs-built_in">string</span>): <span class="hljs-title class_">CapturedRequest</span> | <span class="hljs-literal">undefined</span> { <span class="hljs-comment">/* ... */</span> }
-  <span class="hljs-title function_">clearRequests</span>(<span class="hljs-attr">binId</span>: <span class="hljs-built_in">string</span>): <span class="hljs-built_in">void</span> { <span class="hljs-comment">/* DEL bin:${binId}:requests */</span> }
-  <span class="hljs-title function_">cleanupExpired</span>(<span class="hljs-attr">now</span>: <span class="hljs-built_in">number</span>): <span class="hljs-built_in">string</span>[] { <span class="hljs-comment">/* scan + delete */</span> <span class="hljs-keyword">return</span> []; }
-}
-
-mock.<span class="hljs-property">bins</span> = <span class="hljs-keyword">new</span> <span class="hljs-title class_">BinManager</span>({ <span class="hljs-attr">store</span>: <span class="hljs-keyword">new</span> <span class="hljs-title class_">RedisBinStore</span>() });
+<h3 id="storage">Storage</h3>
+<p><code>MockHttpBins</code> stores each bin in <a href="https://github.com/jaredwray/keyv">Keyv</a> 6. The default is <code>new Keyv()</code>. That store keeps the data in memory for this process.</p>
+<p>Pass a Keyv 6 instance when you want a different adapter. Install the adapter in your project. This package does not include an adapter. <code>@keyv/redis</code> 6 matches this Keyv version.</p>
+<pre><code class="hljs language-typescript"><span class="hljs-keyword">import</span> <span class="hljs-title class_">Keyv</span> <span class="hljs-keyword">from</span> <span class="hljs-string">'keyv'</span>;
+<span class="hljs-keyword">import</span> <span class="hljs-title class_">KeyvRedis</span> <span class="hljs-keyword">from</span> <span class="hljs-string">'@keyv/redis'</span>; <span class="hljs-comment">// pnpm add @keyv/redis</span>
+<span class="hljs-keyword">import</span> { <span class="hljs-title class_">MockHttpBins</span> } <span class="hljs-keyword">from</span> <span class="hljs-string">'@jaredwray/mockhttp'</span>;
+
+mock.<span class="hljs-property">bins</span> = <span class="hljs-keyword">new</span> <span class="hljs-title class_">MockHttpBins</span>({
+  <span class="hljs-attr">keyv</span>: <span class="hljs-keyword">new</span> <span class="hljs-title class_">Keyv</span>({ <span class="hljs-attr">store</span>: <span class="hljs-keyword">new</span> <span class="hljs-title class_">KeyvRedis</span>(<span class="hljs-string">'redis://localhost:6379'</span>) }),
+});
 </code></pre>
+<p>Each capture writes the full bin again. A large body or a high request limit makes that write large. Set <code>maxBodySize</code> and <code>maxRequestsPerBin</code> to limit the size. With the defaults, a full bin of binary bodies is about 17 MB.</p>
+<p>Two processes that share one Keyv can lose a capture. This occurs when both processes write the same bin at the same time.</p>
+<p>If Keyv does not store a write, the bin route returns <code>500</code> with the standard Fastify error body: <code>statusCode</code>, <code>error</code>, and <code>message</code>.</p>
+<p>A failed read depends on the Keyv <code>error</code> listener. Without a listener, Keyv throws the store error and the route returns <code>500</code>. With a listener, Keyv does not throw. A failed read then looks like a missing bin, and the route returns <code>404</code>. <code>listBins()</code> returns only the bins that it read before the error.</p>
+<p><code>listBins()</code> throws an error when the adapter has no iterator.</p>
+<p>An expired bin returns 404. The in-memory Keyv store deletes an expired bin only when a read or <code>listBins()</code> reaches it. Until then, the bin stays in memory.</p>
     </main>
     <aside class="content-aside">
       <h2 class="content-aside__title">TABLE OF CONTENTS</h2>
@@ -715,7 +702,7 @@ mock.<span class="hljs-property">bins</span> = <span class="hljs-keyword">new</s
     <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>

package/site/dist/docs/configuration/index.html

@@ -35,7 +35,7 @@
   </script>
   <title>MockHTTP - Configuration</title>
   <script type="application/ld+json">
-{"@context":"https://schema.org","@type":"TechArticle","headline":"Configuration","description":"","url":"https://mockhttp.org/docs/configuration/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-03","keywords":[]}
+{"@context":"https://schema.org","@type":"TechArticle","headline":"Configuration","description":"","url":"https://mockhttp.org/docs/configuration/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-20","keywords":[]}
 </script>
 </head>
 
@@ -544,7 +544,7 @@ GET /status/429/foo/bar
     <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>

package/site/dist/docs/hosted/index.html

@@ -35,7 +35,7 @@
   </script>
   <title>MockHTTP - MockHttp.org Live</title>
   <script type="application/ld+json">
-{"@context":"https://schema.org","@type":"TechArticle","headline":"MockHttp.org Live","description":"","url":"https://mockhttp.org/docs/hosted/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-03","keywords":[]}
+{"@context":"https://schema.org","@type":"TechArticle","headline":"MockHttp.org Live","description":"","url":"https://mockhttp.org/docs/hosted/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-20","keywords":[]}
 </script>
 </head>
 
@@ -293,7 +293,7 @@
   </header>
   <div class="article__body">
     <main class="article__main">
-      <p><a href="https://mockhttp.org">mockhttp.org</a> is a free hosted instance of this codebase for testing. It runs on a <a href="/docs/how-to-deploy/cloudflare/">Cloudflare Worker</a> (no containers): documentation is served from Workers Assets, and mock APIs such as <code>/get</code> and <code>/post</code> run in the Worker. The service is globally available and rate-limited (1000 requests per minute per IP) to prevent abuse.</p>
+      <p><a href="https://mockhttp.org">mockhttp.org</a> is a free hosted instance of this codebase for testing. It runs on a <a href="/docs/how-to-deploy/cloudflare/">Cloudflare Worker</a> (no containers): documentation is served from Workers Assets, and mock APIs such as <code>/get</code> and <code>/post</code> run in the Worker. The service is globally available and rate-limited (1000 requests per minute per IP) to prevent abuse. Request bins on this service are stored in MongoDB Atlas, in the <code>bins</code> collection, so they are shared across isolates.</p>
 <p>All <a href="https://mockhttp.org">mockhttp.org</a> traffic stays on Cloudflare. A separate test app runs the Node server on <a href="/docs/how-to-deploy/wasmer/">Wasmer Edge</a> at <a href="https://mockhttp.wasmer.app">mockhttp.wasmer.app</a>.</p>
 <p>Getting Started is served at <code>/</code> and <code>/docs</code>, other guides at <code>/docs/...</code>, and the interactive HTTP API reference at <code>/api</code>. Mock endpoints such as <code>/get</code> and <code>/post</code> are unchanged.</p>
     </main>
@@ -318,7 +318,7 @@
     <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>

package/site/dist/docs/how-to-deploy/cloudflare/index.html

@@ -35,7 +35,7 @@
   </script>
   <title>MockHTTP - Cloudflare</title>
   <script type="application/ld+json">
-{"@context":"https://schema.org","@type":"TechArticle","headline":"Cloudflare","description":"Deploy MockHTTP as a Cloudflare Worker. Workers Assets serve the docs site, and the Worker handles mock API routes.","url":"https://mockhttp.org/docs/how-to-deploy/cloudflare/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-03","keywords":[]}
+{"@context":"https://schema.org","@type":"TechArticle","headline":"Cloudflare","description":"Deploy MockHTTP as a Cloudflare Worker. Workers Assets serve the docs site, and the Worker handles mock API routes.","url":"https://mockhttp.org/docs/how-to-deploy/cloudflare/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-20","keywords":[]}
 </script>
 </head>
 
@@ -329,11 +329,6 @@
 <td>Logos and other <code>public/</code> files are copied into <code>site/dist</code> and read through the <code>ASSETS</code> binding.</td>
 </tr>
 <tr>
-<td><code>startBins</code></td>
-<td><code>false</code></td>
-<td>The bin cleanup timer uses <code>setInterval</code>, which can hang a Worker isolate during startup. Bin routes still register. Expired bins are removed when that bin is read, not by a sweep of every bin.</td>
-</tr>
-<tr>
 <td><code>pluginTimeout</code></td>
 <td><code>0</code></td>
 <td>Disables Fastify's plugin boot timeout. Those timers are unreliable on Workers.</td>
@@ -390,7 +385,7 @@ npx wrangler@4.127.0 deploy
     <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>

package/site/dist/docs/how-to-deploy/docker/index.html

@@ -35,7 +35,7 @@
   </script>
   <title>MockHTTP - Docker</title>
   <script type="application/ld+json">
-{"@context":"https://schema.org","@type":"TechArticle","headline":"Docker","description":"Run MockHTTP from the jaredwray/mockhttp image, with Docker Compose, or by building the image from this repository.","url":"https://mockhttp.org/docs/how-to-deploy/docker/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-03","keywords":[]}
+{"@context":"https://schema.org","@type":"TechArticle","headline":"Docker","description":"Run MockHTTP from the jaredwray/mockhttp image, with Docker Compose, or by building the image from this repository.","url":"https://mockhttp.org/docs/how-to-deploy/docker/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-20","keywords":[]}
 </script>
 </head>
 
@@ -399,7 +399,7 @@ docker run -d -p 3000:3000 jaredwray/mockhttp
     <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>

package/site/dist/docs/how-to-deploy/wasmer/index.html

@@ -35,7 +35,7 @@
   </script>
   <title>MockHTTP - Wasmer</title>
   <script type="application/ld+json">
-{"@context":"https://schema.org","@type":"TechArticle","headline":"Wasmer","description":"Deploy the MockHTTP Node.js server to Wasmer Edge with app.yaml, Anybuild, and wasmer deploy.","url":"https://mockhttp.org/docs/how-to-deploy/wasmer/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-03","keywords":[]}
+{"@context":"https://schema.org","@type":"TechArticle","headline":"Wasmer","description":"Deploy the MockHTTP Node.js server to Wasmer Edge with app.yaml, Anybuild, and wasmer deploy.","url":"https://mockhttp.org/docs/how-to-deploy/wasmer/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-20","keywords":[]}
 </script>
 </head>
 
@@ -320,7 +320,7 @@
 <h2 id="build-with-anybuild">Build with Anybuild</h2>
 <p><a href="https://github.com/jaredwray/mockhttp/blob/main/Anybuild"><code>Anybuild</code></a> tells Wasmer how to build the package on a remote builder:</p>
 <ul>
-<li>Node.js 24 and pnpm <code>12.4.1</code></li>
+<li>Node.js 24 and pnpm <code>12.12.1</code></li>
 <li>Build command: <code>pnpm run build &#x26;&#x26; pnpm website:build</code></li>
 <li>Start command: <code>node dist/index.mjs</code></li>
 </ul>
@@ -335,7 +335,7 @@
 <pre><code class="hljs language-bash">wasmer deploy --non-interactive --build-remote
 </code></pre>
 <h2 id="runtime-behavior">Runtime behavior</h2>
-<p>Bins use the default in-memory store, so a bin exists only on the instance that created it. Taps are a library API (<code>mock.taps.inject</code>) and have no HTTP routes, so a deployed app cannot inject one.</p>
+<p>Bins use <code>new Keyv()</code> by default. The store keeps each bin in memory on the instance that created it. Give <code>MockHttpBins</code> a shared Keyv when bins must be visible on more than one instance. Two processes can lose a capture when they write the same bin at the same time. Taps are a library API (<code>mock.taps.inject</code>) and have no HTTP routes, so a deployed app cannot inject one.</p>
 <p><code>@fastify/rate-limit</code> is on at 1000 requests per minute. It keys on the address that connects to the process. The server does not trust proxy headers, and the allow list is only <code>127.0.0.1</code> and <code>::1</code>. On the test app, <code>/ip</code> reports <code>127.0.0.100</code>, which is the edge proxy rather than the caller, and the response includes <code>x-ratelimit-limit: 1000</code>. Clients that share that proxy address share one limit on that instance. This is not the Cloudflare limiter used by <a href="https://mockhttp.org">mockhttp.org</a>.</p>
 <p>The process listens with HTTP. Wasmer terminates TLS for the <code>*.wasmer.app</code> hostname.</p>
     </main>
@@ -360,7 +360,7 @@
     <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>

package/site/dist/docs/https/index.html

@@ -35,7 +35,7 @@
   </script>
   <title>MockHTTP - HTTPS and HTTP/2</title>
   <script type="application/ld+json">
-{"@context":"https://schema.org","@type":"TechArticle","headline":"HTTPS and HTTP/2","description":"","url":"https://mockhttp.org/docs/https/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-03","keywords":[]}
+{"@context":"https://schema.org","@type":"TechArticle","headline":"HTTPS and HTTP/2","description":"","url":"https://mockhttp.org/docs/https/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-20","keywords":[]}
 </script>
 </head>
 
@@ -531,7 +531,7 @@
     <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>

package/site/dist/docs/index.html

@@ -35,7 +35,7 @@
   </script>
   <title>MockHTTP - Getting Started</title>
   <script type="application/ld+json">
-{"@context":"https://schema.org","@type":"TechArticle","headline":"Getting Started","description":"","url":"https://mockhttp.org/docs/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-03","keywords":[]}
+{"@context":"https://schema.org","@type":"TechArticle","headline":"Getting Started","description":"","url":"https://mockhttp.org/docs/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-20","keywords":[]}
 </script>
 </head>
 
@@ -375,7 +375,7 @@
     <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>

package/site/dist/docs/library/index.html

@@ -35,7 +35,7 @@
   </script>
   <title>MockHTTP - Library API</title>
   <script type="application/ld+json">
-{"@context":"https://schema.org","@type":"TechArticle","headline":"Library API","description":"","url":"https://mockhttp.org/docs/library/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-03","keywords":[]}
+{"@context":"https://schema.org","@type":"TechArticle","headline":"Library API","description":"","url":"https://mockhttp.org/docs/library/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-20","keywords":[]}
 </script>
 </head>
 
@@ -333,7 +333,6 @@
 <li><a href="#binsgetrequestbinid-reqid"><code>bins.getRequest(binId, reqId)</code></a></li>
 <li><a href="#binsclearrequestsbinid"><code>bins.clearRequests(binId)</code></a></li>
 <li><a href="#binsrecordrequestbinid-raw"><code>bins.recordRequest(binId, raw)</code></a></li>
-<li><a href="#binsstart--binsstop"><code>bins.start()</code> / <code>bins.stop()</code></a></li>
 <li><a href="#binsmaxbodysize--binsmaxrequestsperbin--binsdefaultttlms"><code>bins.maxBodySize</code> / <code>bins.maxRequestsPerBin</code> / <code>bins.defaultTtlMs</code></a></li>
 </ul>
 </li>
@@ -368,7 +367,6 @@
 <li><code>logging?</code>: boolean - Enable logging (default: true)</li>
 <li><code>staticFiles?</code>: boolean - Serve files from the package <code>public/</code> directory (default: true)</li>
 <li><code>pluginTimeout?</code>: number - Fastify plugin boot timeout in milliseconds; <code>0</code> disables it (default: Fastify's timeout)</li>
-<li><code>startBins?</code>: boolean - Start the request-bin cleanup timer during <code>initialize()</code> (default: true)</li>
 <li><code>httpBin?</code>: HttpBinOptions - Configure which httpbin routes to enable
 <ul>
 <li><code>httpMethods?</code>: boolean - Enable HTTP method routes (default: true)</li>
@@ -402,7 +400,6 @@
 <li><code>logging</code>: boolean - Get/set logging enabled state</li>
 <li><code>staticFiles</code>: boolean - Get/set whether files from <code>public/</code> are served</li>
 <li><code>pluginTimeout</code>: number | undefined - Get/set Fastify plugin boot timeout</li>
-<li><code>startBins</code>: boolean - Get/set whether bin cleanup starts during <code>initialize()</code></li>
 <li><code>rateLimit</code>: RateLimitPluginOptions | undefined - Get/set rate limiting options</li>
 <li><code>httpBin</code>: HttpBinOptions - Get/set httpbin route options</li>
 <li><code>https</code>: HttpsOptions | undefined - Get/set HTTPS configuration</li>
@@ -411,7 +408,7 @@
 <li><code>http1</code>: boolean - Get/set HTTP/1.1 fallback for HTTP/2 with HTTPS</li>
 <li><code>server</code>: FastifyInstance - Get/set the Fastify server instance</li>
 <li><code>taps</code>: TapManager - Get/set the TapManager instance</li>
-<li><code>bins</code>: BinManager - Get/set the BinManager instance for request bins</li>
+<li><code>bins</code>: MockHttpBins - Get or set the request bins</li>
 </ul>
 <h3 id="methods">Methods</h3>
 <h4 id="async-initialize"><code>async initialize()</code></h4>
@@ -452,32 +449,31 @@
 <h4 id="async-registerbinroutesfastifyinstance"><code>async registerBinRoutes(fastifyInstance?)</code></h4>
 <p>Register the request bin routes — management at <code>/bins</code> and capture at <code>/b/:id</code>.</p>
 <h2 id="bins-request-capture">Bins (Request Capture)</h2>
-<p>Access the BinManager via <code>mockHttp.bins</code> to manage request bins programmatically. See <a href="#request-bins">Request Bins</a> for usage examples.</p>
+<p>Use <code>mockHttp.bins</code> to control request bins. See <a href="#request-bins">Request Bins</a> for usage examples.</p>
 <h3 id="binscreatebin"><code>bins.createBin()</code></h3>
-<p>Create a new bin with the configured TTL.</p>
-<p><strong>Returns:</strong> <code>Bin</code> — <code>{ id, createdAt, expiresAt, requestCount }</code></p>
+<p>Create a new bin with the configured TTL. Throws when Keyv does not store the bin.</p>
+<p><strong>Returns:</strong> <code>Promise&#x3C;Bin></code> — <code>{ id, createdAt, expiresAt, requestCount }</code></p>
 <h3 id="binsgetbinid"><code>bins.getBin(id)</code></h3>
-<p>Look up a bin by id. Returns <code>undefined</code> if the bin does not exist or has expired (and lazily removes the expired entry).</p>
-<p><strong>Returns:</strong> <code>Bin | undefined</code></p>
+<p>Look up a bin by id. Returns <code>undefined</code> if the bin does not exist or Keyv has expired it. When the Keyv instance has an <code>error</code> listener, a failed read also returns <code>undefined</code>.</p>
+<p><strong>Returns:</strong> <code>Promise&#x3C;Bin | undefined></code></p>
 <h3 id="binslistbins"><code>bins.listBins()</code></h3>
-<p>List all non-expired bins.</p>
-<p><strong>Returns:</strong> <code>Bin[]</code></p>
+<p>List the bins that Keyv still holds.</p>
+<p><strong>Returns:</strong> <code>Promise&#x3C;Bin[]></code></p>
 <h3 id="binsdeletebinid"><code>bins.deleteBin(id)</code></h3>
-<p>Delete a bin and all its captured requests.</p>
-<p><strong>Returns:</strong> <code>boolean</code> — <code>true</code> if the bin existed</p>
+<p>Delete a bin and all its captured requests. The delete waits for captures already queued for that bin.</p>
+<p><strong>Returns:</strong> <code>Promise&#x3C;boolean></code> — <code>true</code> when the bin existed</p>
 <h3 id="binsgetrequestsbinid"><code>bins.getRequests(binId)</code></h3>
 <p>List captured requests for a bin, newest first.</p>
-<p><strong>Returns:</strong> <code>CapturedRequest[]</code></p>
+<p><strong>Returns:</strong> <code>Promise&#x3C;CapturedRequest[]></code></p>
 <h3 id="binsgetrequestbinid-reqid"><code>bins.getRequest(binId, reqId)</code></h3>
 <p>Look up a single captured request.</p>
-<p><strong>Returns:</strong> <code>CapturedRequest | undefined</code></p>
+<p><strong>Returns:</strong> <code>Promise&#x3C;CapturedRequest | undefined></code></p>
 <h3 id="binsclearrequestsbinid"><code>bins.clearRequests(binId)</code></h3>
-<p>Clear all captured requests in a bin (the bin itself is preserved).</p>
+<p>Clear all captured requests in a bin. The bin stays. Throws when Keyv does not store the change.</p>
+<p><strong>Returns:</strong> <code>Promise&#x3C;boolean></code> — <code>false</code> when the bin does not exist</p>
 <h3 id="binsrecordrequestbinid-raw"><code>bins.recordRequest(binId, raw)</code></h3>
-<p>Manually record a captured request. Returns <code>undefined</code> if the bin does not exist or is expired. Normally invoked by the capture route, but available for programmatic use.</p>
-<p><strong>Returns:</strong> <code>CapturedRequest | undefined</code></p>
-<h3 id="binsstart--binsstop"><code>bins.start()</code> / <code>bins.stop()</code></h3>
-<p>Start or stop the periodic cleanup of expired bins. <code>MockHttp.start()</code> and <code>MockHttp.close()</code> call these automatically. The interval is <code>unref()</code>'d so it never keeps the Node process alive.</p>
+<p>Manually record a captured request. Returns <code>undefined</code> if the bin does not exist. Throws when Keyv does not store the capture. Normally invoked by the capture route, but available for programmatic use.</p>
+<p><strong>Returns:</strong> <code>Promise&#x3C;CapturedRequest | undefined></code></p>
 <h3 id="binsmaxbodysize--binsmaxrequestsperbin--binsdefaultttlms"><code>bins.maxBodySize</code> / <code>bins.maxRequestsPerBin</code> / <code>bins.defaultTtlMs</code></h3>
 <p>Read-only getters for the currently-configured limits.</p>
 <h2 id="taps-response-injection">Taps (Response Injection)</h2>
@@ -553,7 +549,7 @@
     <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>

package/site/dist/docs/taps/index.html

@@ -35,7 +35,7 @@
   </script>
   <title>MockHTTP - Taps</title>
   <script type="application/ld+json">
-{"@context":"https://schema.org","@type":"TechArticle","headline":"Taps","description":"","url":"https://mockhttp.org/docs/taps/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-03","keywords":[]}
+{"@context":"https://schema.org","@type":"TechArticle","headline":"Taps","description":"","url":"https://mockhttp.org/docs/taps/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-20","keywords":[]}
 </script>
 </head>
 
@@ -481,7 +481,7 @@ mock.<span class="hljs-property">taps</span>.<span class="hljs-title function_">
     <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>

package/site/dist/feed.xml

@@ -1 +1 @@
-<?xml version="1.0" encoding="UTF-8"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>MockHTTP</title><link>https://mockhttp.org/</link><description>HTTP mock server and httpbin replacement for API testing. Run it at mockhttp.org, in Docker, or in Node.js.</description><lastBuildDate>Sat, 03 Oct 2026 22:17:09 GMT</lastBuildDate><atom:link href="https://mockhttp.org/feed.xml" rel="self" type="application/rss+xml" /><item><title>Getting Started</title><link>https://mockhttp.org/docs/</link><guid isPermaLink="true">https://mockhttp.org/docs/</guid><description>tests GitHub license codecov npm npm Docker Pulls mockhttp.org A simple HTTP server for mocking responses in tests. Inspired by httpbin and built with Node.js and Fastify. Run it at mockhttp.org, with Docker (jaredwray/mockhttp), or in Node...</description></item><item><title>HTTPS and HTTP/2</title><link>https://mockhttp.org/docs/https/</link><guid isPermaLink="true">https://mockhttp.org/docs/https/</guid><description>MockHttp supports HTTPS with auto-generated self-signed certificates or your own custom certificates. No external dependencies are required — certificate generation uses only Node.js built-in crypto. The simplest way to enable HTTPS is to p...</description></item><item><title>Taps</title><link>https://mockhttp.org/docs/taps/</link><guid isPermaLink="true">https://mockhttp.org/docs/taps/</guid><description>The injection/tap feature allows you to &quot;tap into&quot; the request flow and inject custom responses for specific requests. This is particularly useful for: Offline testing - Mock external API responses without network access Testing edge cases...</description></item><item><title>Bins</title><link>https://mockhttp.org/docs/bins/</link><guid isPermaLink="true">https://mockhttp.org/docs/bins/</guid><description>Bins are ephemeral URL endpoints that capture incoming HTTP requests so you can inspect them later. They&apos;re the inverse of Taps: instead of injecting a response, they record everything they receive. Useful for: Debugging webhooks — point St...</description></item><item><title>Configuration</title><link>https://mockhttp.org/docs/configuration/</link><guid isPermaLink="true">https://mockhttp.org/docs/configuration/</guid><description>MockHttp supports rate limiting using @fastify/rate-limit. Rate limiting is enabled by default at 1000 requests per minute with localhost (127.0.0.1 and ::1) excluded from rate limiting. By default, MockHttp applies the following rate limit...</description></item><item><title>Library API</title><link>https://mockhttp.org/docs/library/</link><guid isPermaLink="true">https://mockhttp.org/docs/library/</guid><description>Parameters: options? (MockHttpOptions): port?: number - The port to listen on (default: 3000) host?: string - The host to listen on (default: &apos;0.0.0.0&apos;) autoDetectPort?: boolean - Auto-detect next available port if in use (default: true) he...</description></item><item><title>MockHttp.org Live</title><link>https://mockhttp.org/docs/hosted/</link><guid isPermaLink="true">https://mockhttp.org/docs/hosted/</guid><description>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 globall...</description></item><item><title>Cloudflare</title><link>https://mockhttp.org/docs/how-to-deploy/cloudflare/</link><guid isPermaLink="true">https://mockhttp.org/docs/how-to-deploy/cloudflare/</guid><description>Deploy MockHTTP as a Cloudflare Worker. Workers Assets serve the docs site, and the Worker handles mock API routes.</description></item><item><title>Docker</title><link>https://mockhttp.org/docs/how-to-deploy/docker/</link><guid isPermaLink="true">https://mockhttp.org/docs/how-to-deploy/docker/</guid><description>Run MockHTTP from the jaredwray/mockhttp image, with Docker Compose, or by building the image from this repository.</description></item><item><title>Wasmer</title><link>https://mockhttp.org/docs/how-to-deploy/wasmer/</link><guid isPermaLink="true">https://mockhttp.org/docs/how-to-deploy/wasmer/</guid><description>Deploy the MockHTTP Node.js server to Wasmer Edge with app.yaml, Anybuild, and wasmer deploy.</description></item></channel></rss>
+<?xml version="1.0" encoding="UTF-8"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>MockHTTP</title><link>https://mockhttp.org/</link><description>HTTP mock server and httpbin replacement for API testing. Run it at mockhttp.org, in Docker, or in Node.js.</description><lastBuildDate>Tue, 20 Oct 2026 00:19:31 GMT</lastBuildDate><atom:link href="https://mockhttp.org/feed.xml" rel="self" type="application/rss+xml" /><item><title>Getting Started</title><link>https://mockhttp.org/docs/</link><guid isPermaLink="true">https://mockhttp.org/docs/</guid><description>tests GitHub license codecov npm npm Docker Pulls mockhttp.org A simple HTTP server for mocking responses in tests. Inspired by httpbin and built with Node.js and Fastify. Run it at mockhttp.org, with Docker (jaredwray/mockhttp), or in Node...</description></item><item><title>HTTPS and HTTP/2</title><link>https://mockhttp.org/docs/https/</link><guid isPermaLink="true">https://mockhttp.org/docs/https/</guid><description>MockHttp supports HTTPS with auto-generated self-signed certificates or your own custom certificates. No external dependencies are required — certificate generation uses only Node.js built-in crypto. The simplest way to enable HTTPS is to p...</description></item><item><title>Taps</title><link>https://mockhttp.org/docs/taps/</link><guid isPermaLink="true">https://mockhttp.org/docs/taps/</guid><description>The injection/tap feature allows you to &quot;tap into&quot; the request flow and inject custom responses for specific requests. This is particularly useful for: Offline testing - Mock external API responses without network access Testing edge cases...</description></item><item><title>Bins</title><link>https://mockhttp.org/docs/bins/</link><guid isPermaLink="true">https://mockhttp.org/docs/bins/</guid><description>Bins are ephemeral URL endpoints that capture incoming HTTP requests so you can inspect them later. They&apos;re the inverse of Taps: instead of injecting a response, they record everything they receive. Useful for: Debugging webhooks — point St...</description></item><item><title>Configuration</title><link>https://mockhttp.org/docs/configuration/</link><guid isPermaLink="true">https://mockhttp.org/docs/configuration/</guid><description>MockHttp supports rate limiting using @fastify/rate-limit. Rate limiting is enabled by default at 1000 requests per minute with localhost (127.0.0.1 and ::1) excluded from rate limiting. By default, MockHttp applies the following rate limit...</description></item><item><title>Library API</title><link>https://mockhttp.org/docs/library/</link><guid isPermaLink="true">https://mockhttp.org/docs/library/</guid><description>Parameters: options? (MockHttpOptions): port?: number - The port to listen on (default: 3000) host?: string - The host to listen on (default: &apos;0.0.0.0&apos;) autoDetectPort?: boolean - Auto-detect next available port if in use (default: true) he...</description></item><item><title>MockHttp.org Live</title><link>https://mockhttp.org/docs/hosted/</link><guid isPermaLink="true">https://mockhttp.org/docs/hosted/</guid><description>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 globall...</description></item><item><title>Cloudflare</title><link>https://mockhttp.org/docs/how-to-deploy/cloudflare/</link><guid isPermaLink="true">https://mockhttp.org/docs/how-to-deploy/cloudflare/</guid><description>Deploy MockHTTP as a Cloudflare Worker. Workers Assets serve the docs site, and the Worker handles mock API routes.</description></item><item><title>Docker</title><link>https://mockhttp.org/docs/how-to-deploy/docker/</link><guid isPermaLink="true">https://mockhttp.org/docs/how-to-deploy/docker/</guid><description>Run MockHTTP from the jaredwray/mockhttp image, with Docker Compose, or by building the image from this repository.</description></item><item><title>Wasmer</title><link>https://mockhttp.org/docs/how-to-deploy/wasmer/</link><guid isPermaLink="true">https://mockhttp.org/docs/how-to-deploy/wasmer/</guid><description>Deploy the MockHTTP Node.js server to Wasmer Edge with app.yaml, Anybuild, and wasmer deploy.</description></item></channel></rss>

package/site/dist/index.html

@@ -35,7 +35,7 @@
   </script>
   <title>MockHTTP - Getting Started</title>
   <script type="application/ld+json">
-{"@context":"https://schema.org","@type":"TechArticle","headline":"Getting Started","description":"","url":"https://mockhttp.org/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-03","keywords":[]}
+{"@context":"https://schema.org","@type":"TechArticle","headline":"Getting Started","description":"","url":"https://mockhttp.org/","publisher":{"@type":"Organization","name":"MockHTTP"},"dateModified":"2026-10-20","keywords":[]}
 </script>
 </head>
 
@@ -375,7 +375,7 @@
     <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>