<?php

declare(strict_types=1);

namespace Jasny\Auth;

use Jasny\Auth\UserInterface as User;
use Jasny\Auth\ContextInterface as Context;

/**
 * Interface to storage of persistent (user) data.
 */
interface StorageInterface
{
    /**
     * Fetch user from DB by id.
     */
    public function fetchUserById(string $id): ?User;

    /**
     * Fetch user from DB by username.
     */
    public function fetchUserByUsername(string $username): ?User;

    /**
     * Fetch context from DB by id.
     */
    public function fetchContext(string $id): ?Context;

    /**
     * Get the default context for the user.
     */
    public function getContextForUser(User $user): ?Context;
}