whet 0.0.1

package/bin/js/node/Https.d.ts

@@ -0,0 +1,330 @@
+import {Socket} from "net"
+import {SocketConnectOptionsTcp} from "./net/Socket"
+import {Agent} from "http"
+import {Buffer} from "buffer"
+
+export type HttpsCreateServerOptions = {
+	/**
+	Specifies the `IncomingMessage` class to be used. Useful for extending the original `IncomingMessage`.
+	
+	Default: `js.node.http.IncomingMessage`.
+	*/
+	IncomingMessage?: null | any, 
+	/**
+	possible NPN protocols. (Protocols should be ordered by their priority).
+	*/
+	NPNProtocols?: null | string[] | Buffer, 
+	/**
+	A function that will be called if client supports SNI TLS extension.
+	Two argument will be passed to it: `servername`, and `cb`.
+	SNICallback should invoke `cb(null, ctx)`, where `ctx` is a SecureContext instance.
+	(You can use tls.createSecureContext(...) to get proper `SecureContext`).
+	If `SNICallback` wasn't provided - default callback with high-level API will be used.
+	*/
+	SNICallback?: null | ((servername: string, cb: ((arg0: Error) => SecureContext)) => void), 
+	/**
+	Specifies the `ServerResponse` class to be used. Useful for extending the original `ServerResponse`.
+	
+	Default: `ServerResponse`.
+	*/
+	ServerResponse?: null | any, 
+	/**
+	trusted certificates in PEM format.
+	If this is omitted several well known "root" CAs will be used, like VeriSign.
+	These are used to authorize connections.
+	*/
+	ca?: null | string | Buffer[], 
+	/**
+	certificate key of the server in PEM format.
+	*/
+	cert?: null | string | Buffer, 
+	/**
+	ciphers to use or exclude.
+	
+	To mitigate BEAST attacks it is recommended that you use this option in conjunction with the `honorCipherOrder`
+	option described below to prioritize the non-CBC cipher.
+	
+	Defaults to AES128-GCM-SHA256:RC4:HIGH:!MD5:!aNULL:!EDH.
+	
+	Consult the OpenSSL cipher list format documentation for details on the format.
+	ECDH (Elliptic Curve Diffie-Hellman) ciphers are not yet supported.
+	*/
+	ciphers?: null | string, 
+	/**
+	PEM encoded CRLs (Certificate Revocation List)
+	*/
+	crl?: null | string | string[], 
+	/**
+	Diffie Hellman parameters, required for Perfect Forward Secrecy.
+	
+	Use openssl dhparam to create it. Its key length should be greater than or equal to 1024 bits,
+	otherwise it throws an error. It is strongly recommended to use 2048 bits or more for stronger security.
+	If omitted or invalid, it is silently discarded and DHE ciphers won't be available.
+	*/
+	dhparam?: null | string | Buffer, 
+	/**
+	named curve to use for ECDH key agreement or false to disable ECDH.
+	
+	Defaults to prime256v1 (NIST P-256). Use `Crypto.getCurves` to obtain a list of available curve names.
+	On recent releases, openssl ecparam -list_curves will also display the name and description
+	of each available elliptic curve.
+	*/
+	ecdhCurve?: null | string, 
+	/**
+	Abort the connection if the SSL/TLS handshake does not finish in this many milliseconds.
+	The default is 120 seconds.
+	A 'clientError' is emitted on the `tls.Server` object whenever a handshake times out.
+	*/
+	handshakeTimeout?: null | number, 
+	/**
+	When choosing a cipher, use the server's preferences instead of the client preferences.
+	Default: true.
+	*/
+	honorCipherOrder?: null | boolean, 
+	/**
+	private key of the server in PEM format.
+	*/
+	key?: null | string | Buffer, 
+	/**
+	passphrase for the private key or pfx.
+	*/
+	passphrase?: null | string, 
+	/**
+	private key, certificate and CA certs of the server in PFX or PKCS12 format.
+	*/
+	pfx?: null | string | Buffer, 
+	/**
+	If true the server will reject any connection which is not authorized with the list of supplied CAs.
+	This option only has an effect if `requestCert` is true.
+	Default: false.
+	*/
+	rejectUnauthorized?: null | boolean, 
+	/**
+	If true the server will request a certificate from clients that connect
+	and attempt to verify that certificate.
+	Default: false.
+	*/
+	requestCert?: null | boolean, 
+	/**
+	The SSL method to use, e.g. SSLv3_method to force SSL version 3.
+	The possible values depend on your installation of OpenSSL and are defined in the constant SSL_METHODS.
+	*/
+	secureProtocol?: null | string, 
+	/**
+	opaque identifier for session resumption.
+	If `requestCert` is true, the default is MD5 hash value generated from command-line.
+	Otherwise, the default is not provided.
+	*/
+	sessionIdContext?: null | string, 
+	/**
+	An integer specifying the seconds after which TLS session identifiers
+	and TLS session tickets created by the server are timed out.
+	See SSL_CTX_set_timeout for more details.
+	*/
+	sessionTimeout?: null | number, 
+	/**
+	A 48-byte `Buffer` instance consisting of 16-byte prefix, 16-byte hmac key, 16-byte AES key.
+	You could use it to accept tls session tickets on multiple instances of tls server.
+	
+	NOTE: Automatically shared between cluster module workers.
+	*/
+	ticketKeys?: any
+}
+
+export type HttpsRequestOptions = {
+	/**
+	possible NPN protocols. (Protocols should be ordered by their priority).
+	*/
+	NPNProtocols?: null | string[] | Buffer, 
+	/**
+	Controls Agent behavior.
+	
+	Possible values:
+	
+	- `undefined` (default): use http.globalAgent for this host and port.
+	- `Agent` object: explicitly use the passed in `Agent`.
+	- `false` : causes a new `Agent` with default values to be used.
+	*/
+	agent?: null | Agent | boolean, 
+	/**
+	Basic authentication i.e. `'user:password'` to compute an Authorization header.
+	*/
+	auth?: null | string, 
+	/**
+	trusted certificates in PEM format.
+	If this is omitted several well known "root" CAs will be used, like VeriSign.
+	These are used to authorize connections.
+	*/
+	ca?: null | string | Buffer[], 
+	/**
+	certificate key of the server in PEM format.
+	*/
+	cert?: null | string | Buffer, 
+	/**
+	An override for checking server's hostname against the certificate.
+	Should return an error if verification fails. Return `js.Lib.undefined` if passing.
+	*/
+	checkServerIdentity?: null | ((arg0: string, arg1: {
+	}) => any), 
+	/**
+	ciphers to use or exclude.
+	
+	To mitigate BEAST attacks it is recommended that you use this option in conjunction with the `honorCipherOrder`
+	option described below to prioritize the non-CBC cipher.
+	
+	Defaults to AES128-GCM-SHA256:RC4:HIGH:!MD5:!aNULL:!EDH.
+	
+	Consult the OpenSSL cipher list format documentation for details on the format.
+	ECDH (Elliptic Curve Diffie-Hellman) ciphers are not yet supported.
+	*/
+	ciphers?: null | string, 
+	/**
+	A function that produces a socket/stream to use for the request when the `agent` option is not used.
+	This can be used to avoid creating a custom `Agent` class just to override the default `createConnection` function.
+	See [agent.createConnection()](https://nodejs.org/api/http.html#http_agent_createconnection_options_callback) for more details.
+	Any `Duplex` stream is a valid return value.
+	*/
+	createConnection?: null | ((options: SocketConnectOptionsTcp, callabck?: ((err: Error, stream: IDuplex) => void)) => IDuplex), 
+	/**
+	PEM encoded CRLs (Certificate Revocation List)
+	*/
+	crl?: null | string | string[], 
+	/**
+	Default port for the protocol.
+	
+	Default: `agent.defaultPort` if an Agent is used, else `undefined`.
+	*/
+	defaultPort?: null | number, 
+	/**
+	Diffie Hellman parameters, required for Perfect Forward Secrecy.
+	
+	Use openssl dhparam to create it. Its key length should be greater than or equal to 1024 bits,
+	otherwise it throws an error. It is strongly recommended to use 2048 bits or more for stronger security.
+	If omitted or invalid, it is silently discarded and DHE ciphers won't be available.
+	*/
+	dhparam?: null | string | Buffer, 
+	/**
+	named curve to use for ECDH key agreement or false to disable ECDH.
+	
+	Defaults to prime256v1 (NIST P-256). Use `Crypto.getCurves` to obtain a list of available curve names.
+	On recent releases, openssl ecparam -list_curves will also display the name and description
+	of each available elliptic curve.
+	*/
+	ecdhCurve?: null | string, 
+	/**
+	IP address family to use when resolving `host` or `hostname`.
+	Valid values are `4` or `6`. When unspecified, both IP v4 and v6 will be used.
+	*/
+	family?: null | number, 
+	/**
+	An object containing request headers.
+	*/
+	headers?: null | {[key: string]: string | string[]}, 
+	/**
+	When choosing a cipher, use the server's preferences instead of the client preferences.
+	Default: true.
+	*/
+	honorCipherOrder?: null | boolean, 
+	/**
+	A domain name or IP address of the server to issue the request to.
+	
+	Default: `'localhost'`.
+	*/
+	host?: null | string, 
+	/**
+	Alias for `host`.
+	To support `url.parse()`, hostname will be used if both `host` and `hostname` are specified.
+	*/
+	hostname?: null | string, 
+	/**
+	private key of the server in PEM format.
+	*/
+	key?: null | string | Buffer, 
+	/**
+	Local interface to bind for network connections.
+	*/
+	localAddress?: null | string, 
+	/**
+	A string specifying the HTTP request method.
+	
+	Default: `'GET'`.
+	*/
+	method?: null | string, 
+	/**
+	passphrase for the private key or pfx.
+	*/
+	passphrase?: null | string, 
+	/**
+	Request path. Should include query string if any. E.G. `'/index.html?page=12'`.
+	An exception is thrown when the request path contains illegal characters.
+	Currently, only spaces are rejected but that may change in the future.
+	
+	Default: `'/'`.
+	*/
+	path?: null | string, 
+	/**
+	private key, certificate and CA certs of the server in PFX or PKCS12 format.
+	*/
+	pfx?: null | string | Buffer, 
+	/**
+	Port of remote server.
+	
+	Default: `defaultPort` if set, else `80`.
+	*/
+	port?: null | number, 
+	/**
+	Protocol to use.
+	
+	Default: `'http:'`.
+	*/
+	protocol?: null | string, 
+	/**
+	If true the server will reject any connection which is not authorized with the list of supplied CAs.
+	This option only has an effect if `requestCert` is true.
+	Default: false.
+	*/
+	rejectUnauthorized?: null | boolean, 
+	/**
+	If true - OCSP status request extension would be added to client hello,
+	and OCSPResponse event will be emitted on socket before establishing secure communication
+	*/
+	requestOCSP?: null | boolean, 
+	/**
+	The SSL method to use, e.g. SSLv3_method to force SSL version 3.
+	The possible values depend on your installation of OpenSSL and are defined in the constant SSL_METHODS.
+	*/
+	secureProtocol?: null | string, 
+	/**
+	Servername for SNI (Server Name Indication) TLS extension.
+	*/
+	servername?: null | string, 
+	/**
+	A Buffer instance, containing TLS session.
+	*/
+	session?: any, 
+	/**
+	opaque identifier for session resumption.
+	If `requestCert` is true, the default is MD5 hash value generated from command-line.
+	Otherwise, the default is not provided.
+	*/
+	sessionIdContext?: null | string, 
+	/**
+	Specifies whether or not to automatically add the Host header.
+	Defaults to `true`.
+	*/
+	setHost?: null | boolean, 
+	/**
+	Establish secure connection on a given socket rather than creating a new socket.
+	If this option is specified, `host` and `port` are ignored.
+	*/
+	socket?: null | Socket, 
+	/**
+	Unix Domain Socket (cannot be used if one of host or port is specified, those specify a TCP Socket).
+	*/
+	socketPath?: null | string, 
+	/**
+	A number specifying the socket timeout in milliseconds.
+	This will set the timeout before the socket is connected.
+	*/
+	timeout?: null | number
+}

package/bin/js/node/Iterator.d.ts

@@ -0,0 +1,5 @@
+import {Iterator as Iterator__1, IteratorStep as IteratorStep__1} from "../lib/Iterator"
+
+export type Iterator<T> = Iterator__1<T>
+
+export type IteratorStep<T> = IteratorStep__1<T>

package/bin/js/node/Path.d.ts

@@ -0,0 +1,44 @@
+import {Rest} from "../../haxe/extern/Rest"
+
+/**
+Path object returned from `Path.parse` and taken by `Path.format`.
+
+@see https://nodejs.org/api/path.html#path_path_format_pathobject
+*/
+export type PathObject = {
+	/**
+	E.g. "index.html" for "C:\path\dir\index.html"
+	*/
+	base: string, 
+	/**
+	E.g. "C:\path\dir" for "C:\path\dir\index.html"
+	*/
+	dir: string, 
+	/**
+	E.g. ".html" for "C:\path\dir\index.html"
+	*/
+	ext: string, 
+	/**
+	E.g. "index" for "C:\path\dir\index.html"
+	*/
+	name: string, 
+	/**
+	E.g. "C:\" for "C:\path\dir\index.html"
+	*/
+	root: string
+}
+
+export type PathModule = {
+	basename: (path: string, ext?: string) => string, 
+	delimiter: string, 
+	dirname: (path: string) => string, 
+	extname: (path: string) => string, 
+	format: (pathObject: PathObject) => string, 
+	isAbsolute: (path: string) => boolean, 
+	join: (...paths: Rest<string>) => string, 
+	normalize: (path: string) => string, 
+	parse: (pathString: string) => PathObject, 
+	relative: (from: string, to: string) => string, 
+	resolve: (...paths: Rest<string>) => string, 
+	sep: string
+}

package/bin/js/node/Process.d.ts

@@ -0,0 +1,6 @@
+
+export type MemoryUsage = {
+	heapTotal: number, 
+	heapUsed: number, 
+	rss: number
+}

package/bin/js/node/Tls.d.ts

@@ -0,0 +1,304 @@
+import {Socket} from "net"
+import {Buffer} from "buffer"
+
+export type TlsOptionsBase = {
+	/**
+	possible NPN protocols. (Protocols should be ordered by their priority).
+	*/
+	NPNProtocols?: null | string[] | Buffer, 
+	/**
+	If true the server will reject any connection which is not authorized with the list of supplied CAs.
+	This option only has an effect if `requestCert` is true.
+	Default: false.
+	*/
+	rejectUnauthorized?: null | boolean
+}
+
+export type TlsServerOptionsBase = {
+	/**
+	possible NPN protocols. (Protocols should be ordered by their priority).
+	*/
+	NPNProtocols?: null | string[] | Buffer, 
+	/**
+	A function that will be called if client supports SNI TLS extension.
+	Two argument will be passed to it: `servername`, and `cb`.
+	SNICallback should invoke `cb(null, ctx)`, where `ctx` is a SecureContext instance.
+	(You can use tls.createSecureContext(...) to get proper `SecureContext`).
+	If `SNICallback` wasn't provided - default callback with high-level API will be used.
+	*/
+	SNICallback?: null | ((servername: string, cb: ((arg0: Error) => SecureContext)) => void), 
+	/**
+	If true the server will reject any connection which is not authorized with the list of supplied CAs.
+	This option only has an effect if `requestCert` is true.
+	Default: false.
+	*/
+	rejectUnauthorized?: null | boolean, 
+	/**
+	If true the server will request a certificate from clients that connect
+	and attempt to verify that certificate.
+	Default: false.
+	*/
+	requestCert?: null | boolean
+}
+
+export type TlsClientOptionsBase = {
+	/**
+	possible NPN protocols. (Protocols should be ordered by their priority).
+	*/
+	NPNProtocols?: null | string[] | Buffer, 
+	/**
+	If true the server will reject any connection which is not authorized with the list of supplied CAs.
+	This option only has an effect if `requestCert` is true.
+	Default: false.
+	*/
+	rejectUnauthorized?: null | boolean, 
+	/**
+	If true - OCSP status request extension would be added to client hello,
+	and OCSPResponse event will be emitted on socket before establishing secure communication
+	*/
+	requestOCSP?: null | boolean, 
+	/**
+	A Buffer instance, containing TLS session.
+	*/
+	session?: any
+}
+
+/**
+Base structure for options object used in tls methods.
+*/
+export type TlsCreateServerOptions = {
+	/**
+	possible NPN protocols. (Protocols should be ordered by their priority).
+	*/
+	NPNProtocols?: null | string[] | Buffer, 
+	/**
+	A function that will be called if client supports SNI TLS extension.
+	Two argument will be passed to it: `servername`, and `cb`.
+	SNICallback should invoke `cb(null, ctx)`, where `ctx` is a SecureContext instance.
+	(You can use tls.createSecureContext(...) to get proper `SecureContext`).
+	If `SNICallback` wasn't provided - default callback with high-level API will be used.
+	*/
+	SNICallback?: null | ((servername: string, cb: ((arg0: Error) => SecureContext)) => void), 
+	/**
+	trusted certificates in PEM format.
+	If this is omitted several well known "root" CAs will be used, like VeriSign.
+	These are used to authorize connections.
+	*/
+	ca?: null | string | Buffer[], 
+	/**
+	certificate key of the server in PEM format.
+	*/
+	cert?: null | string | Buffer, 
+	/**
+	ciphers to use or exclude.
+	
+	To mitigate BEAST attacks it is recommended that you use this option in conjunction with the `honorCipherOrder`
+	option described below to prioritize the non-CBC cipher.
+	
+	Defaults to AES128-GCM-SHA256:RC4:HIGH:!MD5:!aNULL:!EDH.
+	
+	Consult the OpenSSL cipher list format documentation for details on the format.
+	ECDH (Elliptic Curve Diffie-Hellman) ciphers are not yet supported.
+	*/
+	ciphers?: null | string, 
+	/**
+	PEM encoded CRLs (Certificate Revocation List)
+	*/
+	crl?: null | string | string[], 
+	/**
+	Diffie Hellman parameters, required for Perfect Forward Secrecy.
+	
+	Use openssl dhparam to create it. Its key length should be greater than or equal to 1024 bits,
+	otherwise it throws an error. It is strongly recommended to use 2048 bits or more for stronger security.
+	If omitted or invalid, it is silently discarded and DHE ciphers won't be available.
+	*/
+	dhparam?: null | string | Buffer, 
+	/**
+	named curve to use for ECDH key agreement or false to disable ECDH.
+	
+	Defaults to prime256v1 (NIST P-256). Use `Crypto.getCurves` to obtain a list of available curve names.
+	On recent releases, openssl ecparam -list_curves will also display the name and description
+	of each available elliptic curve.
+	*/
+	ecdhCurve?: null | string, 
+	/**
+	Abort the connection if the SSL/TLS handshake does not finish in this many milliseconds.
+	The default is 120 seconds.
+	A 'clientError' is emitted on the `tls.Server` object whenever a handshake times out.
+	*/
+	handshakeTimeout?: null | number, 
+	/**
+	When choosing a cipher, use the server's preferences instead of the client preferences.
+	Default: true.
+	*/
+	honorCipherOrder?: null | boolean, 
+	/**
+	private key of the server in PEM format.
+	*/
+	key?: null | string | Buffer, 
+	/**
+	passphrase for the private key or pfx.
+	*/
+	passphrase?: null | string, 
+	/**
+	private key, certificate and CA certs of the server in PFX or PKCS12 format.
+	*/
+	pfx?: null | string | Buffer, 
+	/**
+	If true the server will reject any connection which is not authorized with the list of supplied CAs.
+	This option only has an effect if `requestCert` is true.
+	Default: false.
+	*/
+	rejectUnauthorized?: null | boolean, 
+	/**
+	If true the server will request a certificate from clients that connect
+	and attempt to verify that certificate.
+	Default: false.
+	*/
+	requestCert?: null | boolean, 
+	/**
+	The SSL method to use, e.g. SSLv3_method to force SSL version 3.
+	The possible values depend on your installation of OpenSSL and are defined in the constant SSL_METHODS.
+	*/
+	secureProtocol?: null | string, 
+	/**
+	opaque identifier for session resumption.
+	If `requestCert` is true, the default is MD5 hash value generated from command-line.
+	Otherwise, the default is not provided.
+	*/
+	sessionIdContext?: null | string, 
+	/**
+	An integer specifying the seconds after which TLS session identifiers
+	and TLS session tickets created by the server are timed out.
+	See SSL_CTX_set_timeout for more details.
+	*/
+	sessionTimeout?: null | number, 
+	/**
+	A 48-byte `Buffer` instance consisting of 16-byte prefix, 16-byte hmac key, 16-byte AES key.
+	You could use it to accept tls session tickets on multiple instances of tls server.
+	
+	NOTE: Automatically shared between cluster module workers.
+	*/
+	ticketKeys?: any
+}
+
+export type TlsConnectOptions = {
+	/**
+	possible NPN protocols. (Protocols should be ordered by their priority).
+	*/
+	NPNProtocols?: null | string[] | Buffer, 
+	/**
+	trusted certificates in PEM format.
+	If this is omitted several well known "root" CAs will be used, like VeriSign.
+	These are used to authorize connections.
+	*/
+	ca?: null | string | Buffer[], 
+	/**
+	certificate key of the server in PEM format.
+	*/
+	cert?: null | string | Buffer, 
+	/**
+	An override for checking server's hostname against the certificate.
+	Should return an error if verification fails. Return `js.Lib.undefined` if passing.
+	*/
+	checkServerIdentity?: null | ((arg0: string, arg1: {
+	}) => any), 
+	/**
+	ciphers to use or exclude.
+	
+	To mitigate BEAST attacks it is recommended that you use this option in conjunction with the `honorCipherOrder`
+	option described below to prioritize the non-CBC cipher.
+	
+	Defaults to AES128-GCM-SHA256:RC4:HIGH:!MD5:!aNULL:!EDH.
+	
+	Consult the OpenSSL cipher list format documentation for details on the format.
+	ECDH (Elliptic Curve Diffie-Hellman) ciphers are not yet supported.
+	*/
+	ciphers?: null | string, 
+	/**
+	PEM encoded CRLs (Certificate Revocation List)
+	*/
+	crl?: null | string | string[], 
+	/**
+	Diffie Hellman parameters, required for Perfect Forward Secrecy.
+	
+	Use openssl dhparam to create it. Its key length should be greater than or equal to 1024 bits,
+	otherwise it throws an error. It is strongly recommended to use 2048 bits or more for stronger security.
+	If omitted or invalid, it is silently discarded and DHE ciphers won't be available.
+	*/
+	dhparam?: null | string | Buffer, 
+	/**
+	named curve to use for ECDH key agreement or false to disable ECDH.
+	
+	Defaults to prime256v1 (NIST P-256). Use `Crypto.getCurves` to obtain a list of available curve names.
+	On recent releases, openssl ecparam -list_curves will also display the name and description
+	of each available elliptic curve.
+	*/
+	ecdhCurve?: null | string, 
+	/**
+	When choosing a cipher, use the server's preferences instead of the client preferences.
+	Default: true.
+	*/
+	honorCipherOrder?: null | boolean, 
+	/**
+	Host the client should connect to.
+	Defaults to 'localhost'
+	*/
+	host?: null | string, 
+	/**
+	private key of the server in PEM format.
+	*/
+	key?: null | string | Buffer, 
+	/**
+	passphrase for the private key or pfx.
+	*/
+	passphrase?: null | string, 
+	/**
+	Creates unix socket connection to path.
+	If this option is specified, host and port are ignored.
+	*/
+	path?: null | string, 
+	/**
+	private key, certificate and CA certs of the server in PFX or PKCS12 format.
+	*/
+	pfx?: null | string | Buffer, 
+	/**
+	Port the client should connect to
+	*/
+	port?: null | number, 
+	/**
+	If true the server will reject any connection which is not authorized with the list of supplied CAs.
+	This option only has an effect if `requestCert` is true.
+	Default: false.
+	*/
+	rejectUnauthorized?: null | boolean, 
+	/**
+	If true - OCSP status request extension would be added to client hello,
+	and OCSPResponse event will be emitted on socket before establishing secure communication
+	*/
+	requestOCSP?: null | boolean, 
+	/**
+	The SSL method to use, e.g. SSLv3_method to force SSL version 3.
+	The possible values depend on your installation of OpenSSL and are defined in the constant SSL_METHODS.
+	*/
+	secureProtocol?: null | string, 
+	/**
+	Servername for SNI (Server Name Indication) TLS extension.
+	*/
+	servername?: null | string, 
+	/**
+	A Buffer instance, containing TLS session.
+	*/
+	session?: any, 
+	/**
+	opaque identifier for session resumption.
+	If `requestCert` is true, the default is MD5 hash value generated from command-line.
+	Otherwise, the default is not provided.
+	*/
+	sessionIdContext?: null | string, 
+	/**
+	Establish secure connection on a given socket rather than creating a new socket.
+	If this option is specified, `host` and `port` are ignored.
+	*/
+	socket?: null | Socket
+}