<?php
declare(strict_types=1);

namespace Soon\Api\Core;

use PDOException;
use Throwable;

/**
 * API 未捕获异常 → JSON 响应（避免空白 500）。
 */
final class ErrorHandler
{
    public static function register(): void
    {
        set_exception_handler([self::class, 'handleException']);
    }

    public static function handleException(Throwable $e): void
    {
        $path = parse_url($_SERVER['REQUEST_URI'] ?? '/', PHP_URL_PATH) ?: '/';
        if (!str_starts_with($path, '/api/')) {
            http_response_code(500);
            exit;
        }
        $debug = (bool)Config::get('app.debug', false);
        $code = 'server_error';
        $msg = '服务器错误，请稍后重试';
        $status = 500;

        if ($e instanceof PDOException) {
            $msg = '数据库操作失败';
            $sqlState = (string)$e->getCode();
            $detail = $e->getMessage();
            if (str_contains($detail, 'max_allowed_packet') || str_contains($detail, 'Packet too large')) {
                $code = 'payload_too_large';
                $msg = '文件过大，超出服务器数据库限制';
                $status = 413;
            } elseif (str_contains($detail, 'Unknown column') || str_contains($detail, "doesn't exist")) {
                $msg = '数据库结构不完整，请导入 database/schema.sql 或执行 php scripts/migrate-schema.php';
            } elseif ($sqlState === '22001' || str_contains($detail, 'Data too long')) {
                $code = 'payload_too_large';
                $msg = '文件内容过长，无法保存';
                $status = 413;
            }
        }

        if ($debug) {
            $msg .= ' (' . $e->getMessage() . ')';
        }
        Json::fail($code, $msg, $status);
    }
}