import EventDispatcher from "../events/EventDispatcher";
declare namespace openfl.net {
	/**
	 * 	The XMLSocket class implements client sockets that let the OpenFL
	 * 	application communicate with a server computer identified by an IP address
	 * 	or domain name. The XMLSocket class is useful for client-server applications
	 * 	that require low latency, such as real-time chat systems. A traditional
	 * 	HTTP-based chat solution frequently polls the server and downloads new
	 * 	messages using an HTTP request. In contrast, an XMLSocket chat solution
	 * 	maintains an open connection to the server, which lets the server
	 * 	immediately send incoming messages without a request from the client. To use
	 * 	the XMLSocket class, the server computer must run a daemon that understands
	 * 	the protocol used by the XMLSocket class. The protocol is described in the
	 * 	following list:
	 * 
	 * 	* XML messages are sent over a full-duplex TCP/IP stream socket connection.
	 * 	* Each XML message is a complete XML document, terminated by a zero (0)
	 * 	byte.
	 * 	* An unlimited number of XML messages can be sent and received over a
	 * 	single XMLSocket connection.
	 * 
	 * 	Setting up a server to communicate with the XMLSocket object can be
	 * 	challenging. If your application does not require real-time interactivity,
	 * 	use the URLLoader class instead of the XMLSocket class.
	 * 
	 * 	To use the methods of the XMLSocket class, first use the constructor, `new
	 * 	XMLSocket`, to create an XMLSocket object.
	 * 
	 * 	SWF files in the local-with-filesystem sandbox may not use sockets.
	 * 
	 * 	_Socket policy files_ on the target host specify the hosts from which SWF
	 * 	files can make socket connections, and the ports to which those
	 * 	connections can be made. The security requirements with regard to socket
	 * 	policy files have become more stringent in the last several releases of
	 * 	Flash Player. In all versions of Flash Player, Adobe recommends the use of
	 * 	a socket policy file; in some circumstances, a socket policy file is
	 * 	required. Therefore, if you are using XMLSocket objects, make sure that
	 * 	the target host provides a socket policy file if necessary.
	 * 
	 * 	The following list summarizes the requirements for socket policy files in
	 * 	different versions of Flash Player:
	 * 
	 * 	*  In Flash Player 9.0.124.0 and later, a socket policy file is required
	 * 	for any XMLSocket connection. That is, a socket policy file on the target
	 * 	host is required no matter what port you are connecting to, and is
	 * 	required even if you are connecting to a port on the same host that is
	 * 	serving the SWF file.
	 * 	*  In Flash Player versions 9.0.115.0 and earlier, if you want to connect
	 * 	to a port number below 1024, or if you want to connect to a host other
	 * 	than the one serving the SWF file, a socket policy file on the target host
	 * 	is required.
	 * 	*  In Flash Player 9.0.115.0, even if a socket policy file isn't required,
	 * 	a warning is displayed when using the Flash Debug Player if the target
	 * 	host doesn't serve a socket policy file.
	 * 
	 * 	However, in Adobe AIR, content in the `application` security sandbox
	 * 	(content installed with the AIR application) are not restricted by these
	 * 	security limitations.
	 * 
	 * 	For more information related to security, see the Flash Player Developer
	 * 	Center Topic: [Security](http://www.adobe.com/go/devnet_security_en).
	 * 
	 * 	@event close         Dispatched when the server closes the socket
	 * 						 connection. The `close` event is dispatched only when
	 * 						 the server closes the connection; it is not
	 * 						 dispatched when you call the `XMLSocket.close()`
	 * 						 method.
	 * 	@event connect       Dispatched after a successful call to the
	 * 						 `XMLSocket.connect()` method.
	 * 	@event data          Dispatched after raw data is sent or received.
	 * 	@event ioError       Dispatched when an input/output error occurs that
	 * 						 causes a send or receive operation to fail.
	 * 	@event securityError Dispatched if a call to the `XMLSocket.connect()`
	 * 						 method attempts to connect either to a server outside
	 * 						 the caller's security sandbox or to a port lower than
	 * 						 1024.
	 * 
	 */
	export class XMLSocket extends EventDispatcher {
		/**
		 * 		Creates a new XMLSocket object. If no parameters are specified, an
		 * 		initially disconnected socket is created. If parameters are specified,
		 * 		a connection is attempted to the specified host and port.
		 * 		**Note:** It is strongly advised to use the constructor form **without
		 * 		parameters**, then add any event listeners, then call the `connect`
		 * 		method with `host` and `port` parameters. This sequence guarantees
		 * 		that all event listeners will work properly.
		 * 
		 * 		@param host A fully qualified DNS domain name or an IP address in the
		 * 					form _.222.333.444_. In Flash Player 9.0.115.0 and AIR 1.0
		 * 					and later, you can specify IPv6 addresses, such as
		 * 					rtmp://[2001:db8:ccc3:ffff:0:444d:555e:666f]. You can also
		 * 					specify `null` to connect to the host server on which the
		 * 					SWF file resides. If the SWF file issuing this call is
		 * 					running in a web browser, `host` must be in the same
		 * 					domain as the SWF file.
		 * 		@param port The TCP port number on the target host used to establish a
		 * 					connection. In Flash Player 9.0.124.0 and later, the
		 * 					target host must serve a socket policy file specifying
		 * 					that socket connections are permitted from the host
		 * 					serving the SWF file to the specified port. In earlier
		 * 					versions of Flash Player, a socket policy file is required
		 * 					only if you want to connect to a port number below 1024,
		 * 					or if you want to connect to a host other than the one
		 * 					serving the SWF file.
		 * 	
		 */
		constructor(host?: string, port?: number);
		/**
		 * 		Indicates whether this XMLSocket object is currently connected. You
		 * 		can also check whether the connection succeeded by registering for the
		 * 		`connect` event and `ioError` event.
		 * 	
		 */
		connected: boolean;
		/**
		 * 		Indicates the number of milliseconds to wait for a connection.
		 * 		If the connection doesn't succeed within the specified time, the
		 * 		connection fails. The default value is 20,000 (twenty seconds).
		 * 	
		 */
		timeout: number;
		/**
		 * 		Closes the connection specified by the XMLSocket object. The `close`
		 * 		event is dispatched only when the server closes the connection; it is
		 * 		not dispatched when you call the `close()` method.
		 * 
		 * 	
		 */
		close(): void;
		/**
		 * 		Establishes a connection to the specified Internet host using the
		 * 		specified TCP port.
		 * 		If you specify `null` for the `host` parameter, the host contacted is
		 * 		the one where the file calling `XMLSocket.connect()` resides. For
		 * 		example, if the calling file was downloaded from www.adobe.com,
		 * 		specifying `null` for the host parameter means you are connecting to
		 * 		www.adobe.com.
		 * 
		 * 		You can prevent a file from using this method by setting the
		 * 		`allowNetworking` parameter of the the `object` and `embed` tags in
		 * 		the HTML page that contains the SWF content.
		 * 
		 * 		For more information, see the Flash Player Developer Center Topic: [Security](http://www.adobe.com/go/devnet_security_en).
		 * 
		 * 		@param host A fully qualified DNS domain name or an IP address in the
		 * 					form _111.222.333.444_. You can also specify `null` to
		 * 					connect to the host server on which the SWF file resides.
		 * 					If the calling file is a SWF file running in a web
		 * 					browser, `host` must be in the same domain as the file.
		 * 		@param port The TCP port number on the target host used to establish a
		 * 					connection. In Flash Player 9.0.124.0 and later, the
		 * 					target host must serve a socket policy file specifying
		 * 					that socket connections are permitted from the host
		 * 					serving the SWF file to the specified port. In earlier
		 * 					versions of Flash Player, a socket policy file is required
		 * 					only if you want to connect to a port number below 1024,
		 * 					or if you want to connect to a host other than the one
		 * 					serving the SWF file.
		 * 		@throws SecurityError Local untrusted files may not communicate with
		 * 							  the Internet. Work around this limitation by
		 * 							  reclassifying the file as local-with-networking
		 * 							  or trusted.
		 * 		@throws SecurityError You may not specify a socket port higher than
		 * 							  65535.
		 * 		@event connect       Dispatched when network connection has been
		 * 							 established.
		 * 		@event data          Dispatched when raw data has been received.
		 * 		@event securityError A connect operation attempted to connect to a
		 * 							 host outside the caller's security sandbox, or to
		 * 							 a port that requires a socket policy file. Work
		 * 							 around either problem by using a socket policy
		 * 							 file on the target host.
		 * 	
		 */
		connect(host: string, port: number): void;
		/**
		 * 		Converts the XML object or data specified in the `object` parameter to
		 * 		a string and transmits it to the server, followed by a zero (0) byte.
		 * 		If `object` is an XML object, the string is the XML textual
		 * 		representation of the XML object. The send operation is asynchronous;
		 * 		it returns immediately, but the data may be transmitted at a later
		 * 		time. The `XMLSocket.send()` method does not return a value indicating
		 * 		whether the data was successfully transmitted.
		 * 		If you do not connect the XMLSocket object to the server using
		 * 		`XMLSocket.connect()`), the `XMLSocket.send()` operation fails.
		 * 
		 * 		@param object An XML object or other data to transmit to the server.
		 * 		@throws IOError The XMLSocket object is not connected to the server.
		 * 	
		 */
		send(object: any): void;
	}
}
export default openfl.net.XMLSocket;