<h2>File Contents: /home/planet5/www/wp-content/plugins/wordpress-seo/src/myyoast-client/domain/registered-client.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/wp-content/plugins/wordpress-seo/src/myyoast-client/domain/registered-client.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php

namespace Yoast\WP\SEO\MyYoast_Client\Domain;

use InvalidArgumentException;
use SensitiveParameter;

/**
 * Immutable value object representing the result of Dynamic Client Registration.
 *
 * Stores the client_id, registration access token, and management endpoint URI
 * received from the authorization server during DCR (RFC 7591).
 */
class Registered_Client {

	/**
	 * The registered OAuth client ID.
	 *
	 * @var string
	 */
	private $client_id;

	/**
	 * The registration access token for RFC 7592 management operations.
	 *
	 * @var string
	 */
	private $registration_access_token;

	/**
	 * The management endpoint URL for this client registration.
	 *
	 * @var string
	 */
	private $registration_client_uri;

	/**
	 * Additional metadata from the registration response.
	 *
	 * @var array&lt;string, string|array&lt;string&gt;&gt;
	 */
	private $metadata;

	/**
	 * The redirect URIs that have completed the authorization-code flow on this site.
	 *
	 * Stored alongside the client (rather than in $metadata, which is reserved for standardized
	 * authorization-server metadata) so the validation state is invalidated automatically whenever
	 * the registration is removed or replaced.
	 *
	 * @var string[]
	 */
	private $validated_uris;

	/**
	 * Registered_Client constructor.
	 *
	 * @param string                              $client_id                 The registered client ID.
	 * @param string                              $registration_access_token The registration access token.
	 * @param string                              $registration_client_uri   The management endpoint URL.
	 * @param array&lt;string, string|array&lt;string&gt;&gt; $metadata                  Additional metadata from the registration response.
	 * @param string[]                            $validated_uris            Redirect URIs that have completed the auth-code flow.
	 *
	 * @throws InvalidArgumentException If client_id is empty.
	 */
	public function __construct(
		string $client_id,
		// phpcs:ignore PHPCompatibility.Attributes.NewAttributes.PHPNativeAttributeFound -- No-op on PHP &lt; 8.2; redacts parameter from stack traces on PHP 8.2+.
		#[SensitiveParameter]
		string $registration_access_token,
		string $registration_client_uri,
		array $metadata = [],
		array $validated_uris = []
	) {
		if ( $client_id === &#039;&#039; ) {
			throw new InvalidArgumentException( &#039;Registered_Client requires a non-empty client_id.&#039; );
		}

		$this-&gt;client_id                 = $client_id;
		$this-&gt;registration_access_token = $registration_access_token;
		$this-&gt;registration_client_uri   = $registration_client_uri;
		$this-&gt;metadata                  = $metadata;
		$this-&gt;validated_uris            = \array_values( $validated_uris );
	}

	/**
	 * Returns the registered client ID.
	 *
	 * @return string
	 */
	public function get_client_id(): string {
		return $this-&gt;client_id;
	}

	/**
	 * Returns the registration access token.
	 *
	 * @return string
	 */
	public function get_registration_access_token(): string {
		return $this-&gt;registration_access_token;
	}

	/**
	 * Returns the management endpoint URL.
	 *
	 * @return string
	 */
	public function get_registration_client_uri(): string {
		return $this-&gt;registration_client_uri;
	}

	/**
	 * Returns additional metadata from the registration response.
	 *
	 * @return array&lt;string, string|array&lt;string&gt;&gt;
	 */
	public function get_metadata(): array {
		return $this-&gt;metadata;
	}

	/**
	 * Returns the redirect URIs this client is registered with.
	 *
	 * @return string[]
	 */
	public function get_redirect_uris(): array {
		$redirect_uris = ( $this-&gt;metadata[&#039;redirect_uris&#039;] ?? [] );

		return ( \is_array( $redirect_uris ) ) ? \array_values( $redirect_uris ) : [];
	}

	/**
	 * Whether this client&#039;s registered redirect URIs exactly match the given set (order-insensitive),
	 * so both additions and removals count as a mismatch.
	 *
	 * @param string[] $redirect_uris The redirect-URI set to compare against.
	 *
	 * @return bool
	 */
	public function has_redirect_uris( array $redirect_uris ): bool {
		$wanted = \array_unique( $redirect_uris );
		$stored = \array_unique( $this-&gt;get_redirect_uris() );
		\sort( $wanted );
		\sort( $stored );

		return $wanted === $stored;
	}

	/**
	 * Returns the redirect URIs that have completed the authorization-code flow on this site.
	 *
	 * @return string[]
	 */
	public function get_validated_uris(): array {
		return $this-&gt;validated_uris;
	}

	/**
	 * Whether the given redirect URI has completed the authorization-code flow on this site.
	 *
	 * @param string $redirect_uri The redirect URI to check.
	 *
	 * @return bool
	 */
	public function is_uri_validated( string $redirect_uri ): bool {
		return \in_array( $redirect_uri, $this-&gt;validated_uris, true );
	}

	/**
	 * Returns a copy of this client with its validated redirect URIs replaced.
	 *
	 * @param string[] $validated_uris The redirect URIs that have completed the auth-code flow.
	 *
	 * @return self
	 */
	public function with_validated_uris( array $validated_uris ): self {
		return new self(
			$this-&gt;client_id,
			$this-&gt;registration_access_token,
			$this-&gt;registration_client_uri,
			$this-&gt;metadata,
			$validated_uris,
		);
	}

	/**
	 * Converts the DTO to an associative array for storage.
	 *
	 * @return array&lt;string, string|array&lt;string&gt;&gt;
	 */
	public function to_array(): array {
		return [
			&#039;client_id&#039;                 =&gt; $this-&gt;client_id,
			&#039;registration_access_token&#039; =&gt; $this-&gt;registration_access_token,
			&#039;registration_client_uri&#039;   =&gt; $this-&gt;registration_client_uri,
			&#039;metadata&#039;                  =&gt; $this-&gt;metadata,
			&#039;validated_uris&#039;            =&gt; $this-&gt;validated_uris,
		];
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fwp-content%2Fplugins%2Fwordpress-seo%2Fsrc%2Fmyyoast-client%2Fdomain'>⬅ Back to Directory</a>