<?php
/**
 * Email address value object.
 *
 * @package Bookline
 */

declare( strict_types=1 );

namespace Bookline\Domain\Shared;

/**
 * Normalises to lowercase and validates format.
 *
 * @since 0.1.0
 */
final class EmailAddress {

	/**
	 * Canonical lowercase email.
	 *
	 * @var string
	 */
	private string $value;

	/**
	 * Constructor.
	 *
	 * @param string $value Email address.
	 *
	 * @throws DomainException When the address is invalid.
	 */
	public function __construct( string $value ) {
		$value = strtolower( trim( $value ) );
		if ( '' === $value || false === filter_var( $value, FILTER_VALIDATE_EMAIL ) ) {
			throw new DomainException( 'email.invalid', 'Email address is not valid.' );
		}
		if ( strlen( $value ) > 255 ) {
			throw new DomainException( 'email.too_long', 'Email address exceeds 255 characters.' );
		}
		$this->value = $value;
	}

	/**
	 * To string.
	 *
	 * @since 0.1.0
	 */
	public function to_string(): string {
		return $this->value;
	}

	/**
	 * Equals.
	 *
	 * @param self $other Parameter.
	 * @since 0.1.0
	 */
	public function equals( self $other ): bool {
		return $this->value === $other->value;
	}

	/**
	 * String cast.
	 *
	 * @since 0.1.0
	 */
	public function __toString(): string {
		return $this->value;
	}
}