PHPORM-227 Fix single document upsert (#3100)

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());