pyrodactyl/app/Exceptions/ServerOperations/ServerOperationException.php

<?php

namespace Pterodactyl\Exceptions\ServerOperations;

use Exception;

class ServerOperationException extends Exception
{
    /**
     * Create a new server operation exception.
     */
    public function __construct(string $message = '', int $code = 0, ?Exception $previous = null)
    {
        parent::__construct($message, $code, $previous);
    }

    /**
     * Create exception for when server cannot accept operations
     */
    public static function serverBusy(string $serverUuid): self
    {
        return new self("Server {$serverUuid} is currently busy and cannot accept new operations.");
    }

    /**
     * Create exception for operation timeout
     */
    public static function operationTimedOut(string $operationId): self
    {
        return new self("Operation {$operationId} has timed out.");
    }

    /**
     * Create exception for invalid operation state
     */
    public static function invalidOperationState(string $operationId, string $currentState): self
    {
        return new self("Operation {$operationId} is in an invalid state: {$currentState}");
    }

    /**
     * Create exception for operation not found
     */
    public static function operationNotFound(string $operationId): self
    {
        return new self("Operation {$operationId} was not found.");
    }

    /**
     * Create exception for rate limit exceeded
     */
    public static function rateLimitExceeded(string $operationType, int $windowSeconds): self
    {
        $minutes = ceil($windowSeconds / 60);
        return new self("Rate limit exceeded for {$operationType} operations. Please wait {$minutes} minutes before trying again.");
    }
}