Add type annotations to assist static analysis

Author: jmikola

src/Operation/Find.php

@@ -428,10 +428,10 @@ private function createQueryOptions(): array
             }
         }
 
-        $modifiers = empty($this->options['modifiers']) ? [] : document_to_array($this->options['modifiers']);
-
-        if (! empty($modifiers)) {
-            $options['modifiers'] = $modifiers;
+        if (! empty($this->options['modifiers'])) {
+            /** @var array|object */
+            $modifiers = $this->options['modifiers'];
+            $options['modifiers'] = is_object($modifiers) ? document_to_array($modifiers) : $modifiers;
         }
 
         return $options;

src/Operation/FindAndModify.php

@@ -293,9 +293,9 @@ private function createCommandDocument(): array
         }
 
         if (isset($this->options['update'])) {
-            $cmd['update'] = is_pipeline($this->options['update'])
-                ? $this->options['update']
-                : (object) $this->options['update'];
+            /** @var array|object */
+            $update = $this->options['update'];
+            $cmd['update'] = is_pipeline($update) ? $update : (object) $update;
         }
 
         foreach (['arrayFilters', 'bypassDocumentValidation', 'comment', 'hint', 'maxTimeMS'] as $option) {

src/functions.php

@@ -115,6 +115,7 @@ function document_to_array($document): array
         /* Nested documents and arrays are intentionally left as BSON. We avoid
          * iterator_to_array() since Document and PackedArray iteration returns
          * all values as MongoDB\BSON\Value instances. */
+        /** @var array */
         return $document->toPHP([
             'array' => 'bson',
             'document' => 'bson',
@@ -248,6 +249,7 @@ function is_pipeline($pipeline): bool
         /* Nested documents and arrays are intentionally left as BSON. We avoid
          * iterator_to_array() since Document iteration returns all values as
          * MongoDB\BSON\Value instances. */
+        /** @var array */
         $pipeline = $pipeline->toPHP([
             'array' => 'bson',
             'document' => 'bson',