<?php

declare(strict_types=1);

/**
 * Loop logging trait.
 *
 * This file is part of MadelineProto.
 * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
 * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU Affero General Public License for more details.
 * You should have received a copy of the GNU General Public License along with MadelineProto.
 * If not, see <http://www.gnu.org/licenses/>.
 *
 * @author    Daniil Gentili <daniil@daniil.it>
 * @copyright 2016-2025 Daniil Gentili <daniil@daniil.it>
 * @license   https://opensource.org/licenses/AGPL-3.0 AGPLv3
 * @link https://docs.madelineproto.xyz MadelineProto documentation
 */

namespace danog\MadelineProto\Loop;

use danog\Loop\Loop;
use danog\MadelineProto\Logger;
use danog\MadelineProto\VoIPController;

/**
 * @internal
 */
abstract class VoIPLoop extends Loop
{
    public function __construct(
        protected VoIPController $instance,
    ) {
    }
    /**
     * Signal that loop has started.
     */
    #[\Override]
    protected function startedLoop(): void
    {
        $this->instance->log("Entered $this");
        parent::startedLoop();
    }

    /**
     * Signal that loop has exited.
     */
    #[\Override]
    protected function exitedLoop(): void
    {
        $this->instance->log("Exited $this");
        parent::exitedLoop();
    }

    /**
     * Report pause, can be overriden for logging.
     *
     * @param float $timeout Pause duration, 0 = forever
     */
    #[\Override]
    protected function reportPause(float $timeout): void
    {
        if ($timeout) {
            $this->instance->log(
                "Pausing $this for $timeout",
                Logger::ULTRA_VERBOSE,
            );
        } else {
            $this->instance->log(
                "Pausing $this until resume is called",
                Logger::ULTRA_VERBOSE,
            );
        }
    }

    /**
     * Get loop name.
     */
    abstract public function __toString(): string;
}