<?php declare(strict_types=1);

/**
 * 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\Ipc\Wrapper;

use Revolt\EventLoop;

/**
 * @internal
 */
trait ClosableTrait
{
    /**
     * @var list<Closure(): void>
     */
    private array $closeCallbacks = [];
    /**
     * Closes the resource, marking it as unusable.
     * Whether pending operations are aborted or not is implementation dependent.
     */
    public function close(): void
    {
        if ($this->closeCallbacks) {
            array_map(EventLoop::queue(...), $this->closeCallbacks);
            $this->closeCallbacks = [];
        }
        $this->__call('close');
    }

    /**
     * Returns whether this resource has been closed.
     *
     * @return bool true if closed, otherwise false
     */
    public function isClosed(): bool
    {
        return $this->__call('isClosed');
    }

    /**
     * Registers a callback that is invoked when this resource is closed.
     *
     * @param \Closure():void $onClose
     */
    public function onClose(\Closure $onClose): void
    {
        $this->closeCallbacks []= $onClose;
    }

    final public function __destruct()
    {
        EventLoop::queue($this->close(...));
    }
}