From b908dc6ea394cf9dd89d75b6d61952fd2bb4f39f Mon Sep 17 00:00:00 2001
From: Dave Smith-Hayes <me@davesmithhayes.com>
Date: Thu, 23 May 2024 21:24:57 -0400
Subject: [PATCH] Add an Entity trait, format the example RSS feed, work on the
 Repository patterns.

---
 app/src/Domain/Entity.php                     | 43 ++++++++++
 app/src/Domain/{Model => Entity}/Channel.php  |  2 +-
 app/src/Domain/{Model => Entity}/User.php     | 27 ++++---
 app/src/Domain/Repository/UserRepository.php  | 79 +++++++++++++++++++
 .../Repository/UserRepositoryInterface.php    | 13 +++
 app/src/Exception/EntityNotFoundException.php |  7 ++
 etc/example-podbean-rss.xml                   |  9 ++-
 7 files changed, 167 insertions(+), 13 deletions(-)
 create mode 100644 app/src/Domain/Entity.php
 rename app/src/Domain/{Model => Entity}/Channel.php (97%)
 rename app/src/Domain/{Model => Entity}/User.php (69%)
 create mode 100644 app/src/Domain/Repository/UserRepository.php
 create mode 100644 app/src/Domain/Repository/UserRepositoryInterface.php
 create mode 100644 app/src/Exception/EntityNotFoundException.php

diff --git a/app/src/Domain/Entity.php b/app/src/Domain/Entity.php
new file mode 100644
index 0000000..d88b7f4
--- /dev/null
+++ b/app/src/Domain/Entity.php
@@ -0,0 +1,43 @@
+<?php
+
+namespace Slovocast\Domain;
+
+use DateTime;
+use DateTimeImmutable;
+
+trait Entity
+{
+    protected int $id;
+    protected DateTimeImmutable $createdAt;
+    protected DateTime $updatedAt;
+
+    public function setId(int $id): void
+    {
+        $this->id = $id;
+    }
+
+    public function getId(): int
+    {
+        return $this->id;
+    }
+
+    public function setCreatedAt(DateTimeImmutable $createdAt): void
+    {
+        $this->createdAt = $createdAt;
+    }
+
+    public function getCreatedAt(): DateTimeImmutable
+    {
+        return $this->createdAt;
+    }
+
+    public function setUpdatedAt(DateTime $updatedAt): void
+    {
+        $this->updatedAt = $updatedAt;
+    }
+
+    public function getUpdatedAt(): DateTime
+    {
+        return $this->updatedAt;
+    }
+}
diff --git a/app/src/Domain/Model/Channel.php b/app/src/Domain/Entity/Channel.php
similarity index 97%
rename from app/src/Domain/Model/Channel.php
rename to app/src/Domain/Entity/Channel.php
index 66cf65f..f8f6369 100644
--- a/app/src/Domain/Model/Channel.php
+++ b/app/src/Domain/Entity/Channel.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace Slovocast\Domain\Model;
+namespace Slovocast\Domain\Entity;
 
 class Channel
 {
diff --git a/app/src/Domain/Model/User.php b/app/src/Domain/Entity/User.php
similarity index 69%
rename from app/src/Domain/Model/User.php
rename to app/src/Domain/Entity/User.php
index fe01a58..3d4eb2c 100644
--- a/app/src/Domain/Model/User.php
+++ b/app/src/Domain/Entity/User.php
@@ -1,19 +1,18 @@
 <?php
 
-namespace Slovocast\Domain\Model;
+namespace Slovocast\Domain\Entity;
+
+use Slovocast\Domain\Entity;
 
 class User
 {
+    use Entity;
+
     public function __construct(
-        private readonly ?int $id,
         private string $email,
         private string $password,
         private string $name
-    ) {
-        $this->email = $email;
-        $this->password = $password;
-        $this->name;
-    }
+    ) { }
 
     public function getEmail(): string
     {
@@ -37,7 +36,7 @@ class User
      */
     public function isNew(): bool
     {
-        return (bool) $this->id;
+        return (bool) $this->getId();
     }
 
     /**
@@ -46,11 +45,19 @@ class User
      */
     public static function fromArray(array $props): User
     {
-        return new self(
-            $props['id'] ?? null,
+        $user = new self(
             $props['email'],
             $props['password'],
             $props['name']
         );
+
+        if ($props['id']) {
+            $user->setId($props['id']);
+        }
+
+        $user->setCreatedAt($props['createdAt']);
+        $user->setUpdatedAt($props['updatedAt']);
+
+        return $user;
     }
 }
diff --git a/app/src/Domain/Repository/UserRepository.php b/app/src/Domain/Repository/UserRepository.php
new file mode 100644
index 0000000..a2cd438
--- /dev/null
+++ b/app/src/Domain/Repository/UserRepository.php
@@ -0,0 +1,79 @@
+<?php
+
+namespace Slovocast\Domain\Repository;
+
+use Slovocast\Infrastructure\DatabaseConnectionInterface;
+use Slovocast\Exception\EntityNotFoundException;
+use Slovocast\Domain\Entity\User;
+use PDO;
+
+class UserRepository implements UserRepositoryInterface
+{
+    public function __construct(
+        private DatabaseConnectionInterface $database
+    ) {}
+
+    /**
+     * @param array $results The Query Results asking for all properties from
+     *                       the database tables.
+     * @return User
+     */
+    protected function userFromQueryResults(array $results): User
+    {
+        return User::fromArray([
+            'id' => $results['id'],
+            'email' => $results['email'],
+            'password' => $results['password'],
+            'name' => $results['name'],
+            'createdAt' => $results['created_at'],
+            'updatedAt' => $results['updated_at']
+        ]);
+    }
+
+    /**
+     * @param string $query The Query for getting a User
+     * @param arary $params The parameters in the query
+     * @param PDO $connection The PDO connection
+     * @return array The column data from the Database
+     * @throws EntityNotFoundException The User does no exist
+     */
+    protected function queryForUser(
+        string $query,
+        array $params,
+        PDO $connection
+    ): array {
+        $statement = $connection->prepare($query);
+        $statement->execute($params);
+        $results = $statement->fetchAll();
+
+        if (!$results) {
+            throw new EntityNotFoundException("Unable to find User");
+        }
+
+        return array_shift($results);
+    }
+
+    public function get(int $id): User
+    {
+        $query = "SELECT * FROM users WHERE id = :id LIMIT 1";
+        $connection = $this->database->getConnection();
+        $userData = $this->queryForUser(
+            $query,
+            [ 'id' => $id ],
+            $connection
+        );
+        return $this->userFromQueryResults($userData);
+    }
+
+    public function getFromEmail(string $email): User
+    {
+        $query = "SELECT * FROM users WHERE email = :email LIMIT 1";
+        $connection = $this->database->getConnection();
+        $userData = $this->queryForUser(
+            $query, 
+            [ 'email' => $email ], 
+            $connection
+        );
+        return $this->userFromQueryResults($userData);
+    }
+}
diff --git a/app/src/Domain/Repository/UserRepositoryInterface.php b/app/src/Domain/Repository/UserRepositoryInterface.php
new file mode 100644
index 0000000..e01503e
--- /dev/null
+++ b/app/src/Domain/Repository/UserRepositoryInterface.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace Slovocast\Domain\Repository;
+
+use Slovocast\Domain\Model\User;
+
+interface UserRepositoryInterface
+{
+    public function get(int $id): User;
+    public function getFromEmail(string $email): User;
+    public function save(User $user): bool;
+    public function update(User $user): bool;
+}
diff --git a/app/src/Exception/EntityNotFoundException.php b/app/src/Exception/EntityNotFoundException.php
new file mode 100644
index 0000000..a991f97
--- /dev/null
+++ b/app/src/Exception/EntityNotFoundException.php
@@ -0,0 +1,7 @@
+<?php
+
+namespace Slovocast\Exception;
+
+use Exception;
+
+class EntityNotFoundException extends Exception { }
diff --git a/etc/example-podbean-rss.xml b/etc/example-podbean-rss.xml
index e0a65f1..f28f26a 100644
--- a/etc/example-podbean-rss.xml
+++ b/etc/example-podbean-rss.xml
@@ -53,8 +53,12 @@
             <comments>https://kevyscountrybreakfast.podbean.com/e/episode-5-sarasota-sizzle/#comments</comments>
             <pubDate>Tue, 12 May 2020 21:30:08 -0300</pubDate>
             <guid isPermaLink="false">kevyscountrybreakfast.podbean.com/d7b42df5-ecf9-593a-803f-40d3a054cc6f</guid>
-            <description><![CDATA[<p>Ah, the sounds of spring. Birds chirping, dogs grilling, and the triumphant return of Kevys Country Breakfast. Join us for an all access guided tour as the Princes of Pod prepare to reclaim their crown of audio royalty. Plus, Taiwanese Baseball and Dave’s perverted palate.</p>]]></description>
-            <content:encoded><![CDATA[<p>Ah, the sounds of spring. Birds chirping, dogs grilling, and the triumphant return of Kevys Country Breakfast. Join us for an all access guided tour as the Princes of Pod prepare to reclaim their crown of audio royalty. Plus, Taiwanese Baseball and Dave’s perverted palate.</p>]]></content:encoded>
+            <description>
+                <![CDATA[<p>Ah, the sounds of spring. Birds chirping, dogs grilling, and the triumphant return of Kevys Country Breakfast. Join us for an all access guided tour as the Princes of Pod prepare to reclaim their crown of audio royalty. Plus, Taiwanese Baseball and Dave’s perverted palate.</p>]]>
+            </description>
+            <content:encoded>
+                <![CDATA[<p>Ah, the sounds of spring. Birds chirping, dogs grilling, and the triumphant return of Kevys Country Breakfast. Join us for an all access guided tour as the Princes of Pod prepare to reclaim their crown of audio royalty. Plus, Taiwanese Baseball and Dave’s perverted palate.</p>]]>
+            </content:encoded>
 
             <enclosure url="https://mcdn.podbean.com/mf/web/sby3om/kcb-episode-5-demo-cut-14.mp3" length="49453453" type="audio/mpeg"/>
             
@@ -68,6 +72,7 @@
             <itunes:episodeType>full</itunes:episodeType>
             <itunes:image href="https://pbcdn1.podbean.com/imglogo/image-logo/4943691/kcb-banner.jpg" />
         </item>
+
         <item>
             <title>Episode #4: Oh Barry, Where Art Thou?</title>
             <itunes:title>Episode #4: Oh Barry, Where Art Thou?</itunes:title>