feat(firestore): add support for remaining map expressions (#7987)

Ported from: googleapis/java-firestore#2321

Author: dlarocque

firebase-firestore/CHANGELOG.md

@@ -11,6 +11,8 @@
   [#7893](https://github.com/firebase/firebase-android-sdk/pull/7893)
 - [feature] Added support for `rand` and `trunc` Pipeline expressions.
   [#7886](https://github.com/firebase/firebase-android-sdk/pull/7886)
+- [feature] Added support for `mapGet` `mapSet`, `mapEntries`, and `mapKeys` Pipeline expressions.
+  [#7987](https://github.com/firebase/firebase-android-sdk/pull/7987)
 
 # 26.1.2
 

firebase-firestore/api.txt

@@ -1126,12 +1126,18 @@ package com.google.firebase.firestore.pipeline {
     method public final com.google.firebase.firestore.pipeline.Expression logicalMinimum(java.lang.Object... others);
     method public static final com.google.firebase.firestore.pipeline.Expression logicalMinimum(String fieldName, java.lang.Object... others);
     method public static final com.google.firebase.firestore.pipeline.Expression map(java.util.Map<java.lang.String,?> elements);
+    method public final com.google.firebase.firestore.pipeline.Expression mapEntries();
+    method public static final com.google.firebase.firestore.pipeline.Expression mapEntries(com.google.firebase.firestore.pipeline.Expression mapExpr);
+    method public static final com.google.firebase.firestore.pipeline.Expression mapEntries(String mapField);
     method public final com.google.firebase.firestore.pipeline.Expression mapGet(com.google.firebase.firestore.pipeline.Expression keyExpression);
     method public static final com.google.firebase.firestore.pipeline.Expression mapGet(com.google.firebase.firestore.pipeline.Expression mapExpression, com.google.firebase.firestore.pipeline.Expression keyExpression);
     method public static final com.google.firebase.firestore.pipeline.Expression mapGet(com.google.firebase.firestore.pipeline.Expression mapExpression, String key);
     method public final com.google.firebase.firestore.pipeline.Expression mapGet(String key);
     method public static final com.google.firebase.firestore.pipeline.Expression mapGet(String fieldName, com.google.firebase.firestore.pipeline.Expression keyExpression);
     method public static final com.google.firebase.firestore.pipeline.Expression mapGet(String fieldName, String key);
+    method public final com.google.firebase.firestore.pipeline.Expression mapKeys();
+    method public static final com.google.firebase.firestore.pipeline.Expression mapKeys(com.google.firebase.firestore.pipeline.Expression mapExpr);
+    method public static final com.google.firebase.firestore.pipeline.Expression mapKeys(String mapField);
     method public static final com.google.firebase.firestore.pipeline.Expression mapMerge(com.google.firebase.firestore.pipeline.Expression firstMap, com.google.firebase.firestore.pipeline.Expression secondMap, com.google.firebase.firestore.pipeline.Expression... otherMaps);
     method public final com.google.firebase.firestore.pipeline.Expression mapMerge(com.google.firebase.firestore.pipeline.Expression mapExpr, com.google.firebase.firestore.pipeline.Expression... otherMaps);
     method public static final com.google.firebase.firestore.pipeline.Expression mapMerge(String firstMapFieldName, com.google.firebase.firestore.pipeline.Expression secondMap, com.google.firebase.firestore.pipeline.Expression... otherMaps);
@@ -1141,6 +1147,15 @@ package com.google.firebase.firestore.pipeline {
     method public final com.google.firebase.firestore.pipeline.Expression mapRemove(String key);
     method public static final com.google.firebase.firestore.pipeline.Expression mapRemove(String mapField, com.google.firebase.firestore.pipeline.Expression key);
     method public static final com.google.firebase.firestore.pipeline.Expression mapRemove(String mapField, String key);
+    method public static final com.google.firebase.firestore.pipeline.Expression mapSet(com.google.firebase.firestore.pipeline.Expression mapExpr, com.google.firebase.firestore.pipeline.Expression key, com.google.firebase.firestore.pipeline.Expression value, com.google.firebase.firestore.pipeline.Expression... moreKeyValues);
+    method public final com.google.firebase.firestore.pipeline.Expression mapSet(com.google.firebase.firestore.pipeline.Expression key, com.google.firebase.firestore.pipeline.Expression value, com.google.firebase.firestore.pipeline.Expression... moreKeyValues);
+    method public static final com.google.firebase.firestore.pipeline.Expression mapSet(com.google.firebase.firestore.pipeline.Expression mapExpr, String key, Object? value, java.lang.Object... moreKeyValues);
+    method public static final com.google.firebase.firestore.pipeline.Expression mapSet(String mapField, com.google.firebase.firestore.pipeline.Expression key, com.google.firebase.firestore.pipeline.Expression value, com.google.firebase.firestore.pipeline.Expression... moreKeyValues);
+    method public final com.google.firebase.firestore.pipeline.Expression mapSet(String key, Object? value, java.lang.Object... moreKeyValues);
+    method public static final com.google.firebase.firestore.pipeline.Expression mapSet(String mapField, String key, Object? value, java.lang.Object... moreKeyValues);
+    method public final com.google.firebase.firestore.pipeline.Expression mapValues();
+    method public static final com.google.firebase.firestore.pipeline.Expression mapValues(com.google.firebase.firestore.pipeline.Expression mapExpr);
+    method public static final com.google.firebase.firestore.pipeline.Expression mapValues(String mapField);
     method public final com.google.firebase.firestore.pipeline.AggregateFunction maximum();
     method public final com.google.firebase.firestore.pipeline.AggregateFunction minimum();
     method public final com.google.firebase.firestore.pipeline.Expression mod(com.google.firebase.firestore.pipeline.Expression divisor);
@@ -1578,16 +1593,26 @@ package com.google.firebase.firestore.pipeline {
     method public com.google.firebase.firestore.pipeline.Expression logicalMinimum(com.google.firebase.firestore.pipeline.Expression expr, java.lang.Object... others);
     method public com.google.firebase.firestore.pipeline.Expression logicalMinimum(String fieldName, java.lang.Object... others);
     method public com.google.firebase.firestore.pipeline.Expression map(java.util.Map<java.lang.String,?> elements);
+    method public com.google.firebase.firestore.pipeline.Expression mapEntries(com.google.firebase.firestore.pipeline.Expression mapExpr);
+    method public com.google.firebase.firestore.pipeline.Expression mapEntries(String mapField);
     method public com.google.firebase.firestore.pipeline.Expression mapGet(com.google.firebase.firestore.pipeline.Expression mapExpression, com.google.firebase.firestore.pipeline.Expression keyExpression);
     method public com.google.firebase.firestore.pipeline.Expression mapGet(com.google.firebase.firestore.pipeline.Expression mapExpression, String key);
     method public com.google.firebase.firestore.pipeline.Expression mapGet(String fieldName, com.google.firebase.firestore.pipeline.Expression keyExpression);
     method public com.google.firebase.firestore.pipeline.Expression mapGet(String fieldName, String key);
+    method public com.google.firebase.firestore.pipeline.Expression mapKeys(com.google.firebase.firestore.pipeline.Expression mapExpr);
+    method public com.google.firebase.firestore.pipeline.Expression mapKeys(String mapField);
     method public com.google.firebase.firestore.pipeline.Expression mapMerge(com.google.firebase.firestore.pipeline.Expression firstMap, com.google.firebase.firestore.pipeline.Expression secondMap, com.google.firebase.firestore.pipeline.Expression... otherMaps);
     method public com.google.firebase.firestore.pipeline.Expression mapMerge(String firstMapFieldName, com.google.firebase.firestore.pipeline.Expression secondMap, com.google.firebase.firestore.pipeline.Expression... otherMaps);
     method public com.google.firebase.firestore.pipeline.Expression mapRemove(com.google.firebase.firestore.pipeline.Expression mapExpr, com.google.firebase.firestore.pipeline.Expression key);
     method public com.google.firebase.firestore.pipeline.Expression mapRemove(com.google.firebase.firestore.pipeline.Expression mapExpr, String key);
     method public com.google.firebase.firestore.pipeline.Expression mapRemove(String mapField, com.google.firebase.firestore.pipeline.Expression key);
     method public com.google.firebase.firestore.pipeline.Expression mapRemove(String mapField, String key);
+    method public com.google.firebase.firestore.pipeline.Expression mapSet(com.google.firebase.firestore.pipeline.Expression mapExpr, com.google.firebase.firestore.pipeline.Expression key, com.google.firebase.firestore.pipeline.Expression value, com.google.firebase.firestore.pipeline.Expression... moreKeyValues);
+    method public com.google.firebase.firestore.pipeline.Expression mapSet(com.google.firebase.firestore.pipeline.Expression mapExpr, String key, Object? value, java.lang.Object... moreKeyValues);
+    method public com.google.firebase.firestore.pipeline.Expression mapSet(String mapField, com.google.firebase.firestore.pipeline.Expression key, com.google.firebase.firestore.pipeline.Expression value, com.google.firebase.firestore.pipeline.Expression... moreKeyValues);
+    method public com.google.firebase.firestore.pipeline.Expression mapSet(String mapField, String key, Object? value, java.lang.Object... moreKeyValues);
+    method public com.google.firebase.firestore.pipeline.Expression mapValues(com.google.firebase.firestore.pipeline.Expression mapExpr);
+    method public com.google.firebase.firestore.pipeline.Expression mapValues(String mapField);
     method public com.google.firebase.firestore.pipeline.Expression mod(com.google.firebase.firestore.pipeline.Expression dividend, com.google.firebase.firestore.pipeline.Expression divisor);
     method public com.google.firebase.firestore.pipeline.Expression mod(com.google.firebase.firestore.pipeline.Expression dividend, Number divisor);
     method public com.google.firebase.firestore.pipeline.Expression mod(String dividendFieldName, com.google.firebase.firestore.pipeline.Expression divisor);

firebase-firestore/gradle.properties

@@ -1,2 +1,2 @@
-version=26.2.3
+version=26.2.0
 latestReleasedVersion=26.1.2