@chainlink/external-adapter-framework 2.6.0 → 2.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (160) hide show
  1. package/README.md +1 -1
  2. package/adapter/types.d.ts +1 -1
  3. package/config/index.d.ts +4 -0
  4. package/config/index.js +4 -0
  5. package/config/index.js.map +1 -1
  6. package/debug/router.js +7 -36
  7. package/debug/router.js.map +1 -1
  8. package/debug/settings-page.d.ts +1 -7
  9. package/debug/settings-page.js +0 -22
  10. package/debug/settings-page.js.map +1 -1
  11. package/generator-adapter/generators/app/index.js +11 -5
  12. package/generator-adapter/node_modules/.yarn-integrity +14 -13
  13. package/generator-adapter/node_modules/@types/node/README.md +3 -3
  14. package/generator-adapter/node_modules/@types/node/async_hooks.d.ts +65 -1
  15. package/generator-adapter/node_modules/@types/node/buffer.buffer.d.ts +2 -0
  16. package/generator-adapter/node_modules/@types/node/buffer.d.ts +8 -4
  17. package/generator-adapter/node_modules/@types/node/child_process.d.ts +26 -122
  18. package/generator-adapter/node_modules/@types/node/cluster.d.ts +1 -1
  19. package/generator-adapter/node_modules/@types/node/compatibility/disposable.d.ts +0 -2
  20. package/generator-adapter/node_modules/@types/node/compatibility/indexable.d.ts +0 -3
  21. package/generator-adapter/node_modules/@types/node/compatibility/iterators.d.ts +0 -1
  22. package/generator-adapter/node_modules/@types/node/crypto.d.ts +17 -1
  23. package/generator-adapter/node_modules/@types/node/diagnostics_channel.d.ts +37 -13
  24. package/generator-adapter/node_modules/@types/node/dns/promises.d.ts +36 -9
  25. package/generator-adapter/node_modules/@types/node/dns.d.ts +73 -20
  26. package/generator-adapter/node_modules/@types/node/events.d.ts +0 -1
  27. package/generator-adapter/node_modules/@types/node/fs/promises.d.ts +62 -54
  28. package/generator-adapter/node_modules/@types/node/fs.d.ts +149 -54
  29. package/generator-adapter/node_modules/@types/node/globals.d.ts +137 -478
  30. package/generator-adapter/node_modules/@types/node/http.d.ts +93 -6
  31. package/generator-adapter/node_modules/@types/node/http2.d.ts +81 -2
  32. package/generator-adapter/node_modules/@types/node/https.d.ts +5 -0
  33. package/generator-adapter/node_modules/@types/node/index.d.ts +7 -3
  34. package/generator-adapter/node_modules/@types/node/{inspector.d.ts → inspector.generated.d.ts} +219 -10
  35. package/generator-adapter/node_modules/@types/node/module.d.ts +136 -17
  36. package/generator-adapter/node_modules/@types/node/net.d.ts +15 -9
  37. package/generator-adapter/node_modules/@types/node/package.json +3 -83
  38. package/generator-adapter/node_modules/@types/node/perf_hooks.d.ts +2 -2
  39. package/generator-adapter/node_modules/@types/node/process.d.ts +3 -4
  40. package/generator-adapter/node_modules/@types/node/querystring.d.ts +2 -3
  41. package/generator-adapter/node_modules/@types/node/readline/promises.d.ts +0 -1
  42. package/generator-adapter/node_modules/@types/node/repl.d.ts +3 -5
  43. package/generator-adapter/node_modules/@types/node/sqlite.d.ts +207 -0
  44. package/generator-adapter/node_modules/@types/node/stream/web.d.ts +11 -3
  45. package/generator-adapter/node_modules/@types/node/stream.d.ts +5 -10
  46. package/generator-adapter/node_modules/@types/node/test.d.ts +1873 -1970
  47. package/generator-adapter/node_modules/@types/node/tls.d.ts +1 -1
  48. package/generator-adapter/node_modules/@types/node/ts5.6/buffer.buffer.d.ts +2 -0
  49. package/generator-adapter/node_modules/@types/node/ts5.6/index.d.ts +7 -3
  50. package/generator-adapter/node_modules/@types/node/url.d.ts +12 -3
  51. package/generator-adapter/node_modules/@types/node/util.d.ts +33 -5
  52. package/generator-adapter/node_modules/@types/node/v8.d.ts +60 -30
  53. package/generator-adapter/node_modules/@types/node/vm.d.ts +61 -8
  54. package/generator-adapter/node_modules/@types/node/web-globals/abortcontroller.d.ts +34 -0
  55. package/generator-adapter/node_modules/@types/node/web-globals/domexception.d.ts +68 -0
  56. package/generator-adapter/node_modules/@types/node/web-globals/events.d.ts +94 -0
  57. package/generator-adapter/node_modules/@types/node/web-globals/fetch.d.ts +46 -0
  58. package/generator-adapter/node_modules/@types/node/web-globals/navigator.d.ts +22 -0
  59. package/generator-adapter/node_modules/@types/node/web-globals/storage.d.ts +24 -0
  60. package/generator-adapter/node_modules/@types/node/worker_threads.d.ts +87 -28
  61. package/generator-adapter/node_modules/@types/node/zlib.d.ts +8 -2
  62. package/generator-adapter/node_modules/@yeoman/adapter/dist/adapter.d.ts +3 -0
  63. package/generator-adapter/node_modules/@yeoman/adapter/dist/adapter.js +12 -2
  64. package/generator-adapter/node_modules/@yeoman/adapter/dist/adapter.js.map +1 -1
  65. package/generator-adapter/node_modules/@yeoman/adapter/dist/queued-adapter.d.ts +3 -0
  66. package/generator-adapter/node_modules/@yeoman/adapter/dist/queued-adapter.js +12 -2
  67. package/generator-adapter/node_modules/@yeoman/adapter/dist/queued-adapter.js.map +1 -1
  68. package/generator-adapter/node_modules/@yeoman/adapter/dist/testing/test-adapter.d.ts +3 -0
  69. package/generator-adapter/node_modules/@yeoman/adapter/dist/testing/test-adapter.js +12 -2
  70. package/generator-adapter/node_modules/@yeoman/adapter/dist/testing/test-adapter.js.map +1 -1
  71. package/generator-adapter/node_modules/@yeoman/adapter/package.json +4 -4
  72. package/generator-adapter/node_modules/@yeoman/adapter/types/adapter.d.ts +12 -1
  73. package/generator-adapter/node_modules/@yeoman/types/package.json +3 -3
  74. package/generator-adapter/node_modules/@yeoman/types/types/environment/environment.d.ts +4 -1
  75. package/generator-adapter/node_modules/@yeoman/types/types/environment/methods-options.d.ts +7 -3
  76. package/generator-adapter/node_modules/@yeoman/types/types/generator/generator.d.ts +8 -5
  77. package/generator-adapter/node_modules/@yeoman/types/types/generator/utils.d.ts +1 -0
  78. package/generator-adapter/node_modules/ansi-regex/index.d.ts +9 -13
  79. package/generator-adapter/node_modules/ansi-regex/index.js +6 -6
  80. package/generator-adapter/node_modules/ansi-regex/license +1 -1
  81. package/generator-adapter/node_modules/ansi-regex/package.json +12 -6
  82. package/generator-adapter/node_modules/ansi-regex/readme.md +4 -22
  83. package/generator-adapter/node_modules/cli-spinners/index.d.ts +122 -111
  84. package/generator-adapter/node_modules/cli-spinners/index.js +7 -11
  85. package/generator-adapter/node_modules/cli-spinners/package.json +15 -9
  86. package/generator-adapter/node_modules/cli-spinners/readme.md +23 -3
  87. package/generator-adapter/node_modules/cli-spinners/spinners.json +44 -1
  88. package/generator-adapter/node_modules/emoji-regex/README.md +14 -48
  89. package/generator-adapter/node_modules/emoji-regex/index.d.ts +21 -1
  90. package/generator-adapter/node_modules/emoji-regex/index.js +5 -3
  91. package/generator-adapter/node_modules/emoji-regex/package.json +12 -7
  92. package/generator-adapter/node_modules/get-east-asian-width/index.js +2 -3
  93. package/generator-adapter/node_modules/get-east-asian-width/lookup.js +11 -11
  94. package/generator-adapter/node_modules/get-east-asian-width/package.json +1 -1
  95. package/generator-adapter/node_modules/ora/index.d.ts +3 -3
  96. package/generator-adapter/node_modules/ora/index.js +67 -48
  97. package/generator-adapter/node_modules/ora/node_modules/chalk/package.json +83 -0
  98. package/generator-adapter/node_modules/ora/node_modules/chalk/readme.md +297 -0
  99. package/generator-adapter/node_modules/ora/node_modules/chalk/source/index.d.ts +325 -0
  100. package/generator-adapter/node_modules/ora/node_modules/chalk/source/index.js +225 -0
  101. package/generator-adapter/node_modules/ora/node_modules/chalk/source/utilities.js +33 -0
  102. package/generator-adapter/node_modules/ora/node_modules/chalk/source/vendor/ansi-styles/index.d.ts +236 -0
  103. package/generator-adapter/node_modules/ora/node_modules/chalk/source/vendor/ansi-styles/index.js +223 -0
  104. package/generator-adapter/node_modules/ora/node_modules/chalk/source/vendor/supports-color/browser.d.ts +1 -0
  105. package/generator-adapter/node_modules/ora/node_modules/chalk/source/vendor/supports-color/browser.js +34 -0
  106. package/generator-adapter/node_modules/ora/node_modules/chalk/source/vendor/supports-color/index.d.ts +55 -0
  107. package/generator-adapter/node_modules/ora/node_modules/chalk/source/vendor/supports-color/index.js +190 -0
  108. package/generator-adapter/node_modules/ora/node_modules/log-symbols/browser-symbols.js +4 -0
  109. package/generator-adapter/node_modules/ora/node_modules/log-symbols/browser.js +1 -8
  110. package/generator-adapter/node_modules/ora/node_modules/log-symbols/index.js +1 -20
  111. package/generator-adapter/node_modules/ora/node_modules/log-symbols/package.json +10 -7
  112. package/generator-adapter/node_modules/ora/node_modules/log-symbols/symbols.js +14 -0
  113. package/generator-adapter/node_modules/ora/node_modules/strip-ansi/package.json +3 -1
  114. package/generator-adapter/node_modules/ora/node_modules/strip-ansi/readme.md +5 -9
  115. package/generator-adapter/node_modules/ora/package.json +13 -13
  116. package/generator-adapter/node_modules/ora/readme.md +49 -3
  117. package/generator-adapter/node_modules/string-width/index.js +52 -45
  118. package/generator-adapter/node_modules/string-width/package.json +8 -7
  119. package/generator-adapter/node_modules/{string-width → strip-ansi}/node_modules/ansi-regex/index.d.ts +13 -9
  120. package/generator-adapter/node_modules/strip-ansi/node_modules/ansi-regex/index.js +10 -0
  121. package/generator-adapter/node_modules/{ora/node_modules/log-symbols/node_modules/is-unicode-supported → strip-ansi/node_modules/ansi-regex}/license +1 -1
  122. package/generator-adapter/node_modules/{string-width → strip-ansi}/node_modules/ansi-regex/package.json +6 -12
  123. package/generator-adapter/node_modules/{ora → strip-ansi}/node_modules/ansi-regex/readme.md +22 -4
  124. package/generator-adapter/package.json +3 -3
  125. package/index.js +3 -0
  126. package/index.js.map +1 -1
  127. package/package.json +19 -19
  128. package/status/router.d.ts +49 -0
  129. package/status/router.js +55 -0
  130. package/status/router.js.map +1 -0
  131. package/transports/http.d.ts +1 -2
  132. package/transports/sse.d.ts +2 -2
  133. package/transports/sse.js +2 -5
  134. package/transports/sse.js.map +1 -1
  135. package/transports/websocket.js +53 -17
  136. package/transports/websocket.js.map +1 -1
  137. package/util/settings.d.ts +11 -0
  138. package/util/settings.js +29 -0
  139. package/util/settings.js.map +1 -0
  140. package/generator-adapter/node_modules/@types/node/dom-events.d.ts +0 -124
  141. package/generator-adapter/node_modules/emoji-regex/index.mjs +0 -4
  142. package/generator-adapter/node_modules/ora/node_modules/ansi-regex/index.d.ts +0 -33
  143. package/generator-adapter/node_modules/ora/node_modules/ansi-regex/index.js +0 -10
  144. package/generator-adapter/node_modules/ora/node_modules/ansi-regex/package.json +0 -61
  145. package/generator-adapter/node_modules/ora/node_modules/log-symbols/node_modules/is-unicode-supported/index.d.ts +0 -12
  146. package/generator-adapter/node_modules/ora/node_modules/log-symbols/node_modules/is-unicode-supported/index.js +0 -17
  147. package/generator-adapter/node_modules/ora/node_modules/log-symbols/node_modules/is-unicode-supported/package.json +0 -43
  148. package/generator-adapter/node_modules/ora/node_modules/log-symbols/node_modules/is-unicode-supported/readme.md +0 -35
  149. package/generator-adapter/node_modules/string-width/node_modules/ansi-regex/index.js +0 -10
  150. package/generator-adapter/node_modules/string-width/node_modules/ansi-regex/license +0 -9
  151. package/generator-adapter/node_modules/string-width/node_modules/ansi-regex/readme.md +0 -60
  152. package/generator-adapter/node_modules/wrap-ansi/node_modules/emoji-regex/LICENSE-MIT.txt +0 -20
  153. package/generator-adapter/node_modules/wrap-ansi/node_modules/emoji-regex/README.md +0 -73
  154. package/generator-adapter/node_modules/wrap-ansi/node_modules/emoji-regex/index.d.ts +0 -23
  155. package/generator-adapter/node_modules/wrap-ansi/node_modules/emoji-regex/index.js +0 -6
  156. package/generator-adapter/node_modules/wrap-ansi/node_modules/emoji-regex/package.json +0 -50
  157. /package/generator-adapter/node_modules/{wrap-ansi/node_modules/emoji-regex → emoji-regex}/es2015/index.js +0 -0
  158. /package/generator-adapter/node_modules/{wrap-ansi/node_modules/emoji-regex → emoji-regex}/es2015/text.js +0 -0
  159. /package/generator-adapter/node_modules/{wrap-ansi/node_modules/emoji-regex → emoji-regex}/text.js +0 -0
  160. /package/generator-adapter/node_modules/ora/node_modules/{ansi-regex → chalk}/license +0 -0
@@ -48,6 +48,7 @@ declare module "http" {
48
48
  // incoming headers will never contain number
49
49
  interface IncomingHttpHeaders extends NodeJS.Dict<string | string[]> {
50
50
  accept?: string | undefined;
51
+ "accept-encoding"?: string | undefined;
51
52
  "accept-language"?: string | undefined;
52
53
  "accept-patch"?: string | undefined;
53
54
  "accept-ranges"?: string | undefined;
@@ -94,6 +95,10 @@ declare module "http" {
94
95
  range?: string | undefined;
95
96
  referer?: string | undefined;
96
97
  "retry-after"?: string | undefined;
98
+ "sec-fetch-site"?: string | undefined;
99
+ "sec-fetch-mode"?: string | undefined;
100
+ "sec-fetch-user"?: string | undefined;
101
+ "sec-fetch-dest"?: string | undefined;
97
102
  "sec-websocket-accept"?: string | undefined;
98
103
  "sec-websocket-extensions"?: string | undefined;
99
104
  "sec-websocket-key"?: string | undefined;
@@ -207,7 +212,7 @@ declare module "http" {
207
212
  | undefined;
208
213
  defaultPort?: number | string | undefined;
209
214
  family?: number | undefined;
210
- headers?: OutgoingHttpHeaders | undefined;
215
+ headers?: OutgoingHttpHeaders | readonly string[] | undefined;
211
216
  hints?: LookupOptions["hints"];
212
217
  host?: string | null | undefined;
213
218
  hostname?: string | null | undefined;
@@ -269,6 +274,13 @@ declare module "http" {
269
274
  * @default 30000
270
275
  */
271
276
  connectionsCheckingInterval?: number | undefined;
277
+ /**
278
+ * Sets the timeout value in milliseconds for receiving the complete HTTP headers from the client.
279
+ * See {@link Server.headersTimeout} for more information.
280
+ * @default 60000
281
+ * @since 18.0.0
282
+ */
283
+ headersTimeout?: number | undefined;
272
284
  /**
273
285
  * Optionally overrides all `socket`s' `readableHighWaterMark` and `writableHighWaterMark`.
274
286
  * This affects `highWaterMark` property of both `IncomingMessage` and `ServerResponse`.
@@ -296,6 +308,13 @@ declare module "http" {
296
308
  * @since v16.5.0
297
309
  */
298
310
  noDelay?: boolean | undefined;
311
+ /**
312
+ * If set to `true`, it forces the server to respond with a 400 (Bad Request) status code
313
+ * to any HTTP/1.1 request message that lacks a Host header (as mandated by the specification).
314
+ * @default true
315
+ * @since 20.0.0
316
+ */
317
+ requireHostHeader?: boolean | undefined;
299
318
  /**
300
319
  * If set to `true`, it enables keep-alive functionality on the socket immediately after a new incoming connection is received,
301
320
  * similarly on what is done in `socket.setKeepAlive([enable][, initialDelay])`.
@@ -314,6 +333,12 @@ declare module "http" {
314
333
  * If the header's value is an array, the items will be joined using `; `.
315
334
  */
316
335
  uniqueHeaders?: Array<string | string[]> | undefined;
336
+ /**
337
+ * If set to `true`, an error is thrown when writing to an HTTP response which does not have a body.
338
+ * @default false
339
+ * @since v18.17.0, v20.2.0
340
+ */
341
+ rejectNonStandardBodyWrites?: boolean | undefined;
317
342
  }
318
343
  type RequestListener<
319
344
  Request extends typeof IncomingMessage = typeof IncomingMessage,
@@ -886,7 +911,7 @@ declare module "http" {
886
911
  * the request body should be sent.
887
912
  * @since v10.0.0
888
913
  */
889
- writeProcessing(): void;
914
+ writeProcessing(callback?: () => void): void;
890
915
  }
891
916
  interface InformationEvent {
892
917
  statusCode: number;
@@ -1545,6 +1570,68 @@ declare module "http" {
1545
1570
  * @since v0.11.4
1546
1571
  */
1547
1572
  destroy(): void;
1573
+ /**
1574
+ * Produces a socket/stream to be used for HTTP requests.
1575
+ *
1576
+ * By default, this function is the same as `net.createConnection()`. However,
1577
+ * custom agents may override this method in case greater flexibility is desired.
1578
+ *
1579
+ * A socket/stream can be supplied in one of two ways: by returning the
1580
+ * socket/stream from this function, or by passing the socket/stream to `callback`.
1581
+ *
1582
+ * This method is guaranteed to return an instance of the `net.Socket` class,
1583
+ * a subclass of `stream.Duplex`, unless the user specifies a socket
1584
+ * type other than `net.Socket`.
1585
+ *
1586
+ * `callback` has a signature of `(err, stream)`.
1587
+ * @since v0.11.4
1588
+ * @param options Options containing connection details. Check `createConnection` for the format of the options
1589
+ * @param callback Callback function that receives the created socket
1590
+ */
1591
+ createConnection(
1592
+ options: ClientRequestArgs,
1593
+ callback?: (err: Error | null, stream: stream.Duplex) => void,
1594
+ ): stream.Duplex | null | undefined;
1595
+ /**
1596
+ * Called when `socket` is detached from a request and could be persisted by the`Agent`. Default behavior is to:
1597
+ *
1598
+ * ```js
1599
+ * socket.setKeepAlive(true, this.keepAliveMsecs);
1600
+ * socket.unref();
1601
+ * return true;
1602
+ * ```
1603
+ *
1604
+ * This method can be overridden by a particular `Agent` subclass. If this
1605
+ * method returns a falsy value, the socket will be destroyed instead of persisting
1606
+ * it for use with the next request.
1607
+ *
1608
+ * The `socket` argument can be an instance of `net.Socket`, a subclass of `stream.Duplex`.
1609
+ * @since v8.1.0
1610
+ */
1611
+ keepSocketAlive(socket: stream.Duplex): void;
1612
+ /**
1613
+ * Called when `socket` is attached to `request` after being persisted because of
1614
+ * the keep-alive options. Default behavior is to:
1615
+ *
1616
+ * ```js
1617
+ * socket.ref();
1618
+ * ```
1619
+ *
1620
+ * This method can be overridden by a particular `Agent` subclass.
1621
+ *
1622
+ * The `socket` argument can be an instance of `net.Socket`, a subclass of `stream.Duplex`.
1623
+ * @since v8.1.0
1624
+ */
1625
+ reuseSocket(socket: stream.Duplex, request: ClientRequest): void;
1626
+ /**
1627
+ * Get a unique name for a set of request options, to determine whether a
1628
+ * connection can be reused. For an HTTP agent, this returns`host:port:localAddress` or `host:port:localAddress:family`. For an HTTPS agent,
1629
+ * the name includes the CA, cert, ciphers, and other HTTPS/TLS-specific options
1630
+ * that determine socket reusability.
1631
+ * @since v0.11.4
1632
+ * @param options A set of options providing information for name generation
1633
+ */
1634
+ getName(options?: ClientRequestArgs): string;
1548
1635
  }
1549
1636
  const METHODS: string[];
1550
1637
  const STATUS_CODES: {
@@ -1941,18 +2028,18 @@ declare module "http" {
1941
2028
  */
1942
2029
  const maxHeaderSize: number;
1943
2030
  /**
1944
- * A browser-compatible implementation of [WebSocket](https://nodejs.org/docs/latest/api/http.html#websocket).
2031
+ * A browser-compatible implementation of `WebSocket`.
1945
2032
  * @since v22.5.0
1946
2033
  */
1947
- const WebSocket: import("undici-types").WebSocket;
2034
+ const WebSocket: typeof import("undici-types").WebSocket;
1948
2035
  /**
1949
2036
  * @since v22.5.0
1950
2037
  */
1951
- const CloseEvent: import("undici-types").CloseEvent;
2038
+ const CloseEvent: typeof import("undici-types").CloseEvent;
1952
2039
  /**
1953
2040
  * @since v22.5.0
1954
2041
  */
1955
- const MessageEvent: import("undici-types").MessageEvent;
2042
+ const MessageEvent: typeof import("undici-types").MessageEvent;
1956
2043
  }
1957
2044
  declare module "node:http" {
1958
2045
  export * from "http";
@@ -965,7 +965,10 @@ declare module "http2" {
965
965
  * * `:path` \= `/`
966
966
  * @since v8.4.0
967
967
  */
968
- request(headers?: OutgoingHttpHeaders, options?: ClientSessionRequestOptions): ClientHttp2Stream;
968
+ request(
969
+ headers?: OutgoingHttpHeaders | readonly string[],
970
+ options?: ClientSessionRequestOptions,
971
+ ): ClientHttp2Stream;
969
972
  addListener(event: "altsvc", listener: (alt: string, origin: string, stream: number) => void): this;
970
973
  addListener(event: "origin", listener: (origins: string[]) => void): this;
971
974
  addListener(
@@ -1223,14 +1226,66 @@ declare module "http2" {
1223
1226
  }
1224
1227
  // Http2Server
1225
1228
  export interface SessionOptions {
1229
+ /**
1230
+ * Sets the maximum dynamic table size for deflating header fields.
1231
+ * @default 4Kib
1232
+ */
1226
1233
  maxDeflateDynamicTableSize?: number | undefined;
1234
+ /**
1235
+ * Sets the maximum number of settings entries per `SETTINGS` frame.
1236
+ * The minimum value allowed is `1`.
1237
+ * @default 32
1238
+ */
1239
+ maxSettings?: number | undefined;
1240
+ /**
1241
+ * Sets the maximum memory that the `Http2Session` is permitted to use.
1242
+ * The value is expressed in terms of number of megabytes, e.g. `1` equal 1 megabyte.
1243
+ * The minimum value allowed is `1`.
1244
+ * This is a credit based limit, existing `Http2Stream`s may cause this limit to be exceeded,
1245
+ * but new `Http2Stream` instances will be rejected while this limit is exceeded.
1246
+ * The current number of `Http2Stream` sessions, the current memory use of the header compression tables,
1247
+ * current data queued to be sent, and unacknowledged `PING` and `SETTINGS` frames are all counted towards the current limit.
1248
+ * @default 10
1249
+ */
1227
1250
  maxSessionMemory?: number | undefined;
1251
+ /**
1252
+ * Sets the maximum number of header entries.
1253
+ * This is similar to `server.maxHeadersCount` or `request.maxHeadersCount` in the `node:http` module.
1254
+ * The minimum value is `1`.
1255
+ * @default 128
1256
+ */
1228
1257
  maxHeaderListPairs?: number | undefined;
1258
+ /**
1259
+ * Sets the maximum number of outstanding, unacknowledged pings.
1260
+ * @default 10
1261
+ */
1229
1262
  maxOutstandingPings?: number | undefined;
1263
+ /**
1264
+ * Sets the maximum allowed size for a serialized, compressed block of headers.
1265
+ * Attempts to send headers that exceed this limit will result in
1266
+ * a `'frameError'` event being emitted and the stream being closed and destroyed.
1267
+ */
1230
1268
  maxSendHeaderBlockLength?: number | undefined;
1269
+ /**
1270
+ * Strategy used for determining the amount of padding to use for `HEADERS` and `DATA` frames.
1271
+ * @default http2.constants.PADDING_STRATEGY_NONE
1272
+ */
1231
1273
  paddingStrategy?: number | undefined;
1274
+ /**
1275
+ * Sets the maximum number of concurrent streams for the remote peer as if a `SETTINGS` frame had been received.
1276
+ * Will be overridden if the remote peer sets its own value for `maxConcurrentStreams`.
1277
+ * @default 100
1278
+ */
1232
1279
  peerMaxConcurrentStreams?: number | undefined;
1280
+ /**
1281
+ * The initial settings to send to the remote peer upon connection.
1282
+ */
1233
1283
  settings?: Settings | undefined;
1284
+ /**
1285
+ * The array of integer values determines the settings types,
1286
+ * which are included in the `CustomSettings`-property of the received remoteSettings.
1287
+ * Please see the `CustomSettings`-property of the `Http2Settings` object for more information, on the allowed setting types.
1288
+ */
1234
1289
  remoteCustomSettings?: number[] | undefined;
1235
1290
  /**
1236
1291
  * Specifies a timeout in milliseconds that
@@ -1239,11 +1294,35 @@ declare module "http2" {
1239
1294
  * @default 100000
1240
1295
  */
1241
1296
  unknownProtocolTimeout?: number | undefined;
1242
- selectPadding?(frameLen: number, maxFrameLen: number): number;
1297
+ /**
1298
+ * If `true`, it turns on strict leading
1299
+ * and trailing whitespace validation for HTTP/2 header field names and values
1300
+ * as per [RFC-9113](https://www.rfc-editor.org/rfc/rfc9113.html#section-8.2.1).
1301
+ * @since v24.2.0
1302
+ * @default true
1303
+ */
1304
+ strictFieldWhitespaceValidation?: boolean | undefined;
1243
1305
  }
1244
1306
  export interface ClientSessionOptions extends SessionOptions {
1307
+ /**
1308
+ * Sets the maximum number of reserved push streams the client will accept at any given time.
1309
+ * Once the current number of currently reserved push streams exceeds reaches this limit,
1310
+ * new push streams sent by the server will be automatically rejected.
1311
+ * The minimum allowed value is 0. The maximum allowed value is 2<sup>32</sup>-1.
1312
+ * A negative value sets this option to the maximum allowed value.
1313
+ * @default 200
1314
+ */
1245
1315
  maxReservedRemoteStreams?: number | undefined;
1316
+ /**
1317
+ * An optional callback that receives the `URL` instance passed to `connect` and the `options` object,
1318
+ * and returns any `Duplex` stream that is to be used as the connection for this session.
1319
+ */
1246
1320
  createConnection?: ((authority: url.URL, option: SessionOptions) => stream.Duplex) | undefined;
1321
+ /**
1322
+ * The protocol to connect with, if not set in the `authority`.
1323
+ * Value may be either `'http:'` or `'https:'`.
1324
+ * @default 'https:'
1325
+ */
1247
1326
  protocol?: "http:" | "https:" | undefined;
1248
1327
  }
1249
1328
  export interface ServerSessionOptions<
@@ -32,6 +32,11 @@ declare module "https" {
32
32
  class Agent extends http.Agent {
33
33
  constructor(options?: AgentOptions);
34
34
  options: AgentOptions;
35
+ createConnection(
36
+ options: RequestOptions,
37
+ callback?: (err: Error | null, stream: Duplex) => void,
38
+ ): Duplex | null | undefined;
39
+ getName(options?: RequestOptions): string;
35
40
  }
36
41
  interface Server<
37
42
  Request extends typeof http.IncomingMessage = typeof http.IncomingMessage,
@@ -36,6 +36,12 @@
36
36
 
37
37
  // Definitions for Node.js modules that are not specific to any version of TypeScript:
38
38
  /// <reference path="globals.d.ts" />
39
+ /// <reference path="web-globals/abortcontroller.d.ts" />
40
+ /// <reference path="web-globals/domexception.d.ts" />
41
+ /// <reference path="web-globals/events.d.ts" />
42
+ /// <reference path="web-globals/fetch.d.ts" />
43
+ /// <reference path="web-globals/navigator.d.ts" />
44
+ /// <reference path="web-globals/storage.d.ts" />
39
45
  /// <reference path="assert.d.ts" />
40
46
  /// <reference path="assert/strict.d.ts" />
41
47
  /// <reference path="async_hooks.d.ts" />
@@ -49,16 +55,14 @@
49
55
  /// <reference path="diagnostics_channel.d.ts" />
50
56
  /// <reference path="dns.d.ts" />
51
57
  /// <reference path="dns/promises.d.ts" />
52
- /// <reference path="dns/promises.d.ts" />
53
58
  /// <reference path="domain.d.ts" />
54
- /// <reference path="dom-events.d.ts" />
55
59
  /// <reference path="events.d.ts" />
56
60
  /// <reference path="fs.d.ts" />
57
61
  /// <reference path="fs/promises.d.ts" />
58
62
  /// <reference path="http.d.ts" />
59
63
  /// <reference path="http2.d.ts" />
60
64
  /// <reference path="https.d.ts" />
61
- /// <reference path="inspector.d.ts" />
65
+ /// <reference path="inspector.generated.d.ts" />
62
66
  /// <reference path="module.d.ts" />
63
67
  /// <reference path="net.d.ts" />
64
68
  /// <reference path="os.d.ts" />