Allow usage of ArrayObject instances as Repository results

template/web/wp-content/themes/<%= slug %>/app/Repositories/AbstractRepository.php

@@ -1,48 +1,71 @@
 <?php
 /**
- * Parent repository class. Provides a very basic, fluent interface to interact
- * with query
+ * Abstract repository class.
  *
  * @package Studiometa
+ * @subpackage Repositories
  */
 
 namespace Studiometa\Repositories;
 
+use ArrayObject;
+
 /** Class */
 abstract class AbstractRepository {
 	/**
-	 * List of posts.
+	 * List of results.
 	 *
-	 * @var array
+	 * @var array|ArrayObject<int, mixed>
 	 */
-	private $result_set = array();
+	private $results = array();
 
 	/**
-	 * Returns an array of posts.
+	 * Returns the results.
 	 *
-	 * @return array
+	 * @return array|ArrayObject<int, mixed>
 	 */
 	public function get() {
-		return $this->result_set;
+		return $this->results;
+	}
+
+	/**
+	 * Set the results.
+	 *
+	 * @param array|ArrayObject<int, mixed> $results The results to set.
+	 * @return $this
+	 */
+	private function set( $results ) {
+		$this->results = $results;
+		return $this;
 	}
 
 	/**
 	 * Returns the first item in a collection. Returns null if there are 0 items in
 	 * the collection.
 	 *
-	 * @return mixed
+	 * @return mixed|null
 	 */
 	public function first() {
-		$local_array = $this->get();
-		return isset( $local_array[0] ) ? $local_array[0] : null;
+		$array = (array) $this->get();
+		return $array[ array_key_first( $array ) ] ?? null;
+	}
+
+	/**
+	 * Get the last item in a collection, null if the collection is empty.
+	 *
+	 * @return mixed|null
+	 */
+	public function last() {
+		$array = (array) $this->get();
+		return $array[ array_key_last( $array ) ] ?? null;
 	}
 
 	/**
 	 * Runs a query.
 	 *
 	 * @param array $params Query params.
 	 *
-	 * @return AbstractRepository
+	 * @return $this
 	 */
 	protected function query( array $params ) {
 		// Clear old result sets.
@@ -53,7 +76,7 @@ protected function query( array $params ) {
 
 		if ( false !== $cached_results && count( $cached_results ) > 0 ) {
 			// Use cached results.
-			return $this->result_set( $cached_results );
+			return $this->set( $cached_results );
 		}
 
 		$results = $this->do_query( $params );
@@ -63,7 +86,7 @@ protected function query( array $params ) {
 			wp_cache_set( $cache_key, $results, __CLASS__ );
 		}
 
-		return $this->result_set( $results );
+		return $this->set( $results );
 	}
 
 	/**
@@ -81,23 +104,10 @@ abstract protected function do_query( $params );
 	/**
 	 * Clears the current result set.
 	 *
-	 * @return AbstractRepository
+	 * @return $this
 	 */
 	protected function reset() {
-		$this->result_set = array();
-		return $this;
-	}
-
-	/**
-	 * Returns current result set
-	 *
-	 * @param array $result_set Result set.
-	 *
-	 * @return AbstractRepository
-	 */
-	protected function result_set( $result_set = array() ) {
-		$this->result_set = $result_set;
+		$this->set( array() );
 		return $this;
 	}
-
 }

template/web/wp-content/themes/<%= slug %>/app/Repositories/PostRepository.php

@@ -33,7 +33,7 @@ public function do_query( $params ) {
 	 * @param array        $exclude Posts to exclude (optional).
 	 * @param integer      $paged   Enable pagination (optional).
 	 *
-	 * @return AbstractRepository
+	 * @return $this
 	 */
 	public function posts_by_category_slug( $slug, $limit = 10, $exclude = array(), $paged = 0 ) {
 
@@ -77,7 +77,7 @@ public function posts_by_category_slug( $slug, $limit = 10, $exclude = array(),
 	 * @param array   $exclude    IDs of posts to exclude.
 	 * @param integer $paged      Enable pagination.
 	 *
-	 * @return AbstractRepository
+	 * @return $this
 	 */
 	public function latest_posts( $limit = 10, array $exclude = array(), $paged = 0 ) {
 

template/web/wp-content/themes/<%= slug %>/app/Repositories/TermRepository.php

@@ -30,7 +30,7 @@ public function do_query( $params ) {
 	 * @param array        $exclude  IDs of posts to exclude.
 	 * @param int          $limit    Number of maximum results.
 	 *
-	 * @return AbstractRepository
+	 * @return $this
 	 */
 	public function top_level_terms( $taxonomy, $exclude = array(), $limit = 100 ) {
 		// Set sane defaults so we don't do full table scans.