PHPORM-227 Fix single document upsert (#3100)

Author: GromNaN

CHANGELOG.md

@@ -1,6 +1,10 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [4.7.2] - coming soon
+
+* Add `Query\Builder::upsert()` method with a single document by @GromNaN in [#3100](https://github.com/mongodb/laravel-mongodb/pull/3100)
+
 ## [4.7.1] - 2024-07-25
 
 * Fix registration of `BusServiceProvider` for compatibility with Horizon by @GromNaN in [#3071](https://github.com/mongodb/laravel-mongodb/pull/3071)

src/Query/Builder.php

@@ -732,6 +732,11 @@ public function upsert(array $values, $uniqueBy, $update = null): int
             return 0;
         }
 
+        // Single document provided
+        if (! array_is_list($values)) {
+            $values = [$values];
+        }
+
         $this->applyBeforeQueryCallbacks();
 
         $options = $this->inheritConnectionOptions();

tests/ModelTest.php

@@ -168,9 +168,8 @@ public function testUpsert()
         $this->assertSame('bar2', User::where('email', 'foo')->first()->name);
 
         // If no update fields are specified, all fields are updated
-        $result = User::upsert([
-            ['email' => 'foo', 'name' => 'bar3'],
-        ], 'email');
+        // Test single document update
+        $result = User::upsert(['email' => 'foo', 'name' => 'bar3'], 'email');
 
         $this->assertSame(1, $result);
         $this->assertSame(2, User::count());

tests/QueryBuilderTest.php

@@ -632,9 +632,8 @@ public function testUpsert()
         $this->assertSame('bar2', DB::collection('users')->where('email', 'foo')->first()['name']);
 
         // If no update fields are specified, all fields are updated
-        $result = DB::collection('users')->upsert([
-            ['email' => 'foo', 'name' => 'bar3'],
-        ], 'email');
+        // Test single document update
+        $result = DB::collection('users')->upsert(['email' => 'foo', 'name' => 'bar3'], 'email');
 
         $this->assertSame(1, $result);
         $this->assertSame(2, DB::collection('users')->count());