@firebase/firestore 3.8.0 → 3.8.1

package/dist/index.node.mjs

@@ -8,7 +8,7 @@ import * as grpc from '@grpc/grpc-js';
 import * as protoLoader from '@grpc/proto-loader';
 
 const name = "@firebase/firestore";
-const version$1 = "3.8.0";
+const version$1 = "3.8.1";
 
 /**
  * @license
@@ -61,7 +61,7 @@ User.GOOGLE_CREDENTIALS = new User('google-credentials-uid');
 User.FIRST_PARTY = new User('first-party-uid');
 User.MOCK_USER = new User('mock-user');
 
-const version = "9.15.0";
+const version = "9.16.0";
 
 /**
  * @license
@@ -5593,6 +5593,15 @@ function canonifyFilter(filter) {
             filter.op.toString() +
             canonicalId(filter.value));
     }
+    else if (compositeFilterIsFlatConjunction(filter)) {
+        // Older SDK versions use an implicit AND operation between their filters.
+        // In the new SDK versions, the developer may use an explicit AND filter.
+        // To stay consistent with the old usages, we add a special case to ensure
+        // the canonical ID for these two are the same. For example:
+        // `col.whereEquals("a", 1).whereEquals("b", 2)` should have the same
+        // canonical ID as `col.where(and(equals("a",1), equals("b",2)))`.
+        return filter.filters.map(filter => canonifyFilter(filter)).join(',');
+    }
     else {
         // filter instanceof CompositeFilter
         const canonicalIdsString = filter.filters
@@ -13371,8 +13380,10 @@ const SCHEMA_VERSION = 15;
 class OverlayedDocument {
     constructor(overlayedDocument, 
     /**
-     * The fields that are locally mutated by patch mutations. If the overlayed
-     * document is from set or delete mutations, this returns null.
+     * The fields that are locally mutated by patch mutations.
+     *
+     * If the overlayed	document is from set or delete mutations, this is `null`.
+     * If there is no overlay (mutation) for the document, this is an empty `FieldMask`.
      */
     mutatedFields) {
         this.overlayedDocument = overlayedDocument;
@@ -13524,6 +13535,11 @@ class LocalDocumentsView {
                 mutatedFields.set(doc.key, overlay.mutation.getFieldMask());
                 mutationApplyToLocalView(overlay.mutation, doc, overlay.mutation.getFieldMask(), Timestamp.now());
             }
+            else {
+                // no overlay exists
+                // Using EMPTY to indicate there is no overlay for the document.
+                mutatedFields.set(doc.key, FieldMask.empty());
+            }
         });
         return this.recalculateAndSaveOverlays(transaction, recalculateDocuments).next(recalculatedFields => {
             recalculatedFields.forEach((documentKey, mask) => mutatedFields.set(documentKey, mask));
@@ -28717,13 +28733,14 @@ class QueryCompositeFilterConstraint extends AppliableConstraint {
     }
 }
 /**
- * Creates a {@link QueryCompositeFilterConstraint} that performs a logical OR
- * of all the provided {@link QueryFilterConstraint}s.
+ * Creates a new {@link QueryCompositeFilterConstraint} that is a disjunction of
+ * the given filter constraints. A disjunction filter includes a document if it
+ * satisfies any of the given filters.
  *
- * @param queryConstraints - Optional. The {@link QueryFilterConstraint}s
- * for OR operation. These must be created with calls to {@link where},
- * {@link or}, or {@link and}.
- * @returns The created {@link QueryCompositeFilterConstraint}.
+ * @param queryConstraints - Optional. The list of
+ * {@link QueryFilterConstraint}s to perform a disjunction for. These must be
+ * created with calls to {@link where}, {@link or}, or {@link and}.
+ * @returns The newly created {@link QueryCompositeFilterConstraint}.
  * @internal TODO remove this internal tag with OR Query support in the server
  */
 function or(...queryConstraints) {
@@ -28732,13 +28749,14 @@ function or(...queryConstraints) {
     return QueryCompositeFilterConstraint._create("or" /* CompositeOperator.OR */, queryConstraints);
 }
 /**
- * Creates a {@link QueryCompositeFilterConstraint} that performs a logical AND
- * of all the provided {@link QueryFilterConstraint}s.
+ * Creates a new {@link QueryCompositeFilterConstraint} that is a conjunction of
+ * the given filter constraints. A conjunction filter includes a document if it
+ * satisfies all of the given filters.
  *
- * @param queryConstraints - Optional. The {@link QueryFilterConstraint}s
- * for AND operation. These must be created with calls to {@link where},
- * {@link or}, or {@link and}.
- * @returns The created {@link QueryCompositeFilterConstraint}.
+ * @param queryConstraints - Optional. The list of
+ * {@link QueryFilterConstraint}s to perform a conjunction for. These must be
+ * created with calls to {@link where}, {@link or}, or {@link and}.
+ * @returns The newly created {@link QueryCompositeFilterConstraint}.
  * @internal TODO remove this internal tag with OR Query support in the server
  */
 function and(...queryConstraints) {
@@ -29781,7 +29799,8 @@ function getDocs(query) {
 }
 /**
  * Executes the query and returns the results as a `QuerySnapshot` from cache.
- * Returns an error if the document is not currently cached.
+ * Returns an empty result set if no documents matching the query are currently
+ * cached.
  *
  * @returns A `Promise` that will be resolved with the results of the query.
  */