<?php
/**
 * Custom exceptions for API interactions.
 *
 * PHP version 8.1+
 *
 * @category Exception
 * @package  TornVaultTracker
 * @author   Keith Solomon <ksolomon@gmail.com>
 * @license  Unlicense https://unlicense.org/
 * @link     https://github.com/ksolomon/Torn-Vault-Tracker
 */

/**
 * Exception thrown when API key is missing.
 *
 * @category Exception
 * @package  TornVaultTracker
 * @author   Keith Solomon <ksolomon@gmail.com>
 * @license  Unlicense https://unlicense.org/
 * @link     https://github.com/ksolomon/Torn-Vault-Tracker
 */
class ApiKeyMissingException extends Exception {
    /**
     * Constructor.
     *
     * @param string    $message  The exception message.
     * @param int       $code     The exception code.
     * @param Throwable $previous The previous throwable.
     */
    public function __construct($message, $code = 0, Throwable $previous = null) {
        parent::__construct($message, $code, $previous);
    }
}

/**
 * Exception thrown on CURL errors.
 *
 * @category Exception
 * @package  TornVaultTracker
 * @author   Keith Solomon <ksolomon@gmail.com>
 * @license  Unlicense https://unlicense.org/
 * @link     https://github.com/ksolomon/Torn-Vault-Tracker
 */
class CurlErrorException extends Exception {
    /**
     * Constructor.
     *
     * @param string    $message  The exception message.
     * @param int       $code     The exception code.
     * @param Throwable $previous The previous throwable.
     */
    public function __construct($message, $code = 0, Throwable $previous = null) {
        parent::__construct($message, $code, $previous);
    }
}

/**
 * Exception thrown on JSON data errors.
 *
 * @category Exception
 * @package  TornVaultTracker
 * @author   Keith Solomon <ksolomon@gmail.com>
 * @license  Unlicense https://unlicense.org/
 * @link     https://github.com/ksolomon/Torn-Vault-Tracker
 */
class JsonDataException extends Exception {
    /**
     * Constructor.
     *
     * @param string    $message  The exception message.
     * @param int       $code     The exception code.
     * @param Throwable $previous The previous throwable.
     */
    public function __construct($message, $code = 0, Throwable $previous = null) {
        parent::__construct($message, $code, $previous);
    }
}

/**
 * Exception thrown on API validation errors.
 *
 * @category Exception
 * @package  TornVaultTracker
 * @author   Keith Solomon <ksolomon@gmail.com>
 * @license  Unlicense https://unlicense.org/
 * @link     https://github.com/ksolomon/Torn-Vault-Tracker
 */
class ApiValidationException extends Exception {
    /**
     * Constructor.
     *
     * @param string    $message  The exception message.
     * @param int       $code     The exception code.
     * @param Throwable $previous The previous throwable.
     */
    public function __construct($message, $code = 0, Throwable $previous = null) {
        parent::__construct($message, $code, $previous);
    }
}