PHPLIB-1654: Support new $concatArrays and $setUnion aggregation accumulators (#1732)

Author: paulinevos

generator/config/accumulator/concatArrays.yaml

@@ -0,0 +1,30 @@
+# $schema: ../schema.json
+name: $concatArrays
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/concatArrays/'
+type:
+  - accumulator
+  - window
+  - resolvesToArray
+encode: single
+description: |
+  Concatenates arrays to return the concatenated array.
+arguments:
+  -
+    name: array
+    type:
+      - resolvesToArray # of arrays
+    variadic: array
+    description: |
+      An array of expressions that resolve to an array. 
+      If any argument resolves to a value of null or refers to a field that is missing, `$concatArrays` returns `null`.
+tests:
+  -
+    name: 'Warehouse collection'
+    link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/concatArrays/#example'
+    pipeline:
+      -
+        $project:
+          items:
+            $concatArrays:
+              - '$instock'
+              - '$ordered'

generator/config/accumulator/setUnion.yaml

@@ -0,0 +1,32 @@
+# $schema: ../schema.json
+name: $setUnion
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/setUnion/'
+type:
+  - accumulator
+  - window
+  - resolvesToArray
+encode: single
+description: |
+  Takes two or more arrays and returns an array containing the elements that appear in any input array.
+arguments:
+  -
+    name: array
+    type:
+      - resolvesToArray # of arrays
+    variadic: array
+    description: |
+      An array of expressions that resolve to an array.
+tests:
+  -
+    name: 'Flowers collection'
+    link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/setUnion/#example'
+    pipeline:
+      -
+        $project:
+          flowerFieldA: 1
+          flowerFieldB: 1
+          allValues:
+            $setUnion:
+              - "$flowerFieldA"
+              - "$flowerFieldB"
+          _id: 0

src/Builder/Accumulator/ConcatArraysAccumulator.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MongoDB\Tests\Builder\Accumulator;
+
+use MongoDB\Builder\Accumulator;
+use MongoDB\Builder\Expression;
+use MongoDB\Builder\Pipeline;
+use MongoDB\Builder\Stage;
+use MongoDB\Tests\Builder\PipelineTestCase;
+
+/**
+ * Test $concatArrays accumulator
+ */
+class ConcatArraysAccumulatorTest extends PipelineTestCase
+{
+    public function testWarehouseCollection(): void
+    {
+        $concatArrays = Accumulator::concatArrays(...);
+
+        $pipeline = new Pipeline(
+            Stage::project(
+                items: $concatArrays(
+                    Expression::arrayFieldPath('instock'),
+                    Expression::arrayFieldPath('ordered'),
+                ),
+            ),
+        );
+
+        $this->assertSamePipeline(Pipelines::ConcatArraysWarehouseCollection, $pipeline);
+    }
+}

src/Builder/Accumulator/FactoryTrait.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MongoDB\Tests\Builder\Accumulator;
+
+use MongoDB\Builder\Accumulator;
+use MongoDB\Builder\Expression;
+use MongoDB\Builder\Pipeline;
+use MongoDB\Builder\Stage;
+use MongoDB\Tests\Builder\PipelineTestCase;
+
+/**
+ * Test $setUnion accumulator
+ */
+class SetUnionAccumulatorTest extends PipelineTestCase
+{
+    public function testFlowersCollection(): void
+    {
+        $setUnion = Accumulator::setUnion(...);
+
+        $pipeline = new Pipeline(
+            Stage::project(
+                flowerFieldA: 1,
+                flowerFieldB: 1,
+                allValues: $setUnion(
+                    Expression::arrayFieldPath('flowerFieldA'),
+                    Expression::arrayFieldPath('flowerFieldB'),
+                ),
+                _id: 0,
+            ),
+        );
+
+        $this->assertSamePipeline(Pipelines::SetUnionFlowersCollection, $pipeline);
+    }
+}