<?php
/**
 * The author of a post as a Person node.
 *
 * @package ElevenRank
 * @since   1.0.0
 */

namespace ElevenRank\Modules\Schema;

defined( 'ABSPATH' ) || exit;

/**
 * Only what the site already shows publicly: the display name and the address of the author's page.
 * No e-mail address, no profile picture address.
 *
 * @since 1.0.0
 */
final class Author_Node {

	/**
	 * The Person node of a user.
	 *
	 * @since 1.0.0
	 *
	 * @param int $user_id User id.
	 * @return array<string, mixed>|null Null when the user has no display name.
	 */
	public static function build( int $user_id ): ?array {
		if ( $user_id < 1 ) {
			return null;
		}

		$name = trim( (string) get_the_author_meta( 'display_name', $user_id ) );

		if ( '' === $name ) {
			return null;
		}

		return array(
			'@type' => 'Person',
			'@id'   => Ids::author( $user_id ),
			'name'  => $name,
			'url'   => get_author_posts_url( $user_id ),
		);
	}
}