* SPDX-License-Identifier: AGPL-3.0-or-later */ namespace KTXF\Mail\Entity; use JsonSerializable; /** * Mail Address Interface * * Represents an email address with optional display name. * * @since 2025.05.01 */ interface IAddress extends JsonSerializable { public const JSON_PROPERTY_ADDRESS = 'address'; public const JSON_PROPERTY_NAME = 'name'; /** * Gets the email address * * @since 2025.05.01 * * @return string Email address (e.g., "user@example.com") */ public function getAddress(): string; /** * Gets the display name * * @since 2025.05.01 * * @return string|null Display name (e.g., "John Doe") or null */ public function getName(): ?string; /** * Gets the formatted address string * * @since 2025.05.01 * * @return string Formatted as "Name

" or just "address" if no name */ public function toString(): string; }