SessionException.php

<?php
/*
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/.
 */
/**
 * Italix Session - SessionException
 *
 * @package Italix\Session
 */

declare(strict_types=1);

namespace Italix\Session;

use RuntimeException;

/**
 * Thrown when the library is asked for something it cannot honestly do.
 *
 * There are exactly three cases, and they are all configuration errors rather
 * than runtime conditions:
 *
 *   - a store is asked to list or revoke by subject when it cannot index
 *     (`can_find_by_subject() === false`) — returning an empty list instead
 *     would read as "one device", which is a lie the caller cannot detect;
 *   - a cookie is described in a way a browser would discard (`SameSite=None`
 *     without `Secure`, a `__Host-` name with a domain);
 *   - the facade is used before `begin()` or after `end()`.
 *
 * A missing session is **not** one of them: that is `SessionState::ABSENT`,
 * which every caller must handle anyway.
 */
class SessionException extends RuntimeException
{
}