<?php

namespace BinSoul\Net\Mqtt;

/**
 * Represents a subscription.
 */
interface Subscription
{
    /**
     * Returns the topic filter.
     *
     * @return string
     */
    public function getFilter();

    /**
     * Returns the quality of service level.
     *
     * @return int
     */
    public function getQosLevel();

    /**
     * Returns a new subscription with the given topic filter.
     *
     * @param string $filter
     *
     * @return self
     */
    public function withFilter($filter);

    /**
     * Returns a new subscription with the given quality of service level.
     *
     * @param int $level
     *
     * @return self
     */
    public function withQosLevel($level);
}