@firebase/firestore 3.8.4 → 3.9.0-20230314181055

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.4";
+const version$1 = "3.9.0-20230314181055";
 
 /**
  * @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.17.2";
+const version = "9.18.0-20230314181055";
 
 /**
  * @license
@@ -15835,8 +15835,11 @@ class IndexedDbPersistence {
                 // accesses internal state. We execute this code directly during shutdown
                 // to make sure it gets a chance to run.
                 this.markClientZombied();
-                if (isSafari() && navigator.appVersion.match(/Version\/1[45]/)) {
-                    // On Safari 14 and 15, we do not run any cleanup actions as it might
+                const safariIndexdbBugVersionRegex = /(?:Version|Mobile)\/1[456]/;
+                if (isSafari() &&
+                    (navigator.appVersion.match(safariIndexdbBugVersionRegex) ||
+                        navigator.userAgent.match(safariIndexdbBugVersionRegex))) {
+                    // On Safari 14, 15, and 16, we do not run any cleanup actions as it might
                     // trigger a bug that prevents Safari from re-opening IndexedDB during
                     // the next page load.
                     // See https://bugs.webkit.org/show_bug.cgi?id=226547
@@ -17912,6 +17915,66 @@ class StreamBridge {
     }
 }
 
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The value returned from the most recent invocation of
+ * `generateUniqueDebugId()`, or null if it has never been invoked.
+ */
+let lastUniqueDebugId = null;
+/**
+ * Generates and returns an initial value for `lastUniqueDebugId`.
+ *
+ * The returned value is randomly selected from a range of integers that are
+ * represented as 8 hexadecimal digits. This means that (within reason) any
+ * numbers generated by incrementing the returned number by 1 will also be
+ * represented by 8 hexadecimal digits. This leads to all "IDs" having the same
+ * length when converted to a hexadecimal string, making reading logs containing
+ * these IDs easier to follow. And since the return value is randomly selected
+ * it will help to differentiate between logs from different executions.
+ */
+function generateInitialUniqueDebugId() {
+    const minResult = 0x10000000;
+    const maxResult = 0x90000000;
+    const resultRange = maxResult - minResult;
+    const resultOffset = Math.round(resultRange * Math.random());
+    return minResult + resultOffset;
+}
+/**
+ * Generates and returns a unique ID as a hexadecimal string.
+ *
+ * The returned ID is intended to be used in debug logging messages to help
+ * correlate log messages that may be spatially separated in the logs, but
+ * logically related. For example, a network connection could include the same
+ * "debug ID" string in all of its log messages to help trace a specific
+ * connection over time.
+ *
+ * @return the 10-character generated ID (e.g. "0xa1b2c3d4").
+ */
+function generateUniqueDebugId() {
+    if (lastUniqueDebugId === null) {
+        lastUniqueDebugId = generateInitialUniqueDebugId();
+    }
+    else {
+        lastUniqueDebugId++;
+    }
+    return '0x' + lastUniqueDebugId.toString(16);
+}
+
 /**
  * @license
  * Copyright 2017 Google LLC
@@ -17998,7 +18061,7 @@ function nodePromise(action) {
 // TODO: Fetch runtime version from grpc-js/package.json instead
 // when there's a cleaner way to dynamic require JSON in both Node ESM and CJS
 const grpcVersion = '1.7.3';
-const LOG_TAG$9 = 'Connection';
+const LOG_TAG$9 = 'GrpcConnection';
 const X_GOOG_API_CLIENT_VALUE = `gl-node/${process.versions.node} fire/${SDK_VERSION} grpc/${grpcVersion}`;
 function createMetadata(databasePath, authToken, appCheckToken, appId) {
     hardAssert(authToken === null || authToken.type === 'OAuth');
@@ -18050,34 +18113,36 @@ class GrpcConnection {
         return this.cachedStub;
     }
     invokeRPC(rpcName, path, request, authToken, appCheckToken) {
+        const streamId = generateUniqueDebugId();
         const stub = this.ensureActiveStub();
         const metadata = createMetadata(this.databasePath, authToken, appCheckToken, this.databaseInfo.appId);
         const jsonRequest = Object.assign({ database: this.databasePath }, request);
         return nodePromise((callback) => {
-            logDebug(LOG_TAG$9, `RPC '${rpcName}' invoked with request:`, request);
+            logDebug(LOG_TAG$9, `RPC '${rpcName}' ${streamId} invoked with request:`, request);
             return stub[rpcName](jsonRequest, metadata, (grpcError, value) => {
                 if (grpcError) {
-                    logDebug(LOG_TAG$9, `RPC '${rpcName}' failed with error:`, grpcError);
+                    logDebug(LOG_TAG$9, `RPC '${rpcName}' ${streamId} failed with error:`, grpcError);
                     callback(new FirestoreError(mapCodeFromRpcCode(grpcError.code), grpcError.message));
                 }
                 else {
-                    logDebug(LOG_TAG$9, `RPC '${rpcName}' completed with response:`, value);
+                    logDebug(LOG_TAG$9, `RPC '${rpcName}' ${streamId} completed with response:`, value);
                     callback(undefined, value);
                 }
             });
         });
     }
     invokeStreamingRPC(rpcName, path, request, authToken, appCheckToken, expectedResponseCount) {
+        const streamId = generateUniqueDebugId();
         const results = [];
         const responseDeferred = new Deferred();
-        logDebug(LOG_TAG$9, `RPC '${rpcName}' invoked (streaming) with request:`, request);
+        logDebug(LOG_TAG$9, `RPC '${rpcName}' ${streamId} invoked (streaming) with request:`, request);
         const stub = this.ensureActiveStub();
         const metadata = createMetadata(this.databasePath, authToken, appCheckToken, this.databaseInfo.appId);
         const jsonRequest = Object.assign(Object.assign({}, request), { database: this.databasePath });
         const stream = stub[rpcName](jsonRequest, metadata);
         let callbackFired = false;
         stream.on('data', (response) => {
-            logDebug(LOG_TAG$9, `RPC ${rpcName} received result:`, response);
+            logDebug(LOG_TAG$9, `RPC ${rpcName} ${streamId} received result:`, response);
             results.push(response);
             if (expectedResponseCount !== undefined &&
                 results.length === expectedResponseCount) {
@@ -18086,14 +18151,14 @@ class GrpcConnection {
             }
         });
         stream.on('end', () => {
-            logDebug(LOG_TAG$9, `RPC '${rpcName}' completed.`);
+            logDebug(LOG_TAG$9, `RPC '${rpcName}' ${streamId} completed.`);
             if (!callbackFired) {
                 callbackFired = true;
                 responseDeferred.resolve(results);
             }
         });
         stream.on('error', (grpcError) => {
-            logDebug(LOG_TAG$9, `RPC '${rpcName}' failed with error:`, grpcError);
+            logDebug(LOG_TAG$9, `RPC '${rpcName}' ${streamId} failed with error:`, grpcError);
             const code = mapCodeFromRpcCode(grpcError.code);
             responseDeferred.reject(new FirestoreError(code, grpcError.message));
         });
@@ -18101,6 +18166,7 @@ class GrpcConnection {
     }
     // TODO(mikelehen): This "method" is a monster. Should be refactored.
     openStream(rpcName, authToken, appCheckToken) {
+        const streamId = generateUniqueDebugId();
         const stub = this.ensureActiveStub();
         const metadata = createMetadata(this.databasePath, authToken, appCheckToken, this.databaseInfo.appId);
         const grpcStream = stub[rpcName](metadata);
@@ -18115,7 +18181,7 @@ class GrpcConnection {
         const stream = new StreamBridge({
             sendFn: (msg) => {
                 if (!closed) {
-                    logDebug(LOG_TAG$9, 'GRPC stream sending:', msg);
+                    logDebug(LOG_TAG$9, `RPC '${rpcName}' stream ${streamId} sending:`, msg);
                     try {
                         grpcStream.write(msg);
                     }
@@ -18128,32 +18194,34 @@ class GrpcConnection {
                     }
                 }
                 else {
-                    logDebug(LOG_TAG$9, 'Not sending because gRPC stream is closed:', msg);
+                    logDebug(LOG_TAG$9, `RPC '${rpcName}' stream ${streamId} ` +
+                        'not sending because gRPC stream is closed:', msg);
                 }
             },
             closeFn: () => {
-                logDebug(LOG_TAG$9, 'GRPC stream closed locally via close().');
+                logDebug(LOG_TAG$9, `RPC '${rpcName}' stream ${streamId} closed locally via close().`);
                 close();
             }
         });
         grpcStream.on('data', (msg) => {
             if (!closed) {
-                logDebug(LOG_TAG$9, 'GRPC stream received:', msg);
+                logDebug(LOG_TAG$9, `RPC '${rpcName}' stream ${streamId} received:`, msg);
                 stream.callOnMessage(msg);
             }
         });
         grpcStream.on('end', () => {
-            logDebug(LOG_TAG$9, 'GRPC stream ended.');
+            logDebug(LOG_TAG$9, `RPC '${rpcName}' stream ${streamId} ended.`);
             close();
         });
         grpcStream.on('error', (grpcError) => {
             if (!closed) {
-                logWarn(LOG_TAG$9, 'GRPC stream error. Code:', grpcError.code, 'Message:', grpcError.message);
+                logWarn(LOG_TAG$9, `RPC '${rpcName}' stream ${streamId} error. Code:`, grpcError.code, 'Message:', grpcError.message);
                 const code = mapCodeFromRpcCode(grpcError.code);
                 close(new FirestoreError(code, grpcError.message));
             }
         });
-        logDebug(LOG_TAG$9, 'Opening GRPC stream');
+        logDebug(LOG_TAG$9, `Opening RPC '${rpcName}' stream ${streamId} ` +
+            `to ${this.databaseInfo.host}`);
         // TODO(dimond): Since grpc has no explicit open status (or does it?) we
         // simulate an onOpen in the next loop after the stream had it's listeners
         // registered
@@ -26558,7 +26626,7 @@ class Query {
 }
 /**
  * A `CollectionReference` object can be used for adding documents, getting
- * document references, and querying for documents (using {@link query}).
+ * document references, and querying for documents (using {@link (query:1)}).
  */
 class CollectionReference extends Query {
     /** @hideconstructor */
@@ -28714,9 +28782,9 @@ class AppliableConstraint {
 /**
  * A `QueryConstraint` is used to narrow the set of documents returned by a
  * Firestore query. `QueryConstraint`s are created by invoking {@link where},
- * {@link orderBy}, {@link startAt}, {@link startAfter}, {@link
- * endBefore}, {@link endAt}, {@link limit}, {@link limitToLast} and
- * can then be passed to {@link query} to create a new query instance that
+ * {@link orderBy}, {@link (startAt:1)}, {@link (startAfter:1)}, {@link
+ * (endBefore:1)}, {@link (endAt:1)}, {@link limit}, {@link limitToLast} and
+ * can then be passed to {@link (query:1)} to create a new query instance that
  * also contains this `QueryConstraint`.
  */
 class QueryConstraint extends AppliableConstraint {
@@ -28737,7 +28805,7 @@ function query(query, queryConstraint, ...additionalQueryConstraints) {
  * A `QueryFieldFilterConstraint` is used to narrow the set of documents returned by
  * a Firestore query by filtering on one or more document fields.
  * `QueryFieldFilterConstraint`s are created by invoking {@link where} and can then
- * be passed to {@link query} to create a new query instance that also contains
+ * be passed to {@link (query:1)} to create a new query instance that also contains
  * this `QueryFieldFilterConstraint`.
  */
 class QueryFieldFilterConstraint extends QueryConstraint {
@@ -28787,9 +28855,8 @@ function where(fieldPath, opStr, value) {
  * returned by a Firestore query by performing the logical OR or AND of multiple
  * {@link QueryFieldFilterConstraint}s or {@link QueryCompositeFilterConstraint}s.
  * `QueryCompositeFilterConstraint`s are created by invoking {@link or} or
- * {@link and} and can then be passed to {@link query} to create a new query
+ * {@link and} and can then be passed to {@link (query:1)} to create a new query
  * instance that also contains the `QueryCompositeFilterConstraint`.
- * @internal TODO remove this internal tag with OR Query support in the server
  */
 class QueryCompositeFilterConstraint extends AppliableConstraint {
     /**
@@ -28842,7 +28909,6 @@ class QueryCompositeFilterConstraint extends AppliableConstraint {
  * {@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) {
     // Only support QueryFilterConstraints
@@ -28858,7 +28924,6 @@ function or(...queryConstraints) {
  * {@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) {
     // Only support QueryFilterConstraints
@@ -28868,7 +28933,7 @@ function and(...queryConstraints) {
 /**
  * A `QueryOrderByConstraint` is used to sort the set of documents returned by a
  * Firestore query. `QueryOrderByConstraint`s are created by invoking
- * {@link orderBy} and can then be passed to {@link query} to create a new query
+ * {@link orderBy} and can then be passed to {@link (query:1)} to create a new query
  * instance that also contains this `QueryOrderByConstraint`.
  *
  * Note: Documents that do not contain the orderBy field will not be present in
@@ -28914,7 +28979,7 @@ function orderBy(fieldPath, directionStr = 'asc') {
  * A `QueryLimitConstraint` is used to limit the number of documents returned by
  * a Firestore query.
  * `QueryLimitConstraint`s are created by invoking {@link limit} or
- * {@link limitToLast} and can then be passed to {@link query} to create a new
+ * {@link limitToLast} and can then be passed to {@link (query:1)} to create a new
  * query instance that also contains this `QueryLimitConstraint`.
  */
 class QueryLimitConstraint extends QueryConstraint {
@@ -28965,7 +29030,7 @@ function limitToLast(limit) {
  * A `QueryStartAtConstraint` is used to exclude documents from the start of a
  * result set returned by a Firestore query.
  * `QueryStartAtConstraint`s are created by invoking {@link (startAt:1)} or
- * {@link (startAfter:1)} and can then be passed to {@link query} to create a
+ * {@link (startAfter:1)} and can then be passed to {@link (query:1)} to create a
  * new query instance that also contains this `QueryStartAtConstraint`.
  */
 class QueryStartAtConstraint extends QueryConstraint {
@@ -29000,7 +29065,7 @@ function startAfter(...docOrFields) {
  * A `QueryEndAtConstraint` is used to exclude documents from the end of a
  * result set returned by a Firestore query.
  * `QueryEndAtConstraint`s are created by invoking {@link (endAt:1)} or
- * {@link (endBefore:1)} and can then be passed to {@link query} to create a new
+ * {@link (endBefore:1)} and can then be passed to {@link (query:1)} to create a new
  * query instance that also contains this `QueryEndAtConstraint`.
  */
 class QueryEndAtConstraint extends QueryConstraint {