wreq-js 2.2.1 → 2.3.0

package/dist/wreq-js.d.ts

@@ -1,6 +1,7 @@
-import { Readable } from 'node:stream';
-import { ReadableStream } from 'node:stream/web';
+import { Readable } from "node:stream";
+import { ReadableStream } from "node:stream/web";
 
+//#region src/generated-types.d.ts
 /**
  * Auto-generated from Rust build script
  * DO NOT EDIT MANUALLY
@@ -13,7 +14,8 @@ type BrowserProfile = 'chrome_100' | 'chrome_101' | 'chrome_104' | 'chrome_105'
  * Operating systems supported for emulation
  */
 type EmulationOS = 'windows' | 'macos' | 'linux' | 'android' | 'ios';
-
+//#endregion
+//#region src/types.d.ts
 /**
  * Controls how cookies are scoped for a request.
  * - "session": reuse an explicit Session or sessionId across calls.
@@ -25,7 +27,17 @@ type CookieMode = "session" | "ephemeral";
  * that only need to carry a session id.
  */
 interface SessionHandle {
-    readonly id: string;
+  readonly id: string;
+}
+interface SessionCookie {
+  name: string;
+  value: string;
+  domain?: string;
+  path?: string;
+  secure: boolean;
+  httpOnly: boolean;
+  sameSite?: "lax" | "strict" | "none";
+  expiresAtMs?: number;
 }
 /**
  * A tuple of [name, value] pairs used for initializing headers.
@@ -58,89 +70,90 @@ type AlpnProtocol = "HTTP1" | "HTTP2" | "HTTP3";
 type AlpsProtocol = "HTTP1" | "HTTP2" | "HTTP3";
 type TlsVersion = "1.0" | "1.1" | "1.2" | "1.3" | "TLS1.0" | "TLS1.1" | "TLS1.2" | "TLS1.3";
 type Http2PseudoHeaderId = "Method" | "Scheme" | "Authority" | "Path" | "Protocol";
+type TrustStoreMode = "combined" | "mozilla" | "defaultPaths";
 type Http2SettingId = "HeaderTableSize" | "EnablePush" | "MaxConcurrentStreams" | "InitialWindowSize" | "MaxFrameSize" | "MaxHeaderListSize" | "EnableConnectProtocol" | "NoRfc7540Priorities";
 interface Http2StreamDependency {
-    dependencyId: number;
-    weight: number;
-    exclusive?: boolean;
+  dependencyId: number;
+  weight: number;
+  exclusive?: boolean;
 }
 interface Http2Priority {
-    streamId: number;
-    dependency: Http2StreamDependency;
+  streamId: number;
+  dependency: Http2StreamDependency;
 }
 interface Http2ExperimentalSetting {
-    id: number;
-    value: number;
+  id: number;
+  value: number;
 }
 interface CustomTlsOptions {
-    alpnProtocols?: AlpnProtocol[];
-    alpsProtocols?: AlpsProtocol[];
-    alpsUseNewCodepoint?: boolean;
-    sessionTicket?: boolean;
-    minTlsVersion?: TlsVersion;
-    maxTlsVersion?: TlsVersion;
-    preSharedKey?: boolean;
-    enableEchGrease?: boolean;
-    permuteExtensions?: boolean;
-    greaseEnabled?: boolean;
-    enableOcspStapling?: boolean;
-    enableSignedCertTimestamps?: boolean;
-    recordSizeLimit?: number;
-    pskSkipSessionTicket?: boolean;
-    keySharesLimit?: number;
-    pskDheKe?: boolean;
-    renegotiation?: boolean;
-    delegatedCredentials?: string;
-    curvesList?: string;
-    cipherList?: string;
-    sigalgsList?: string;
-    certificateCompressionAlgorithms?: Array<"zlib" | "brotli" | "zstd">;
-    extensionPermutation?: number[];
-    aesHwOverride?: boolean;
-    preserveTls13CipherList?: boolean;
-    randomAesHwOverride?: boolean;
+  alpnProtocols?: AlpnProtocol[];
+  alpsProtocols?: AlpsProtocol[];
+  alpsUseNewCodepoint?: boolean;
+  sessionTicket?: boolean;
+  minTlsVersion?: TlsVersion;
+  maxTlsVersion?: TlsVersion;
+  preSharedKey?: boolean;
+  enableEchGrease?: boolean;
+  permuteExtensions?: boolean;
+  greaseEnabled?: boolean;
+  enableOcspStapling?: boolean;
+  enableSignedCertTimestamps?: boolean;
+  recordSizeLimit?: number;
+  pskSkipSessionTicket?: boolean;
+  keySharesLimit?: number;
+  pskDheKe?: boolean;
+  renegotiation?: boolean;
+  delegatedCredentials?: string;
+  curvesList?: string;
+  cipherList?: string;
+  sigalgsList?: string;
+  certificateCompressionAlgorithms?: Array<"zlib" | "brotli" | "zstd">;
+  extensionPermutation?: number[];
+  aesHwOverride?: boolean;
+  preserveTls13CipherList?: boolean;
+  randomAesHwOverride?: boolean;
 }
 interface CustomHttp1Options {
-    http09Responses?: boolean;
-    writev?: boolean;
-    maxHeaders?: number;
-    readBufExactSize?: number;
-    maxBufSize?: number;
-    ignoreInvalidHeadersInResponses?: boolean;
-    allowSpacesAfterHeaderNameInResponses?: boolean;
-    allowObsoleteMultilineHeadersInResponses?: boolean;
+  http09Responses?: boolean;
+  writev?: boolean;
+  maxHeaders?: number;
+  readBufExactSize?: number;
+  maxBufSize?: number;
+  ignoreInvalidHeadersInResponses?: boolean;
+  allowSpacesAfterHeaderNameInResponses?: boolean;
+  allowObsoleteMultilineHeadersInResponses?: boolean;
 }
 interface CustomHttp2Options {
-    adaptiveWindow?: boolean;
-    initialStreamId?: number;
-    initialConnectionWindowSize?: number;
-    initialWindowSize?: number;
-    initialMaxSendStreams?: number;
-    maxFrameSize?: number;
-    keepAliveInterval?: number;
-    keepAliveTimeout?: number;
-    keepAliveWhileIdle?: boolean;
-    maxConcurrentResetStreams?: number;
-    maxSendBufferSize?: number;
-    maxConcurrentStreams?: number;
-    maxHeaderListSize?: number;
-    maxPendingAcceptResetStreams?: number;
-    enablePush?: boolean;
-    headerTableSize?: number;
-    enableConnectProtocol?: boolean;
-    noRfc7540Priorities?: boolean;
-    settingsOrder?: Http2SettingId[];
-    headersPseudoOrder?: Http2PseudoHeaderId[];
-    headersStreamDependency?: Http2StreamDependency;
-    priorities?: Http2Priority[];
-    experimentalSettings?: Http2ExperimentalSetting[];
+  adaptiveWindow?: boolean;
+  initialStreamId?: number;
+  initialConnectionWindowSize?: number;
+  initialWindowSize?: number;
+  initialMaxSendStreams?: number;
+  maxFrameSize?: number;
+  keepAliveInterval?: number;
+  keepAliveTimeout?: number;
+  keepAliveWhileIdle?: boolean;
+  maxConcurrentResetStreams?: number;
+  maxSendBufferSize?: number;
+  maxConcurrentStreams?: number;
+  maxHeaderListSize?: number;
+  maxPendingAcceptResetStreams?: number;
+  enablePush?: boolean;
+  headerTableSize?: number;
+  enableConnectProtocol?: boolean;
+  noRfc7540Priorities?: boolean;
+  settingsOrder?: Http2SettingId[];
+  headersPseudoOrder?: Http2PseudoHeaderId[];
+  headersStreamDependency?: Http2StreamDependency;
+  priorities?: Http2Priority[];
+  experimentalSettings?: Http2ExperimentalSetting[];
 }
 interface CustomEmulationOptions {
-    tlsOptions?: CustomTlsOptions;
-    http1Options?: CustomHttp1Options;
-    http2Options?: CustomHttp2Options;
-    headers?: HeadersInit;
-    origHeaders?: string[];
+  tlsOptions?: CustomTlsOptions;
+  http1Options?: CustomHttp1Options;
+  http2Options?: CustomHttp2Options;
+  headers?: HeadersInit;
+  origHeaders?: string[];
 }
 /**
  * Represents the various types of data that can be used as a request body.
@@ -168,43 +181,43 @@ type BodyInit = string | ArrayBuffer | ArrayBufferView | URLSearchParams | Buffe
 type WebSocketBinaryType = "nodebuffer" | "arraybuffer" | "blob";
 type WebSocketEventType = "open" | "message" | "close" | "error";
 interface WebSocketOpenEvent {
-    type: "open";
-    isTrusted: false;
-    timeStamp: number;
-    target: WebSocket;
-    currentTarget: WebSocket;
+  type: "open";
+  isTrusted: false;
+  timeStamp: number;
+  target: WebSocket;
+  currentTarget: WebSocket;
 }
 interface WebSocketMessageEvent {
-    type: "message";
-    isTrusted: false;
-    timeStamp: number;
-    data: string | Buffer | ArrayBuffer | Blob;
-    target: WebSocket;
-    currentTarget: WebSocket;
+  type: "message";
+  isTrusted: false;
+  timeStamp: number;
+  data: string | Buffer | ArrayBuffer | Blob;
+  target: WebSocket;
+  currentTarget: WebSocket;
 }
 interface WebSocketErrorEvent {
-    type: "error";
-    isTrusted: false;
-    timeStamp: number;
-    message?: string;
-    target: WebSocket;
-    currentTarget: WebSocket;
+  type: "error";
+  isTrusted: false;
+  timeStamp: number;
+  message?: string;
+  target: WebSocket;
+  currentTarget: WebSocket;
 }
 interface WebSocketCloseEvent {
-    type: "close";
-    isTrusted: false;
-    timeStamp: number;
-    /**
-     * WebSocket close status code (RFC 6455).
-     */
-    code: number;
-    /**
-     * UTF-8 close reason sent by the peer.
-     */
-    reason: string;
-    wasClean: boolean;
-    target: WebSocket;
-    currentTarget: WebSocket;
+  type: "close";
+  isTrusted: false;
+  timeStamp: number;
+  /**
+   * WebSocket close status code (RFC 6455).
+   */
+  code: number;
+  /**
+   * UTF-8 close reason sent by the peer.
+   */
+  reason: string;
+  wasClean: boolean;
+  target: WebSocket;
+  currentTarget: WebSocket;
 }
 /**
  * Options for configuring a fetch style request with wreq-specific extensions
@@ -222,205 +235,264 @@ interface WebSocketCloseEvent {
  * };
  * ```
  */
+type RequestEventType = "request_start" | "request_sent" | "response_headers" | "body_progress" | "body_complete" | "done" | "error";
+interface RequestEvent {
+  type: RequestEventType;
+  timestamp: number;
+  status?: number;
+  url?: string;
+  contentLength?: number | null;
+  downloadedBytes?: number;
+  message?: string;
+}
+interface RequestDiagnostics {
+  totalDurationMs?: number;
+  headersDurationMs?: number;
+  status?: number;
+  localAddr?: string;
+  remoteAddr?: string;
+  tlsPeerCertificatePresent?: boolean;
+  tlsPeerCertificateChainLength?: number;
+}
 interface RequestInit {
-    /**
-     * A string to set request's method.
-     * @default 'GET'
-     */
-    method?: string;
-    /**
-     * A Headers object, an object literal, or an array of two-item arrays to set request's headers.
-     */
-    headers?: HeadersInit;
-    /**
-     * A BodyInit object or null to set request's body.
-     */
-    body?: BodyInit | null;
-    /**
-     * An AbortSignal to set request's signal.
-     */
-    signal?: AbortSignal | null;
-    /**
-     * A string indicating whether request follows redirects, results in an error upon
-     * encountering a redirect, or returns the redirect (in an opaque fashion).
-     * @default 'follow'
-     */
-    redirect?: "follow" | "manual" | "error";
-    /**
-     * Transport instance to use for this request. When provided, transport-level
-     * options such as `browser`, `os`, `proxy`, and `insecure` must not be set.
-     */
-    transport?: Transport;
-    /**
-     * Browser profile to impersonate for this request.
-     * Applies browser profile behavior handled by the native layer.
-     * Ignored when `transport` is provided.
-     * @default 'chrome_142'
-     */
-    browser?: BrowserProfile;
-    /**
-     * Operating system to emulate for this request.
-     * Influences platform-specific behavior handled by the native layer.
-     * Ignored when `transport` is provided.
-     * @default 'macos'
-     */
-    os?: EmulationOS;
-    /**
-     * Custom emulation overrides. When `browser` or `os` is present, these fields
-     * layer on top of the resolved preset profile. When both are omitted, this
-     * switches the request into standalone custom emulation mode.
-     */
-    emulation?: CustomEmulationOptions;
-    /**
-     * Proxy URL to route the request through (e.g., 'http://proxy.example.com:8080').
-     * Proxy support depends on the native layer and proxy scheme.
-     * Ignored when `transport` is provided.
-     */
-    proxy?: string;
-    /**
-     * Request timeout in milliseconds. If the request takes longer than this value,
-     * it will be aborted.
-     * @default 30000
-     */
-    timeout?: number;
-    /**
-     * Controls how cookies are managed for this call.
-     * - "ephemeral": default when no session/sessionId is provided. Creates an isolated session per request.
-     * - "session": requires an explicit session or sessionId and reuses its cookie jar.
-     */
-    cookieMode?: CookieMode;
-    /**
-     * Session instance to bind this request to. When provided, {@link cookieMode}
-     * automatically behaves like `"session"`.
-     */
-    session?: Session;
-    /**
-     * Identifier of an existing session created elsewhere (e.g., via {@link createSession}).
-     */
-    sessionId?: string;
-    /**
-     * Disable default headers from browser emulation. When enabled, only explicitly
-     * provided headers will be sent with the request, preventing emulation headers
-     * from being automatically added or appended.
-     * @default false
-     */
-    disableDefaultHeaders?: boolean;
-    /**
-     * Disable HTTPS certificate verification. When enabled, self-signed and invalid
-     * certificates will be accepted.
-     * Ignored when `transport` is provided.
-     *
-     * # Warning
-     *
-     * You should think very carefully before using this method. If invalid
-     * certificates are trusted, *any* certificate for *any* site will be
-     * trusted for use. This includes expired certificates. This introduces
-     * significant vulnerabilities, and should only be used as a last resort.
-     *
-     * @default false
-     */
-    insecure?: boolean;
-    /**
-     * Whether to automatically decompress response bodies. When set to `false`,
-     * the raw compressed response body is returned as-is and the `Content-Encoding`
-     * header is preserved. Useful for proxy scenarios where the downstream client
-     * handles decompression.
-     * @default true
-     */
-    compress?: boolean;
+  /**
+   * A string to set request's method.
+   * @default 'GET'
+   */
+  method?: string;
+  /**
+   * A Headers object, an object literal, or an array of two-item arrays to set request's headers.
+   */
+  headers?: HeadersInit;
+  /**
+   * A BodyInit object or null to set request's body.
+   */
+  body?: BodyInit | null;
+  /**
+   * An AbortSignal to set request's signal.
+   */
+  signal?: AbortSignal | null;
+  /**
+   * A string indicating whether request follows redirects, results in an error upon
+   * encountering a redirect, or returns the redirect (in an opaque fashion).
+   * @default 'follow'
+   */
+  redirect?: "follow" | "manual" | "error";
+  /**
+   * Transport instance to use for this request. When provided, transport-level
+   * options such as `browser`, `os`, `proxy`, and `insecure` must not be set.
+   */
+  transport?: Transport;
+  /**
+   * Browser profile to impersonate for this request.
+   * Applies browser profile behavior handled by the native layer.
+   * Ignored when `transport` is provided.
+   * @default 'chrome_142'
+   */
+  browser?: BrowserProfile;
+  /**
+   * Operating system to emulate for this request.
+   * Influences platform-specific behavior handled by the native layer.
+   * Ignored when `transport` is provided.
+   * @default 'macos'
+   */
+  os?: EmulationOS;
+  /**
+   * Custom emulation overrides. When `browser` or `os` is present, these fields
+   * layer on top of the resolved preset profile. When both are omitted, this
+   * switches the request into standalone custom emulation mode.
+   */
+  emulation?: CustomEmulationOptions;
+  /**
+   * Proxy URL to route the request through (e.g., 'http://proxy.example.com:8080').
+   * Proxy support depends on the native layer and proxy scheme.
+   * Ignored when `transport` is provided.
+   */
+  proxy?: string;
+  /**
+   * Request timeout in milliseconds. If the request takes longer than this value,
+   * it will be aborted.
+   * @default 30000
+   */
+  timeout?: number;
+  /**
+   * Controls how cookies are managed for this call.
+   * - "ephemeral": default when no session/sessionId is provided. Creates an isolated session per request.
+   * - "session": requires an explicit session or sessionId and reuses its cookie jar.
+   */
+  cookieMode?: CookieMode;
+  /**
+   * Session instance to bind this request to. When provided, {@link cookieMode}
+   * automatically behaves like `"session"`.
+   */
+  session?: Session;
+  /**
+   * Identifier of an existing session created elsewhere (e.g., via {@link createSession}).
+   */
+  sessionId?: string;
+  /**
+   * Disable default headers from browser emulation. When enabled, only explicitly
+   * provided headers will be sent with the request, preventing emulation headers
+   * from being automatically added or appended.
+   * @default false
+   */
+  disableDefaultHeaders?: boolean;
+  /**
+   * Disable HTTPS certificate verification. When enabled, self-signed and invalid
+   * certificates will be accepted.
+   * Ignored when `transport` is provided.
+   *
+   * # Warning
+   *
+   * You should think very carefully before using this method. If invalid
+   * certificates are trusted, *any* certificate for *any* site will be
+   * trusted for use. This includes expired certificates. This introduces
+   * significant vulnerabilities, and should only be used as a last resort.
+   *
+   * @default false
+   */
+  insecure?: boolean;
+  /**
+   * Controls which certificate roots are used for TLS verification.
+   *
+   * - `"combined"` merges OpenSSL/BoringSSL default verify paths with bundled Mozilla roots.
+   * - `"mozilla"` uses only the bundled Mozilla roots.
+   * - `"defaultPaths"` uses only OpenSSL/BoringSSL default verify paths such as
+   *   `SSL_CERT_FILE` / `SSL_CERT_DIR` when configured.
+   *
+   * Note: `"defaultPaths"` is not a native OS trust-store verifier.
+   * Ignored when `transport` is provided.
+   * @default "combined"
+   */
+  trustStore?: TrustStoreMode;
+  /**
+   * Whether to automatically decompress response bodies. When set to `false`,
+   * the raw compressed response body is returned as-is and the `Content-Encoding`
+   * header is preserved. Useful for proxy scenarios where the downstream client
+   * handles decompression.
+   * @default true
+   */
+  compress?: boolean;
+  /**
+   * Optional callback for structured request lifecycle events emitted by the
+   * native bridge.
+   */
+  onRequestEvent?: (event: RequestEvent) => void;
+  /**
+   * Capture a final diagnostics payload where supported by the native layer.
+   */
+  captureDiagnostics?: boolean;
 }
 /**
  * Configuration for {@link createSession}.
  */
 interface CreateSessionOptions {
-    /**
-     * Provide a custom identifier instead of an auto-generated random ID.
-     */
-    sessionId?: string;
-    /**
-     * Default headers applied to every request made through this session.
-     */
-    defaultHeaders?: HeadersInit;
-    /**
-     * Browser profile to bind to this session. Defaults to 'chrome_142'.
-     */
-    browser?: BrowserProfile;
-    /**
-     * Operating system to bind to this session. Defaults to 'macos'.
-     */
-    os?: EmulationOS;
-    /**
-     * Custom emulation overrides or a standalone custom emulation for the session transport.
-     */
-    emulation?: CustomEmulationOptions;
-    /**
-     * Optional proxy for every request made through the session.
-     */
-    proxy?: string;
-    /**
-     * Default timeout applied when {@link Session.fetch} is called without
-     * overriding `timeout`.
-     */
-    timeout?: number;
-    /**
-     * Disable HTTPS certificate verification. When enabled, self-signed and invalid
-     * certificates will be accepted for all requests made through this session.
-     *
-     * # Warning
-     *
-     * You should think very carefully before using this method. If invalid
-     * certificates are trusted, *any* certificate for *any* site will be
-     * trusted for use. This includes expired certificates. This introduces
-     * significant vulnerabilities, and should only be used as a last resort.
-     *
-     * @default false
-     */
-    insecure?: boolean;
+  /**
+   * Provide a custom identifier instead of an auto-generated random ID.
+   */
+  sessionId?: string;
+  /**
+   * Default headers applied to every request made through this session.
+   */
+  defaultHeaders?: HeadersInit;
+  /**
+   * Browser profile to bind to this session. Defaults to 'chrome_142'.
+   */
+  browser?: BrowserProfile;
+  /**
+   * Operating system to bind to this session. Defaults to 'macos'.
+   */
+  os?: EmulationOS;
+  /**
+   * Custom emulation overrides or a standalone custom emulation for the session transport.
+   */
+  emulation?: CustomEmulationOptions;
+  /**
+   * Optional proxy for every request made through the session.
+   */
+  proxy?: string;
+  /**
+   * Default timeout applied when {@link Session.fetch} is called without
+   * overriding `timeout`.
+   */
+  timeout?: number;
+  /**
+   * Disable HTTPS certificate verification. When enabled, self-signed and invalid
+   * certificates will be accepted for all requests made through this session.
+   *
+   * # Warning
+   *
+   * You should think very carefully before using this method. If invalid
+   * certificates are trusted, *any* certificate for *any* site will be
+   * trusted for use. This includes expired certificates. This introduces
+   * significant vulnerabilities, and should only be used as a last resort.
+   *
+   * @default false
+   */
+  insecure?: boolean;
+  /**
+   * Controls which certificate roots are used for TLS verification for this session.
+   * @default "combined"
+   */
+  trustStore?: TrustStoreMode;
+  /**
+   * Enable extra connection/TLS diagnostics for requests made through this session.
+   */
+  captureDiagnostics?: boolean;
 }
 /**
  * Configuration for {@link createTransport}.
  */
 interface CreateTransportOptions {
-    /**
-     * Proxy URL to route requests through (e.g., 'http://proxy.example.com:8080').
-     */
-    proxy?: string;
-    /**
-     * Browser profile to impersonate for this transport.
-     */
-    browser?: BrowserProfile;
-    /**
-     * Operating system to emulate for this transport.
-     */
-    os?: EmulationOS;
-    /**
-     * Custom emulation overrides or a standalone custom emulation for this transport.
-     */
-    emulation?: CustomEmulationOptions;
-    /**
-     * Disable HTTPS certificate verification for this transport.
-     */
-    insecure?: boolean;
-    /**
-     * Idle timeout for pooled connections (ms).
-     */
-    poolIdleTimeout?: number;
-    /**
-     * Maximum number of idle connections per host.
-     */
-    poolMaxIdlePerHost?: number;
-    /**
-     * Maximum total connections in the pool.
-     */
-    poolMaxSize?: number;
-    /**
-     * TCP connect timeout (ms).
-     */
-    connectTimeout?: number;
-    /**
-     * Read timeout (ms).
-     */
-    readTimeout?: number;
+  /**
+   * Proxy URL to route requests through (e.g., 'http://proxy.example.com:8080').
+   */
+  proxy?: string;
+  /**
+   * Browser profile to impersonate for this transport.
+   */
+  browser?: BrowserProfile;
+  /**
+   * Operating system to emulate for this transport.
+   */
+  os?: EmulationOS;
+  /**
+   * Custom emulation overrides or a standalone custom emulation for this transport.
+   */
+  emulation?: CustomEmulationOptions;
+  /**
+   * Disable HTTPS certificate verification for this transport.
+   */
+  insecure?: boolean;
+  /**
+   * Controls which certificate roots are used for TLS verification for this transport.
+   * @default "combined"
+   */
+  trustStore?: TrustStoreMode;
+  /**
+   * Idle timeout for pooled connections (ms).
+   */
+  poolIdleTimeout?: number;
+  /**
+   * Maximum number of idle connections per host.
+   */
+  poolMaxIdlePerHost?: number;
+  /**
+   * Maximum total connections in the pool.
+   */
+  poolMaxSize?: number;
+  /**
+   * TCP connect timeout (ms).
+   */
+  connectTimeout?: number;
+  /**
+   * Read timeout (ms).
+   */
+  readTimeout?: number;
+  /**
+   * Enable extra connection/TLS diagnostics for requests made through this transport.
+   */
+  captureDiagnostics?: boolean;
 }
 /**
  * Legacy request options interface. This interface is deprecated and will be removed in a future version.
@@ -444,106 +516,120 @@ interface CreateTransportOptions {
  * ```
  */
 interface RequestOptions {
-    /**
-     * The URL to request.
-     */
-    url: string;
-    /**
-     * Browser profile to impersonate.
-     * Applies browser profile behavior handled by the native layer.
-     * @default 'chrome_142'
-     */
-    browser?: BrowserProfile;
-    /**
-     * Operating system to emulate.
-     * @default 'macos'
-     */
-    os?: EmulationOS;
-    /**
-     * Custom emulation overrides. When `browser` or `os` is present, these fields
-     * layer on top of the resolved preset profile. When both are omitted, this
-     * switches the request into standalone custom emulation mode.
-     */
-    emulation?: CustomEmulationOptions;
-    /**
-     * HTTP method to use for the request.
-     * @default 'GET'
-     */
-    method?: string;
-    /**
-     * Additional headers to send with the request.
-     * Browser-specific headers will be automatically added based on the selected browser profile.
-     */
-    headers?: Record<string, string> | HeaderTuple[];
-    /**
-     * Request body data (for POST, PUT, PATCH requests).
-     */
-    body?: BodyInit | null;
-    /**
-     * Transport instance to use for this request. When provided, transport-level
-     * options such as `browser`, `os`, `proxy`, and `insecure` must not be set.
-     */
-    transport?: Transport;
-    /**
-     * Proxy URL to route the request through (e.g., 'http://proxy.example.com:8080').
-     * Proxy support depends on the native layer and proxy scheme.
-     */
-    proxy?: string;
-    /**
-     * Redirect policy applied to this request. Matches the `redirect` option accepted by {@link fetch}.
-     * @default "follow"
-     */
-    redirect?: "follow" | "manual" | "error";
-    /**
-     * Request timeout in milliseconds. If the request takes longer than this value,
-     * it will be aborted.
-     * @default 30000
-     */
-    timeout?: number;
-    /**
-     * Signal used to abort the request.
-     */
-    signal?: AbortSignal | null;
-    /**
-     * Session instance to bind this request to.
-     */
-    session?: Session;
-    /**
-     * Controls cookie scoping behavior for this request.
-     */
-    cookieMode?: CookieMode;
-    /**
-     * Identifier for the session that should handle this request.
-     * @internal
-     */
-    sessionId?: string;
-    /**
-     * Internal flag indicating whether the session should be discarded once the
-     * request finishes.
-     * @internal
-     */
-    ephemeral?: boolean;
-    /**
-     * Disable default headers from browser emulation. When enabled, only explicitly
-     * provided headers will be sent with the request, preventing emulation headers
-     * from being automatically added or appended.
-     * @default false
-     */
-    disableDefaultHeaders?: boolean;
-    /**
-     * Disable HTTPS certificate verification. When enabled, self-signed and invalid
-     * certificates will be accepted.
-     *
-     * # Warning
-     *
-     * You should think very carefully before using this method. If invalid
-     * certificates are trusted, *any* certificate for *any* site will be
-     * trusted for use. This includes expired certificates. This introduces
-     * significant vulnerabilities, and should only be used as a last resort.
-     *
-     * @default false
-     */
-    insecure?: boolean;
+  /**
+   * The URL to request.
+   */
+  url: string;
+  /**
+   * Browser profile to impersonate.
+   * Applies browser profile behavior handled by the native layer.
+   * @default 'chrome_142'
+   */
+  browser?: BrowserProfile;
+  /**
+   * Operating system to emulate.
+   * @default 'macos'
+   */
+  os?: EmulationOS;
+  /**
+   * Custom emulation overrides. When `browser` or `os` is present, these fields
+   * layer on top of the resolved preset profile. When both are omitted, this
+   * switches the request into standalone custom emulation mode.
+   */
+  emulation?: CustomEmulationOptions;
+  /**
+   * HTTP method to use for the request.
+   * @default 'GET'
+   */
+  method?: string;
+  /**
+   * Additional headers to send with the request.
+   * Browser-specific headers will be automatically added based on the selected browser profile.
+   */
+  headers?: Record<string, string> | HeaderTuple[];
+  /**
+   * Request body data (for POST, PUT, PATCH requests).
+   */
+  body?: BodyInit | null;
+  /**
+   * Transport instance to use for this request. When provided, transport-level
+   * options such as `browser`, `os`, `proxy`, and `insecure` must not be set.
+   */
+  transport?: Transport;
+  /**
+   * Proxy URL to route the request through (e.g., 'http://proxy.example.com:8080').
+   * Proxy support depends on the native layer and proxy scheme.
+   */
+  proxy?: string;
+  /**
+   * Redirect policy applied to this request. Matches the `redirect` option accepted by {@link fetch}.
+   * @default "follow"
+   */
+  redirect?: "follow" | "manual" | "error";
+  /**
+   * Request timeout in milliseconds. If the request takes longer than this value,
+   * it will be aborted.
+   * @default 30000
+   */
+  timeout?: number;
+  /**
+   * Signal used to abort the request.
+   */
+  signal?: AbortSignal | null;
+  /**
+   * Session instance to bind this request to.
+   */
+  session?: Session;
+  /**
+   * Controls cookie scoping behavior for this request.
+   */
+  cookieMode?: CookieMode;
+  /**
+   * Identifier for the session that should handle this request.
+   * @internal
+   */
+  sessionId?: string;
+  /**
+   * Internal flag indicating whether the session should be discarded once the
+   * request finishes.
+   * @internal
+   */
+  ephemeral?: boolean;
+  /**
+   * Disable default headers from browser emulation. When enabled, only explicitly
+   * provided headers will be sent with the request, preventing emulation headers
+   * from being automatically added or appended.
+   * @default false
+   */
+  disableDefaultHeaders?: boolean;
+  /**
+   * Disable HTTPS certificate verification. When enabled, self-signed and invalid
+   * certificates will be accepted.
+   *
+   * # Warning
+   *
+   * You should think very carefully before using this method. If invalid
+   * certificates are trusted, *any* certificate for *any* site will be
+   * trusted for use. This includes expired certificates. This introduces
+   * significant vulnerabilities, and should only be used as a last resort.
+   *
+   * @default false
+   */
+  insecure?: boolean;
+  /**
+   * Controls which certificate roots are used for TLS verification.
+   * @default "combined"
+   */
+  trustStore?: TrustStoreMode;
+  /**
+   * Optional callback for structured request lifecycle events emitted by the
+   * native bridge.
+   */
+  onRequestEvent?: (event: RequestEvent) => void;
+  /**
+   * Capture a final diagnostics payload where supported by the native layer.
+   */
+  captureDiagnostics?: boolean;
 }
 /**
  * Internal response payload returned from the native Rust binding.
@@ -553,38 +639,42 @@ interface RequestOptions {
  * @internal
  */
 interface NativeResponse {
-    /**
-     * HTTP status code (e.g., 200, 404, 500).
-     */
-    status: number;
-    /**
-     * Response headers as [name, value] tuples.
-     * Header names are normalized to lowercase.
-     */
-    headers: HeaderTuple[];
-    /**
-     * Handle for streaming response body chunks from the native layer.
-     * When `null`, the response does not have a body (e.g., HEAD/204/304).
-     */
-    bodyHandle: number | null;
-    /**
-     * Inline body buffer returned for small payloads. When present, `bodyHandle`
-     * will be `null` to avoid a second native round-trip to read the body.
-     */
-    bodyBytes: Buffer | null;
-    /**
-     * Optional Content-Length hint reported by the server after decompression.
-     */
-    contentLength: number | null;
-    /**
-     * Cookies set by the server as [name, value] tuples.
-     */
-    cookies: HeaderTuple[];
-    /**
-     * Final URL after following any redirects.
-     * If no redirects occurred, this will match the original request URL.
-     */
-    url: string;
+  /**
+   * HTTP status code (e.g., 200, 404, 500).
+   */
+  status: number;
+  /**
+   * Response headers as [name, value] tuples.
+   * Header names are normalized to lowercase.
+   */
+  headers: HeaderTuple[];
+  /**
+   * Handle for streaming response body chunks from the native layer.
+   * When `null`, the response does not have a body (e.g., HEAD/204/304).
+   */
+  bodyHandle: number | null;
+  /**
+   * Inline body buffer returned for small payloads. When present, `bodyHandle`
+   * will be `null` to avoid a second native round-trip to read the body.
+   */
+  bodyBytes: Buffer | null;
+  /**
+   * Optional Content-Length hint reported by the server after decompression.
+   */
+  contentLength: number | null;
+  /**
+   * Cookies set by the server as [name, value] tuples.
+   */
+  cookies: HeaderTuple[];
+  /**
+   * Final URL after following any redirects.
+   * If no redirects occurred, this will match the original request URL.
+   */
+  url: string;
+  /**
+   * Optional diagnostics payload collected by the native layer.
+   */
+  diagnostics?: RequestDiagnostics | null;
 }
 /**
  * Configuration options for creating a WebSocket connection.
@@ -603,83 +693,93 @@ interface NativeResponse {
  * ```
  */
 interface WebSocketOptions {
-    /**
-     * Browser profile to impersonate for the WebSocket upgrade request.
-     * Automatically applies browser-specific headers and TLS fingerprints.
-     * @default 'chrome_142'
-     */
-    browser?: BrowserProfile;
-    /**
-     * Operating system to emulate for the WebSocket handshake.
-     * @default 'macos'
-     */
-    os?: EmulationOS;
-    /**
-     * Custom emulation overrides. When `browser` or `os` is present, these fields
-     * layer on top of the resolved preset profile. When both are omitted, this
-     * switches the handshake into standalone custom emulation mode.
-     */
-    emulation?: CustomEmulationOptions;
-    /**
-     * Additional headers to send with the WebSocket upgrade request.
-     * Common headers include Authorization, Origin, or custom application headers.
-     */
-    headers?: HeadersInit;
-    /**
-     * Proxy URL to route the connection through (e.g., 'http://proxy.example.com:8080').
-     * Proxy support depends on the native layer and proxy scheme.
-     */
-    proxy?: string;
-    /**
-     * Optional subprotocols for compatibility with the WHATWG WebSocket constructor.
-     * Values are validated for non-empty, unique entries and sent in
-     * the `Sec-WebSocket-Protocol` handshake header.
-     */
-    protocols?: string | string[];
-    /**
-     * Controls the binary payload type exposed via `MessageEvent.data`.
-     * - "nodebuffer": delivers Node.js Buffer instances (default)
-     * - "arraybuffer": delivers ArrayBuffer instances
-     * - "blob": delivers Blob instances
-     */
-    binaryType?: WebSocketBinaryType;
+  /**
+   * Browser profile to impersonate for the WebSocket upgrade request.
+   * Automatically applies browser-specific headers and TLS fingerprints.
+   * @default 'chrome_142'
+   */
+  browser?: BrowserProfile;
+  /**
+   * Operating system to emulate for the WebSocket handshake.
+   * @default 'macos'
+   */
+  os?: EmulationOS;
+  /**
+   * Custom emulation overrides. When `browser` or `os` is present, these fields
+   * layer on top of the resolved preset profile. When both are omitted, this
+   * switches the handshake into standalone custom emulation mode.
+   */
+  emulation?: CustomEmulationOptions;
+  /**
+   * Additional headers to send with the WebSocket upgrade request.
+   * Common headers include Authorization, Origin, or custom application headers.
+   */
+  headers?: HeadersInit;
+  /**
+   * Proxy URL to route the connection through (e.g., 'http://proxy.example.com:8080').
+   * Proxy support depends on the native layer and proxy scheme.
+   */
+  proxy?: string;
+  /**
+   * Optional subprotocols for compatibility with the WHATWG WebSocket constructor.
+   * Values are validated for non-empty, unique entries and sent in
+   * the `Sec-WebSocket-Protocol` handshake header.
+   */
+  protocols?: string | string[];
+  /**
+   * Maximum size in bytes for a single incoming WebSocket frame.
+   * Increase this when the peer sends large unfragmented frames.
+   */
+  maxFrameSize?: number;
+  /**
+   * Maximum size in bytes for a complete incoming WebSocket message.
+   * Increase this when the peer sends very large fragmented messages.
+   */
+  maxMessageSize?: number;
+  /**
+   * Controls the binary payload type exposed via `MessageEvent.data`.
+   * - "nodebuffer": delivers Node.js Buffer instances (default)
+   * - "arraybuffer": delivers ArrayBuffer instances
+   * - "blob": delivers Blob instances
+   */
+  binaryType?: WebSocketBinaryType;
 }
 interface LegacyWebSocketOptions extends WebSocketOptions {
-    /**
-     * @deprecated Use `websocket(url, options)` or `new WebSocket(...)`.
-     */
-    url: string;
-    /**
-     * @deprecated Use `onmessage` or `addEventListener("message", ...)`.
-     */
-    onMessage?: (data: string | Buffer) => void;
-    /**
-     * @deprecated Use `onclose` or `addEventListener("close", ...)`.
-     */
-    onClose?: (event: WebSocketCloseEvent) => void;
-    /**
-     * @deprecated Use `onerror` or `addEventListener("error", ...)`.
-     */
-    onError?: (error: string) => void;
+  /**
+   * @deprecated Use `websocket(url, options)` or `new WebSocket(...)`.
+   */
+  url: string;
+  /**
+   * @deprecated Use `onmessage` or `addEventListener("message", ...)`.
+   */
+  onMessage?: (data: string | Buffer) => void;
+  /**
+   * @deprecated Use `onclose` or `addEventListener("close", ...)`.
+   */
+  onClose?: (event: WebSocketCloseEvent) => void;
+  /**
+   * @deprecated Use `onerror` or `addEventListener("error", ...)`.
+   */
+  onError?: (error: string) => void;
 }
 type SessionWebSocketOptions = Omit<WebSocketOptions, "browser" | "os" | "proxy" | "emulation">;
 interface LegacySessionWebSocketOptions extends SessionWebSocketOptions {
-    /**
-     * @deprecated Use `session.websocket(url, options)`.
-     */
-    url: string;
-    /**
-     * @deprecated Use `onmessage` or `addEventListener("message", ...)`.
-     */
-    onMessage?: (data: string | Buffer) => void;
-    /**
-     * @deprecated Use `onclose` or `addEventListener("close", ...)`.
-     */
-    onClose?: (event: WebSocketCloseEvent) => void;
-    /**
-     * @deprecated Use `onerror` or `addEventListener("error", ...)`.
-     */
-    onError?: (error: string) => void;
+  /**
+   * @deprecated Use `session.websocket(url, options)`.
+   */
+  url: string;
+  /**
+   * @deprecated Use `onmessage` or `addEventListener("message", ...)`.
+   */
+  onMessage?: (data: string | Buffer) => void;
+  /**
+   * @deprecated Use `onclose` or `addEventListener("close", ...)`.
+   */
+  onClose?: (event: WebSocketCloseEvent) => void;
+  /**
+   * @deprecated Use `onerror` or `addEventListener("error", ...)`.
+   */
+  onError?: (error: string) => void;
 }
 /**
  * Internal WebSocket connection object returned from the native Rust binding.
@@ -689,22 +789,22 @@ interface LegacySessionWebSocketOptions extends SessionWebSocketOptions {
  * @internal
  */
 interface NativeWebSocketConnection {
-    /**
-     * Unique identifier for this WebSocket connection.
-     * Used internally to track and manage the connection.
-     * @internal
-     */
-    _id: number;
-    /**
-     * Selected subprotocol returned by the server, when present.
-     * @internal
-     */
-    protocol?: string;
-    /**
-     * Negotiated extension string returned by the server, when present.
-     * @internal
-     */
-    extensions?: string;
+  /**
+   * Unique identifier for this WebSocket connection.
+   * Used internally to track and manage the connection.
+   * @internal
+   */
+  _id: number;
+  /**
+   * Selected subprotocol returned by the server, when present.
+   * @internal
+   */
+  protocol?: string;
+  /**
+   * Negotiated extension string returned by the server, when present.
+   * @internal
+   */
+  extensions?: string;
 }
 /**
  * Error thrown when a request fails. This can occur due to network errors,
@@ -722,138 +822,143 @@ interface NativeWebSocketConnection {
  * ```
  */
 declare class RequestError extends TypeError {
-    constructor(message: string);
+  constructor(message: string);
 }
-
+//#endregion
+//#region src/wreq-js.d.ts
 interface NativeWebSocketCloseEvent {
-    code: number;
-    reason: string;
+  code: number;
+  reason: string;
 }
 type SessionDefaults = {
-    transportMode: ResolvedEmulationMode;
-    proxy?: string;
-    timeout?: number;
-    insecure?: boolean;
-    defaultHeaders?: HeaderTuple[];
-    transportId?: string;
-    ownsTransport?: boolean;
+  transportMode: ResolvedEmulationMode;
+  proxy?: string;
+  timeout?: number;
+  insecure?: boolean;
+  trustStore?: TrustStoreMode;
+  defaultHeaders?: HeaderTuple[];
+  captureDiagnostics?: boolean;
+  transportId?: string;
+  ownsTransport?: boolean;
 };
 type PresetEmulationMode = {
-    kind: "preset";
-    browser: BrowserProfile;
-    os: EmulationOS;
-    emulationJson?: string;
+  kind: "preset";
+  browser: BrowserProfile;
+  os: EmulationOS;
+  emulationJson?: string;
 };
 type CustomEmulationMode = {
-    kind: "custom";
-    emulationJson: string;
+  kind: "custom";
+  emulationJson: string;
 };
 type ResolvedEmulationMode = PresetEmulationMode | CustomEmulationMode;
 type LegacyWebSocketCallbacks = {
-    onMessage?: (data: string | Buffer) => void;
-    onClose?: (event: WebSocketCloseEvent) => void;
-    onError?: (error: string) => void;
+  onMessage?: (data: string | Buffer) => void;
+  onClose?: (event: WebSocketCloseEvent) => void;
+  onError?: (error: string) => void;
 };
 type WebSocketOpenDispatchMode = "automatic" | "deferred";
 type InternalWebSocketInit = {
-    readonly _internal: true;
-    url: string;
-    options: WebSocketOptions;
-    openDispatchMode: WebSocketOpenDispatchMode;
-    connect: (callbacks: {
-        onMessage: (data: string | Buffer) => void;
-        onClose: (event: NativeWebSocketCloseEvent) => void;
-        onError: (message: string) => void;
-    }) => Promise<NativeWebSocketConnection>;
-    legacyCallbacks: LegacyWebSocketCallbacks | undefined;
+  readonly _internal: true;
+  url: string;
+  options: WebSocketOptions;
+  openDispatchMode: WebSocketOpenDispatchMode;
+  connect: (callbacks: {
+    onMessage: (data: string | Buffer) => void;
+    onClose: (event: NativeWebSocketCloseEvent) => void;
+    onError: (message: string) => void;
+  }) => Promise<NativeWebSocketConnection>;
+  legacyCallbacks: LegacyWebSocketCallbacks | undefined;
 };
 declare class Headers implements Iterable<[string, string]> {
-    private readonly store;
-    constructor(init?: HeadersInit);
-    private applyInit;
-    private normalizeName;
-    private assertValue;
-    append(name: string, value: unknown): void;
-    set(name: string, value: unknown): void;
-    get(name: string): string | null;
-    has(name: string): boolean;
-    delete(name: string): void;
-    entries(): IterableIterator<[string, string]>;
-    keys(): IterableIterator<string>;
-    values(): IterableIterator<string>;
-    forEach(callback: (value: string, name: string, parent: Headers) => void, thisArg?: unknown): void;
-    [Symbol.iterator](): IterableIterator<[string, string]>;
-    toObject(): Record<string, string>;
-    toTuples(): HeaderTuple[];
+  private readonly store;
+  constructor(init?: HeadersInit);
+  private applyInit;
+  private normalizeName;
+  private assertValue;
+  append(name: string, value: unknown): void;
+  set(name: string, value: unknown): void;
+  get(name: string): string | null;
+  has(name: string): boolean;
+  delete(name: string): void;
+  entries(): IterableIterator<[string, string]>;
+  keys(): IterableIterator<string>;
+  values(): IterableIterator<string>;
+  forEach(callback: (value: string, name: string, parent: Headers) => void, thisArg?: unknown): void;
+  [Symbol.iterator](): IterableIterator<[string, string]>;
+  toObject(): Record<string, string>;
+  toTuples(): HeaderTuple[];
 }
 type ResponseType = "basic" | "cors" | "error" | "opaque" | "opaqueredirect";
 declare class Response {
-    readonly status: number;
-    readonly ok: boolean;
-    readonly contentLength: number | null;
-    readonly url: string;
-    readonly type: ResponseType;
-    bodyUsed: boolean;
-    private readonly payload;
-    private readonly requestUrl;
-    private redirectedMemo;
-    private readonly headersInit;
-    private headersInstance;
-    private readonly cookiesInit;
-    private cookiesRecord;
-    private inlineBody;
-    private bodySource;
-    private bodyStream;
-    private nativeHandleAvailable;
-    private nativeHandle;
-    constructor(payload: NativeResponse, requestUrl: string, bodySource?: ReadableStream<Uint8Array> | null);
-    get redirected(): boolean;
-    get statusText(): string;
-    get headers(): Headers;
-    get cookies(): Record<string, string | string[]>;
-    get body(): ReadableStream<Uint8Array> | null;
-    json<T = unknown>(): Promise<T>;
-    arrayBuffer(): Promise<ArrayBuffer>;
-    text(): Promise<string>;
-    blob(): Promise<Blob>;
-    formData(): Promise<FormData>;
-    readable(): Readable;
-    clone(): Response;
-    private assertBodyAvailable;
-    private consumeBody;
+  readonly status: number;
+  readonly ok: boolean;
+  readonly contentLength: number | null;
+  readonly url: string;
+  readonly diagnostics: RequestDiagnostics | null;
+  readonly type: ResponseType;
+  bodyUsed: boolean;
+  private readonly payload;
+  private readonly requestUrl;
+  private redirectedMemo;
+  private readonly headersInit;
+  private headersInstance;
+  private readonly cookiesInit;
+  private cookiesRecord;
+  private inlineBody;
+  private bodySource;
+  private bodyStream;
+  private nativeHandleAvailable;
+  private nativeHandle;
+  constructor(payload: NativeResponse, requestUrl: string, bodySource?: ReadableStream<Uint8Array> | null);
+  get redirected(): boolean;
+  get statusText(): string;
+  get headers(): Headers;
+  get cookies(): Record<string, string | string[]>;
+  get body(): ReadableStream<Uint8Array> | null;
+  json<T = unknown>(): Promise<T>;
+  arrayBuffer(): Promise<ArrayBuffer>;
+  text(): Promise<string>;
+  blob(): Promise<Blob>;
+  formData(): Promise<FormData>;
+  readable(): Readable;
+  clone(): Response;
+  private assertBodyAvailable;
+  private consumeBody;
 }
 declare class Transport {
-    readonly id: string;
-    private disposed;
-    constructor(id: string);
-    get closed(): boolean;
-    close(): Promise<void>;
+  readonly id: string;
+  private disposed;
+  constructor(id: string);
+  get closed(): boolean;
+  close(): Promise<void>;
 }
 declare class Session implements SessionHandle {
-    readonly id: string;
-    private disposed;
-    private readonly defaults;
-    constructor(id: string, defaults: SessionDefaults);
-    get closed(): boolean;
-    private ensureActive;
-    /** @internal */
-    getDefaults(): SessionDefaults;
-    /** @internal */
-    _defaultsRef(): SessionDefaults;
-    fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
-    clearCookies(): Promise<void>;
-    getCookies(url: string | URL): Record<string, string>;
-    setCookie(name: string, value: string, url: string | URL): void;
-    /**
-     * Create a WebSocket connection that shares this session's cookies and TLS configuration.
-     *
-     * @param urlOrOptions - WebSocket URL or legacy options object
-     * @param options - Session WebSocket options
-     * @returns Promise that resolves to the WebSocket instance
-     */
-    websocket(url: string | URL, options?: SessionWebSocketOptions): Promise<WebSocket>;
-    websocket(options: LegacySessionWebSocketOptions): Promise<WebSocket>;
-    close(): Promise<void>;
+  readonly id: string;
+  private disposed;
+  private readonly defaults;
+  constructor(id: string, defaults: SessionDefaults);
+  get closed(): boolean;
+  private ensureActive;
+  /** @internal */
+  getDefaults(): SessionDefaults;
+  /** @internal */
+  _defaultsRef(): SessionDefaults;
+  fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+  clearCookies(): Promise<void>;
+  getCookies(url: string | URL): Record<string, string>;
+  getAllCookies(): SessionCookie[];
+  setCookie(name: string, value: string, url: string | URL): void;
+  /**
+   * Create a WebSocket connection that shares this session's cookies and TLS configuration.
+   *
+   * @param urlOrOptions - WebSocket URL or legacy options object
+   * @param options - Session WebSocket options
+   * @returns Promise that resolves to the WebSocket instance
+   */
+  websocket(url: string | URL, options?: SessionWebSocketOptions): Promise<WebSocket>;
+  websocket(options: LegacySessionWebSocketOptions): Promise<WebSocket>;
+  close(): Promise<void>;
 }
 /**
  * Fetch-compatible entry point that adds browser impersonation controls.
@@ -923,119 +1028,119 @@ declare function get(url: string | URL | Request, init?: Omit<RequestInit, "meth
  */
 declare function post(url: string | URL | Request, body?: BodyInit | null, init?: Omit<RequestInit, "method" | "body">): Promise<Response>;
 type WebSocketAddEventListenerOptions = boolean | {
-    once?: boolean;
-    signal?: AbortSignal | null;
+  once?: boolean;
+  signal?: AbortSignal | null;
 };
 /**
  * WHATWG-style WebSocket API with async connection establishment.
  */
 declare class WebSocket {
-    static readonly CONNECTING = 0;
-    static readonly OPEN = 1;
-    static readonly CLOSING = 2;
-    static readonly CLOSED = 3;
-    readonly url: string;
-    protocol: string;
-    extensions: string;
-    readyState: number;
-    private _binaryType;
-    private _bufferedAmount;
-    private _onopen;
-    private _onmessage;
-    private _onclose;
-    private _onerror;
-    private _onHandlerOrder;
-    private _listenerOrderCounter;
-    private readonly _listeners;
-    private readonly _legacyCallbacks;
-    private readonly _openDispatchMode;
-    private _connection;
-    private _connectPromise;
-    private _closeOptions;
-    private _finalizerToken;
-    private _openEventDispatched;
-    private _openEventQueued;
-    private _closeEventDispatched;
-    private _nativeCloseStarted;
-    private _pendingMessages;
-    private _sendChain;
-    constructor(init: InternalWebSocketInit);
-    constructor(url: string | URL, protocols?: string | string[]);
-    constructor(url: string | URL, protocols?: string | string[], options?: WebSocketOptions);
-    constructor(url: string | URL, options?: WebSocketOptions);
-    get binaryType(): WebSocketBinaryType;
-    set binaryType(value: WebSocketBinaryType);
-    get bufferedAmount(): number;
-    get onopen(): ((this: WebSocket, event: WebSocketOpenEvent) => void) | null;
-    set onopen(listener: ((this: WebSocket, event: WebSocketOpenEvent) => void) | null);
-    get onmessage(): ((this: WebSocket, event: WebSocketMessageEvent) => void) | null;
-    set onmessage(listener: ((this: WebSocket, event: WebSocketMessageEvent) => void) | null);
-    get onclose(): ((this: WebSocket, event: WebSocketCloseEvent) => void) | null;
-    set onclose(listener: ((this: WebSocket, event: WebSocketCloseEvent) => void) | null);
-    get onerror(): ((this: WebSocket, event: WebSocketErrorEvent) => void) | null;
-    set onerror(listener: ((this: WebSocket, event: WebSocketErrorEvent) => void) | null);
-    static _connectWithInit(init: InternalWebSocketInit): Promise<WebSocket>;
-    private static buildStandaloneInit;
-    private connect;
-    private _waitUntilConnected;
-    private scheduleOpenEventAfterConnect;
-    private scheduleOpenEventAfterAwait;
-    private scheduleOpenEventWithDepth;
-    private releaseConnectionTracking;
-    private toMessageEventData;
-    private invokeListener;
-    private createBaseEvent;
-    private getOnHandler;
-    private getOnHandlerOrder;
-    private getListenerMap;
-    private dispatchEvent;
-    private dispatchOpenEvent;
-    private dispatchMessageEvent;
-    private dispatchCloseEvent;
-    private dispatchErrorEvent;
-    private handleNativeMessage;
-    private handleNativeError;
-    private handleNativeClose;
-    private finalizeClosed;
-    private startNativeClose;
-    addEventListener(type: "open", listener: ((event: WebSocketOpenEvent) => void) | null, options?: WebSocketAddEventListenerOptions): void;
-    addEventListener(type: "message", listener: ((event: WebSocketMessageEvent) => void) | null, options?: WebSocketAddEventListenerOptions): void;
-    addEventListener(type: "close", listener: ((event: WebSocketCloseEvent) => void) | null, options?: WebSocketAddEventListenerOptions): void;
-    addEventListener(type: "error", listener: ((event: WebSocketErrorEvent) => void) | null, options?: WebSocketAddEventListenerOptions): void;
-    addEventListener(type: string, listener: unknown, options?: WebSocketAddEventListenerOptions): void;
-    removeEventListener(type: "open", listener: ((event: WebSocketOpenEvent) => void) | null): void;
-    removeEventListener(type: "message", listener: ((event: WebSocketMessageEvent) => void) | null): void;
-    removeEventListener(type: "close", listener: ((event: WebSocketCloseEvent) => void) | null): void;
-    removeEventListener(type: "error", listener: ((event: WebSocketErrorEvent) => void) | null): void;
-    removeEventListener(type: string, listener: unknown): void;
-    private getSendByteLength;
-    private normalizeSendPayload;
-    send(data: string | Buffer | ArrayBuffer | ArrayBufferView | Blob): void;
-    close(code?: number, reason?: string): void;
+  static readonly CONNECTING = 0;
+  static readonly OPEN = 1;
+  static readonly CLOSING = 2;
+  static readonly CLOSED = 3;
+  readonly url: string;
+  protocol: string;
+  extensions: string;
+  readyState: number;
+  private _binaryType;
+  private _bufferedAmount;
+  private _onopen;
+  private _onmessage;
+  private _onclose;
+  private _onerror;
+  private _onHandlerOrder;
+  private _listenerOrderCounter;
+  private readonly _listeners;
+  private readonly _legacyCallbacks;
+  private readonly _openDispatchMode;
+  private _connection;
+  private _connectPromise;
+  private _closeOptions;
+  private _finalizerToken;
+  private _openEventDispatched;
+  private _openEventQueued;
+  private _closeEventDispatched;
+  private _nativeCloseStarted;
+  private _pendingMessages;
+  private _sendChain;
+  constructor(init: InternalWebSocketInit);
+  constructor(url: string | URL, protocols?: string | string[]);
+  constructor(url: string | URL, protocols?: string | string[], options?: WebSocketOptions);
+  constructor(url: string | URL, options?: WebSocketOptions);
+  get binaryType(): WebSocketBinaryType;
+  set binaryType(value: WebSocketBinaryType);
+  get bufferedAmount(): number;
+  get onopen(): ((this: WebSocket, event: WebSocketOpenEvent) => void) | null;
+  set onopen(listener: ((this: WebSocket, event: WebSocketOpenEvent) => void) | null);
+  get onmessage(): ((this: WebSocket, event: WebSocketMessageEvent) => void) | null;
+  set onmessage(listener: ((this: WebSocket, event: WebSocketMessageEvent) => void) | null);
+  get onclose(): ((this: WebSocket, event: WebSocketCloseEvent) => void) | null;
+  set onclose(listener: ((this: WebSocket, event: WebSocketCloseEvent) => void) | null);
+  get onerror(): ((this: WebSocket, event: WebSocketErrorEvent) => void) | null;
+  set onerror(listener: ((this: WebSocket, event: WebSocketErrorEvent) => void) | null);
+  static _connectWithInit(init: InternalWebSocketInit): Promise<WebSocket>;
+  private static buildStandaloneInit;
+  private connect;
+  private _waitUntilConnected;
+  private scheduleOpenEventAfterConnect;
+  private scheduleOpenEventAfterAwait;
+  private scheduleOpenEventWithDepth;
+  private releaseConnectionTracking;
+  private toMessageEventData;
+  private invokeListener;
+  private createBaseEvent;
+  private getOnHandler;
+  private getOnHandlerOrder;
+  private getListenerMap;
+  private dispatchEvent;
+  private dispatchOpenEvent;
+  private dispatchMessageEvent;
+  private dispatchCloseEvent;
+  private dispatchErrorEvent;
+  private handleNativeMessage;
+  private handleNativeError;
+  private handleNativeClose;
+  private finalizeClosed;
+  private startNativeClose;
+  addEventListener(type: "open", listener: ((event: WebSocketOpenEvent) => void) | null, options?: WebSocketAddEventListenerOptions): void;
+  addEventListener(type: "message", listener: ((event: WebSocketMessageEvent) => void) | null, options?: WebSocketAddEventListenerOptions): void;
+  addEventListener(type: "close", listener: ((event: WebSocketCloseEvent) => void) | null, options?: WebSocketAddEventListenerOptions): void;
+  addEventListener(type: "error", listener: ((event: WebSocketErrorEvent) => void) | null, options?: WebSocketAddEventListenerOptions): void;
+  addEventListener(type: string, listener: unknown, options?: WebSocketAddEventListenerOptions): void;
+  removeEventListener(type: "open", listener: ((event: WebSocketOpenEvent) => void) | null): void;
+  removeEventListener(type: "message", listener: ((event: WebSocketMessageEvent) => void) | null): void;
+  removeEventListener(type: "close", listener: ((event: WebSocketCloseEvent) => void) | null): void;
+  removeEventListener(type: "error", listener: ((event: WebSocketErrorEvent) => void) | null): void;
+  removeEventListener(type: string, listener: unknown): void;
+  private getSendByteLength;
+  private normalizeSendPayload;
+  send(data: string | Buffer | ArrayBuffer | ArrayBufferView | Blob): void;
+  close(code?: number, reason?: string): void;
 }
 /**
  * Create a WebSocket connection with browser impersonation.
  */
 declare function websocket(url: string | URL, options?: WebSocketOptions): Promise<WebSocket>;
 declare function websocket(options: LegacyWebSocketOptions): Promise<WebSocket>;
-
 declare const _default: {
-    fetch: typeof fetch;
-    request: typeof request;
-    get: typeof get;
-    post: typeof post;
-    getProfiles: typeof getProfiles;
-    getOperatingSystems: typeof getOperatingSystems;
-    createTransport: typeof createTransport;
-    createSession: typeof createSession;
-    withSession: typeof withSession;
-    websocket: typeof websocket;
-    WebSocket: typeof WebSocket;
-    Headers: typeof Headers;
-    Response: typeof Response;
-    Transport: typeof Transport;
-    Session: typeof Session;
-    RequestError: typeof RequestError;
+  fetch: typeof fetch;
+  request: typeof request;
+  get: typeof get;
+  post: typeof post;
+  getProfiles: typeof getProfiles;
+  getOperatingSystems: typeof getOperatingSystems;
+  createTransport: typeof createTransport;
+  createSession: typeof createSession;
+  withSession: typeof withSession;
+  websocket: typeof websocket;
+  WebSocket: typeof WebSocket;
+  Headers: typeof Headers;
+  Response: typeof Response;
+  Transport: typeof Transport;
+  Session: typeof Session;
+  RequestError: typeof RequestError;
 };
-
-export { type AlpnProtocol, type AlpsProtocol, type BodyInit, type BrowserProfile, type CookieMode, type CreateSessionOptions, type CreateTransportOptions, type CustomEmulationOptions, type CustomHttp1Options, type CustomHttp2Options, type CustomTlsOptions, type EmulationOS, Headers, type HeadersInit, type Http2ExperimentalSetting, type Http2Priority, type Http2PseudoHeaderId, type Http2SettingId, type Http2StreamDependency, RequestError, type RequestInit, type RequestOptions, Response, Session, type SessionHandle, type SessionWebSocketOptions, type TlsVersion, Transport, WebSocket, type WebSocketBinaryType, type WebSocketCloseEvent, type WebSocketErrorEvent, type WebSocketEventType, type WebSocketMessageEvent, type WebSocketOpenEvent, type WebSocketOptions, createSession, createTransport, _default as default, fetch, get, getOperatingSystems, getProfiles, post, request, websocket, withSession };
+//#endregion
+export { type AlpnProtocol, type AlpsProtocol, type BodyInit, type BrowserProfile, type CookieMode, type CreateSessionOptions, type CreateTransportOptions, type CustomEmulationOptions, type CustomHttp1Options, type CustomHttp2Options, type CustomTlsOptions, type EmulationOS, Headers, type HeadersInit, type Http2ExperimentalSetting, type Http2Priority, type Http2PseudoHeaderId, type Http2SettingId, type Http2StreamDependency, type RequestDiagnostics, RequestError, type RequestEvent, type RequestEventType, type RequestInit, type RequestOptions, Response, Session, type SessionHandle, type SessionWebSocketOptions, type TlsVersion, Transport, WebSocket, type WebSocketBinaryType, type WebSocketCloseEvent, type WebSocketErrorEvent, type WebSocketEventType, type WebSocketMessageEvent, type WebSocketOpenEvent, type WebSocketOptions, createSession, createTransport, _default as default, fetch, get, getOperatingSystems, getProfiles, post, request, websocket, withSession };
+//# sourceMappingURL=wreq-js.d.ts.map