chore: generate libraries at Wed Feb 25 22:09:45 UTC 2026

Author: cloud-java-bot

google-cloud-firestore/src/main/java/com/google/cloud/firestore/Pipeline.java

@@ -275,23 +275,18 @@ public static Pipeline subcollection(String path) {
   }
 
   /**
-   * Defines one or more variables in the pipeline's scope. `define` is used to
-   * bind a value to a
+   * Defines one or more variables in the pipeline's scope. `define` is used to bind a value to a
    * variable for internal reuse within the pipeline body (accessed via the {@link
    * Expression#variable(String)} function).
    *
-   * <p>
-   * This stage is useful for declaring reusable values or intermediate
-   * calculations that can be
-   * referenced multiple times in later parts of the pipeline, improving
-   * readability and maintainability.
+   * <p>This stage is useful for declaring reusable values or intermediate calculations that can be
+   * referenced multiple times in later parts of the pipeline, improving readability and
+   * maintainability.
    *
-   * <p>
-   * Each variable is defined using an {@link AliasedExpression}, which pairs an
-   * expression with a name (alias).
+   * <p>Each variable is defined using an {@link AliasedExpression}, which pairs an expression with
+   * a name (alias).
    *
-   * <p>
-   * Example:
+   * <p>Example:
    *
    * <pre>{@code
    * firestore.pipeline().collection("products")
@@ -302,10 +297,8 @@ public static Pipeline subcollection(String path) {
    *     .select(field("name"), variable("newStock"));
    * }</pre>
    *
-   * @param expression            The expression to define using
-   *                              {@link AliasedExpression}.
-   * @param additionalExpressions Additional expressions to define using
-   *                              {@link AliasedExpression}.
+   * @param expression The expression to define using {@link AliasedExpression}.
+   * @param additionalExpressions Additional expressions to define using {@link AliasedExpression}.
    * @return A new Pipeline object with this stage appended to the stage list.
    */
   @BetaApi
@@ -331,28 +324,19 @@ public Expression toArrayExpression() {
   }
 
   /**
-   * Converts this Pipeline into an expression that evaluates to a single scalar
-   * result. Used for
-   * 1:1 lookups or Aggregations when the subquery is expected to return a single
-   * value or object.
-   *
-   * <p>
-   * <b>Runtime Validation:</b> The runtime will validate that the result set
-   * contains exactly
-   * one item. It throws a runtime error if the result has more than one item, and
-   * evaluates to
+   * Converts this Pipeline into an expression that evaluates to a single scalar result. Used for
+   * 1:1 lookups or Aggregations when the subquery is expected to return a single value or object.
+   *
+   * <p><b>Runtime Validation:</b> The runtime will validate that the result set contains exactly
+   * one item. It throws a runtime error if the result has more than one item, and evaluates to
    * {@code null} if the pipeline has zero results.
    *
-   * <p>
-   * <b>Result Unwrapping:</b> For simpler access, scalar subqueries producing a
-   * single field
-   * automatically unwrap that value to the top level, ignoring the inner alias.
-   * If the subquery
+   * <p><b>Result Unwrapping:</b> For simpler access, scalar subqueries producing a single field
+   * automatically unwrap that value to the top level, ignoring the inner alias. If the subquery
    * returns multiple fields, they are preserved as a map.
    *
-   * <p>
-   * <b>Example 1: Single field unwrapping</b>
-   * 
+   * <p><b>Example 1: Single field unwrapping</b>
+   *
    * <pre>{@code
    * // Calculate average rating for each restaurant using a subquery
    * db.pipeline().collection("restaurants")
@@ -367,11 +351,8 @@ public Expression toArrayExpression() {
    *             .as("average_rating"))
    * }</pre>
    *
-   * <p>
-   * <i>The result set is unwrapped twice: from {@code "average_rating": [{
-   * "value": 4.5 }]}
-   * to {@code "average_rating": { "value": 4.5 }}, and finally to
-   * {@code "average_rating": 4.5}.</i>
+   * <p><i>The result set is unwrapped twice: from {@code "average_rating": [{ "value": 4.5 }]} to
+   * {@code "average_rating": { "value": 4.5 }}, and finally to {@code "average_rating": 4.5}.</i>
    *
    * <pre>{@code
    * // Output Document:
@@ -391,9 +372,8 @@ public Expression toArrayExpression() {
    * ]
    * }</pre>
    *
-   * <p>
-   * <b>Example 2: Multiple fields (Map)</b>
-   * 
+   * <p><b>Example 2: Multiple fields (Map)</b>
+   *
    * <pre>{@code
    * // For each restaurant, calculate review statistics (average rating AND total
    * // count)
@@ -409,8 +389,7 @@ public Expression toArrayExpression() {
    *             .as("stats"))
    * }</pre>
    *
-   * <p>
-   * <i>When the subquery produces multiple fields, they are wrapped in a map:</i>
+   * <p><i>When the subquery produces multiple fields, they are wrapped in a map:</i>
    *
    * <pre>{@code
    * // Output Document:

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

@@ -218,7 +218,6 @@ public static Field field(FieldPath fieldPath) {
     return Field.ofUserPath(fieldPath.toString());
   }
 
-
   /**
    * Creates an expression that returns the current timestamp.
    *
@@ -229,7 +228,6 @@ public static Expression currentTimestamp() {
     return new FunctionExpression("current_timestamp", ImmutableList.of());
   }
 
-
   /**
    * Creates an expression that returns a default value if an expression evaluates to an absent
    * value.
@@ -4834,8 +4832,7 @@ public static Expression pipeline(Pipeline pipeline) {
   }
 
   /**
-   * Accesses a field/property of the expression (useful when the expression
-   * evaluates to a Map or
+   * Accesses a field/property of the expression (useful when the expression evaluates to a Map or
    * Document).
    *
    * @param key The key of the field to access.
@@ -4847,8 +4844,7 @@ public Expression getField(String key) {
   }
 
   /**
-   * Retrieves the value of a specific field from the document evaluated by this
-   * expression.
+   * Retrieves the value of a specific field from the document evaluated by this expression.
    *
    * @param keyExpression The expression evaluating to the key to access.
    * @return A new {@link Expression} representing the field value.
@@ -4862,7 +4858,7 @@ public Expression getField(Expression keyExpression) {
    * Accesses a field/property of a document field using the provided {@code key}.
    *
    * @param fieldName The field name of the map or document field.
-   * @param key       The key of the field to access.
+   * @param key The key of the field to access.
    * @return An {@link Expression} representing the value of the field.
    */
   @BetaApi
@@ -4871,10 +4867,9 @@ public static Expression getField(String fieldName, String key) {
   }
 
   /**
-   * Accesses a field/property of the expression using the provided
-   * {@code keyExpression}.
+   * Accesses a field/property of the expression using the provided {@code keyExpression}.
    *
-   * @param expression    The expression evaluating to a Map or Document.
+   * @param expression The expression evaluating to a Map or Document.
    * @param keyExpression The expression evaluating to the key.
    * @return A new {@link Expression} representing the value of the field.
    */
@@ -4884,10 +4879,9 @@ public static Expression getField(Expression expression, Expression keyExpressio
   }
 
   /**
-   * Accesses a field/property of a document field using the provided
-   * {@code keyExpression}.
+   * Accesses a field/property of a document field using the provided {@code keyExpression}.
    *
-   * @param fieldName     The field name of the map or document field.
+   * @param fieldName The field name of the map or document field.
    * @param keyExpression The expression evaluating to the key.
    * @return A new {@link Expression} representing the value of the field.
    */
@@ -4897,11 +4891,11 @@ public static Expression getField(String fieldName, Expression keyExpression) {
   }
 
   /**
-   * Accesses a field/property of the expression (useful when the expression
-   * evaluates to a Map or Document).
+   * Accesses a field/property of the expression (useful when the expression evaluates to a Map or
+   * Document).
    *
    * @param expression The expression evaluating to a map/document.
-   * @param key        The key of the field to access.
+   * @param key The key of the field to access.
    * @return An {@link Expression} representing the value of the field.
    */
   @BetaApi
@@ -4912,8 +4906,7 @@ public static Expression getField(Expression expression, String key) {
   /**
    * Internal expression representing a variable reference.
    *
-   * <p>
-   * This evaluates to the value of a variable defined in a pipeline context.
+   * <p>This evaluates to the value of a variable defined in a pipeline context.
    */
   static class Variable extends Expression {
     private final String name;
@@ -4928,9 +4921,7 @@ public Value toProto() {
     }
   }
 
-  /**
-   * Internal expression representing a pipeline value.
-   */
+  /** Internal expression representing a pipeline value. */
   static class PipelineValueExpression extends Expression {
     private final Pipeline pipeline;
 
@@ -4943,5 +4934,4 @@ public Value toProto() {
       return pipeline.toProtoValue();
     }
   }
-
 }

google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/stages/DefineStage.java

@@ -39,7 +39,10 @@ public DefineStage(Map<String, Expression> expressions) {
   Iterable<Value> toStageArgs() {
     java.util.Map<String, Value> converted = new java.util.HashMap<>();
     for (Map.Entry<String, Expression> entry : expressions.entrySet()) {
-      converted.put(entry.getKey(), com.google.cloud.firestore.pipeline.expressions.FunctionUtils.exprToValue(entry.getValue()));
+      converted.put(
+          entry.getKey(),
+          com.google.cloud.firestore.pipeline.expressions.FunctionUtils.exprToValue(
+              entry.getValue()));
     }
     return Collections.singletonList(encodeValue(converted));
   }