@types/node 22.15.21 → 22.19.3

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 (80) hide show
  1. node v22.19/README.md +15 -0
  2. node v22.19/assert/strict.d.ts +111 -0
  3. node/assert.d.ts → node v22.19/assert.d.ts +119 -95
  4. node/buffer.buffer.d.ts → node v22.19/buffer.buffer.d.ts +9 -0
  5. node/buffer.d.ts → node v22.19/buffer.d.ts +14 -6
  6. node/child_process.d.ts → node v22.19/child_process.d.ts +89 -162
  7. node/cluster.d.ts → node v22.19/cluster.d.ts +4 -5
  8. node/compatibility/disposable.d.ts → node v22.19/compatibility/disposable.d.ts +0 -2
  9. node/compatibility/indexable.d.ts → node v22.19/compatibility/indexable.d.ts +0 -3
  10. node/compatibility/iterators.d.ts → node v22.19/compatibility/iterators.d.ts +0 -1
  11. node/crypto.d.ts → node v22.19/crypto.d.ts +203 -167
  12. node/dgram.d.ts → node v22.19/dgram.d.ts +9 -8
  13. node/diagnostics_channel.d.ts → node v22.19/diagnostics_channel.d.ts +17 -12
  14. node/dns/promises.d.ts → node v22.19/dns/promises.d.ts +36 -9
  15. node/dns.d.ts → node v22.19/dns.d.ts +79 -21
  16. node/events.d.ts → node v22.19/events.d.ts +80 -35
  17. node/fs/promises.d.ts → node v22.19/fs/promises.d.ts +81 -58
  18. node/fs.d.ts → node v22.19/fs.d.ts +154 -130
  19. node v22.19/globals.d.ts +172 -0
  20. node v22.19/globals.typedarray.d.ts +38 -0
  21. node/http.d.ts → node v22.19/http.d.ts +140 -35
  22. node/http2.d.ts → node v22.19/http2.d.ts +114 -27
  23. node/https.d.ts → node v22.19/https.d.ts +96 -62
  24. node/index.d.ts → node v22.19/index.d.ts +7 -2
  25. node v22.19/inspector.d.ts +253 -0
  26. node/inspector.d.ts → node v22.19/inspector.generated.d.ts +880 -830
  27. node/module.d.ts → node v22.19/module.d.ts +136 -17
  28. node/net.d.ts → node v22.19/net.d.ts +33 -11
  29. node/os.d.ts → node v22.19/os.d.ts +14 -3
  30. node/package.json → node v22.19/package.json +3 -83
  31. node/path.d.ts → node v22.19/path.d.ts +1 -1
  32. node/perf_hooks.d.ts → node v22.19/perf_hooks.d.ts +8 -10
  33. node/process.d.ts → node v22.19/process.d.ts +39 -27
  34. node/readline/promises.d.ts → node v22.19/readline/promises.d.ts +1 -2
  35. node/repl.d.ts → node v22.19/repl.d.ts +3 -5
  36. node/sqlite.d.ts → node v22.19/sqlite.d.ts +219 -6
  37. node/stream/consumers.d.ts → node v22.19/stream/consumers.d.ts +2 -2
  38. node/stream/web.d.ts → node v22.19/stream/web.d.ts +8 -0
  39. node/stream.d.ts → node v22.19/stream.d.ts +34 -32
  40. node/string_decoder.d.ts → node v22.19/string_decoder.d.ts +2 -2
  41. node v22.19/test.d.ts +2162 -0
  42. node/tls.d.ts → node v22.19/tls.d.ts +122 -66
  43. node/ts5.6/buffer.buffer.d.ts → node v22.19/ts5.6/buffer.buffer.d.ts +10 -2
  44. node v22.19/ts5.6/globals.typedarray.d.ts +34 -0
  45. node/ts5.6/index.d.ts → node v22.19/ts5.6/index.d.ts +7 -2
  46. node/url.d.ts → node v22.19/url.d.ts +21 -9
  47. node/util.d.ts → node v22.19/util.d.ts +33 -11
  48. node/v8.d.ts → node v22.19/v8.d.ts +66 -35
  49. node/vm.d.ts → node v22.19/vm.d.ts +65 -56
  50. node/wasi.d.ts → node v22.19/wasi.d.ts +1 -1
  51. node v22.19/web-globals/abortcontroller.d.ts +34 -0
  52. node v22.19/web-globals/domexception.d.ts +68 -0
  53. node v22.19/web-globals/events.d.ts +97 -0
  54. node v22.19/web-globals/fetch.d.ts +46 -0
  55. node v22.19/web-globals/navigator.d.ts +22 -0
  56. node v22.19/web-globals/storage.d.ts +24 -0
  57. node/worker_threads.d.ts → node v22.19/worker_threads.d.ts +112 -74
  58. node/zlib.d.ts → node v22.19/zlib.d.ts +39 -26
  59. node/README.md +0 -15
  60. node/assert/strict.d.ts +0 -8
  61. node/dom-events.d.ts +0 -124
  62. node/globals.d.ts +0 -371
  63. node/globals.typedarray.d.ts +0 -21
  64. node/test.d.ts +0 -2280
  65. node/ts5.6/globals.typedarray.d.ts +0 -19
  66. {node → node v22.19}/LICENSE +0 -0
  67. node/async_hooks.d.ts → node v22.19/async_hooks.d.ts +1 -1
  68. {node → node v22.19}/compatibility/index.d.ts +0 -0
  69. {node → node v22.19}/console.d.ts +0 -0
  70. {node → node v22.19}/constants.d.ts +0 -0
  71. {node → node v22.19}/domain.d.ts +0 -0
  72. {node → node v22.19}/punycode.d.ts +0 -0
  73. {node → node v22.19}/querystring.d.ts +0 -0
  74. {node → node v22.19}/readline.d.ts +0 -0
  75. {node → node v22.19}/sea.d.ts +0 -0
  76. {node → node v22.19}/stream/promises.d.ts +0 -0
  77. {node → node v22.19}/timers/promises.d.ts +0 -0
  78. {node → node v22.19}/timers.d.ts +0 -0
  79. {node → node v22.19}/trace_events.d.ts +0 -0
  80. {node → node v22.19}/tty.d.ts +0 -0
@@ -9,6 +9,7 @@
9
9
  * @see [source](https://github.com/nodejs/node/blob/v22.x/lib/http2.js)
10
10
  */
11
11
  declare module "http2" {
12
+ import { NonSharedBuffer } from "node:buffer";
12
13
  import EventEmitter = require("node:events");
13
14
  import * as fs from "node:fs";
14
15
  import * as net from "node:net";
@@ -55,14 +56,15 @@ declare module "http2" {
55
56
  length: number;
56
57
  }
57
58
  export interface ServerStreamFileResponseOptions {
58
- // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
59
- statCheck?(stats: fs.Stats, headers: OutgoingHttpHeaders, statOptions: StatOptions): void | boolean;
59
+ statCheck?:
60
+ | ((stats: fs.Stats, headers: OutgoingHttpHeaders, statOptions: StatOptions) => void)
61
+ | undefined;
60
62
  waitForTrailers?: boolean | undefined;
61
63
  offset?: number | undefined;
62
64
  length?: number | undefined;
63
65
  }
64
66
  export interface ServerStreamFileResponseOptionsWithError extends ServerStreamFileResponseOptions {
65
- onError?(err: NodeJS.ErrnoException): void;
67
+ onError?: ((err: NodeJS.ErrnoException) => void) | undefined;
66
68
  }
67
69
  export interface Http2Stream extends stream.Duplex {
68
70
  /**
@@ -195,7 +197,7 @@ declare module "http2" {
195
197
  sendTrailers(headers: OutgoingHttpHeaders): void;
196
198
  addListener(event: "aborted", listener: () => void): this;
197
199
  addListener(event: "close", listener: () => void): this;
198
- addListener(event: "data", listener: (chunk: Buffer | string) => void): this;
200
+ addListener(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
199
201
  addListener(event: "drain", listener: () => void): this;
200
202
  addListener(event: "end", listener: () => void): this;
201
203
  addListener(event: "error", listener: (err: Error) => void): this;
@@ -210,7 +212,7 @@ declare module "http2" {
210
212
  addListener(event: string | symbol, listener: (...args: any[]) => void): this;
211
213
  emit(event: "aborted"): boolean;
212
214
  emit(event: "close"): boolean;
213
- emit(event: "data", chunk: Buffer | string): boolean;
215
+ emit(event: "data", chunk: NonSharedBuffer | string): boolean;
214
216
  emit(event: "drain"): boolean;
215
217
  emit(event: "end"): boolean;
216
218
  emit(event: "error", err: Error): boolean;
@@ -225,7 +227,7 @@ declare module "http2" {
225
227
  emit(event: string | symbol, ...args: any[]): boolean;
226
228
  on(event: "aborted", listener: () => void): this;
227
229
  on(event: "close", listener: () => void): this;
228
- on(event: "data", listener: (chunk: Buffer | string) => void): this;
230
+ on(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
229
231
  on(event: "drain", listener: () => void): this;
230
232
  on(event: "end", listener: () => void): this;
231
233
  on(event: "error", listener: (err: Error) => void): this;
@@ -240,7 +242,7 @@ declare module "http2" {
240
242
  on(event: string | symbol, listener: (...args: any[]) => void): this;
241
243
  once(event: "aborted", listener: () => void): this;
242
244
  once(event: "close", listener: () => void): this;
243
- once(event: "data", listener: (chunk: Buffer | string) => void): this;
245
+ once(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
244
246
  once(event: "drain", listener: () => void): this;
245
247
  once(event: "end", listener: () => void): this;
246
248
  once(event: "error", listener: (err: Error) => void): this;
@@ -255,7 +257,7 @@ declare module "http2" {
255
257
  once(event: string | symbol, listener: (...args: any[]) => void): this;
256
258
  prependListener(event: "aborted", listener: () => void): this;
257
259
  prependListener(event: "close", listener: () => void): this;
258
- prependListener(event: "data", listener: (chunk: Buffer | string) => void): this;
260
+ prependListener(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
259
261
  prependListener(event: "drain", listener: () => void): this;
260
262
  prependListener(event: "end", listener: () => void): this;
261
263
  prependListener(event: "error", listener: (err: Error) => void): this;
@@ -270,7 +272,7 @@ declare module "http2" {
270
272
  prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
271
273
  prependOnceListener(event: "aborted", listener: () => void): this;
272
274
  prependOnceListener(event: "close", listener: () => void): this;
273
- prependOnceListener(event: "data", listener: (chunk: Buffer | string) => void): this;
275
+ prependOnceListener(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
274
276
  prependOnceListener(event: "drain", listener: () => void): this;
275
277
  prependOnceListener(event: "end", listener: () => void): this;
276
278
  prependOnceListener(event: "error", listener: (err: Error) => void): this;
@@ -789,10 +791,10 @@ declare module "http2" {
789
791
  * @since v8.9.3
790
792
  * @param payload Optional ping payload.
791
793
  */
792
- ping(callback: (err: Error | null, duration: number, payload: Buffer) => void): boolean;
794
+ ping(callback: (err: Error | null, duration: number, payload: NonSharedBuffer) => void): boolean;
793
795
  ping(
794
796
  payload: NodeJS.ArrayBufferView,
795
- callback: (err: Error | null, duration: number, payload: Buffer) => void,
797
+ callback: (err: Error | null, duration: number, payload: NonSharedBuffer) => void,
796
798
  ): boolean;
797
799
  /**
798
800
  * Calls `ref()` on this `Http2Session` instance's underlying `net.Socket`.
@@ -854,7 +856,7 @@ declare module "http2" {
854
856
  ): this;
855
857
  addListener(
856
858
  event: "goaway",
857
- listener: (errorCode: number, lastStreamID: number, opaqueData?: Buffer) => void,
859
+ listener: (errorCode: number, lastStreamID: number, opaqueData?: NonSharedBuffer) => void,
858
860
  ): this;
859
861
  addListener(event: "localSettings", listener: (settings: Settings) => void): this;
860
862
  addListener(event: "ping", listener: () => void): this;
@@ -864,7 +866,7 @@ declare module "http2" {
864
866
  emit(event: "close"): boolean;
865
867
  emit(event: "error", err: Error): boolean;
866
868
  emit(event: "frameError", frameType: number, errorCode: number, streamID: number): boolean;
867
- emit(event: "goaway", errorCode: number, lastStreamID: number, opaqueData?: Buffer): boolean;
869
+ emit(event: "goaway", errorCode: number, lastStreamID: number, opaqueData?: NonSharedBuffer): boolean;
868
870
  emit(event: "localSettings", settings: Settings): boolean;
869
871
  emit(event: "ping"): boolean;
870
872
  emit(event: "remoteSettings", settings: Settings): boolean;
@@ -873,7 +875,10 @@ declare module "http2" {
873
875
  on(event: "close", listener: () => void): this;
874
876
  on(event: "error", listener: (err: Error) => void): this;
875
877
  on(event: "frameError", listener: (frameType: number, errorCode: number, streamID: number) => void): this;
876
- on(event: "goaway", listener: (errorCode: number, lastStreamID: number, opaqueData?: Buffer) => void): this;
878
+ on(
879
+ event: "goaway",
880
+ listener: (errorCode: number, lastStreamID: number, opaqueData?: NonSharedBuffer) => void,
881
+ ): this;
877
882
  on(event: "localSettings", listener: (settings: Settings) => void): this;
878
883
  on(event: "ping", listener: () => void): this;
879
884
  on(event: "remoteSettings", listener: (settings: Settings) => void): this;
@@ -882,7 +887,10 @@ declare module "http2" {
882
887
  once(event: "close", listener: () => void): this;
883
888
  once(event: "error", listener: (err: Error) => void): this;
884
889
  once(event: "frameError", listener: (frameType: number, errorCode: number, streamID: number) => void): this;
885
- once(event: "goaway", listener: (errorCode: number, lastStreamID: number, opaqueData?: Buffer) => void): this;
890
+ once(
891
+ event: "goaway",
892
+ listener: (errorCode: number, lastStreamID: number, opaqueData?: NonSharedBuffer) => void,
893
+ ): this;
886
894
  once(event: "localSettings", listener: (settings: Settings) => void): this;
887
895
  once(event: "ping", listener: () => void): this;
888
896
  once(event: "remoteSettings", listener: (settings: Settings) => void): this;
@@ -896,7 +904,7 @@ declare module "http2" {
896
904
  ): this;
897
905
  prependListener(
898
906
  event: "goaway",
899
- listener: (errorCode: number, lastStreamID: number, opaqueData?: Buffer) => void,
907
+ listener: (errorCode: number, lastStreamID: number, opaqueData?: NonSharedBuffer) => void,
900
908
  ): this;
901
909
  prependListener(event: "localSettings", listener: (settings: Settings) => void): this;
902
910
  prependListener(event: "ping", listener: () => void): this;
@@ -911,7 +919,7 @@ declare module "http2" {
911
919
  ): this;
912
920
  prependOnceListener(
913
921
  event: "goaway",
914
- listener: (errorCode: number, lastStreamID: number, opaqueData?: Buffer) => void,
922
+ listener: (errorCode: number, lastStreamID: number, opaqueData?: NonSharedBuffer) => void,
915
923
  ): this;
916
924
  prependOnceListener(event: "localSettings", listener: (settings: Settings) => void): this;
917
925
  prependOnceListener(event: "ping", listener: () => void): this;
@@ -965,7 +973,10 @@ declare module "http2" {
965
973
  * * `:path` \= `/`
966
974
  * @since v8.4.0
967
975
  */
968
- request(headers?: OutgoingHttpHeaders, options?: ClientSessionRequestOptions): ClientHttp2Stream;
976
+ request(
977
+ headers?: OutgoingHttpHeaders | readonly string[],
978
+ options?: ClientSessionRequestOptions,
979
+ ): ClientHttp2Stream;
969
980
  addListener(event: "altsvc", listener: (alt: string, origin: string, stream: number) => void): this;
970
981
  addListener(event: "origin", listener: (origins: string[]) => void): this;
971
982
  addListener(
@@ -1223,14 +1234,66 @@ declare module "http2" {
1223
1234
  }
1224
1235
  // Http2Server
1225
1236
  export interface SessionOptions {
1237
+ /**
1238
+ * Sets the maximum dynamic table size for deflating header fields.
1239
+ * @default 4Kib
1240
+ */
1226
1241
  maxDeflateDynamicTableSize?: number | undefined;
1242
+ /**
1243
+ * Sets the maximum number of settings entries per `SETTINGS` frame.
1244
+ * The minimum value allowed is `1`.
1245
+ * @default 32
1246
+ */
1247
+ maxSettings?: number | undefined;
1248
+ /**
1249
+ * Sets the maximum memory that the `Http2Session` is permitted to use.
1250
+ * The value is expressed in terms of number of megabytes, e.g. `1` equal 1 megabyte.
1251
+ * The minimum value allowed is `1`.
1252
+ * This is a credit based limit, existing `Http2Stream`s may cause this limit to be exceeded,
1253
+ * but new `Http2Stream` instances will be rejected while this limit is exceeded.
1254
+ * The current number of `Http2Stream` sessions, the current memory use of the header compression tables,
1255
+ * current data queued to be sent, and unacknowledged `PING` and `SETTINGS` frames are all counted towards the current limit.
1256
+ * @default 10
1257
+ */
1227
1258
  maxSessionMemory?: number | undefined;
1259
+ /**
1260
+ * Sets the maximum number of header entries.
1261
+ * This is similar to `server.maxHeadersCount` or `request.maxHeadersCount` in the `node:http` module.
1262
+ * The minimum value is `1`.
1263
+ * @default 128
1264
+ */
1228
1265
  maxHeaderListPairs?: number | undefined;
1266
+ /**
1267
+ * Sets the maximum number of outstanding, unacknowledged pings.
1268
+ * @default 10
1269
+ */
1229
1270
  maxOutstandingPings?: number | undefined;
1271
+ /**
1272
+ * Sets the maximum allowed size for a serialized, compressed block of headers.
1273
+ * Attempts to send headers that exceed this limit will result in
1274
+ * a `'frameError'` event being emitted and the stream being closed and destroyed.
1275
+ */
1230
1276
  maxSendHeaderBlockLength?: number | undefined;
1277
+ /**
1278
+ * Strategy used for determining the amount of padding to use for `HEADERS` and `DATA` frames.
1279
+ * @default http2.constants.PADDING_STRATEGY_NONE
1280
+ */
1231
1281
  paddingStrategy?: number | undefined;
1282
+ /**
1283
+ * Sets the maximum number of concurrent streams for the remote peer as if a `SETTINGS` frame had been received.
1284
+ * Will be overridden if the remote peer sets its own value for `maxConcurrentStreams`.
1285
+ * @default 100
1286
+ */
1232
1287
  peerMaxConcurrentStreams?: number | undefined;
1288
+ /**
1289
+ * The initial settings to send to the remote peer upon connection.
1290
+ */
1233
1291
  settings?: Settings | undefined;
1292
+ /**
1293
+ * The array of integer values determines the settings types,
1294
+ * which are included in the `CustomSettings`-property of the received remoteSettings.
1295
+ * Please see the `CustomSettings`-property of the `Http2Settings` object for more information, on the allowed setting types.
1296
+ */
1234
1297
  remoteCustomSettings?: number[] | undefined;
1235
1298
  /**
1236
1299
  * Specifies a timeout in milliseconds that
@@ -1239,11 +1302,35 @@ declare module "http2" {
1239
1302
  * @default 100000
1240
1303
  */
1241
1304
  unknownProtocolTimeout?: number | undefined;
1242
- selectPadding?(frameLen: number, maxFrameLen: number): number;
1305
+ /**
1306
+ * If `true`, it turns on strict leading
1307
+ * and trailing whitespace validation for HTTP/2 header field names and values
1308
+ * as per [RFC-9113](https://www.rfc-editor.org/rfc/rfc9113.html#section-8.2.1).
1309
+ * @since v24.2.0
1310
+ * @default true
1311
+ */
1312
+ strictFieldWhitespaceValidation?: boolean | undefined;
1243
1313
  }
1244
1314
  export interface ClientSessionOptions extends SessionOptions {
1315
+ /**
1316
+ * Sets the maximum number of reserved push streams the client will accept at any given time.
1317
+ * Once the current number of currently reserved push streams exceeds reaches this limit,
1318
+ * new push streams sent by the server will be automatically rejected.
1319
+ * The minimum allowed value is 0. The maximum allowed value is 2<sup>32</sup>-1.
1320
+ * A negative value sets this option to the maximum allowed value.
1321
+ * @default 200
1322
+ */
1245
1323
  maxReservedRemoteStreams?: number | undefined;
1324
+ /**
1325
+ * An optional callback that receives the `URL` instance passed to `connect` and the `options` object,
1326
+ * and returns any `Duplex` stream that is to be used as the connection for this session.
1327
+ */
1246
1328
  createConnection?: ((authority: url.URL, option: SessionOptions) => stream.Duplex) | undefined;
1329
+ /**
1330
+ * The protocol to connect with, if not set in the `authority`.
1331
+ * Value may be either `'http:'` or `'https:'`.
1332
+ * @default 'https:'
1333
+ */
1247
1334
  protocol?: "http:" | "https:" | undefined;
1248
1335
  }
1249
1336
  export interface ServerSessionOptions<
@@ -1724,45 +1811,45 @@ declare module "http2" {
1724
1811
  * @since v8.4.0
1725
1812
  */
1726
1813
  setTimeout(msecs: number, callback?: () => void): void;
1727
- read(size?: number): Buffer | string | null;
1814
+ read(size?: number): NonSharedBuffer | string | null;
1728
1815
  addListener(event: "aborted", listener: (hadError: boolean, code: number) => void): this;
1729
1816
  addListener(event: "close", listener: () => void): this;
1730
- addListener(event: "data", listener: (chunk: Buffer | string) => void): this;
1817
+ addListener(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
1731
1818
  addListener(event: "end", listener: () => void): this;
1732
1819
  addListener(event: "readable", listener: () => void): this;
1733
1820
  addListener(event: "error", listener: (err: Error) => void): this;
1734
1821
  addListener(event: string | symbol, listener: (...args: any[]) => void): this;
1735
1822
  emit(event: "aborted", hadError: boolean, code: number): boolean;
1736
1823
  emit(event: "close"): boolean;
1737
- emit(event: "data", chunk: Buffer | string): boolean;
1824
+ emit(event: "data", chunk: NonSharedBuffer | string): boolean;
1738
1825
  emit(event: "end"): boolean;
1739
1826
  emit(event: "readable"): boolean;
1740
1827
  emit(event: "error", err: Error): boolean;
1741
1828
  emit(event: string | symbol, ...args: any[]): boolean;
1742
1829
  on(event: "aborted", listener: (hadError: boolean, code: number) => void): this;
1743
1830
  on(event: "close", listener: () => void): this;
1744
- on(event: "data", listener: (chunk: Buffer | string) => void): this;
1831
+ on(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
1745
1832
  on(event: "end", listener: () => void): this;
1746
1833
  on(event: "readable", listener: () => void): this;
1747
1834
  on(event: "error", listener: (err: Error) => void): this;
1748
1835
  on(event: string | symbol, listener: (...args: any[]) => void): this;
1749
1836
  once(event: "aborted", listener: (hadError: boolean, code: number) => void): this;
1750
1837
  once(event: "close", listener: () => void): this;
1751
- once(event: "data", listener: (chunk: Buffer | string) => void): this;
1838
+ once(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
1752
1839
  once(event: "end", listener: () => void): this;
1753
1840
  once(event: "readable", listener: () => void): this;
1754
1841
  once(event: "error", listener: (err: Error) => void): this;
1755
1842
  once(event: string | symbol, listener: (...args: any[]) => void): this;
1756
1843
  prependListener(event: "aborted", listener: (hadError: boolean, code: number) => void): this;
1757
1844
  prependListener(event: "close", listener: () => void): this;
1758
- prependListener(event: "data", listener: (chunk: Buffer | string) => void): this;
1845
+ prependListener(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
1759
1846
  prependListener(event: "end", listener: () => void): this;
1760
1847
  prependListener(event: "readable", listener: () => void): this;
1761
1848
  prependListener(event: "error", listener: (err: Error) => void): this;
1762
1849
  prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
1763
1850
  prependOnceListener(event: "aborted", listener: (hadError: boolean, code: number) => void): this;
1764
1851
  prependOnceListener(event: "close", listener: () => void): this;
1765
- prependOnceListener(event: "data", listener: (chunk: Buffer | string) => void): this;
1852
+ prependOnceListener(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
1766
1853
  prependOnceListener(event: "end", listener: () => void): this;
1767
1854
  prependOnceListener(event: "readable", listener: () => void): this;
1768
1855
  prependOnceListener(event: "error", listener: (err: Error) => void): this;
@@ -2422,7 +2509,7 @@ declare module "http2" {
2422
2509
  * ```
2423
2510
  * @since v8.4.0
2424
2511
  */
2425
- export function getPackedSettings(settings: Settings): Buffer;
2512
+ export function getPackedSettings(settings: Settings): NonSharedBuffer;
2426
2513
  /**
2427
2514
  * Returns a `HTTP/2 Settings Object` containing the deserialized settings from
2428
2515
  * the given `Buffer` as generated by `http2.getPackedSettings()`.
@@ -4,24 +4,22 @@
4
4
  * @see [source](https://github.com/nodejs/node/blob/v22.x/lib/https.js)
5
5
  */
6
6
  declare module "https" {
7
+ import { NonSharedBuffer } from "node:buffer";
7
8
  import { Duplex } from "node:stream";
8
9
  import * as tls from "node:tls";
9
10
  import * as http from "node:http";
10
11
  import { URL } from "node:url";
11
- type ServerOptions<
12
+ interface ServerOptions<
12
13
  Request extends typeof http.IncomingMessage = typeof http.IncomingMessage,
13
14
  Response extends typeof http.ServerResponse<InstanceType<Request>> = typeof http.ServerResponse,
14
- > = tls.SecureContextOptions & tls.TlsOptions & http.ServerOptions<Request, Response>;
15
- type RequestOptions =
16
- & http.RequestOptions
17
- & tls.SecureContextOptions
18
- & {
19
- checkServerIdentity?:
20
- | ((hostname: string, cert: tls.DetailedPeerCertificate) => Error | undefined)
21
- | undefined;
22
- rejectUnauthorized?: boolean | undefined; // Defaults to true
23
- servername?: string | undefined; // SNI TLS Extension
24
- };
15
+ > extends http.ServerOptions<Request, Response>, tls.TlsOptions {}
16
+ interface RequestOptions extends http.RequestOptions, tls.SecureContextOptions {
17
+ checkServerIdentity?:
18
+ | ((hostname: string, cert: tls.DetailedPeerCertificate) => Error | undefined)
19
+ | undefined;
20
+ rejectUnauthorized?: boolean | undefined; // Defaults to true
21
+ servername?: string | undefined; // SNI TLS Extension
22
+ }
25
23
  interface AgentOptions extends http.AgentOptions, tls.ConnectionOptions {
26
24
  maxCachedSessions?: number | undefined;
27
25
  }
@@ -32,6 +30,11 @@ declare module "https" {
32
30
  class Agent extends http.Agent {
33
31
  constructor(options?: AgentOptions);
34
32
  options: AgentOptions;
33
+ createConnection(
34
+ options: RequestOptions,
35
+ callback?: (err: Error | null, stream: Duplex) => void,
36
+ ): Duplex | null | undefined;
37
+ getName(options?: RequestOptions): string;
35
38
  }
36
39
  interface Server<
37
40
  Request extends typeof http.IncomingMessage = typeof http.IncomingMessage,
@@ -61,22 +64,25 @@ declare module "https" {
61
64
  */
62
65
  closeIdleConnections(): void;
63
66
  addListener(event: string, listener: (...args: any[]) => void): this;
64
- addListener(event: "keylog", listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
67
+ addListener(event: "keylog", listener: (line: NonSharedBuffer, tlsSocket: tls.TLSSocket) => void): this;
65
68
  addListener(
66
69
  event: "newSession",
67
- listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
70
+ listener: (sessionId: NonSharedBuffer, sessionData: NonSharedBuffer, callback: () => void) => void,
68
71
  ): this;
69
72
  addListener(
70
73
  event: "OCSPRequest",
71
74
  listener: (
72
- certificate: Buffer,
73
- issuer: Buffer,
74
- callback: (err: Error | null, resp: Buffer) => void,
75
+ certificate: NonSharedBuffer,
76
+ issuer: NonSharedBuffer,
77
+ callback: (err: Error | null, resp: Buffer | null) => void,
75
78
  ) => void,
76
79
  ): this;
77
80
  addListener(
78
81
  event: "resumeSession",
79
- listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
82
+ listener: (
83
+ sessionId: NonSharedBuffer,
84
+ callback: (err: Error | null, sessionData: Buffer | null) => void,
85
+ ) => void,
80
86
  ): this;
81
87
  addListener(event: "secureConnection", listener: (tlsSocket: tls.TLSSocket) => void): this;
82
88
  addListener(event: "tlsClientError", listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
@@ -89,28 +95,32 @@ declare module "https" {
89
95
  addListener(event: "clientError", listener: (err: Error, socket: Duplex) => void): this;
90
96
  addListener(
91
97
  event: "connect",
92
- listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
98
+ listener: (req: InstanceType<Request>, socket: Duplex, head: NonSharedBuffer) => void,
93
99
  ): this;
94
100
  addListener(event: "request", listener: http.RequestListener<Request, Response>): this;
95
101
  addListener(
96
102
  event: "upgrade",
97
- listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
103
+ listener: (req: InstanceType<Request>, socket: Duplex, head: NonSharedBuffer) => void,
98
104
  ): this;
99
105
  emit(event: string, ...args: any[]): boolean;
100
- emit(event: "keylog", line: Buffer, tlsSocket: tls.TLSSocket): boolean;
106
+ emit(event: "keylog", line: NonSharedBuffer, tlsSocket: tls.TLSSocket): boolean;
101
107
  emit(
102
108
  event: "newSession",
103
- sessionId: Buffer,
104
- sessionData: Buffer,
105
- callback: (err: Error, resp: Buffer) => void,
109
+ sessionId: NonSharedBuffer,
110
+ sessionData: NonSharedBuffer,
111
+ callback: () => void,
106
112
  ): boolean;
107
113
  emit(
108
114
  event: "OCSPRequest",
109
- certificate: Buffer,
110
- issuer: Buffer,
111
- callback: (err: Error | null, resp: Buffer) => void,
115
+ certificate: NonSharedBuffer,
116
+ issuer: NonSharedBuffer,
117
+ callback: (err: Error | null, resp: Buffer | null) => void,
118
+ ): boolean;
119
+ emit(
120
+ event: "resumeSession",
121
+ sessionId: NonSharedBuffer,
122
+ callback: (err: Error | null, sessionData: Buffer | null) => void,
112
123
  ): boolean;
113
- emit(event: "resumeSession", sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void): boolean;
114
124
  emit(event: "secureConnection", tlsSocket: tls.TLSSocket): boolean;
115
125
  emit(event: "tlsClientError", err: Error, tlsSocket: tls.TLSSocket): boolean;
116
126
  emit(event: "close"): boolean;
@@ -128,30 +138,33 @@ declare module "https" {
128
138
  res: InstanceType<Response>,
129
139
  ): boolean;
130
140
  emit(event: "clientError", err: Error, socket: Duplex): boolean;
131
- emit(event: "connect", req: InstanceType<Request>, socket: Duplex, head: Buffer): boolean;
141
+ emit(event: "connect", req: InstanceType<Request>, socket: Duplex, head: NonSharedBuffer): boolean;
132
142
  emit(
133
143
  event: "request",
134
144
  req: InstanceType<Request>,
135
145
  res: InstanceType<Response>,
136
146
  ): boolean;
137
- emit(event: "upgrade", req: InstanceType<Request>, socket: Duplex, head: Buffer): boolean;
147
+ emit(event: "upgrade", req: InstanceType<Request>, socket: Duplex, head: NonSharedBuffer): boolean;
138
148
  on(event: string, listener: (...args: any[]) => void): this;
139
- on(event: "keylog", listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
149
+ on(event: "keylog", listener: (line: NonSharedBuffer, tlsSocket: tls.TLSSocket) => void): this;
140
150
  on(
141
151
  event: "newSession",
142
- listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
152
+ listener: (sessionId: NonSharedBuffer, sessionData: NonSharedBuffer, callback: () => void) => void,
143
153
  ): this;
144
154
  on(
145
155
  event: "OCSPRequest",
146
156
  listener: (
147
- certificate: Buffer,
148
- issuer: Buffer,
149
- callback: (err: Error | null, resp: Buffer) => void,
157
+ certificate: NonSharedBuffer,
158
+ issuer: NonSharedBuffer,
159
+ callback: (err: Error | null, resp: Buffer | null) => void,
150
160
  ) => void,
151
161
  ): this;
152
162
  on(
153
163
  event: "resumeSession",
154
- listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
164
+ listener: (
165
+ sessionId: NonSharedBuffer,
166
+ callback: (err: Error | null, sessionData: Buffer | null) => void,
167
+ ) => void,
155
168
  ): this;
156
169
  on(event: "secureConnection", listener: (tlsSocket: tls.TLSSocket) => void): this;
157
170
  on(event: "tlsClientError", listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
@@ -162,26 +175,35 @@ declare module "https" {
162
175
  on(event: "checkContinue", listener: http.RequestListener<Request, Response>): this;
163
176
  on(event: "checkExpectation", listener: http.RequestListener<Request, Response>): this;
164
177
  on(event: "clientError", listener: (err: Error, socket: Duplex) => void): this;
165
- on(event: "connect", listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void): this;
178
+ on(
179
+ event: "connect",
180
+ listener: (req: InstanceType<Request>, socket: Duplex, head: NonSharedBuffer) => void,
181
+ ): this;
166
182
  on(event: "request", listener: http.RequestListener<Request, Response>): this;
167
- on(event: "upgrade", listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void): this;
183
+ on(
184
+ event: "upgrade",
185
+ listener: (req: InstanceType<Request>, socket: Duplex, head: NonSharedBuffer) => void,
186
+ ): this;
168
187
  once(event: string, listener: (...args: any[]) => void): this;
169
- once(event: "keylog", listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
188
+ once(event: "keylog", listener: (line: NonSharedBuffer, tlsSocket: tls.TLSSocket) => void): this;
170
189
  once(
171
190
  event: "newSession",
172
- listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
191
+ listener: (sessionId: NonSharedBuffer, sessionData: NonSharedBuffer, callback: () => void) => void,
173
192
  ): this;
174
193
  once(
175
194
  event: "OCSPRequest",
176
195
  listener: (
177
- certificate: Buffer,
178
- issuer: Buffer,
179
- callback: (err: Error | null, resp: Buffer) => void,
196
+ certificate: NonSharedBuffer,
197
+ issuer: NonSharedBuffer,
198
+ callback: (err: Error | null, resp: Buffer | null) => void,
180
199
  ) => void,
181
200
  ): this;
182
201
  once(
183
202
  event: "resumeSession",
184
- listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
203
+ listener: (
204
+ sessionId: NonSharedBuffer,
205
+ callback: (err: Error | null, sessionData: Buffer | null) => void,
206
+ ) => void,
185
207
  ): this;
186
208
  once(event: "secureConnection", listener: (tlsSocket: tls.TLSSocket) => void): this;
187
209
  once(event: "tlsClientError", listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
@@ -192,26 +214,35 @@ declare module "https" {
192
214
  once(event: "checkContinue", listener: http.RequestListener<Request, Response>): this;
193
215
  once(event: "checkExpectation", listener: http.RequestListener<Request, Response>): this;
194
216
  once(event: "clientError", listener: (err: Error, socket: Duplex) => void): this;
195
- once(event: "connect", listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void): this;
217
+ once(
218
+ event: "connect",
219
+ listener: (req: InstanceType<Request>, socket: Duplex, head: NonSharedBuffer) => void,
220
+ ): this;
196
221
  once(event: "request", listener: http.RequestListener<Request, Response>): this;
197
- once(event: "upgrade", listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void): this;
222
+ once(
223
+ event: "upgrade",
224
+ listener: (req: InstanceType<Request>, socket: Duplex, head: NonSharedBuffer) => void,
225
+ ): this;
198
226
  prependListener(event: string, listener: (...args: any[]) => void): this;
199
- prependListener(event: "keylog", listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
227
+ prependListener(event: "keylog", listener: (line: NonSharedBuffer, tlsSocket: tls.TLSSocket) => void): this;
200
228
  prependListener(
201
229
  event: "newSession",
202
- listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
230
+ listener: (sessionId: NonSharedBuffer, sessionData: NonSharedBuffer, callback: () => void) => void,
203
231
  ): this;
204
232
  prependListener(
205
233
  event: "OCSPRequest",
206
234
  listener: (
207
- certificate: Buffer,
208
- issuer: Buffer,
209
- callback: (err: Error | null, resp: Buffer) => void,
235
+ certificate: NonSharedBuffer,
236
+ issuer: NonSharedBuffer,
237
+ callback: (err: Error | null, resp: Buffer | null) => void,
210
238
  ) => void,
211
239
  ): this;
212
240
  prependListener(
213
241
  event: "resumeSession",
214
- listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
242
+ listener: (
243
+ sessionId: NonSharedBuffer,
244
+ callback: (err: Error | null, sessionData: Buffer | null) => void,
245
+ ) => void,
215
246
  ): this;
216
247
  prependListener(event: "secureConnection", listener: (tlsSocket: tls.TLSSocket) => void): this;
217
248
  prependListener(event: "tlsClientError", listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
@@ -224,30 +255,33 @@ declare module "https" {
224
255
  prependListener(event: "clientError", listener: (err: Error, socket: Duplex) => void): this;
225
256
  prependListener(
226
257
  event: "connect",
227
- listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
258
+ listener: (req: InstanceType<Request>, socket: Duplex, head: NonSharedBuffer) => void,
228
259
  ): this;
229
260
  prependListener(event: "request", listener: http.RequestListener<Request, Response>): this;
230
261
  prependListener(
231
262
  event: "upgrade",
232
- listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
263
+ listener: (req: InstanceType<Request>, socket: Duplex, head: NonSharedBuffer) => void,
233
264
  ): this;
234
265
  prependOnceListener(event: string, listener: (...args: any[]) => void): this;
235
- prependOnceListener(event: "keylog", listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
266
+ prependOnceListener(event: "keylog", listener: (line: NonSharedBuffer, tlsSocket: tls.TLSSocket) => void): this;
236
267
  prependOnceListener(
237
268
  event: "newSession",
238
- listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
269
+ listener: (sessionId: NonSharedBuffer, sessionData: NonSharedBuffer, callback: () => void) => void,
239
270
  ): this;
240
271
  prependOnceListener(
241
272
  event: "OCSPRequest",
242
273
  listener: (
243
- certificate: Buffer,
244
- issuer: Buffer,
245
- callback: (err: Error | null, resp: Buffer) => void,
274
+ certificate: NonSharedBuffer,
275
+ issuer: NonSharedBuffer,
276
+ callback: (err: Error | null, resp: Buffer | null) => void,
246
277
  ) => void,
247
278
  ): this;
248
279
  prependOnceListener(
249
280
  event: "resumeSession",
250
- listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
281
+ listener: (
282
+ sessionId: NonSharedBuffer,
283
+ callback: (err: Error | null, sessionData: Buffer | null) => void,
284
+ ) => void,
251
285
  ): this;
252
286
  prependOnceListener(event: "secureConnection", listener: (tlsSocket: tls.TLSSocket) => void): this;
253
287
  prependOnceListener(event: "tlsClientError", listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
@@ -260,12 +294,12 @@ declare module "https" {
260
294
  prependOnceListener(event: "clientError", listener: (err: Error, socket: Duplex) => void): this;
261
295
  prependOnceListener(
262
296
  event: "connect",
263
- listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
297
+ listener: (req: InstanceType<Request>, socket: Duplex, head: NonSharedBuffer) => void,
264
298
  ): this;
265
299
  prependOnceListener(event: "request", listener: http.RequestListener<Request, Response>): this;
266
300
  prependOnceListener(
267
301
  event: "upgrade",
268
- listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
302
+ listener: (req: InstanceType<Request>, socket: Duplex, head: NonSharedBuffer) => void,
269
303
  ): this;
270
304
  }
271
305
  /**