Add updateOrCreate method

src/Query.php

@@ -68,6 +68,20 @@ public function firstOrCreate(array $attributes = [], array $values = []): Model
         return $this->create($attributes + $values);
     }
 
+    /**
+     * Update a model or create a new one.
+     */
+    public function updateOrCreate(array $attributes, array $values = []): Model
+    {
+        if (! is_null($instance = (clone $this)->where($attributes)->first())) {
+            $instance->fill($values)->save();
+
+            return $instance;
+        }
+
+        return $this->create($attributes + $values);
+    }
+
     /**
      * Add a where clause to the query.
      */

tests/ModelTest.php

@@ -153,6 +153,24 @@
     expect($found->wasRecentlyCreated)->toBeFalse();
 });
 
+it('can be updated or created with id', function () {
+    $model = ModelStub::updateOrCreate([
+        'id' => 'foo-bar',
+    ], [
+        'name' => 'John Doe',
+    ]);
+
+    $found = ModelStub::updateOrCreate([
+        'id' => 'foo-bar',
+    ], [
+        'name' => 'Jane Doe',
+    ]);
+
+    expect($model->is($found))->toBeTrue();
+    expect($model->name)->toBe('John Doe');
+    expect($found->name)->toBe('Jane Doe');
+});
+
 it('throws exception when creating a model with an empty key', function (mixed $id) {
     ModelStub::create(['id' => $id]);
 })->with([