Interface IRettiwtConfig

The configuration for initializing a new Rettiwt instance.

interface IRettiwtConfig {
    apiKey?: string;
    delay?: number | () => number | Promise<number>;
    errorHandler?: IErrorHandler;
    fetch?: {
        (input: URL | RequestInfo, init?: RequestInit): Promise<Response>;
        (input: string | URL | Request, init?: RequestInit): Promise<Response>;
    };
    headers?: { [key: string]: string };
    logging?: boolean;
    maxRetries?: number;
    proxy?: null | string | AxiosProxyConfig;
    responseMiddleware?: (response: AxiosResponse) => void | Promise<void>;
    timeout?: number;
    xChatConversationKeyProvider?: XChatConversationKeyProvider;
    xChatConversationKeys?: Record<string, XChatConversationKey>;
    xChatSession?: IXChatDecryptor;
}

Properties

apiKey? delay? errorHandler? fetch? headers? logging? maxRetries? proxy? responseMiddleware? timeout? xChatConversationKeyProvider? xChatConversationKeys? xChatSession?

Properties

OptionalapiKey

apiKey?: string

The apiKey (cookie) to use for authenticating Rettiwt against Twitter API.

Optionaldelay

delay?: number | () => number | Promise<number>

The delay (in ms) to use between concurrent request.

Can either be a number or a function that returns a number synchronously or asynchronously.

OptionalerrorHandler

errorHandler?: IErrorHandler

Optional custom error handler to define error conditions and process API/HTTP errors in responses.

Optionalfetch

fetch?: {
    (input: URL | RequestInfo, init?: RequestInit): Promise<Response>;
    (input: string | URL | Request, init?: RequestInit): Promise<Response>;
}

A custom fetch implementation to use for making HTTP requests.

Type declaration

    • (input: URL | RequestInfo, init?: RequestInit): Promise<Response>

    • MDN Reference

      Parameters

      • input: URL | RequestInfo
      • Optionalinit: RequestInit

      Returns Promise<Response>

    • (input: string | URL | Request, init?: RequestInit): Promise<Response>

    • MDN Reference

      Parameters

      • input: string | URL | Request
      • Optionalinit: RequestInit

      Returns Promise<Response>

Remarks


- When specified, the underlying HTTP client switches to a fetch-based transport. - Allows injecting a fetch-compatible client (e.g. a browser-impersonation client) to control TLS/HTTP fingerprints or run in environments without Node.js HTTP agents.

See

https://axios.rest/pages/advanced/fetch-adapter

Optionalheaders

headers?: { [key: string]: string }

Optional custom HTTP headers to add to all requests to Twitter API.

Remarks

Custom headers can be useful for proxies, avoiding rate limits, etc.

Optionallogging

logging?: boolean

Whether to write logs to console or not.

OptionalmaxRetries

maxRetries?: number

The maximum number of retries to use.

Remarks

Recommended to use a value of 5 combined with a delay of 1000 to prevent error 404.

Optionalproxy

proxy?: null | string | AxiosProxyConfig

The proxy to use.

Remarks


- If set to anything besides `undefined`, disables Axios' built-in environment variable-set proxy.

Example

// Use custom proxy config via config object
{
  proxy: {
    host: '127.0.0.1',
    port: 8080
  }
}

// Use custom proxy config via URL
{
  proxy: 'https://127.0.0.1:8080'
}

// Use Axios environment variable for proxy
{
  proxy: undefined
}

OptionalresponseMiddleware

responseMiddleware?: (response: AxiosResponse) => void | Promise<void>

Optional response middleware to be executed on obtaining a successful response.

Type declaration

    • (response: AxiosResponse): void | Promise<void>

    • Parameters

      • response: AxiosResponse

        The raw AxiosReponse object.

      Returns void | Promise<void>

Optionaltimeout

timeout?: number

The max wait time (in milli-seconds) for a response; if not set, Twitter server timeout is used.

OptionalxChatConversationKeyProvider

xChatConversationKeyProvider?: XChatConversationKeyProvider

Optional provider used to resolve a local XChat conversation key on demand.

OptionalxChatConversationKeys

xChatConversationKeys?: Record<string, XChatConversationKey>

Optional XChat conversation keys, indexed by conversation ID, used to decrypt encrypted DM payloads returned by the XChat conversation endpoint.

OptionalxChatSession

xChatSession?: IXChatDecryptor

Optional unlocked session used to recover and cache versioned XChat keys.

Settings

Member Visibility

On This Page

Properties