feat(database): support inserting and updating relationships

Author: innocenzi

packages/database/src/Builder/QueryBuilders/InsertQueryBuilder.php

@@ -5,7 +5,6 @@
 namespace Tempest\Database\Builder;
 
 use Stringable;
-use Tempest\Reflection\ClassReflector;
 
 final readonly class TableDefinition implements Stringable
 {

packages/database/src/Builder/QueryBuilders/UpdateQueryBuilder.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Database\Exceptions;
+
+use Exception;
+use Tempest\Database\Builder\ModelInspector;
+
+final class CouldNotUpdateRelation extends Exception implements DatabaseException
+{
+    public static function requiresSingleRecord(ModelInspector $model): self
+    {
+        return new self(sprintf(
+            'Attempted to update a relation on %s without targeting a single record by primary key. Use `where(%s, $id)` to update relations.',
+            $model->getName(),
+            $model->getPrimaryKey(),
+        ));
+    }
+
+    public static function requiresPrimaryKey(ModelInspector $model): self
+    {
+        return new self(sprintf('Attempted to update a relation on %s, but it does not have a primary key.', $model->getName()));
+    }
+}

packages/database/src/Builder/TableDefinition.php

@@ -45,7 +45,6 @@ public function execute(BuildsQuery|Query $query): void
 
         try {
             $statement = $this->connection->prepare($query->toSql()->toString());
-
             $statement->execute($bindings);
 
             $this->lastStatement = $statement;
@@ -90,7 +89,6 @@ public function fetch(BuildsQuery|Query $query): array
 
         try {
             $pdoQuery = $this->connection->prepare($query->toSql()->toString());
-
             $pdoQuery->execute($bindings);
 
             return $pdoQuery->fetchAll(PDO::FETCH_NAMED);

packages/database/src/Exceptions/CouldNotUpdateRelation.php

@@ -4,8 +4,6 @@
 
 use Tempest\Database\Config\DatabaseDialect;
 use Tempest\Database\Database;
-use Tempest\Database\Exceptions\HasManyRelationCouldNotBeInsterted;
-use Tempest\Database\Exceptions\HasOneRelationCouldNotBeInserted;
 use Tempest\Database\Migrations\CreateMigrationsTable;
 use Tempest\Database\PrimaryKey;
 use Tempest\Database\Query;
@@ -26,10 +24,7 @@ final class InsertQueryBuilderTest extends FrameworkIntegrationTestCase
     public function test_insert_on_plain_table(): void
     {
         $query = query('chapters')
-            ->insert(
-                title: 'Chapter 01',
-                index: 1,
-            )
+            ->insert(title: 'Chapter 01', index: 1)
             ->build();
 
         $expected = $this->buildExpectedInsert('INSERT INTO `chapters` (`title`, `index`) VALUES (?, ?)');
@@ -72,11 +67,7 @@ public function test_insert_with_batch(): void
 
     public function test_insert_on_model_table(): void
     {
-        $author = new Author(
-            name: 'brent',
-            type: AuthorType::A,
-        );
-
+        $author = new Author(name: 'brent', type: AuthorType::A);
         $query = query(Author::class)
             ->insert(
                 $author,
@@ -94,15 +85,11 @@ public function test_insert_on_model_table_with_new_relation(): void
     {
         $book = Book::new(
             title: 'Timeline Taxi',
-            author: Author::new(
-                name: 'Brent',
-            ),
+            author: Author::new(name: 'Brent'),
         );
 
         $bookQuery = query(Book::class)
-            ->insert(
-                $book,
-            )
+            ->insert($book)
             ->build();
 
         $expectedBookQuery = $this->buildExpectedInsert('INSERT INTO `books` (`title`, `author_id`) VALUES (?, ?)');
@@ -130,9 +117,7 @@ public function test_insert_on_model_table_with_existing_relation(): void
         );
 
         $bookQuery = query(Book::class)
-            ->insert(
-                $book,
-            )
+            ->insert($book)
             ->build();
 
         $expectedBookQuery = $this->buildExpectedInsert('INSERT INTO `books` (`title`, `author_id`) VALUES (?, ?)');
@@ -142,30 +127,6 @@ public function test_insert_on_model_table_with_existing_relation(): void
         $this->assertSame(10, $bookQuery->bindings[1]);
     }
 
-    public function test_inserting_has_many_via_parent_model_throws_exception(): void
-    {
-        $this->assertException(HasManyRelationCouldNotBeInsterted::class, function (): void {
-            query(Book::class)
-                ->insert(
-                    title: 'Timeline Taxi',
-                    chapters: ['title' => 'Chapter 01'],
-                )
-                ->build();
-        });
-    }
-
-    public function test_inserting_has_one_via_parent_model_throws_exception(): void
-    {
-        $this->assertException(HasOneRelationCouldNotBeInserted::class, function (): void {
-            query(Book::class)
-                ->insert(
-                    title: 'Timeline Taxi',
-                    isbn: ['value' => '979-8344313764'],
-                )
-                ->build();
-        });
-    }
-
     public function test_then_method(): void
     {
         $this->migrate(CreateMigrationsTable::class, CreatePublishersTable::class, CreateAuthorTable::class, CreateBookTable::class, CreateChapterTable::class);
@@ -218,7 +179,9 @@ public function test_insert_mapping(): void
     {
         $author = Author::new(name: 'test');
 
-        $query = query(Author::class)->insert($author)->build();
+        $query = query(Author::class)
+            ->insert($author)
+            ->build();
 
         $dialect = $this->container->get(Database::class)->dialect;