fix(fetch): add HTTPS Agent types to fetch & Request (web-std#78)

* fix: add typings for HTTPS agent for fetch and Request (remix-run#18)

Co-authored-by: Clifford Fajardo <cfajardo@linkedin.com>

* chore: fix changeset

---------

Co-authored-by: Clifford Fajardo <cliffordfajardo@gmail.com>
Co-authored-by: Clifford Fajardo <cfajardo@linkedin.com>
Co-authored-by: Irakli Gozalishvili <contact@gozala.io>

Author: 4 people

.changeset/polite-poets-enjoy.md

@@ -0,0 +1,5 @@
+---
+"@web-std/fetch": minor
+---
+
+expose `RequestExtraOptions` to `fetch` & add `HTTPs.agent` to types

packages/fetch/src/fetch.js

@@ -33,7 +33,7 @@ const supportedSchemas = new Set(['data:', 'http:', 'https:', 'file:']);
  * Fetch function
  *
  * @param   {string | URL | import('./request').default} url - Absolute url or Request instance
- * @param   {RequestInit} [options_] - Fetch options
+ * @param   {RequestInit & import('./request.js').RequestExtraOptions} [options_] - Fetch options
  * @return  {Promise<import('./response').default>}
  */
 async function fetch(url, options_ = {}) {
@@ -319,9 +319,9 @@ async function fetch(url, options_ = {}) {
 }
 
 /**
- * 
- * @param {import('http').ClientRequest} request 
- * @param {(error:Error) => void} errorCallback 
+ *
+ * @param {import('http').ClientRequest} request
+ * @param {(error:Error) => void} errorCallback
  */
 function fixResponseChunkedTransferBadEnding(request, errorCallback) {
 	const LAST_CHUNK = Buffer.from('0\r\n\r\n');

packages/fetch/src/request.js

@@ -53,7 +53,7 @@ const isRequest = object => {
  * @property {number} [highWaterMark]
  * @property {boolean} [insecureHTTPParser]
  *
- * @typedef {((url:URL) => import('http').Agent) | import('http').Agent} Agent
+ * @typedef {((url:URL) => import('http').Agent | import('https').Agent) | import('http').Agent | import('https').Agent} Agent
  *
  * @typedef {Object} RequestOptions
  * @property {string} [method]