The typings state that the callback will be called with an IncomingMessage. However, request extends the interface so that it also has a body property

The request.jar method is missing CookieJar argument.

Argument is needed to use a custom cookie store:

request.jar(new FileCookieStore('cookies.json'));

The CookieJar interface is missing a signature for setCookie:

Documentation:

.setCookie(cookieOrString, currentUrl, [{options},] cb(err,cookie))

The interface should be:

setCookie(cookie: Cookie | string, uri: string | url.Url, options?: any): void

The jar attribute in CoreOptions is now too strictly typed:

jar - If true, remember cookies for future use (or define your custom cookie jar; see examples section)

Documentation

It should be boolean | CookieJar

We should adopt the style of other typings and include the related documentation in the comments.
It would greatly help in providing context to the typings: it's convenient to jump straight to the definitions and read the doc. This would be a first step in the direction of integrating documentation.

It would also have prevented issues such as #3.

Hi @louy
Would you accept to migrate this repo to the types Github organization?

This is am important library so it could benefit from a better exposure.