feat: fix method param types

Author: DeiseCAPBarbosa

src/Cursor/Cursor.php

@@ -133,13 +133,13 @@ public function disableTimeout(bool $flag = true)
      *
      * @see http://php.net/manual/pt_BR/class.mongodb-driver-readpreference.php
      *
-     * @param int $mode preference mode that the Cursor will use
+     * @param int|string $mode preference mode that the Cursor will use
      *
      * @see ReadPreference::class To get a glance of the constants available
      *
      * @return $this
      */
-    public function setReadPreference(int $mode)
+    public function setReadPreference(int|string $mode): static
     {
         $this->params[1]['readPreference'] = new ReadPreference($mode);
 

src/Cursor/SchemaCursor.php

@@ -154,13 +154,13 @@ public function disableTimeout(bool $flag = true)
      *
      * @see http://php.net/manual/pt_BR/class.mongodb-driver-readpreference.php
      *
-     * @param int $mode preference mode that the Cursor will use
+     * @param int|string $mode preference mode that the Cursor will use
      *
      * @see ReadPreference::class To get a glance of the constants available
      *
      * @return $this
      */
-    public function setReadPreference(int $mode)
+    public function setReadPreference(int|string $mode): static
     {
         $this->params[1]['readPreference'] = new ReadPreference($mode);
 

src/LegacyRecord.php

@@ -2,6 +2,7 @@
 namespace Mongolid;
 
 use Illuminate\Contracts\Container\BindingResolutionException;
+use MongoDB\BSON\Document;
 use MongoDB\Collection;
 use MongoDB\Driver\WriteConcern;
 use MongoDB\Exception\BadMethodCallException;
@@ -16,6 +17,7 @@
 use Mongolid\Schema\DynamicSchema;
 use Mongolid\Schema\HasSchemaInterface;
 use Mongolid\Schema\Schema;
+use stdClass;
 
 /**
  * This class was created to keep v2 compatibility.
@@ -380,10 +382,10 @@ public function getCollection(): Collection
     }
 
     /**
-     * @return array|object
+     * @return array|stdClass|Document
      * @throws BindingResolutionException
      */
-    public function bsonSerialize(): object|array
+    public function bsonSerialize(): array|stdClass|Document
     {
         return Container::make(ModelMapper::class)
             ->map($this, array_merge($this->fillable, $this->guarded), $this->dynamic, $this->timestamps);

src/Model/AbstractModel.php

@@ -2,6 +2,7 @@
 namespace Mongolid\Model;
 
 use Illuminate\Contracts\Container\BindingResolutionException;
+use MongoDB\BSON\Document;
 use MongoDB\Collection;
 use MongoDB\Driver\WriteConcern;
 use Mongolid\Connection\Connection;
@@ -11,6 +12,7 @@
 use Mongolid\Model\Exception\NoCollectionNameException;
 use Mongolid\Query\Builder;
 use Mongolid\Query\ModelMapper;
+use stdClass;
 
 /**
  * The Mongolid\Model\Model base class will ensure to enable your model to
@@ -281,7 +283,7 @@ public function setWriteConcern(int $writeConcern): void
     /**
      * @throws BindingResolutionException
      */
-    public function bsonSerialize(): object|array
+    public function bsonSerialize(): array|stdClass|Document
     {
         return Container::make(ModelMapper::class)
             ->map($this, array_merge($this->fillable, $this->guarded), $this->dynamic, $this->timestamps);

tests/Unit/Cursor/CursorTest.php

@@ -76,12 +76,12 @@ public function testShouldSetReadPreferenceParameterAccordingly(): void
     {
         // Set
         $cursor = $this->getCursor();
-        $mode = ReadPreference::RP_SECONDARY;
+        $mode = ReadPreference::SECONDARY;
 
         // Actions
         $cursor->setReadPreference($mode);
         $readPreferenceParameter = $this->getProtected($cursor, 'params')[1]['readPreference'];
-        $result = $readPreferenceParameter->getMode();
+        $result = $readPreferenceParameter->getModeString();
 
         // Assertions
         $this->assertInstanceOf(ReadPreference::class, $readPreferenceParameter);
@@ -92,13 +92,13 @@ public function testShouldBeAbleToSetReadPreferenceAndCursorTimeoutTogether(): v
     {
         // Set
         $cursor = $this->getCursor();
-        $mode = ReadPreference::RP_SECONDARY;
+        $mode = ReadPreference::SECONDARY;
 
         // Actions
         $cursor->setReadPreference($mode);
         $cursor->disableTimeout();
         $readPreferenceParameter = $this->getProtected($cursor, 'params')[1]['readPreference'];
-        $result = $readPreferenceParameter->getMode();
+        $result = $readPreferenceParameter->getModeString();
         $timeoutResult = $this->getProtected($cursor, 'params')[1]['noCursorTimeout'];
 
         // Assertions

tests/Unit/Cursor/SchemaCursorTest.php

@@ -83,13 +83,13 @@ public function testShouldSetReadPreferenceParameterAccordingly()
     {
         // Arrange
         $cursor = $this->getCursor();
-        $mode = ReadPreference::RP_SECONDARY;
+        $mode = ReadPreference::SECONDARY;
         $cursor->setReadPreference($mode);
         $readPreferenceParameter = $this->getProtected($cursor, 'params')[1]['readPreference'];
 
         // Assert
         $this->assertInstanceOf(ReadPreference::class, $readPreferenceParameter);
-        $this->assertSame($readPreferenceParameter->getMode(), $mode);
+        $this->assertSame($readPreferenceParameter->getModeString(), $mode);
     }
 
     public function testShouldCountDocuments()

tests/Unit/Util/QueryBuilderTest.php

@@ -30,6 +30,8 @@ public function testShouldPrepareQueryValue(
 
     public function queryValueScenarios(): array
     {
+        $objectId = new ObjectId('64e8963b1de34f08a40502e0');
+
         return [
             'An array' => [
                 'query' => ['age' => ['$gt' => 25]],