wreq-js 0.1.0 → 1.0.0

package/dist/types.d.ts

@@ -1,111 +1,354 @@
-import type { BrowserProfile } from './generated-types';
+import type { BrowserProfile } from "./generated-types";
 export type { BrowserProfile };
 /**
- * HTTP method types
+ * Controls how cookies are scoped for a request.
+ * - "session": reuse an explicit Session or sessionId across calls.
+ * - "ephemeral": create an isolated, single-use session.
  */
-export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD';
+export type CookieMode = "session" | "ephemeral";
 /**
- * Request options for making HTTP requests with browser impersonation
+ * Minimal handle implemented by {@link Session}. Exposed so {@link RequestInit.session}
+ * can accept either a Session instance or a compatible object.
+ */
+export interface SessionHandle {
+    readonly id: string;
+}
+/**
+ * A tuple of [name, value] pairs used for initializing headers.
+ * Both name and value must be strings.
+ *
+ * @example
+ * ```typescript
+ * const headers: HeaderTuple = ['Content-Type', 'application/json'];
+ * ```
+ */
+export type HeaderTuple = [string, string];
+/**
+ * Represents various input types accepted when creating or initializing headers.
+ * Can be an iterable of header tuples, an array of tuples, or a plain object.
+ *
+ * @example
+ * ```typescript
+ * // As an object
+ * const headers: HeadersInit = { 'Content-Type': 'application/json' };
+ *
+ * // As an array of tuples
+ * const headers: HeadersInit = [['Content-Type', 'application/json']];
+ *
+ * // As an iterable
+ * const headers: HeadersInit = new Map([['Content-Type', 'application/json']]);
+ * ```
+ */
+export type HeadersInit = Iterable<HeaderTuple> | Array<HeaderTuple> | Record<string, string | number | boolean | null | undefined>;
+/**
+ * Represents the various types of data that can be used as a request body.
+ * Supports string, binary data (ArrayBuffer, ArrayBufferView), URL-encoded parameters, and Node.js Buffer.
+ *
+ * @example
+ * ```typescript
+ * // String body
+ * const body: BodyInit = JSON.stringify({ key: 'value' });
+ *
+ * // URLSearchParams
+ * const body: BodyInit = new URLSearchParams({ key: 'value' });
+ *
+ * // Buffer
+ * const body: BodyInit = Buffer.from('data');
+ * ```
+ */
+export type BodyInit = string | ArrayBuffer | ArrayBufferView | URLSearchParams | Buffer;
+/**
+ * Options for configuring a fetch request. Compatible with the standard Fetch API
+ * with additional wreq-specific extensions for browser impersonation, proxies, and timeouts.
+ *
+ * @example
+ * ```typescript
+ * const options: RequestInit = {
+ *   method: 'POST',
+ *   headers: { 'Content-Type': 'application/json' },
+ *   body: JSON.stringify({ key: 'value' }),
+ *   browser: 'chrome_142',
+ *   proxy: 'http://proxy.example.com:8080',
+ *   timeout: 5000
+ * };
+ * ```
+ */
+export 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";
+    /**
+     * Browser profile to impersonate for this request.
+     * Automatically applies browser-specific headers, TLS fingerprints, and HTTP/2 settings.
+     * @default 'chrome_142'
+     */
+    browser?: BrowserProfile;
+    /**
+     * Proxy URL to route the request through (e.g., 'http://proxy.example.com:8080').
+     * Supports HTTP and SOCKS5 proxies.
+     */
+    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?: SessionHandle;
+    /**
+     * Identifier of an existing session created elsewhere (e.g., via {@link createSession}).
+     */
+    sessionId?: string;
+}
+/**
+ * Configuration for {@link createSession}.
+ */
+export interface CreateSessionOptions {
+    /**
+     * Provide a custom identifier instead of an auto-generated random ID.
+     */
+    sessionId?: string;
+    /**
+     * Browser profile to bind to this session. Defaults to 'chrome_142'.
+     */
+    browser?: BrowserProfile;
+    /**
+     * 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;
+}
+/**
+ * Standard HTTP request methods supported by wreq.
+ * Represents the most commonly used HTTP verbs for RESTful operations.
+ */
+export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD";
+/**
+ * Legacy request options interface. This interface is deprecated and will be removed in a future version.
+ *
+ * @deprecated Use {@link RequestInit} with the standard `fetch()` API instead.
+ *
+ * @example
+ * ```typescript
+ * // Old (deprecated):
+ * const options: RequestOptions = {
+ *   url: 'https://api.example.com',
+ *   method: 'POST',
+ *   body: JSON.stringify({ data: 'value' })
+ * };
+ *
+ * // New (recommended):
+ * const response = await fetch('https://api.example.com', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ data: 'value' })
+ * });
+ * ```
  */
 export interface RequestOptions {
     /**
-     * The URL to request
+     * The URL to request.
      */
     url: string;
     /**
-     * Browser profile to impersonate
-     * @default 'chrome_137'
+     * Browser profile to impersonate.
+     * Automatically applies browser-specific headers, TLS fingerprints, and HTTP/2 settings.
+     * @default 'chrome_142'
      */
     browser?: BrowserProfile;
     /**
-     * HTTP method
+     * HTTP method to use for the request.
      * @default 'GET'
      */
     method?: HttpMethod;
     /**
-     * Additional headers to send with the request
-     * Browser-specific headers will be automatically added
+     * Additional headers to send with the request.
+     * Browser-specific headers will be automatically added based on the selected browser profile.
      */
     headers?: Record<string, string>;
     /**
-     * Request body (for POST, PUT, PATCH requests)
+     * Request body data (for POST, PUT, PATCH requests).
      */
     body?: string;
     /**
-     * Proxy URL (e.g., 'http://proxy.example.com:8080')
+     * Proxy URL to route the request through (e.g., 'http://proxy.example.com:8080').
+     * Supports HTTP and SOCKS5 proxies.
      */
     proxy?: string;
     /**
-     * Request timeout in milliseconds
+     * Request timeout in milliseconds. If the request takes longer than this value,
+     * it will be aborted.
      * @default 30000
      */
     timeout?: number;
+    /**
+     * 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;
 }
 /**
- * Response object returned from HTTP requests
+ * Internal response payload returned from the native Rust binding.
+ * This interface represents the raw response data before it's converted
+ * to a standard Response object.
+ *
+ * @internal
  */
-export interface Response {
+export interface NativeResponse {
     /**
-     * HTTP status code
+     * HTTP status code (e.g., 200, 404, 500).
      */
     status: number;
     /**
-     * Response headers
+     * Response headers as key-value pairs.
+     * Header names are normalized to lowercase.
      */
     headers: Record<string, string>;
     /**
-     * Response body as string
+     * Response body as a UTF-8 encoded string.
      */
     body: string;
     /**
-     * Cookies set by the server
+     * Cookies set by the server as key-value pairs.
      */
     cookies: Record<string, string>;
     /**
-     * Final URL after redirects
+     * Final URL after following any redirects.
+     * If no redirects occurred, this will match the original request URL.
      */
     url: string;
 }
 /**
- * WebSocket options for creating a connection
+ * Configuration options for creating a WebSocket connection.
+ * Supports browser impersonation and proxies, similar to HTTP requests.
+ *
+ * @example
+ * ```typescript
+ * const ws = await createWebSocket({
+ *   url: 'wss://echo.websocket.org',
+ *   browser: 'chrome_142',
+ *   headers: { 'Authorization': 'Bearer token' },
+ *   onMessage: (data) => {
+ *     console.log('Received:', data);
+ *   },
+ *   onClose: () => {
+ *     console.log('Connection closed');
+ *   },
+ *   onError: (error) => {
+ *     console.error('WebSocket error:', error);
+ *   }
+ * });
+ * ```
  */
 export interface WebSocketOptions {
     /**
-     * The WebSocket URL to connect to (wss:// or ws://)
+     * The WebSocket URL to connect to. Must use wss:// (secure) or ws:// (insecure) protocol.
      */
     url: string;
     /**
-     * Browser profile to impersonate
-     * @default 'chrome_137'
+     * Browser profile to impersonate for the WebSocket upgrade request.
+     * Automatically applies browser-specific headers and TLS fingerprints.
+     * @default 'chrome_142'
      */
     browser?: BrowserProfile;
     /**
-     * Additional headers to send with the WebSocket upgrade request
+     * Additional headers to send with the WebSocket upgrade request.
+     * Common headers include Authorization, Origin, or custom application headers.
      */
     headers?: Record<string, string>;
     /**
-     * Proxy URL (e.g., 'http://proxy.example.com:8080')
+     * Proxy URL to route the connection through (e.g., 'http://proxy.example.com:8080').
+     * Supports HTTP and SOCKS5 proxies.
      */
     proxy?: string;
     /**
-     * Callback for incoming messages (required)
+     * Callback function invoked when a message is received from the server.
+     * The data parameter will be a string for text frames or a Buffer for binary frames.
+     *
+     * @param data - The received message as a string or Buffer
      */
     onMessage: (data: string | Buffer) => void;
     /**
-     * Callback for connection close event
+     * Callback function invoked when the WebSocket connection is closed.
+     * This is called for both clean closes and connection errors.
      */
     onClose?: () => void;
     /**
-     * Callback for error events
+     * Callback function invoked when a connection or protocol error occurs.
+     *
+     * @param error - A string describing the error that occurred
      */
     onError?: (error: string) => void;
 }
 /**
- * Internal WebSocket connection object returned from native binding
+ * Internal WebSocket connection object returned from the native Rust binding.
+ * This interface contains the connection ID used to reference the WebSocket
+ * in subsequent operations like sending messages or closing the connection.
+ *
+ * @internal
  */
 export interface NativeWebSocketConnection {
+    /**
+     * Unique identifier for this WebSocket connection.
+     * Used internally to track and manage the connection.
+     * @internal
+     */
     _id: number;
 }
+/**
+ * Error thrown when a request fails. This can occur due to network errors,
+ * timeouts, invalid URLs, or other request-related issues.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const response = await fetch('https://api.example.com');
+ * } catch (error) {
+ *   if (error instanceof RequestError) {
+ *     console.error('Request failed:', error.message);
+ *   }
+ * }
+ * ```
+ */
 export declare class RequestError extends Error {
     constructor(message: string);
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;;OAGG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAE3C;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1,10 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RequestError = void 0;
+/**
+ * Error thrown when a request fails. This can occur due to network errors,
+ * timeouts, invalid URLs, or other request-related issues.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const response = await fetch('https://api.example.com');
+ * } catch (error) {
+ *   if (error instanceof RequestError) {
+ *     console.error('Request failed:', error.message);
+ *   }
+ * }
+ * ```
+ */
 class RequestError extends Error {
     constructor(message) {
         super(message);
-        this.name = 'RequestError';
+        this.name = "RequestError";
     }
 }
 exports.RequestError = RequestError;

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAmIA,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AA6XA;;;;;;;;;;;;;;GAcG;AACH,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC"}

package/dist/wreq-js.d.ts

@@ -1,26 +1,72 @@
-import type { RequestOptions, Response, BrowserProfile, WebSocketOptions, NativeWebSocketConnection } from './types';
-import { RequestError } from './types';
+import type { BodyInit, BrowserProfile, CreateSessionOptions, HeadersInit, NativeResponse, NativeWebSocketConnection, RequestOptions, SessionHandle, WebSocketOptions, RequestInit as WreqRequestInit } from "./types";
+import { RequestError } from "./types";
+type SessionDefaults = {
+    browser: BrowserProfile;
+    proxy?: string;
+    timeout?: number;
+};
+export 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>;
+}
+type ResponseType = "basic" | "cors" | "error" | "opaque" | "opaqueredirect";
+export declare class Response {
+    readonly status: number;
+    readonly statusText: string;
+    readonly ok: boolean;
+    readonly headers: Headers;
+    readonly url: string;
+    readonly redirected: boolean;
+    readonly type: ResponseType;
+    readonly cookies: Record<string, string>;
+    readonly body: string;
+    bodyUsed: boolean;
+    private readonly payload;
+    private readonly requestUrl;
+    constructor(payload: NativeResponse, requestUrl: string);
+    json<T = unknown>(): Promise<T>;
+    text(): Promise<string>;
+    clone(): Response;
+    private assertBodyAvailable;
+}
+export declare class Session implements SessionHandle {
+    readonly id: string;
+    private disposed;
+    private readonly defaults;
+    constructor(id: string, defaults: SessionDefaults);
+    get closed(): boolean;
+    private ensureActive;
+    private enforceBrowser;
+    private enforceProxy;
+    fetch(input: string | URL, init?: WreqRequestInit): Promise<Response>;
+    clearCookies(): Promise<void>;
+    close(): Promise<void>;
+}
 /**
- * Make an HTTP request with browser impersonation
- *
- * @param options - Request options
- * @returns Promise that resolves to the response
- *
- * @example
- * ```typescript
- * import { request } from 'wreq-js';
+ * Fetch-compatible entry point that adds browser impersonation controls.
  *
- * const response = await request({
- *   url: 'https://example.com/api',
- *   browser: 'chrome_137',
- *   headers: {
- *     'Custom-Header': 'value'
- *   }
- * });
- *
- * console.log(response.status); // 200
- * console.log(response.body);   // Response body
- * ```
+ * @param input - Request URL (string or URL instance)
+ * @param init - Fetch-compatible init options
+ */
+export declare function fetch(input: string | URL, init?: WreqRequestInit): Promise<Response>;
+export declare function createSession(options?: CreateSessionOptions): Promise<Session>;
+export declare function withSession<T>(fn: (session: Session) => Promise<T> | T, options?: CreateSessionOptions): Promise<T>;
+/**
+ * @deprecated Use {@link fetch} instead.
  */
 export declare function request(options: RequestOptions): Promise<Response>;
 /**
@@ -38,40 +84,13 @@ export declare function request(options: RequestOptions): Promise<Response>;
  */
 export declare function getProfiles(): BrowserProfile[];
 /**
- * Convenience function for GET requests
- *
- * @param url - URL to request
- * @param options - Additional request options
- * @returns Promise that resolves to the response
- *
- * @example
- * ```typescript
- * import { get } from 'wreq-js';
- *
- * const response = await get('https://example.com/api');
- * ```
+ * Convenience helper for GET requests using {@link fetch}.
  */
-export declare function get(url: string, options?: Omit<RequestOptions, 'url' | 'method'>): Promise<Response>;
+export declare function get(url: string, init?: Omit<WreqRequestInit, "method">): Promise<Response>;
 /**
- * Convenience function for POST requests
- *
- * @param url - URL to request
- * @param body - Request body
- * @param options - Additional request options
- * @returns Promise that resolves to the response
- *
- * @example
- * ```typescript
- * import { post } from 'wreq-js';
- *
- * const response = await post(
- *   'https://example.com/api',
- *   JSON.stringify({ foo: 'bar' }),
- *   { headers: { 'Content-Type': 'application/json' } }
- * );
- * ```
+ * Convenience helper for POST requests using {@link fetch}.
  */
-export declare function post(url: string, body?: string, options?: Omit<RequestOptions, 'url' | 'method' | 'body'>): Promise<Response>;
+export declare function post(url: string, body?: BodyInit | null, init?: Omit<WreqRequestInit, "method" | "body">): Promise<Response>;
 /**
  * WebSocket connection class
  *
@@ -81,7 +100,7 @@ export declare function post(url: string, body?: string, options?: Omit<RequestO
  *
  * const ws = await websocket({
  *   url: 'wss://echo.websocket.org',
- *   browser: 'chrome_137',
+ *   browser: 'chrome_142',
  *   onMessage: (data) => {
  *     console.log('Received:', data);
  *   },
@@ -105,6 +124,8 @@ export declare function post(url: string, body?: string, options?: Omit<RequestO
  */
 export declare class WebSocket {
     private _connection;
+    private _finalizerToken;
+    private _closed;
     constructor(connection: NativeWebSocketConnection);
     /**
      * Send a message (text or binary)
@@ -122,15 +143,21 @@ export declare class WebSocket {
  * @returns Promise that resolves to the WebSocket instance
  */
 export declare function websocket(options: WebSocketOptions): Promise<WebSocket>;
-export type { RequestOptions, Response, BrowserProfile, HttpMethod, WebSocketOptions, } from './types';
-export type { RequestError };
+export type { BodyInit, BrowserProfile, CookieMode, CreateSessionOptions, HeadersInit, HttpMethod, RequestInit, RequestOptions, SessionHandle, WebSocketOptions, } from "./types";
+export { RequestError };
 declare const _default: {
+    fetch: typeof fetch;
     request: typeof request;
     get: typeof get;
     post: typeof post;
     getProfiles: typeof getProfiles;
+    createSession: typeof createSession;
+    withSession: typeof withSession;
     websocket: typeof websocket;
     WebSocket: typeof WebSocket;
+    Headers: typeof Headers;
+    Response: typeof Response;
+    Session: typeof Session;
 };
 export default _default;
 //# sourceMappingURL=wreq-js.d.ts.map

package/dist/wreq-js.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wreq-js.d.ts","sourceRoot":"","sources":["../src/wreq-js.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA0EvC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoBxE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAE9C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,GAAG,CACvB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,QAAQ,CAAC,GAC/C,OAAO,CAAC,QAAQ,CAAC,CAEnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,IAAI,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC,GACxD,OAAO,CAAC,QAAQ,CAAC,CAEnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,WAAW,CAA4B;gBAEnC,UAAU,EAAE,yBAAyB;IAIjD;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAkC7E;AAED,YAAY,EACV,cAAc,EACd,QAAQ,EACR,cAAc,EACd,UAAU,EACV,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,YAAY,EAAE,CAAC;;;;;;;;;AAE7B,wBAOE"}
+{"version":3,"file":"wreq-js.d.ts","sourceRoot":"","sources":["../src/wreq-js.ts"],"names":[],"mappings":"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"}