@passcod/faith 0.0.7 → 0.0.9

package/README.md

@@ -401,6 +401,15 @@ In HTTP/1, servers can send custom status text. This is returned here. In HTTP/2
 status text is not supported at all, and the `statusText` property is either empty or simulated
 from well-known status codes.
 
+### `Response.trailers: Promise<Headers | null>`
+
+The `trailers()` read-only property of the `Response` interface returns a promise that resolves to
+either `null` or a `Headers` structure that contains the HTTP/2 or /3 trailing headers.
+
+Note that this will never resolve if you don't also consume the body in some way.
+
+Custom to Fáith. This was once in the spec but was removed as it wasn't implemented by any browser.
+
 ### `Response.type: string`
 
 *The `type` read-only property of the `Response` interface contains the type of the response. The
@@ -446,6 +455,20 @@ in every way, but stored in a different variable.*
 
 *`clone()` throws an error if the response body has already been used.*
 
+### `Response.discard(): Promise<void>`
+
+Discard the response body, releasing the connection back to the pool.
+
+This is useful when you don't need the body but want to ensure the connection can be reused for
+subsequent requests. If you don't call this and don't consume the body, the connection may be held
+open until the response is garbage collected. When the connection is HTTP/2 or /3, calling this is
+not necessary as the connection can be reused regardless, but it's still good practice to make it
+explicit and won't do unnecessary work in those cases.
+
+The returned promise resolves when the body has been fully discarded.
+
+This is custom to Fáith.
+
 ### `Response.formData(): !`
 
 Fáith deliberately does not implement this. The method exists so the types work out, but it will
@@ -624,6 +647,31 @@ defines bounds for safety: minimum 1 second, maximum 2 minutes (120 seconds).
 
 Default: 30.
 
+#### `AgentOptions.http3.upgradeEnabled: bool`
+
+Fáith keeps track of "Alt-Svc" advertisements from the servers, which indicate if and how HTTP/3 is
+available. It then uses those advertisements to attempt connection over HTTP/3, and also keeps
+track of failures, so it doesn't waste time retrying HTTP/3 for hosts that don't actually support
+it even if they did advertise it.
+
+Setting this setting to `false` disables this mechanism, which effectively disables HTTP/3 usage.
+
+Default: `true`.
+
+#### `AgentOptions.http3.hints: Array<{ host: string; port: number }>`
+
+If you know upfront that a host has HTTP/3 support, and at what port it's listening, you can skip
+a first HTTP/1 or /2 connection by providing a hint here. If the connection fails, the hint will
+be ignored for the `upgradeFailedTtl` duration, just like for the normal pathway with Alt-Svc
+advertisements (essentially, hints pre-populate the Alt-Svc advertisements cache).
+
+#### `AgentOptions.http3.upgradeAdvertisedTtl: number`
+#### `AgentOptions.http3.upgradeConfirmedTtl: number`
+#### `AgentOptions.http3.upgradeFailedTtl: number`
+#### `AgentOptions.http3.upgradeCacheCapacity: number`
+
+These four settings allow tweaking the HTTP/3 advertisement/knowledge cache behaviour.
+
 ### `AgentOptions.pool: object`
 
 Settings related to the connection pool. This is a nested object.
@@ -750,6 +798,8 @@ Returns statistics gathered by this agent:
 
 - `requestsSent`
 - `responsesReceived`
+- `bodiesStarted`
+- `bodiesFinished`
 
 ## Error mapping
 
@@ -764,6 +814,7 @@ error kind, documented in this comprehensive mapping:
   - `Network` — network error
   - `Redirect` — when the agent is configured to error on redirects
 - JS `SyntaxError`:
+  - `AddressParse` — IP parse error for `AgentOptions.dns.overrides`
   - `JsonParse` — JSON parse error for `response.json()`
   - `PemParse` — PEM parse error for `AgentOptions.tls.identity`
   - `Utf8Parse` — UTF8 decoding error for `response.text()`
@@ -786,3 +837,12 @@ constant from `ERROR_CODES`, instead of doing string matching on the error messa
 
 Due to technical limitations, when reading a body stream, reads might fail, but that error
 will not have a `code` property.
+
+## Versions
+
+Two version constants are exposed:
+
+- `FAITH_VERSION` is the version of the Fáith library itself
+- `REQWEST_VERSION` is the version of the underlying [reqwest](https://github.com/seanmonstar/reqwest) library
+
+These can be used to construct your own user agent strings, in logging, or for seeking help.

package/index.d.ts

@@ -317,6 +317,44 @@ export interface AgentHttp3Options {
    * Default: 30.
    */
   maxIdleTimeout?: number
+  /**
+   * Whether HTTP/3 upgrade via Alt-Svc is enabled. When enabled, the agent will track Alt-Svc
+   * headers from responses and automatically upgrade subsequent requests to HTTP/3 when available.
+   *
+   * Default: true.
+   */
+  upgradeEnabled?: boolean
+  /**
+   * How long (in seconds) to cache an Alt-Svc advertisement before the first HTTP/3 attempt.
+   * This is overridden by the `ma` (max-age) parameter in the Alt-Svc header if present.
+   *
+   * Default: 86400 (24 hours).
+   */
+  upgradeAdvertisedTtl?: number
+  /**
+   * How long (in seconds) to cache a confirmed working HTTP/3 connection.
+   *
+   * Default: 86400 (24 hours).
+   */
+  upgradeConfirmedTtl?: number
+  /**
+   * How long (in seconds) to cache a failed HTTP/3 attempt. During this time, no HTTP/3
+   * upgrades will be attempted for the origin, even if the server sends Alt-Svc headers.
+   *
+   * Default: 300 (5 minutes).
+   */
+  upgradeFailedTtl?: number
+  /**
+   * Maximum number of origins to track in the Alt-Svc cache.
+   *
+   * Default: 10000.
+   */
+  upgradeCacheCapacity?: number
+  /**
+   * Hints for hosts that are known to support HTTP/3. These are added to the Alt-Svc cache
+   * on agent initialization, so the first request to these hosts will attempt HTTP/3.
+   */
+  hints?: Array<Http3Hint>
 }
 
 export interface AgentOptions {
@@ -621,6 +659,17 @@ export declare const enum Http3Congestion {
   Bbr1 = 'bbr1'
 }
 
+/**
+ * A hint that HTTP/3 is available at a specific host and port. This pre-populates the Alt-Svc
+ * cache so the first request to this host will attempt HTTP/3 immediately.
+ */
+export interface Http3Hint {
+  /** The hostname (e.g., "example.com"). */
+  host: string
+  /** The port number (e.g., 443). */
+  port: number
+}
+
 /**
  * Determines the behavior in case the server replies with a redirect status.
  * One of the following values:

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-android-arm64')
         const bindingPackageVersion = require('@passcod/faith-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-android-arm-eabi')
         const bindingPackageVersion = require('@passcod/faith-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-win32-x64-gnu')
         const bindingPackageVersion = require('@passcod/faith-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-win32-x64-msvc')
         const bindingPackageVersion = require('@passcod/faith-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-win32-ia32-msvc')
         const bindingPackageVersion = require('@passcod/faith-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-win32-arm64-msvc')
         const bindingPackageVersion = require('@passcod/faith-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('@passcod/faith-darwin-universal')
       const bindingPackageVersion = require('@passcod/faith-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-darwin-x64')
         const bindingPackageVersion = require('@passcod/faith-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-darwin-arm64')
         const bindingPackageVersion = require('@passcod/faith-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-freebsd-x64')
         const bindingPackageVersion = require('@passcod/faith-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-freebsd-arm64')
         const bindingPackageVersion = require('@passcod/faith-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('@passcod/faith-linux-x64-musl')
           const bindingPackageVersion = require('@passcod/faith-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('@passcod/faith-linux-x64-gnu')
           const bindingPackageVersion = require('@passcod/faith-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('@passcod/faith-linux-arm64-musl')
           const bindingPackageVersion = require('@passcod/faith-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('@passcod/faith-linux-arm64-gnu')
           const bindingPackageVersion = require('@passcod/faith-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('@passcod/faith-linux-arm-musleabihf')
           const bindingPackageVersion = require('@passcod/faith-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('@passcod/faith-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@passcod/faith-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('@passcod/faith-linux-loong64-musl')
           const bindingPackageVersion = require('@passcod/faith-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('@passcod/faith-linux-loong64-gnu')
           const bindingPackageVersion = require('@passcod/faith-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('@passcod/faith-linux-riscv64-musl')
           const bindingPackageVersion = require('@passcod/faith-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('@passcod/faith-linux-riscv64-gnu')
           const bindingPackageVersion = require('@passcod/faith-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-linux-ppc64-gnu')
         const bindingPackageVersion = require('@passcod/faith-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-linux-s390x-gnu')
         const bindingPackageVersion = require('@passcod/faith-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-openharmony-arm64')
         const bindingPackageVersion = require('@passcod/faith-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-openharmony-x64')
         const bindingPackageVersion = require('@passcod/faith-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('@passcod/faith-openharmony-arm')
         const bindingPackageVersion = require('@passcod/faith-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.0.7' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@passcod/faith",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "fáith: a Rust-powered fetch",
   "repository": "https://github.com/passcod/faith",
   "author": {
@@ -70,17 +70,17 @@
     "node": ">= 20"
   },
   "optionalDependencies": {
-    "@passcod/faith-darwin-arm64": "0.0.7",
-    "@passcod/faith-android-arm64": "0.0.7",
-    "@passcod/faith-win32-arm64-msvc": "0.0.7",
-    "@passcod/faith-linux-arm64-gnu": "0.0.7",
-    "@passcod/faith-linux-arm64-musl": "0.0.7",
-    "@passcod/faith-android-arm-eabi": "0.0.7",
-    "@passcod/faith-linux-arm-gnueabihf": "0.0.7",
-    "@passcod/faith-darwin-x64": "0.0.7",
-    "@passcod/faith-win32-x64-msvc": "0.0.7",
-    "@passcod/faith-freebsd-x64": "0.0.7",
-    "@passcod/faith-linux-x64-gnu": "0.0.7",
-    "@passcod/faith-linux-x64-musl": "0.0.7"
+    "@passcod/faith-darwin-arm64": "0.0.9",
+    "@passcod/faith-android-arm64": "0.0.9",
+    "@passcod/faith-win32-arm64-msvc": "0.0.9",
+    "@passcod/faith-linux-arm64-gnu": "0.0.9",
+    "@passcod/faith-linux-arm64-musl": "0.0.9",
+    "@passcod/faith-android-arm-eabi": "0.0.9",
+    "@passcod/faith-linux-arm-gnueabihf": "0.0.9",
+    "@passcod/faith-darwin-x64": "0.0.9",
+    "@passcod/faith-win32-x64-msvc": "0.0.9",
+    "@passcod/faith-freebsd-x64": "0.0.9",
+    "@passcod/faith-linux-x64-gnu": "0.0.9",
+    "@passcod/faith-linux-x64-musl": "0.0.9"
   }
 }

package/wrapper.d.ts

@@ -274,6 +274,30 @@ export class Response {
 	 */
 	readonly body: ReadableStream<Uint8Array> | null;
 
+	/**
+	 * The `trailers()` read-only property of the `Response` interface returns a promise that
+	 * resolves to either `null` or a `Headers` structure that contains the HTTP/2 or /3 trailing
+	 * headers.
+	 *
+	 * This was once in the spec but was removed as it wasn't implemented by any browser.
+	 *
+	 * Note that this will never resolve if you don't also consume the body in some way.
+	 */
+	readonly trailers: Promise<Headers | null>;
+
+	/**
+	 * Discard the response body, releasing the connection back to the pool.
+	 *
+	 * This is useful when you don't need the body but want to ensure the connection
+	 * can be reused for subsequent requests. If you don't call this and don't consume
+	 * the body, the connection may be held open until the response is garbage collected.
+	 *
+	 * This is custom to Fáith.
+	 *
+	 * @returns {Promise<void>} Resolves when the body has been fully discarded
+	 */
+	discard(): Promise<void>;
+
 	/**
 	 * The `text()` method of the `Response` interface takes a `Response` stream and reads it to
 	 * completion. It returns a promise that resolves with a `String`. The response is always decoded
@@ -322,16 +346,6 @@ export class Response {
 	 */
 	formData(): Promise<FormData>;
 
-	/**
-	 * The `trailers()` method of the `Response` interface returns a promise that resolves to either
-	 * `null` or a `Headers` structure that contains the HTTP/2 or /3 trailing headers.
-	 *
-	 * This was once in the spec as a getter but was removed as it wasn't implemented by any browser.
-	 *
-	 * Note that this will never resolve if you don't also consume the body in some way.
-	 */
-	trailers(): Promise<Headers | null>;
-
 	/**
 	 * The `clone()` method of the `Response` interface creates a clone of a response object, identical
 	 * in every way, but stored in a different variable.

package/wrapper.js

@@ -119,15 +119,6 @@ class Response {
 		throw new Error("not supported");
 	}
 
-	/**
-	 * Discard the response body, releasing the connection back to the pool.
-	 *
-	 * This is useful when you don't need the body but want to ensure the connection
-	 * can be reused for subsequent requests. If you don't call this and don't consume
-	 * the body, the connection may be held open until the response is garbage collected.
-	 *
-	 * @returns {Promise<void>} Resolves when the body has been fully discarded
-	 */
 	async discard() {
 		return await this.#nativeResponse.discard();
 	}