Add new classes and methods for session management

src/Socialbox/Managers/SessionManager.php

@@ -0,0 +1,182 @@
+<?php
+
+    namespace Socialbox\Managers;
+
+    use DateMalformedStringException;
+    use DateTime;
+    use InvalidArgumentException;
+    use PDO;
+    use PDOException;
+    use Socialbox\Classes\Cryptography;
+    use Socialbox\Classes\Database;
+    use Socialbox\Classes\Utilities;
+    use Socialbox\Enums\SessionState;
+    use Socialbox\Enums\StandardError;
+    use Socialbox\Exceptions\DatabaseOperationException;
+    use Socialbox\Objects\SessionRecord;
+    use Symfony\Component\Uid\Uuid;
+
+    class SessionManager
+    {
+        /**
+         * Creates a new session with the given public key.
+         *
+         * @param string $publicKey The public key to associate with the new session.
+         *
+         * @return string The UUID of the newly created session.
+         *
+         * @throws InvalidArgumentException If the public key is empty or invalid.
+         * @throws DatabaseOperationException If there is an error while creating the session in the database.
+         */
+        public static function createSession(string $publicKey): string
+        {
+            if($publicKey === '')
+            {
+                throw new InvalidArgumentException('The public key cannot be empty', StandardError::RPC_INVALID_ARGUMENTS);
+            }
+
+            if(!Cryptography::validatePublicKey($publicKey))
+            {
+                throw new InvalidArgumentException('The given public key is invalid', StandardError::INVALID_PUBLIC_KEY);
+            }
+
+            $publicKey = Utilities::base64decode($publicKey);
+            $uuid = Uuid::v4()->toRfc4122();
+
+            try
+            {
+                $statement = Database::getConnection()->prepare("INSERT INTO sessions (uuid, public_key) VALUES (?, ?)");
+                $statement->bindParam(1, $uuid);
+                $statement->bindParam(2, $publicKey);
+                $statement->execute();
+            }
+            catch(PDOException $e)
+            {
+                throw new DatabaseOperationException('Failed to create a session on the database', $e);
+            }
+
+            return $uuid;
+        }
+
+        /**
+         * Checks if a session with the given UUID exists in the database.
+         *
+         * @param string $uuid The UUID of the session to check.
+         * @return bool True if the session exists, false otherwise.
+         * @throws DatabaseOperationException If there is an error executing the database query.
+         */
+        public static function sessionExists(string $uuid): bool
+        {
+            try
+            {
+                $statement = Database::getConnection()->prepare("SELECT COUNT(*) FROM sessions WHERE uuid=?");
+                $statement->bindParam(1, $uuid);
+                $statement->execute();
+                $result = $statement->fetchColumn();
+
+                return $result > 0;
+            }
+            catch(PDOException $e)
+            {
+                throw new DatabaseOperationException('Failed to check if the session exists', $e);
+            }
+        }
+
+        /**
+         * Retrieves a session record by its unique identifier.
+         *
+         * @param string $uuid The unique identifier of the session.
+         * @return SessionRecord The session record corresponding to the given UUID.
+         * @throws DatabaseOperationException If the session record cannot be found or if there is an error during retrieval.
+         */
+        public static function getSession(string $uuid): SessionRecord
+        {
+            try
+            {
+                $statement = Database::getConnection()->prepare("SELECT * FROM sessions WHERE uuid=?");
+                $statement->bindParam(1, $uuid);
+                $statement->execute();
+                $data = $statement->fetch(PDO::FETCH_ASSOC);
+
+                if ($data === false)
+                {
+                    throw new DatabaseOperationException(sprintf('Session record %s not found', $uuid));
+                }
+
+                // Convert the timestamp fields to DateTime objects
+                $data['created'] = new DateTime($data['created']);
+                $data['last_request'] = new DateTime($data['last_request']);
+
+                return SessionRecord::fromArray($data);
+            }
+            catch (PDOException | DateMalformedStringException $e)
+            {
+                throw new DatabaseOperationException(sprintf('Failed to retrieve session record %s', $uuid), $e);
+            }
+        }
+
+        /**
+         * Update the authenticated peer associated with the given session UUID.
+         *
+         * @param string $uuid The UUID of the session to update.
+         * @return void
+         */
+        public static function updateAuthenticatedPeer(string $uuid): void
+        {
+            try
+            {
+                $statement = Database::getConnection()->prepare("UPDATE sessions SET authenticated_peer_uuid=? WHERE uuid=?");
+                $statement->bindParam(1, $uuid);
+                $statement->bindParam(2, $uuid);
+                $statement->execute();
+            }
+            catch (PDOException $e)
+            {
+                throw new DatabaseOperationException('Failed to update authenticated peer', $e);
+            }
+        }
+
+        /**
+         * Updates the last request timestamp for a given session by its UUID.
+         *
+         * @param string $uuid The UUID of the session to be updated.
+         * @return void
+         */
+        public static function updateLastRequest(string $uuid): void
+        {
+            try
+            {
+                $formattedTime = (new DateTime('@' . time()))->format('Y-m-d H:i:s');
+                $statement = Database::getConnection()->prepare("UPDATE sessions SET last_request=? WHERE uuid=?");
+                $statement->bindValue(1, $formattedTime, PDO::PARAM_STR);
+                $statement->bindParam(2, $uuid);
+                $statement->execute();
+            }
+            catch (PDOException | DateMalformedStringException $e)
+            {
+                throw new DatabaseOperationException('Failed to update last request', $e);
+            }
+        }
+
+        /**
+         * Updates the state of a session given its UUID.
+         *
+         * @param string $uuid The unique identifier of the session to update.
+         * @param SessionState $state The new state to be set for the session.
+         * @return void No return value.
+         */
+        public static function updateState(string $uuid, SessionState $state): void
+        {
+            try
+            {
+                $state_value = $state->value;
+                $statement = Database::getConnection()->prepare('UPDATE sessions SET state=? WHERE uuid=?');
+                $statement->bindParam(1, $state_value);
+                $statement->bindParam(2, $uuid);
+            }
+            catch(PDOException $e)
+            {
+                throw new DatabaseOperationException('Failed to update session state', $e);
+            }
+        }
+    }