@passcod/faith 0.0.8 → 0.1.0

package/README.md

@@ -226,7 +226,7 @@ following values:*
 
 - *`omit`: Never send credentials in the request or include credentials in the response.*
 - ~~`same-origin`~~: Fáith does not implement this, as there is no concept of "origin" on the server.
-- *`include`: *Always include credentials,* ~~even for cross-origin requests.~~
+- *`include`: Always include credentials,* ~~even for cross-origin requests.~~
 
 Fáith ignores the `Access-Control-Allow-Credentials` and `Access-Control-Allow-Origin` headers.
 
@@ -257,8 +257,6 @@ Fáith allows all request headers to be set (unlike browsers, which [forbid][1]
 
 ### `FetchOptions.integrity: string`
 
-Not implemented yet.
-
 *Contains the subresource integrity value of the request.*
 
 *The format of this option is `<hash-algo>-<hash-source>` where:*
@@ -267,6 +265,9 @@ Not implemented yet.
 - *`<hash-source>` is the Base64-encoding of the result of hashing the resource with the specified
   hash algorithm.*
 
+Multiple space-separated values are supported; if any matches, verification passes. Unknown
+algorithms are silently ignored (but if all algorithms are unknown, an error is thrown).
+
 Fáith only checks the integrity when using `bytes()`, `json()`, `text()`, `arrayBuffer()`, and
 `blob()`. Verification when reading through the `body` stream is not currently supported.
 
@@ -401,6 +402,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 +456,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 +648,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 +799,8 @@ Returns statistics gathered by this agent:
 
 - `requestsSent`
 - `responsesReceived`
+- `bodiesStarted`
+- `bodiesFinished`
 
 ## Error mapping
 
@@ -764,6 +815,8 @@ 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`
+  - `InvalidIntegrity` — SRI parse error for `RequestInit.integrity`
   - `JsonParse` — JSON parse error for `response.json()`
   - `PemParse` — PEM parse error for `AgentOptions.tls.identity`
   - `Utf8Parse` — UTF8 decoding error for `response.text()`
@@ -776,6 +829,7 @@ error kind, documented in this comprehensive mapping:
 - JS generic `Error`:
   - `BodyStream` — internal stream handling error
   - `Config` — invalid agent configuration
+  - `IntegrityMismatch` — SRI checksum mismatch (with `RequestInit.integrity`)
   - `RuntimeThread` — failed to start or schedule threads on the internal tokio runtime
 
 The library exports an `ERROR_CODES` object which has every error code the library throws, and
@@ -786,3 +840,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

@@ -613,7 +613,9 @@ export declare const enum FaithErrorKind {
   AddressParse = 'AddressParse',
   BodyStream = 'BodyStream',
   Config = 'Config',
+  IntegrityMismatch = 'IntegrityMismatch',
   InvalidHeader = 'InvalidHeader',
+  InvalidIntegrity = 'InvalidIntegrity',
   InvalidMethod = 'InvalidMethod',
   InvalidUrl = 'InvalidUrl',
   JsonParse = 'JsonParse',
@@ -636,6 +638,7 @@ export interface FaithOptionsAndBody {
   credentials?: CredentialsOption
   duplex?: DuplexOption
   headers?: Array<[string, string]>
+  integrity?: string
   method?: string
   timeout?: number
 }

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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8' && 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.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && 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.1.0 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.8",
+  "version": "0.1.0",
   "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.8",
-    "@passcod/faith-android-arm64": "0.0.8",
-    "@passcod/faith-win32-arm64-msvc": "0.0.8",
-    "@passcod/faith-linux-arm64-gnu": "0.0.8",
-    "@passcod/faith-linux-arm64-musl": "0.0.8",
-    "@passcod/faith-android-arm-eabi": "0.0.8",
-    "@passcod/faith-linux-arm-gnueabihf": "0.0.8",
-    "@passcod/faith-darwin-x64": "0.0.8",
-    "@passcod/faith-win32-x64-msvc": "0.0.8",
-    "@passcod/faith-freebsd-x64": "0.0.8",
-    "@passcod/faith-linux-x64-gnu": "0.0.8",
-    "@passcod/faith-linux-x64-musl": "0.0.8"
+    "@passcod/faith-darwin-arm64": "0.1.0",
+    "@passcod/faith-android-arm64": "0.1.0",
+    "@passcod/faith-win32-arm64-msvc": "0.1.0",
+    "@passcod/faith-linux-arm64-gnu": "0.1.0",
+    "@passcod/faith-linux-arm64-musl": "0.1.0",
+    "@passcod/faith-android-arm-eabi": "0.1.0",
+    "@passcod/faith-linux-arm-gnueabihf": "0.1.0",
+    "@passcod/faith-darwin-x64": "0.1.0",
+    "@passcod/faith-win32-x64-msvc": "0.1.0",
+    "@passcod/faith-freebsd-x64": "0.1.0",
+    "@passcod/faith-linux-x64-gnu": "0.1.0",
+    "@passcod/faith-linux-x64-musl": "0.1.0"
   }
 }

package/wrapper.d.ts

@@ -29,7 +29,9 @@ export const ERROR_CODES: {
 	readonly AddressParse: "AddressParse";
 	readonly BodyStream: "BodyStream";
 	readonly Config: "Config";
+	readonly IntegrityMismatch: "IntegrityMismatch";
 	readonly InvalidHeader: "InvalidHeader";
+	readonly InvalidIntegrity: "InvalidIntegrity";
 	readonly InvalidMethod: "InvalidMethod";
 	readonly InvalidUrl: "InvalidUrl";
 	readonly JsonParse: "JsonParse";
@@ -146,6 +148,25 @@ export interface FetchOptions {
 	 * This option must be present when `body` is a `ReadableStream`.
 	 */
 	duplex?: "half";
+	/**
+	 * Contains the subresource integrity value of the request.
+	 *
+	 * The format of this option is `<hash-algo>-<hash-source>` where:
+	 *
+	 * - `<hash-algo>` is one of the following values: `sha256`, `sha384`, or `sha512`
+	 * - `<hash-source>` is the Base64-encoding of the result of hashing the resource with the
+	 *   specified hash algorithm.
+	 *
+	 * Multiple space-separated values are supported; if any matches, verification passes. Unknown
+	 * algorithms are silently ignored (but if all algorithms are unknown, an error is thrown).
+	 *
+	 * Fáith only checks the integrity when using `bytes()`, `json()`, `text()`, `arrayBuffer()`, and
+	 * `blob()`. Verification when reading through the `body` stream is not currently supported.
+	 *
+	 * Note that browsers will throw at the `fetch()` call when integrity fails, but Fáith will only
+	 * throw when the above methods are called, as until then the body contents are not available.
+	 */
+	integrity?: string;
 	/**
 	 * Any headers you want to add to your request, contained within a `Headers` object or an object
 	 * literal whose keys are the names of headers and whose values are the header values.
@@ -274,6 +295,17 @@ 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.
 	 *
@@ -335,16 +367,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.