Deployed bed715f with MkDocs version: 1.6.1

errors/index.html

@@ -462,6 +462,17 @@
     </span>
   </a>
 
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#missingdecodererror" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        MissingDecoderError
+      
+    </span>
+  </a>
+  
 </li>
 
         <li class="md-nav__item">
@@ -830,6 +841,17 @@
     </span>
   </a>
 
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#missingdecodererror" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        MissingDecoderError
+      
+    </span>
+  </a>
+  
 </li>
 
         <li class="md-nav__item">
@@ -891,7 +913,8 @@ <h2 id="the-exception-tree">The exception tree<a class="headerlink" href="#the-e
 <a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a>│       └── ServiceUnavailableError (503)
 <a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>├── RetryBudgetExhaustedError       (a retry was needed but the budget refused)
 <a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a>├── BulkheadFullError                (acquire_timeout elapsed before a slot opened)
-<a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a>└── DecodeError                      (response_model= decoder failed; HTTP call itself succeeded)
+<a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a>├── DecodeError                      (response_model= decoder failed; HTTP call itself succeeded)
+<a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a>└── MissingDecoderError              (no registered decoder claims response_model=; fires before the HTTP call)
 </code></pre></div>
 <h2 id="status-to-exception-mapping">Status-to-exception mapping<a class="headerlink" href="#status-to-exception-mapping" title="Permanent link">&para;</a></h2>
 <table>
@@ -1037,6 +1060,18 @@ <h2 id="decodeerror"><code>DecodeError</code><a class="headerlink" href="#decode
 <a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a>    <span class="p">)</span>
 <a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a>    <span class="k">raise</span>
 </code></pre></div>
+<h2 id="missingdecodererror"><code>MissingDecoderError</code><a class="headerlink" href="#missingdecodererror" title="Permanent link">&para;</a></h2>
+<p>Raised by <code>send()</code> / <code>send_with_response()</code> / verb methods when <code>response_model=</code> is set but no registered decoder claims the model. Carries:</p>
+<ul>
+<li><code>model: type</code> — the <code>response_model=</code> value that wasn't claimed.</li>
+<li><code>registered_names: tuple[str, ...]</code> — class names of the registered decoders that all rejected the model. Empty tuple means no decoders were registered.</li>
+</ul>
+<p>Corrective action depends on the message hint:</p>
+<ul>
+<li><code>no decoders registered. Install pip install httpware[pydantic] or pip install httpware[msgspec], or pass decoders=[...] explicitly.</code> — install an extra or pass an explicit decoder list.</li>
+<li><code>registered decoders (PydanticDecoder + MsgspecDecoder) all rejected it.</code> — your <code>response_model</code> type is exotic enough that neither built-in claims it. Pass a custom <code>ResponseDecoder</code> via <code>decoders=[...]</code>.</li>
+</ul>
+<p>Unlike <code>DecodeError</code>, this error fires <em>before</em> the HTTP request — no traffic is sent.</p>
 <h2 id="see-also">See also<a class="headerlink" href="#see-also" title="Permanent link">&para;</a></h2>
 <ul>
 <li><strong><a href="../resilience/">Resilience reference</a></strong> — <code>AsyncRetry</code>, <code>RetryBudget</code>, <code>AsyncBulkhead</code> parameter tables.</li>