feat(firestore): add DML stages, literals source, and atomic execution option to Android SDK pipelines

firebase-firestore/CHANGELOG.md

@@ -7,6 +7,10 @@
   Protocol Buffers to `4.36.1`.
   ([#8580](https://github.com/firebase/firebase-android-sdk/pull/8580))
 - [feature] Add support for the following new types: MinKey, MaxKey, RegexValue, Int32Value, BsonObjectId, BsonTimestamp, and subtype for Blob. [#8147](//github.com/firebase/firebase-android-sdk/pull/8147)
+- [feature] Added pipeline DML stages (`delete()`, `update()`, `insert()`, `upsert()`), the
+  `PipelineSource.literals()` source, atomic execution via `Pipeline.ExecuteOptions.withAtomic()`,
+  and support for removing reserved fields such as `__name__` with `removeFields()`.
+  ([#8524](https://github.com/firebase/firebase-android-sdk/pull/8524))
 
 # 26.6.0
 

firebase-firestore/api.txt

@@ -472,13 +472,20 @@ package com.google.firebase.firestore {
     method public com.google.firebase.firestore.Pipeline aggregate(com.google.firebase.firestore.pipeline.AggregateStage aggregateStage, com.google.firebase.firestore.pipeline.AggregateOptions options);
     method public com.google.firebase.firestore.Pipeline aggregate(com.google.firebase.firestore.pipeline.AliasedAggregate accumulator, com.google.firebase.firestore.pipeline.AliasedAggregate... additionalAccumulators);
     method public com.google.firebase.firestore.Pipeline define(com.google.firebase.firestore.pipeline.AliasedExpression aliasedExpression, com.google.firebase.firestore.pipeline.AliasedExpression... additionalExpressions);
+    method public com.google.firebase.firestore.Pipeline delete();
     method public com.google.firebase.firestore.Pipeline distinct(com.google.firebase.firestore.pipeline.Selectable group, java.lang.Object... additionalGroups);
     method public com.google.firebase.firestore.Pipeline distinct(String groupField, java.lang.Object... additionalGroups);
     method public com.google.android.gms.tasks.Task<com.google.firebase.firestore.Pipeline.Snapshot> execute();
     method public com.google.android.gms.tasks.Task<com.google.firebase.firestore.Pipeline.Snapshot> execute(com.google.firebase.firestore.Pipeline.ExecuteOptions options);
     method public com.google.firebase.firestore.Pipeline findNearest(com.google.firebase.firestore.pipeline.Field vectorField, double[] vectorValue, com.google.firebase.firestore.pipeline.FindNearestStage.DistanceMeasure distanceMeasure);
     method public com.google.firebase.firestore.Pipeline findNearest(String vectorField, com.google.firebase.firestore.pipeline.Expression vectorValue, com.google.firebase.firestore.pipeline.FindNearestStage.DistanceMeasure distanceMeasure, com.google.firebase.firestore.pipeline.FindNearestOptions options);
     method public com.google.firebase.firestore.Pipeline findNearest(String vectorField, double[] vectorValue, com.google.firebase.firestore.pipeline.FindNearestStage.DistanceMeasure distanceMeasure);
+    method public com.google.firebase.firestore.Pipeline insert();
+    method public com.google.firebase.firestore.Pipeline insert(com.google.firebase.firestore.CollectionReference collection);
+    method public com.google.firebase.firestore.Pipeline insert(com.google.firebase.firestore.CollectionReference collection, com.google.firebase.firestore.pipeline.Expression documentIdExpression);
+    method public com.google.firebase.firestore.Pipeline insert(com.google.firebase.firestore.pipeline.Expression documentIdExpression);
+    method public com.google.firebase.firestore.Pipeline insert(String collectionPath);
+    method public com.google.firebase.firestore.Pipeline insert(String collectionPath, com.google.firebase.firestore.pipeline.Expression documentIdExpression);
     method public com.google.firebase.firestore.Pipeline limit(int limit);
     method public com.google.firebase.firestore.Pipeline offset(int offset);
     method public com.google.firebase.firestore.Pipeline rawStage(com.google.firebase.firestore.pipeline.RawStage rawStage);
@@ -499,11 +506,18 @@ package com.google.firebase.firestore {
     method public com.google.firebase.firestore.Pipeline unnest(com.google.firebase.firestore.pipeline.Selectable arrayWithAlias, com.google.firebase.firestore.pipeline.UnnestOptions options);
     method public com.google.firebase.firestore.Pipeline unnest(com.google.firebase.firestore.pipeline.UnnestStage unnestStage);
     method public com.google.firebase.firestore.Pipeline unnest(String arrayField, String alias);
+    method public com.google.firebase.firestore.Pipeline update(com.google.firebase.firestore.pipeline.Selectable... fields);
+    method public com.google.firebase.firestore.Pipeline upsert(com.google.firebase.firestore.CollectionReference collection);
+    method public com.google.firebase.firestore.Pipeline upsert(com.google.firebase.firestore.CollectionReference collection, com.google.firebase.firestore.pipeline.Expression documentIdExpression);
+    method public com.google.firebase.firestore.Pipeline upsert(com.google.firebase.firestore.pipeline.Selectable... additionalFields);
+    method public com.google.firebase.firestore.Pipeline upsert(String collectionPath);
+    method public com.google.firebase.firestore.Pipeline upsert(String collectionPath, com.google.firebase.firestore.pipeline.Expression documentIdExpression);
     method public com.google.firebase.firestore.Pipeline where(com.google.firebase.firestore.pipeline.BooleanExpression condition);
   }
 
   public static final class Pipeline.ExecuteOptions extends com.google.firebase.firestore.pipeline.AbstractOptions<com.google.firebase.firestore.Pipeline.ExecuteOptions> {
     ctor public Pipeline.ExecuteOptions();
+    method public com.google.firebase.firestore.Pipeline.ExecuteOptions withAtomic(boolean atomic);
     method public com.google.firebase.firestore.Pipeline.ExecuteOptions withIndexMode(com.google.firebase.firestore.Pipeline.ExecuteOptions.IndexMode indexMode);
   }
 
@@ -547,6 +561,7 @@ package com.google.firebase.firestore {
     method public com.google.firebase.firestore.Pipeline database();
     method public com.google.firebase.firestore.Pipeline documents(com.google.firebase.firestore.DocumentReference... documents);
     method public com.google.firebase.firestore.Pipeline documents(java.lang.String... documents);
+    method public com.google.firebase.firestore.Pipeline literals(java.util.Map<java.lang.String,? extends java.lang.Object?>... data);
     method public static com.google.firebase.firestore.Pipeline subcollection(com.google.firebase.firestore.pipeline.SubcollectionSource source);
     method public static com.google.firebase.firestore.Pipeline subcollection(String path);
     field public static final com.google.firebase.firestore.PipelineSource.Companion Companion;
@@ -1994,6 +2009,9 @@ package com.google.firebase.firestore.pipeline {
   public class FunctionExpression extends com.google.firebase.firestore.pipeline.Expression {
   }
 
+  public final class LiteralsSource extends com.google.firebase.firestore.pipeline.Stage<com.google.firebase.firestore.pipeline.LiteralsSource> {
+  }
+
   public final class Ordering {
     method public static com.google.firebase.firestore.pipeline.Ordering ascending(com.google.firebase.firestore.pipeline.Expression expr);
     method public static com.google.firebase.firestore.pipeline.Ordering ascending(String fieldName);

firebase-firestore/gradle.properties

@@ -1,2 +1,2 @@
-version=27.0.1
+version=27.1.0
 latestReleasedVersion=27.0.0