First run at a setup

src/dashboard/application/search-rankings/top-page-repository.php

@@ -0,0 +1,42 @@
+<?php
+// phpcs:disable Yoast.NamingConventions.NamespaceName.TooLong -- Needed in the folder structure.
+namespace Yoast\WP\SEO\Dashboard\Application\Search_Rankings;
+
+use Yoast\WP\SEO\Dashboard\Domain\Data_Provider\Dashboard_Repository_Interface;
+use Yoast\WP\SEO\Dashboard\Domain\Data_Provider\Data_Container;
+use Yoast\WP\SEO\Dashboard\Domain\Data_Provider\Parameters;
+use Yoast\WP\SEO\Dashboard\Infrastructure\Search_Console\Site_Kit_Search_Console_Adapter;
+
+/**
+ * The data provider for search ranking related data.
+ */
+class Top_Page_Repository implements Dashboard_Repository_Interface {
+
+	/**
+	 * The adapter.
+	 *
+	 * @var Site_Kit_Search_Console_Adapter $site_kit_search_console_adapter
+	 */
+	private $site_kit_search_console_adapter;
+
+	/**
+	 * The constructor.
+	 *
+	 * @param Site_Kit_Search_Console_Adapter $site_kit_search_console_adapter The adapter.
+	 */
+	public function __construct( Site_Kit_Search_Console_Adapter $site_kit_search_console_adapter ) {
+		$this->site_kit_search_console_adapter = $site_kit_search_console_adapter;
+	}
+
+	/**
+	 * Method to get search related data from a provider.
+	 *
+	 * @param Parameters $parameters The parameter to get the search data for.
+	 *
+	 * @return Data_Container
+	 */
+	public function get_data( Parameters $parameters ): Data_Container {
+
+		return $this->site_kit_search_console_adapter->get_data( $parameters );
+	}
+}

src/dashboard/application/search-rankings/top-query-repository.php

@@ -0,0 +1,42 @@
+<?php
+// phpcs:disable Yoast.NamingConventions.NamespaceName.TooLong -- Needed in the folder structure.
+namespace Yoast\WP\SEO\Dashboard\Application\Search_Rankings;
+
+use Yoast\WP\SEO\Dashboard\Domain\Data_Provider\Dashboard_Repository_Interface;
+use Yoast\WP\SEO\Dashboard\Domain\Data_Provider\Data_Container;
+use Yoast\WP\SEO\Dashboard\Domain\Data_Provider\Parameters;
+use Yoast\WP\SEO\Dashboard\Infrastructure\Search_Console\Site_Kit_Search_Console_Adapter;
+
+/**
+ * The data provider for search ranking related data.
+ */
+class Top_Query_Repository implements Dashboard_Repository_Interface {
+
+	/**
+	 * The adapter.
+	 *
+	 * @var Site_Kit_Search_Console_Adapter $site_kit_search_console_adapter
+	 */
+	private $site_kit_search_console_adapter;
+
+	/**
+	 * The constructor.
+	 *
+	 * @param Site_Kit_Search_Console_Adapter $site_kit_search_console_adapter The adapter.
+	 */
+	public function __construct( Site_Kit_Search_Console_Adapter $site_kit_search_console_adapter ) {
+		$this->site_kit_search_console_adapter = $site_kit_search_console_adapter;
+	}
+
+	/**
+	 * Method to get search related data from a provider.
+	 *
+	 * @param Parameters $parameters The parameter to get the search data for.
+	 *
+	 * @return Data_Container
+	 */
+	public function get_data( Parameters $parameters ): Data_Container {
+
+		return $this->site_kit_search_console_adapter->get_data( $parameters );
+	}
+}

src/dashboard/domain/data-provider/dashboard-repository-interface.php

@@ -0,0 +1,18 @@
+<?php
+// phpcs:disable Yoast.NamingConventions.NamespaceName.TooLong -- Needed in the folder structure.
+namespace Yoast\WP\SEO\Dashboard\Domain\Data_Provider;
+
+/**
+ * Interface describing the way to get data for a specific data provider.
+ */
+interface Dashboard_Repository_Interface {
+
+	/**
+	 * Method to get search related data from a provider.
+	 *
+	 * @param Parameters $parameters The parameter to get the search data for.
+	 *
+	 * @return Data_Container
+	 */
+	public function get_data( Parameters $parameters ): Data_Container;
+}

src/dashboard/domain/data-provider/data-container.php

@@ -0,0 +1,48 @@
+<?php
+// phpcs:disable Yoast.NamingConventions.NamespaceName.TooLong -- Needed in the folder structure.
+namespace Yoast\WP\SEO\Dashboard\Domain\Data_Provider;
+
+/**
+ * The data container.
+ */
+class Data_Container {
+
+	/**
+	 * All the search data points.
+	 *
+	 * @var array<Data_Interface> $data_container
+	 */
+	private $data_container;
+
+	/**
+	 * The constructor
+	 */
+	public function __construct() {
+		$this->data_container = [];
+	}
+
+	/**
+	 * Method to add data.
+	 *
+	 * @param Data_Interface $data The data.
+	 *
+	 * @return void
+	 */
+	public function add_data( Data_Interface $data ) {
+		$this->data_container[] = $data;
+	}
+
+	/**
+	 * Converts the list to an array.
+	 *
+	 * @return array<string,string> The array of endpoints.
+	 */
+	public function to_array(): array {
+		$result = [];
+		foreach ( $this->data_container as $data ) {
+			$result[] = $data->to_array();
+		}
+
+		return $result;
+	}
+}

src/dashboard/domain/data-provider/data-interface.php

@@ -0,0 +1,16 @@
+<?php
+// phpcs:disable Yoast.NamingConventions.NamespaceName.TooLong -- Needed in the folder structure.
+namespace Yoast\WP\SEO\Dashboard\Domain\Data_Provider;
+
+/**
+ * The interface to describe the data domain.
+ */
+interface Data_Interface {
+
+	/**
+	 * A to array method.
+	 *
+	 * @return array<string>
+	 */
+	public function to_array(): array;
+}

src/dashboard/domain/data-provider/parameters.php

@@ -0,0 +1,90 @@
+<?php
+// phpcs:disable Yoast.NamingConventions.NamespaceName.TooLong -- Needed in the folder structure.
+namespace Yoast\WP\SEO\Dashboard\Domain\Data_Provider;
+
+/**
+ * Object representation of the request parameters.
+ */
+abstract class Parameters {
+
+	/**
+	 * The start date.
+	 *
+	 * @var string $start_date
+	 */
+	private $start_date;
+
+	/**
+	 * The end date.
+	 *
+	 * @var string $end_date
+	 */
+	private $end_date;
+
+	/**
+	 * The amount of results.
+	 *
+	 * @var int $limit
+	 */
+	private $limit;
+
+	/**
+	 * Getter for the start date.
+	 *
+	 * @return string
+	 */
+	public function get_start_date(): string {
+		return $this->start_date;
+	}
+
+	/**
+	 * Getter for the end date.
+	 * The date format should be Y-M-D.
+	 *
+	 * @return string
+	 */
+	public function get_end_date(): string {
+		return $this->end_date;
+	}
+
+	/**
+	 * Getter for the result limit.
+	 *
+	 * @return int
+	 */
+	public function get_limit(): int {
+		return $this->limit;
+	}
+
+	/**
+	 * The start date setter.
+	 *
+	 * @param string $start_date The start date.
+	 *
+	 * @return void
+	 */
+	public function set_start_date( string $start_date ): void {
+		$this->start_date = $start_date;
+	}
+
+	/**
+	 * The end date setter.
+	 *
+	 * @param string $end_date The end date.
+	 *
+	 * @return void
+	 */
+	public function set_end_date( string $end_date ): void {
+		$this->end_date = $end_date;
+	}
+
+	/**
+	 * The result limit.
+	 *
+	 * @param int $limit The result limit.
+	 * @return void
+	 */
+	public function set_limit( int $limit ): void {
+		$this->limit = $limit;
+	}
+}

src/dashboard/domain/search-rankings/search-data.php

@@ -0,0 +1,87 @@
+<?php
+// phpcs:disable Yoast.NamingConventions.NamespaceName.TooLong -- Needed in the folder structure.
+namespace Yoast\WP\SEO\Dashboard\Domain\Search_Rankings;
+
+use Yoast\WP\SEO\Dashboard\Domain\Data_Provider\Data_Interface;
+
+/**
+ * Domain object that represents a single Search Data record.
+ */
+class Search_Data implements Data_Interface {
+
+	/**
+	 * The amount of clicks a `key` gets.
+	 *
+	 * @var int $clicks
+	 */
+	private $clicks;
+
+	/**
+	 * The click-through rate a `key` gets.
+	 *
+	 * @var float $clicks
+	 */
+	private $ctr;
+
+	/**
+	 * The amount of impressions a `key` gets.
+	 *
+	 * @var int $impressions
+	 */
+	private $impressions;
+
+	/**
+	 * The average position for the given `key`.
+	 *
+	 * @var float $position
+	 */
+	private $position;
+
+	/**
+	 * In the context of this domain object subject can represent a `URI` or a `search term`
+	 *
+	 * @var string
+	 */
+	private $subject;
+
+	/**
+	 * The seo score.
+	 *
+	 * @var int
+	 */
+	private $seo_score;
+
+	/**
+	 * The constructor.
+	 *
+	 * @param int    $clicks      The clicks.
+	 * @param float  $ctr         The ctr.
+	 * @param int    $impressions The impressions.
+	 * @param float  $position    The position.
+	 * @param string $subject     The subject of the data.
+	 */
+	public function __construct( int $clicks, float $ctr, int $impressions, float $position, string $subject ) {
+		$this->clicks      = $clicks;
+		$this->ctr         = $ctr;
+		$this->impressions = $impressions;
+		$this->position    = $position;
+		$this->subject     = $subject;
+		$this->seo_score   = 0;
+	}
+
+	/**
+	 * The array representation of this domain object.
+	 *
+	 * @return array<string|float|int|string[]>
+	 */
+	public function to_array(): array {
+		return [
+			'clicks'      => $this->clicks,
+			'ctr'         => $this->ctr,
+			'impressions' => $this->impressions,
+			'position'    => $this->position,
+			'subject'     => $this->subject,
+			'seoScore'    => $this->seo_score,
+		];
+	}
+}