<?php

namespace App\Support;

use Illuminate\Contracts\Database\Query\Builder as QueryBuilder;
use Illuminate\Database\Connection;
use Illuminate\Database\Eloquent\Builder;

/**
 * Case-insensitiver E-Mail-Vergleich, der den B-Tree-Index nutzt (Audit F22).
 *
 * `LOWER(email) = ?` schließt jeden Index aus – auf `companies` (110.000
 * Zeilen) ein Vollscan bei jedem Login. Die Spalten `users.email`,
 * `companies.email` und `contacts.email` tragen die Kollation
 * `utf8mb4_unicode_ci`, MySQL vergleicht also ohnehin ohne Groß-/Klein-
 * schreibung; der direkte Vergleich reicht und trifft den Index.
 *
 * SQLite (Testsuite) vergleicht `=` binär – dort bleibt LOWER(), damit die
 * Tests dieselbe Semantik prüfen. Der Aufrufer übergibt die Adresse bereits
 * kleingeschrieben und getrimmt.
 */
final class EmailQuery
{
    /**
     * @template TBuilder of Builder|QueryBuilder
     *
     * @param  TBuilder  $query
     * @return TBuilder
     */
    public static function whereEmail(Builder|QueryBuilder $query, string $email, string $column = 'email'): Builder|QueryBuilder
    {
        $connection = $query->getConnection();
        $driver = $connection instanceof Connection ? $connection->getDriverName() : 'unknown';

        if ($driver === 'mysql' || $driver === 'mariadb') {
            return $query->where($column, $email);
        }

        return $query->whereRaw('LOWER('.$column.') = ?', [$email]);
    }
}