<?php

declare(strict_types=1);

namespace App\Exceptions\Social;

use Illuminate\Http\Client\Response;

class DiscordPublishException extends SocialPublishException
{
    public static function fromApiResponse(mixed $response): static
    {
        /** @var Response $response */
        $status = $response->status();
        $rawResponse = $response->body();
        $code = (int) data_get($response->json(), 'code');
        $message = (string) data_get($response->json(), 'message', 'An unknown Discord error occurred.');

        // Missing access / missing permissions: the bot can't see or post in the channel.
        if (in_array($code, [50001, 50013], true) || $status === 403) {
            return new static(
                userMessage: "The bot can't post in this channel. Make sure it has access and permission to send messages there.",
                category: ErrorCategory::Permission,
                platformErrorCode: (string) $code,
                rawResponse: $rawResponse,
            );
        }

        // Unknown channel — it was deleted or the id is stale.
        if ($code === 10003) {
            return new static(
                userMessage: 'That Discord channel no longer exists. Pick a different channel.',
                category: ErrorCategory::Permission,
                platformErrorCode: (string) $code,
                rawResponse: $rawResponse,
            );
        }

        // Attachment too large.
        if ($code === 40005 || $status === 413) {
            return new static(
                userMessage: "A media file exceeds Discord's upload size limit.",
                category: ErrorCategory::MediaFormat,
                platformErrorCode: (string) $code,
                rawResponse: $rawResponse,
            );
        }

        // 401: the configured bot token is invalid (operator-level misconfiguration).
        if ($status === 401) {
            return new static(
                userMessage: 'Discord rejected the bot token. Check the DISCORD_BOT_TOKEN configuration.',
                category: ErrorCategory::Permission,
                platformErrorCode: (string) $status,
                rawResponse: $rawResponse,
            );
        }

        if ($status === 429) {
            return new static(
                userMessage: 'Discord rate limit reached. Please try again shortly.',
                category: ErrorCategory::RateLimit,
                platformErrorCode: (string) $status,
                rawResponse: $rawResponse,
            );
        }

        if ($status >= 500) {
            return new static(
                userMessage: 'Discord is temporarily unavailable. Please try again later.',
                category: ErrorCategory::ServerError,
                platformErrorCode: (string) $status,
                rawResponse: $rawResponse,
            );
        }

        return new static(
            userMessage: $message,
            category: ErrorCategory::Unknown,
            platformErrorCode: (string) $code,
            rawResponse: $rawResponse,
        );
    }

    public function platform(): string
    {
        return 'discord';
    }

    /**
     * Whether this response confirms the bot lost access to THIS specific
     * guild (kicked, missing access, or the guild is gone) — used by
     * ConnectionVerifier against getGuild's response.
     *
     * Deliberately NOT the same check fromApiResponse() uses above, and not
     * called from it: fromApiResponse() classifies channel-message responses
     * (channel-send scope, where a 403 there stays a Permission-category
     * publish failure rather than disconnecting the account — the bot could
     * still be a guild member with access to other channels), while this
     * classifies getGuild responses (guild-membership scope, where the same
     * 403/404 unambiguously means the bot is out of this guild entirely).
     * 401 is excluded from both: Discord auth is one bot token shared across
     * every connected account, so a 401 means that shared token is
     * misconfigured (an operator problem), never evidence that this specific
     * guild connection is dead.
     */
    public static function isConfirmedDeadGuild(Response $response): bool
    {
        return in_array($response->status(), [403, 404], true);
    }
}