Add updateOrCreate and updateOrCreateWithoutRefresh methods

Introduced two new methods in `Eloquent\Builder` to streamline updating or creating model instances. `updateOrCreate` handles instance updates or creation with refresh, while `updateOrCreateWithoutRefresh` performs the same without triggering a refresh. These enhancements improve flexibility and control over model persistence.

Author: Ionut Rusen

src/Eloquent/Builder.php

@@ -146,6 +146,39 @@ public function updateWithoutRefresh(array $attributes = []): int
 
         return $query->update($this->addUpdatedAtColumn($attributes));
     }
+    public function updateOrCreate(array $attributes, array $values = []): Model
+    {
+        // Attempt to find an existing instance matching the attributes
+        $instance = $this->firstWhere($attributes);
+
+        if ($instance) {
+            // Update the instance if found
+            $instance->fill($values)->save();
+        } else {
+            // Create a new instance with attributes and values merged
+            $instance = $this->create(array_merge($attributes, $values));
+        }
+
+        return $instance;
+    }
+    public function updateOrCreateWithoutRefresh(array $attributes, array $values = []): Model
+    {
+        // Attempt to find an existing instance matching the attributes
+        $instance = $this->firstWhere($attributes);
+
+        if ($instance) {
+            // Update the instance without triggering refresh
+            $this->whereKey($instance->getKey())->updateWithoutRefresh($values);
+
+            // Refresh the instance in memory with updated values
+            $instance->fill($values);
+        } else {
+            // Create a new instance without triggering a refresh
+            $instance = $this->createWithoutRefresh(array_merge($attributes, $values));
+        }
+
+        return $instance;
+    }
 
     public function firstOrCreateWithoutRefresh(array $attributes = [], array $values = [])
     {