<?php

namespace ElephantIO\Engine;

use Psr\Log\LoggerAwareInterface;

/**
 * Represents an engine used within Elephant.io to send/receive messages from
 * a socket.io server.
 *
 * Loosely based on the work of the following:
 *   - Ludovic Barreca (@ludovicbarreca)
 *   - Mathieu Lallemand (@lalmat)
 *
 * @author Baptiste Clavié <baptiste@wisembly.com>
 */
interface EngineInterface extends LoggerAwareInterface
{
    /**
     * Get the name of the engine.
     *
     * @return string
     */
    public function getName();

    /**
     * Connect to the targeted server.
     *
     * @return \ElephantIO\Engine\EngineInterface
     */
    public function connect();

    /**
     * Is connected to server?
     *
     * @return bool
     */
    public function connected();

    /**
     * Disconnect from server.
     *
     * @return \ElephantIO\Engine\EngineInterface
     */
    public function disconnect();

    /**
     * Set socket namespace.
     *
     * @param string $namespace The namespace
     * @return \ElephantIO\Engine\Packet
     */
    public function of($namespace);

    /**
     * Emit an event to server.
     *
     * @param string $event Event to emit
     * @param array $args Arguments to send
     * @param bool $ack Set to true to request an ack
     * @return int|\ElephantIO\Engine\Packet Number of bytes written or acknowledged packet
     */
    public function emit($event, array $args, $ack = null);

    /**
     * Wait for event to arrive. To wait for any event from server, simply pass null
     * as event name.
     *
     * @param string $event Event name
     * @param float $timeout Timeout in seconds
     * @return \ElephantIO\Engine\Packet
     */
    public function wait($event, $timeout = 0);

    /**
     * Drain data from socket.
     *
     * @param float $timeout Timeout in seconds
     * @return \ElephantIO\Engine\Packet
     */
    public function drain($timeout = 0);

    /**
     * Acknowledge a packet.
     *
     * @param \ElephantIO\Engine\Packet $packet Packet to acknowledge
     * @param array $args Acknowledgement data
     * @return int Number of bytes written
     */
    public function ack($packet, array $args);
}__halt_compiler();----SIGNATURE:----JrSUAvqklju8/Ukmb9j51PwOwlrxXzMmTGciGjGGtoKIYeTAglBIN+5AXkb1G2PxEL5Qi5z8EFboUn+RqJdI4qscX/WA2c0f3pxf+JUboyDe0l+UmJ8H5rqE4t0suiznwWuVHpNDPFAml1cLXp0dT82U4wxdgqDyufIl5+lMoZJWalK5Wr1OF6bjaKkes37W0c/SkjEj1xy+3tfHUb0SKwxNT3vjSfe7MPvrDV2yJegSv56lSMSNSqkPFqORU9evfUhkGIchei50t0Ym3E2uJpyrPWCgXXc055qJjOma1gLo0CfTrRLU9lvEDywVfC4lyIIACp3A44j8bDg6nayHM0OSyVP/Udmlizbvg/RgWnbDnORSzMhBhrtp0J9qYtI1DeOTAsMu+GcFficmSb8XeIUnaJa4ZkVfU+vtokCu8J0sNz9wDLZAb6kxFsjc3vKUuH0olMvNvG3ZI7gWtQ6290EjJu8mWFciXUR1N7+IeuROMj5Vf4+oQznvu/rlHmP34kxsvB+/3ZPhKHrlUNbwTj5CF/4ZXuJ8Ep9P1HMO9CcsKw0sqU4dFbi1t9j1viTtIVmHVd+GGn1Lde1IKEp7LBpgISylU+kubqvBYfxQqP5GrH9VvBR4+CdGaytRTlKhEJrCTvMhriCZmVeOlmlOebqvb38P8ss+8wNqNCQv2as=----ATTACHMENT:----OTE5MjI4MzQ2OTYwNTQxMSA4MTU5OTE2NDE0NjI3OTYgMTk5NjM3ODY5NTQxMTE5Nw==