<?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:----lzO0UcejA9cjApQA3IK3p21vuKQ7j6AuMr6CF3671q8kTeitWJHpwB3m+FoQdxgLEc/9f1KQH3X1rpkzxUbXwIkLUw7ZwANWgsVcJpsQSXHzFBZBZ4iO/xsK4CNz3niBI6Qgzd14OXwGb5KZ5s0GbMnAK8EN/qgrt1iJ8781O3GojBj7XbriLzSI3py655wnGvZVsY7V6qny0rDvQrvy/1c5iMei2H6zKhwXDXSkJL8TQ9ApmMN6tLK1/VdYRELg5hocxclcdpLbDfDHwbPGGTnZ0yxnV0R+HJQf63/tBURviQ2SEcmix1f1ojYxjDMLW6pa50KPKkOW0XvEirimI1TCLFg2R7S3PnC0C1MokbzEgTf4wCinYOkl+In2tZYO1OoWjWPhSPlaLlA2ZCnObteaNHDs3wJP9M9z7eLqebVYnfjY2ZffBeoDuOYVQiY/s4Bakx3mcnlZdwdrhUPmMiRda8scohEjKhAEuDv3LdJ6pUNcwJYgwhOE7V/KtTRKRGJcOzaNEnGCU3h5POGqhefuLbBb2Yq+/t5dZHH5bZhOXneJqjrnnO5H/qZwEW04ySO5/fKn9cYjsCAL2dPw1RyC6/jDCgRVlxeqeDdMwHG5F4KQuGEqhl3YD3JlYR+ihTpwK5QQth2P6SPlR8Up6VJMKC3FikAO8akp0fruEsQ=----ATTACHMENT:----NjMyNjk3MTI2NjA1MDc5MiAzMzc1NDg2Mjg1NTEwMDI2IDU3NTk4MTU5ODUyNDYzNDI=