Merge branch 'main' into dl/map-expressions

Author: dlarocque

README.md

@@ -49,7 +49,7 @@ If you are using Maven without the BOM, add this to your dependencies:
 If you are using Gradle 5.x or later, add this to your dependencies:
 
 ```Groovy
-implementation platform('com.google.cloud:libraries-bom:26.76.0')
+implementation platform('com.google.cloud:libraries-bom:26.77.0')
 
 implementation 'com.google.cloud:google-cloud-firestore'
 ```

generation_config.yaml

@@ -1,6 +1,6 @@
 gapic_generator_version: 2.67.0
-googleapis_commitish: dd3d17addb94bd4a392a5270795c11a27a1334fc
-libraries_bom_version: 26.76.0
+googleapis_commitish: 798823426715215eccca4d7e7ee4c814843045d7
+libraries_bom_version: 26.77.0
 libraries:
   - api_shortname: firestore
     name_pretty: Cloud Firestore

google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/expressions/AggregateFunction.java

@@ -214,6 +214,111 @@ public static AggregateFunction maximum(Expression expression) {
     return new AggregateFunction("maximum", expression);
   }
 
+  /**
+   * Creates an aggregation that finds the first value of a field across multiple stage inputs.
+   *
+   * @param fieldName The name of the field to find the first value of.
+   * @return A new {@link AggregateFunction} representing the first aggregation.
+   */
+  @BetaApi
+  public static AggregateFunction first(String fieldName) {
+    return new AggregateFunction("first", fieldName);
+  }
+
+  /**
+   * Creates an aggregation that finds the first value of an expression across multiple stage
+   * inputs.
+   *
+   * @param expression The expression to find the first value of.
+   * @return A new {@link AggregateFunction} representing the first aggregation.
+   */
+  @BetaApi
+  public static AggregateFunction first(Expression expression) {
+    return new AggregateFunction("first", expression);
+  }
+
+  /**
+   * Creates an aggregation that finds the last value of a field across multiple stage inputs.
+   *
+   * @param fieldName The name of the field to find the last value of.
+   * @return A new {@link AggregateFunction} representing the last aggregation.
+   */
+  @BetaApi
+  public static AggregateFunction last(String fieldName) {
+    return new AggregateFunction("last", fieldName);
+  }
+
+  /**
+   * Creates an aggregation that finds the last value of an expression across multiple stage inputs.
+   *
+   * @param expression The expression to find the last value of.
+   * @return A new {@link AggregateFunction} representing the last aggregation.
+   */
+  @BetaApi
+  public static AggregateFunction last(Expression expression) {
+    return new AggregateFunction("last", expression);
+  }
+
+  /**
+   * Creates an aggregation that collects all values of a field across multiple stage inputs into an
+   * array.
+   *
+   * <p>If the expression resolves to an absent value, it is converted to `null`. The order of
+   * elements in the output array is not stable and shouldn't be relied upon.
+   *
+   * @param fieldName The name of the field to collect values from.
+   * @return A new {@link AggregateFunction} representing the array_agg aggregation.
+   */
+  @BetaApi
+  public static AggregateFunction arrayAgg(String fieldName) {
+    return new AggregateFunction("array_agg", fieldName);
+  }
+
+  /**
+   * Creates an aggregation that collects all values of an expression across multiple stage inputs
+   * into an array.
+   *
+   * <p>If the expression resolves to an absent value, it is converted to `null`. The order of
+   * elements in the output array is not stable and shouldn't be relied upon.
+   *
+   * @param expression The expression to collect values from.
+   * @return A new {@link AggregateFunction} representing the array_agg aggregation.
+   */
+  @BetaApi
+  public static AggregateFunction arrayAgg(Expression expression) {
+    return new AggregateFunction("array_agg", expression);
+  }
+
+  /**
+   * Creates an aggregation that collects all distinct values of a field across multiple stage
+   * inputs into an array.
+   *
+   * <p>If the expression resolves to an absent value, it is converted to `null`. The order of
+   * elements in the output array is not stable and shouldn't be relied upon.
+   *
+   * @param fieldName The name of the field to collect values from.
+   * @return A new {@link AggregateFunction} representing the array_agg_distinct aggregation.
+   */
+  @BetaApi
+  public static AggregateFunction arrayAggDistinct(String fieldName) {
+    return new AggregateFunction("array_agg_distinct", fieldName);
+  }
+
+  /**
+   * Creates an aggregation that collects all distinct values of an expression across multiple stage
+   * inputs into an array.
+   *
+   * <p>If the expression resolves to an absent value, it is converted to `null`. The order of
+   * elements in the output array is not stable and shouldn't be relied upon.
+   *
+   * @param expression The expression to collect values from.
+   * @return A new {@link AggregateFunction} representing the array_agg_distinct aggregation.
+   */
+  @BetaApi
+  public static AggregateFunction arrayAggDistinct(Expression expression) {
+    return new AggregateFunction("array_agg_distinct", expression);
+  }
+
   /**
    * Assigns an alias to this aggregate.
    *