<?php

/**
 * @package         Regular Labs Library
 * @version         26.5.22170
 * 
 * @author          Peter van Westen <info@regularlabs.com>
 * @link            https://regularlabs.com
 * @copyright       Copyright © 2026 Regular Labs All Rights Reserved
 * @license         GNU General Public License version 2 or later
 */
namespace RegularLabs\Library;

use DateTimeZone;
use Joomla\CMS\User\User as JUser;
defined('_JEXEC') or die;
class User
{
    public static function authorise(string $action, ?string $assetname = null, ?int $id = null): bool
    {
        return self::get($id)->authorise($action, $assetname) ?? \false;
    }
    public static function get(?int $id = null): JUser
    {
        $user = $id ? \RegularLabs\Library\Runtime::getUserFactory()->loadUserById($id) : \RegularLabs\Library\Runtime::getApplication()->getIdentity();
        return $user ?? \RegularLabs\Library\Runtime::getUserFactory()->loadUserById(0);
    }
    public static function getAuthorisedCategories(string $component, string $action, ?int $id = null): array
    {
        return self::get($id)->getAuthorisedCategories($component, $action);
    }
    public static function getAuthorisedGroups(?int $id = null): array
    {
        return self::get($id)->getAuthorisedGroups();
    }
    public static function getAuthorisedViewLevels(?int $id = null): array
    {
        return self::get($id)->getAuthorisedViewLevels();
    }
    public static function getByEmail(string $email): ?JUser
    {
        return self::getByKey('email', $email);
    }
    public static function getById(?int $id = null): ?JUser
    {
        if (!$id) {
            return null;
        }
        $user = static::get($id);
        if ($user->guest) {
            return null;
        }
        return $user;
    }
    public static function getByKey(string $key, string $value): ?JUser
    {
        $id = self::getIdByKey($key, $value);
        if (!$id) {
            return null;
        }
        return self::getById($id);
    }
    public static function getByUsername(string $username): ?JUser
    {
        return self::getByKey('username', $username);
    }
    public static function getEmail(?int $id = null): string
    {
        return (string) self::getValue('email', $id, '');
    }
    public static function getId(?int $id = null): int
    {
        return (int) self::getValue('id', $id, 0);
    }
    public static function getName(?int $id = null): string
    {
        return (string) self::getValue('name', $id, '');
    }
    public static function getTimezone(?int $id = null): DateTimeZone
    {
        return self::get($id)->getTimezone();
    }
    public static function getUsername(?int $id = null): string
    {
        return (string) self::getValue('username', $id, '');
    }
    public static function getValue(string $key, ?int $id = null, $default = null): mixed
    {
        $user = self::get($id);
        return $user->{$key} ?? $default;
    }
    public static function hasId(int $id): bool
    {
        return self::getId() === $id;
    }
    public static function isAdministrator(?int $id = null): bool
    {
        return self::get($id)->authorise('core.admin') ?? \false;
    }
    public static function isCurrent(int $id): bool
    {
        return self::hasId($id);
    }
    public static function isGuest(?int $id = null): bool
    {
        return (bool) self::getValue('guest', $id, \true);
    }
    private static function getIdByKey(string $key, string $value): int
    {
        $cache = new \RegularLabs\Library\Cache();
        if ($cache->exists()) {
            return $cache->get();
        }
        $db = \RegularLabs\Library\DB::get();
        $query = $db->getQuery(\true)->select($db->quoteName('id'))->from($db->quoteName('#__users'))->where($db->quoteName($key) . ' = :value')->bind(':value', $value)->setLimit(1);
        $db->setQuery($query);
        $id = (int) $db->loadResult();
        return $cache->set($id);
    }
}