1	<?php
2
3	declare(strict_types=1);
4
5	/**
6	* This file is part of php-fast-forward/http-message.
7	*
8	* This source file is subject to the license bundled
9	* with this source code in the file LICENSE.
10	*
11	* @copyright Copyright (c) 2025-2026 Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
12	* @license   https://opensource.org/licenses/MIT MIT License
13	*
14	* @see       https://github.com/php-fast-forward/http-message
15	* @see       https://github.com/php-fast-forward
16	* @see       https://datatracker.ietf.org/doc/html/rfc2119
17	*/
18
19	namespace FastForward\Http\Message\Header\Authorization;
20
21	/**
22	* Interface AuthorizationCredential.
23	*
24	* Represents the structured credential extracted from an HTTP
25	* `Authorization` header. Implementations of this interface MUST model the
26	* specific authentication scheme used by the client, such as API Key,
27	* Basic, Bearer, Digest, or AWS Signature Version 4.
28	*
29	* Types implementing this interface SHALL be returned by the
30	* {@see FastForward\Http\Message\Header\Authorization::parse()} and related
31	* helper methods. They MUST encapsulate all information necessary for
32	* downstream authentication logic to validate the user agent.
33	*
34	* This interface does not enforce any specific methods, but implementors
35	* SHOULD expose immutable, well-typed public properties or accessors to
36	* represent authentication values in a safe and structured form.
37	*/
38	interface AuthorizationCredential {}