@firebase/util 1.9.7-canary.f58d48cd4 → 1.9.7-dataconnect-preview.d986d4bf2

package/dist/index.cjs.js

@@ -638,7 +638,7 @@ class Deferred {
         });
     }
     /**
-     * Our API internals are not promiseified and cannot because our callback APIs have subtle expectations around
+     * Our API internals are not promisified and cannot because our callback APIs have subtle expectations around
      * invoking promises inline, which Promises are forbidden to do. This method accepts an optional node-style callback
      * and returns a node-style callback which will resolve or reject the Deferred's promise.
      */
@@ -780,6 +780,9 @@ function isNode() {
 }
 /**
  * Detect Browser Environment
+ * Note: This will return true for certain test frameworks that are incompletely
+ * mimicking a browser, and should not lead to assuming all browser APIs are
+ * available.
  */
 function isBrowser() {
     return typeof window !== 'undefined' || isWebWorker();
@@ -915,7 +918,7 @@ function areCookiesEnabled() {
  *
  * Usage:
  *
- *   // Typescript string literals for type-safe codes
+ *   // TypeScript string literals for type-safe codes
  *   type Err =
  *     'unknown' |
  *     'object-not-found'
@@ -1026,7 +1029,7 @@ function jsonEval(str) {
 }
 /**
  * Returns JSON representing a javascript object.
- * @param {*} data Javascript object to be stringified.
+ * @param {*} data JavaScript object to be stringified.
  * @return {string} The JSON contents of the object.
  */
 function stringify(data) {
@@ -1629,7 +1632,7 @@ class ObserverProxy {
     /**
      * Subscribe function that can be used to add an Observer to the fan-out list.
      *
-     * - We require that no event is sent to a subscriber sychronously to their
+     * - We require that no event is sent to a subscriber synchronously to their
      *   call to subscribe().
      */
     subscribe(nextOrObserver, error, complete) {
@@ -1890,7 +1893,7 @@ function validateContextObject(fnName, argumentName, context, optional) {
 // so it's been modified.
 // Note that not all Unicode characters appear as single characters in JavaScript strings.
 // fromCharCode returns the UTF-16 encoding of a character - so some Unicode characters
-// use 2 characters in Javascript.  All 4-byte UTF-8 characters begin with a first
+// use 2 characters in JavaScript.  All 4-byte UTF-8 characters begin with a first
 // character in the range 0xD800 - 0xDBFF (the first character of a so-called surrogate
 // pair).
 // See http://www.ecma-international.org/ecma-262/5.1/#sec-15.1.3
@@ -2121,10 +2124,66 @@ function getModularInstance(service) {
     }
 }
 
+/**
+ * @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.
+ */
+class FetchProvider {
+    static initialize(fetchImpl, headersImpl, responseImpl) {
+        this.fetchImpl = fetchImpl;
+        if (headersImpl) {
+            this.headersImpl = headersImpl;
+        }
+        if (responseImpl) {
+            this.responseImpl = responseImpl;
+        }
+    }
+    static fetch() {
+        if (this.fetchImpl) {
+            return this.fetchImpl;
+        }
+        if (typeof self !== 'undefined' && 'fetch' in self) {
+            return self.fetch;
+        }
+        throw new Error('Could not find fetch implementation, make sure you call FetchProvider.initialize() with an appropriate polyfill');
+    }
+    static headers() {
+        if (this.headersImpl) {
+            return this.headersImpl;
+        }
+        if (typeof self !== 'undefined' && 'Headers' in self) {
+            return self.Headers;
+        }
+        throw new Error('Could not find Headers implementation, make sure you call FetchProvider.initialize() with an appropriate polyfill');
+    }
+    static response() {
+        if (this.responseImpl) {
+            return this.responseImpl;
+        }
+        if (typeof self !== 'undefined' && 'Response' in self) {
+            return self.Response;
+        }
+        throw new Error('Could not find Response implementation, make sure you call FetchProvider.initialize() with an appropriate polyfill');
+    }
+}
+
 exports.CONSTANTS = CONSTANTS;
 exports.DecodeBase64StringError = DecodeBase64StringError;
 exports.Deferred = Deferred;
 exports.ErrorFactory = ErrorFactory;
+exports.FetchProvider = FetchProvider;
 exports.FirebaseError = FirebaseError;
 exports.MAX_VALUE_MILLIS = MAX_VALUE_MILLIS;
 exports.RANDOM_FACTOR = RANDOM_FACTOR;