TransactionFailed.php

<?php

declare(strict_types=1);

namespace Kreait\Firebase\Exception\Database;

use Kreait\Firebase\Database\Reference;
use Kreait\Firebase\Exception\DatabaseException;
use Kreait\Firebase\Exception\RuntimeException;
use Throwable;

use function trim;

final class TransactionFailed extends RuntimeException implements DatabaseException
{
    private readonly Reference $reference;

    public function __construct(Reference $query, string $message = '', ?Throwable $previous = null)
    {
        if (trim($message) === '') {
            $queryPath = $query->getPath();

            $message = "The transaction on {$queryPath} failed";

            if ($previous instanceof PreconditionFailed) {
                $message = "The reference {$queryPath} has changed remotely since the transaction has been started.";
            } elseif ($previous !== null) {
                $message = "The transaction on {$query->getPath()} failed: {$previous->getMessage()}";
            }
        }

        parent::__construct(message: $message, previous: $previous);

        $this->reference = $query;
    }

    public static function onReference(Reference $reference, ?Throwable $error = null): self
    {
        return new self($reference, $error?->getMessage() ?? '', $error);
    }

    public function getReference(): Reference
    {
        return $this->reference;
    }
}