import { _registerComponent, registerVersion, _getProvider, getApp, _removeServiceInstance, SDK_VERSION } from '@firebase/app';
import { Component } from '@firebase/component';
import { Logger, LogLevel } from '@firebase/logger';
import { FirebaseError, getDefaultEmulatorHostnameAndPort, createMockUserToken, getModularInstance, deepEqual } from '@firebase/util';
/**
* @license
* Copyright 2017 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.
*/
/**
* Simple wrapper around a nullable UID. Mostly exists to make code more
* readable.
*/
class User {
constructor(t) {
this.uid = t;
}
isAuthenticated() {
return null != this.uid;
}
/**
* Returns a key representing this user, suitable for inclusion in a
* dictionary.
*/ toKey() {
return this.isAuthenticated() ? "uid:" + this.uid : "anonymous-user";
}
isEqual(t) {
return t.uid === this.uid;
}
}
/** A user with a null UID. */ User.UNAUTHENTICATED = new User(null),
// TODO(mikelehen): Look into getting a proper uid-equivalent for
// non-FirebaseAuth providers.
User.GOOGLE_CREDENTIALS = new User("google-credentials-uid"), User.FIRST_PARTY = new User("first-party-uid"),
User.MOCK_USER = new User("mock-user");
/**
* @license
* Copyright 2017 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.
*/
let d = "10.8.0";
/**
* @license
* Copyright 2017 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.
*/
const f = new Logger("@firebase/firestore");
/**
* Sets the verbosity of Cloud Firestore logs (debug, error, or silent).
*
* @param logLevel - The verbosity you set for activity and error logging. Can
* be any of the following values:
*
*
* - `debug` for the most verbose logging level, primarily for
* debugging.
* - `error` to log errors only.
* `silent` to turn off logging.
*
*/ function setLogLevel(t) {
f.setLogLevel(t);
}
function __PRIVATE_logDebug(t, ...e) {
if (f.logLevel <= LogLevel.DEBUG) {
const r = e.map(__PRIVATE_argToString);
f.debug(`Firestore (${d}): ${t}`, ...r);
}
}
function __PRIVATE_logError(t, ...e) {
if (f.logLevel <= LogLevel.ERROR) {
const r = e.map(__PRIVATE_argToString);
f.error(`Firestore (${d}): ${t}`, ...r);
}
}
/**
* @internal
*/ function __PRIVATE_logWarn(t, ...e) {
if (f.logLevel <= LogLevel.WARN) {
const r = e.map(__PRIVATE_argToString);
f.warn(`Firestore (${d}): ${t}`, ...r);
}
}
/**
* Converts an additional log parameter to a string representation.
*/ function __PRIVATE_argToString(t) {
if ("string" == typeof t) return t;
try {
/**
* @license
* Copyright 2020 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.
*/
/** Formats an object as a JSON string, suitable for logging. */
return function __PRIVATE_formatJSON(t) {
return JSON.stringify(t);
}(t);
} catch (e) {
// Converting to JSON failed, just log the object directly
return t;
}
}
/**
* @license
* Copyright 2017 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.
*/
/**
* Unconditionally fails, throwing an Error with the given message.
* Messages are stripped in production builds.
*
* Returns `never` and can be used in expressions:
* @example
* let futureVar = fail('not implemented yet');
*/ function fail(t = "Unexpected state") {
// Log the failure in addition to throw an exception, just in case the
// exception is swallowed.
const e = `FIRESTORE (${d}) INTERNAL ASSERTION FAILED: ` + t;
// NOTE: We don't use FirestoreError here because these are internal failures
// that cannot be handled by the user. (Also it would create a circular
// dependency between the error and assert modules which doesn't work.)
throw __PRIVATE_logError(e), new Error(e);
}
/**
* Fails if the given assertion condition is false, throwing an Error with the
* given message if it did.
*
* Messages are stripped in production builds.
*/ function __PRIVATE_hardAssert(t, e) {
t || fail();
}
/**
* Casts `obj` to `T`. In non-production builds, verifies that `obj` is an
* instance of `T` before casting.
*/ function __PRIVATE_debugCast(t,
// eslint-disable-next-line @typescript-eslint/no-explicit-any
e) {
return t;
}
/**
* @license
* Copyright 2017 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.
*/ const E = "ok", m = "cancelled", A = "unknown", T = "invalid-argument", R = "deadline-exceeded", P = "not-found", I = "already-exists", V = "permission-denied", p = "unauthenticated", y = "resource-exhausted", w = "failed-precondition", g = "aborted", F = "out-of-range", v = "unimplemented", D = "internal", b = "unavailable", C = "data-loss";
/** An error returned by a Firestore operation. */ class FirestoreError extends FirebaseError {
/** @hideconstructor */
constructor(
/**
* The backend error code associated with this error.
*/
t,
/**
* A custom error description.
*/
e) {
super(t, e), this.code = t, this.message = e,
// HACK: We write a toString property directly because Error is not a real
// class and so inheritance does not work correctly. We could alternatively
// do the same "back-door inheritance" trick that FirebaseError does.
this.toString = () => `${this.name}: [code=${this.code}]: ${this.message}`;
}
}
/**
* @license
* Copyright 2017 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 __PRIVATE_Deferred {
constructor() {
this.promise = new Promise(((t, e) => {
this.resolve = t, this.reject = e;
}));
}
}
/**
* @license
* Copyright 2017 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 __PRIVATE_OAuthToken {
constructor(t, e) {
this.user = e, this.type = "OAuth", this.headers = new Map, this.headers.set("Authorization", `Bearer ${t}`);
}
}
/**
* A CredentialsProvider that always yields an empty token.
* @internal
*/ class __PRIVATE_EmptyAuthCredentialsProvider {
getToken() {
return Promise.resolve(null);
}
invalidateToken() {}
start(t, e) {
// Fire with initial user.
t.enqueueRetryable((() => e(User.UNAUTHENTICATED)));
}
shutdown() {}
}
/**
* A CredentialsProvider that always returns a constant token. Used for
* emulator token mocking.
*/ class __PRIVATE_EmulatorAuthCredentialsProvider {
constructor(t) {
this.token = t,
/**
* Stores the listener registered with setChangeListener()
* This isn't actually necessary since the UID never changes, but we use this
* to verify the listen contract is adhered to in tests.
*/
this.changeListener = null;
}
getToken() {
return Promise.resolve(this.token);
}
invalidateToken() {}
start(t, e) {
this.changeListener = e,
// Fire with initial user.
t.enqueueRetryable((() => e(this.token.user)));
}
shutdown() {
this.changeListener = null;
}
}
/** Credential provider for the Lite SDK. */ class __PRIVATE_LiteAuthCredentialsProvider {
constructor(t) {
this.auth = null, t.onInit((t => {
this.auth = t;
}));
}
getToken() {
return this.auth ? this.auth.getToken().then((t => t ? (__PRIVATE_hardAssert("string" == typeof t.accessToken),
new __PRIVATE_OAuthToken(t.accessToken, new User(this.auth.getUid()))) : null)) : Promise.resolve(null);
}
invalidateToken() {}
start(t, e) {}
shutdown() {}
}
/*
* FirstPartyToken provides a fresh token each time its value
* is requested, because if the token is too old, requests will be rejected.
* Technically this may no longer be necessary since the SDK should gracefully
* recover from unauthenticated errors (see b/33147818 for context), but it's
* safer to keep the implementation as-is.
*/ class __PRIVATE_FirstPartyToken {
constructor(t, e, r) {
this.t = t, this.i = e, this.o = r, this.type = "FirstParty", this.user = User.FIRST_PARTY,
this.u = new Map;
}
/**
* Gets an authorization token, using a provided factory function, or return
* null.
*/ l() {
return this.o ? this.o() : null;
}
get headers() {
this.u.set("X-Goog-AuthUser", this.t);
// Use array notation to prevent minification
const t = this.l();
return t && this.u.set("Authorization", t), this.i && this.u.set("X-Goog-Iam-Authorization-Token", this.i),
this.u;
}
}
/*
* Provides user credentials required for the Firestore JavaScript SDK
* to authenticate the user, using technique that is only available
* to applications hosted by Google.
*/ class __PRIVATE_FirstPartyAuthCredentialsProvider {
constructor(t, e, r) {
this.t = t, this.i = e, this.o = r;
}
getToken() {
return Promise.resolve(new __PRIVATE_FirstPartyToken(this.t, this.i, this.o));
}
start(t, e) {
// Fire with initial uid.
t.enqueueRetryable((() => e(User.FIRST_PARTY)));
}
shutdown() {}
invalidateToken() {}
}
class AppCheckToken {
constructor(t) {
this.value = t, this.type = "AppCheck", this.headers = new Map, t && t.length > 0 && this.headers.set("x-firebase-appcheck", this.value);
}
}
/** AppCheck token provider for the Lite SDK. */ class __PRIVATE_LiteAppCheckTokenProvider {
constructor(t) {
this.h = t, this.appCheck = null, t.onInit((t => {
this.appCheck = t;
}));
}
getToken() {
return this.appCheck ? this.appCheck.getToken().then((t => t ? (__PRIVATE_hardAssert("string" == typeof t.token),
new AppCheckToken(t.token)) : null)) : Promise.resolve(null);
}
invalidateToken() {}
start(t, e) {}
shutdown() {}
}
/**
* Builds a CredentialsProvider depending on the type of
* the credentials passed in.
*/
/**
* @license
* Copyright 2017 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 DatabaseInfo {
/**
* Constructs a DatabaseInfo using the provided host, databaseId and
* persistenceKey.
*
* @param databaseId - The database to use.
* @param appId - The Firebase App Id.
* @param persistenceKey - A unique identifier for this Firestore's local
* storage (used in conjunction with the databaseId).
* @param host - The Firestore backend host to connect to.
* @param ssl - Whether to use SSL when connecting.
* @param forceLongPolling - Whether to use the forceLongPolling option
* when using WebChannel as the network transport.
* @param autoDetectLongPolling - Whether to use the detectBufferingProxy
* option when using WebChannel as the network transport.
* @param longPollingOptions Options that configure long-polling.
* @param useFetchStreams Whether to use the Fetch API instead of
* XMLHTTPRequest
*/
constructor(t, e, r, n, i, s, o, a, u) {
this.databaseId = t, this.appId = e, this.persistenceKey = r, this.host = n, this.ssl = i,
this.forceLongPolling = s, this.autoDetectLongPolling = o, this.longPollingOptions = a,
this.useFetchStreams = u;
}
}
/** The default database name for a project. */
/**
* Represents the database ID a Firestore client is associated with.
* @internal
*/
class DatabaseId {
constructor(t, e) {
this.projectId = t, this.database = e || "(default)";
}
static empty() {
return new DatabaseId("", "");
}
get isDefaultDatabase() {
return "(default)" === this.database;
}
isEqual(t) {
return t instanceof DatabaseId && t.projectId === this.projectId && t.database === this.database;
}
}
/**
* Path represents an ordered sequence of string segments.
*/
class BasePath {
constructor(t, e, r) {
void 0 === e ? e = 0 : e > t.length && fail(), void 0 === r ? r = t.length - e : r > t.length - e && fail(),
this.segments = t, this.offset = e, this.len = r;
}
get length() {
return this.len;
}
isEqual(t) {
return 0 === BasePath.comparator(this, t);
}
child(t) {
const e = this.segments.slice(this.offset, this.limit());
return t instanceof BasePath ? t.forEach((t => {
e.push(t);
})) : e.push(t), this.construct(e);
}
/** The index of one past the last segment of the path. */ limit() {
return this.offset + this.length;
}
popFirst(t) {
return t = void 0 === t ? 1 : t, this.construct(this.segments, this.offset + t, this.length - t);
}
popLast() {
return this.construct(this.segments, this.offset, this.length - 1);
}
firstSegment() {
return this.segments[this.offset];
}
lastSegment() {
return this.get(this.length - 1);
}
get(t) {
return this.segments[this.offset + t];
}
isEmpty() {
return 0 === this.length;
}
isPrefixOf(t) {
if (t.length < this.length) return !1;
for (let e = 0; e < this.length; e++) if (this.get(e) !== t.get(e)) return !1;
return !0;
}
isImmediateParentOf(t) {
if (this.length + 1 !== t.length) return !1;
for (let e = 0; e < this.length; e++) if (this.get(e) !== t.get(e)) return !1;
return !0;
}
forEach(t) {
for (let e = this.offset, r = this.limit(); e < r; e++) t(this.segments[e]);
}
toArray() {
return this.segments.slice(this.offset, this.limit());
}
static comparator(t, e) {
const r = Math.min(t.length, e.length);
for (let n = 0; n < r; n++) {
const r = t.get(n), i = e.get(n);
if (r < i) return -1;
if (r > i) return 1;
}
return t.length < e.length ? -1 : t.length > e.length ? 1 : 0;
}
}
/**
* A slash-separated path for navigating resources (documents and collections)
* within Firestore.
*
* @internal
*/ class ResourcePath extends BasePath {
construct(t, e, r) {
return new ResourcePath(t, e, r);
}
canonicalString() {
// NOTE: The client is ignorant of any path segments containing escape
// sequences (e.g. __id123__) and just passes them through raw (they exist
// for legacy reasons and should not be used frequently).
return this.toArray().join("/");
}
toString() {
return this.canonicalString();
}
/**
* Returns a string representation of this path
* where each path segment has been encoded with
* `encodeURIComponent`.
*/ toUriEncodedString() {
return this.toArray().map(encodeURIComponent).join("/");
}
/**
* Creates a resource path from the given slash-delimited string. If multiple
* arguments are provided, all components are combined. Leading and trailing
* slashes from all components are ignored.
*/ static fromString(...t) {
// NOTE: The client is ignorant of any path segments containing escape
// sequences (e.g. __id123__) and just passes them through raw (they exist
// for legacy reasons and should not be used frequently).
const e = [];
for (const r of t) {
if (r.indexOf("//") >= 0) throw new FirestoreError(T, `Invalid segment (${r}). Paths must not contain // in them.`);
// Strip leading and traling slashed.
e.push(...r.split("/").filter((t => t.length > 0)));
}
return new ResourcePath(e);
}
static emptyPath() {
return new ResourcePath([]);
}
}
const S = /^[_a-zA-Z][_a-zA-Z0-9]*$/;
/**
* A dot-separated path for navigating sub-objects within a document.
* @internal
*/ class FieldPath$1 extends BasePath {
construct(t, e, r) {
return new FieldPath$1(t, e, r);
}
/**
* Returns true if the string could be used as a segment in a field path
* without escaping.
*/ static isValidIdentifier(t) {
return S.test(t);
}
canonicalString() {
return this.toArray().map((t => (t = t.replace(/\\/g, "\\\\").replace(/`/g, "\\`"),
FieldPath$1.isValidIdentifier(t) || (t = "`" + t + "`"), t))).join(".");
}
toString() {
return this.canonicalString();
}
/**
* Returns true if this field references the key of a document.
*/ isKeyField() {
return 1 === this.length && "__name__" === this.get(0);
}
/**
* The field designating the key of a document.
*/ static keyField() {
return new FieldPath$1([ "__name__" ]);
}
/**
* Parses a field string from the given server-formatted string.
*
* - Splitting the empty string is not allowed (for now at least).
* - Empty segments within the string (e.g. if there are two consecutive
* separators) are not allowed.
*
* TODO(b/37244157): we should make this more strict. Right now, it allows
* non-identifier path components, even if they aren't escaped.
*/ static fromServerFormat(t) {
const e = [];
let r = "", n = 0;
const __PRIVATE_addCurrentSegment = () => {
if (0 === r.length) throw new FirestoreError(T, `Invalid field path (${t}). Paths must not be empty, begin with '.', end with '.', or contain '..'`);
e.push(r), r = "";
};
let i = !1;
for (;n < t.length; ) {
const e = t[n];
if ("\\" === e) {
if (n + 1 === t.length) throw new FirestoreError(T, "Path has trailing escape character: " + t);
const e = t[n + 1];
if ("\\" !== e && "." !== e && "`" !== e) throw new FirestoreError(T, "Path has invalid escape sequence: " + t);
r += e, n += 2;
} else "`" === e ? (i = !i, n++) : "." !== e || i ? (r += e, n++) : (__PRIVATE_addCurrentSegment(),
n++);
}
if (__PRIVATE_addCurrentSegment(), i) throw new FirestoreError(T, "Unterminated ` in path: " + t);
return new FieldPath$1(e);
}
static emptyPath() {
return new FieldPath$1([]);
}
}
/**
* @license
* Copyright 2017 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.
*/
/**
* @internal
*/ class DocumentKey {
constructor(t) {
this.path = t;
}
static fromPath(t) {
return new DocumentKey(ResourcePath.fromString(t));
}
static fromName(t) {
return new DocumentKey(ResourcePath.fromString(t).popFirst(5));
}
static empty() {
return new DocumentKey(ResourcePath.emptyPath());
}
get collectionGroup() {
return this.path.popLast().lastSegment();
}
/** Returns true if the document is in the specified collectionId. */ hasCollectionId(t) {
return this.path.length >= 2 && this.path.get(this.path.length - 2) === t;
}
/** Returns the collection group (i.e. the name of the parent collection) for this key. */ getCollectionGroup() {
return this.path.get(this.path.length - 2);
}
/** Returns the fully qualified path to the parent collection. */ getCollectionPath() {
return this.path.popLast();
}
isEqual(t) {
return null !== t && 0 === ResourcePath.comparator(this.path, t.path);
}
toString() {
return this.path.toString();
}
static comparator(t, e) {
return ResourcePath.comparator(t.path, e.path);
}
static isDocumentKey(t) {
return t.length % 2 == 0;
}
/**
* Creates and returns a new document key with the given segments.
*
* @param segments - The segments of the path to the document
* @returns A new instance of DocumentKey
*/ static fromSegments(t) {
return new DocumentKey(new ResourcePath(t.slice()));
}
}
/**
* @license
* Copyright 2017 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.
*/ function __PRIVATE_validateNonEmptyArgument(t, e, r) {
if (!r) throw new FirestoreError(T, `Function ${t}() cannot be called with an empty ${e}.`);
}
/**
* Validates that two boolean options are not set at the same time.
* @internal
*/
/**
* Validates that `path` refers to a document (indicated by the fact it contains
* an even numbers of segments).
*/
function __PRIVATE_validateDocumentPath(t) {
if (!DocumentKey.isDocumentKey(t)) throw new FirestoreError(T, `Invalid document reference. Document references must have an even number of segments, but ${t} has ${t.length}.`);
}
/**
* Validates that `path` refers to a collection (indicated by the fact it
* contains an odd numbers of segments).
*/ function __PRIVATE_validateCollectionPath(t) {
if (DocumentKey.isDocumentKey(t)) throw new FirestoreError(T, `Invalid collection reference. Collection references must have an odd number of segments, but ${t} has ${t.length}.`);
}
/**
* Returns true if it's a non-null object without a custom prototype
* (i.e. excludes Array, Date, etc.).
*/
/** Returns a string describing the type / value of the provided input. */
function __PRIVATE_valueDescription(t) {
if (void 0 === t) return "undefined";
if (null === t) return "null";
if ("string" == typeof t) return t.length > 20 && (t = `${t.substring(0, 20)}...`),
JSON.stringify(t);
if ("number" == typeof t || "boolean" == typeof t) return "" + t;
if ("object" == typeof t) {
if (t instanceof Array) return "an array";
{
const e =
/** try to get the constructor name for an object. */
function __PRIVATE_tryGetCustomObjectType(t) {
if (t.constructor) return t.constructor.name;
return null;
}
/**
* Casts `obj` to `T`, optionally unwrapping Compat types to expose the
* underlying instance. Throws if `obj` is not an instance of `T`.
*
* This cast is used in the Lite and Full SDK to verify instance types for
* arguments passed to the public API.
* @internal
*/ (t);
return e ? `a custom ${e} object` : "an object";
}
}
return "function" == typeof t ? "a function" : fail();
}
function __PRIVATE_cast(t,
// eslint-disable-next-line @typescript-eslint/no-explicit-any
e) {
if ("_delegate" in t && (
// Unwrap Compat types
// eslint-disable-next-line @typescript-eslint/no-explicit-any
t = t._delegate), !(t instanceof e)) {
if (e.name === t.constructor.name) throw new FirestoreError(T, "Type does not match the expected instance. Did you pass a reference from a different Firestore SDK?");
{
const r = __PRIVATE_valueDescription(t);
throw new FirestoreError(T, `Expected type '${e.name}', but it was: ${r}`);
}
}
return t;
}
function __PRIVATE_validatePositiveNumber(t, e) {
if (e <= 0) throw new FirestoreError(T, `Function ${t}() requires a positive number, but it was: ${e}.`);
}
/**
* @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.
*/
/**
* Compares two `ExperimentalLongPollingOptions` objects for equality.
*/
/**
* Creates and returns a new `ExperimentalLongPollingOptions` with the same
* option values as the given instance.
*/
function __PRIVATE_cloneLongPollingOptions(t) {
const e = {};
return void 0 !== t.timeoutSeconds && (e.timeoutSeconds = t.timeoutSeconds), e;
}
/**
* @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 N = 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.
*/
/**
* 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 __PRIVATE_generateUniqueDebugId() {
return null === N ? N = function __PRIVATE_generateInitialUniqueDebugId() {
return 268435456 + Math.round(2147483648 * Math.random());
}() : N++, "0x" + N.toString(16);
}
/**
* @license
* Copyright 2017 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.
*/
/**
* Returns whether a variable is either undefined or null.
*/ function __PRIVATE_isNullOrUndefined(t) {
return null == t;
}
/** Returns whether the value represents -0. */ function __PRIVATE_isNegativeZero(t) {
// Detect if the value is -0.0. Based on polyfill from
// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/is
return 0 === t && 1 / t == -1 / 0;
}
/**
* Returns whether a value is an integer and in the safe integer range
* @param value - The value to test for being an integer and in the safe range
*/
/**
* @license
* Copyright 2020 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.
*/
const O = {
BatchGetDocuments: "batchGet",
Commit: "commit",
RunQuery: "runQuery",
RunAggregationQuery: "runAggregationQuery"
};
/**
* Maps RPC names to the corresponding REST endpoint name.
*
* We use array notation to avoid mangling.
*/
/**
* @license
* Copyright 2017 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.
*/
/**
* Error Codes describing the different ways GRPC can fail. These are copied
* directly from GRPC's sources here:
*
* https://github.com/grpc/grpc/blob/bceec94ea4fc5f0085d81235d8e1c06798dc341a/include/grpc%2B%2B/impl/codegen/status_code_enum.h
*
* Important! The names of these identifiers matter because the string forms
* are used for reverse lookups from the webchannel stream. Do NOT change the
* names of these identifiers or change this into a const enum.
*/
var q, B;
/**
* Converts an HTTP Status Code to the equivalent error code.
*
* @param status - An HTTP Status Code, like 200, 404, 503, etc.
* @returns The equivalent Code. Unknown status codes are mapped to
* Code.UNKNOWN.
*/
function __PRIVATE_mapCodeFromHttpStatus(t) {
if (void 0 === t) return __PRIVATE_logError("RPC_ERROR", "HTTP error has no status"),
A;
// The canonical error codes for Google APIs [1] specify mapping onto HTTP
// status codes but the mapping is not bijective. In each case of ambiguity
// this function chooses a primary error.
// [1]
// https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
switch (t) {
case 200:
// OK
return E;
case 400:
// Bad Request
return w;
// Other possibilities based on the forward mapping
// return Code.INVALID_ARGUMENT;
// return Code.OUT_OF_RANGE;
case 401:
// Unauthorized
return p;
case 403:
// Forbidden
return V;
case 404:
// Not Found
return P;
case 409:
// Conflict
return g;
// Other possibilities:
// return Code.ALREADY_EXISTS;
case 416:
// Range Not Satisfiable
return F;
case 429:
// Too Many Requests
return y;
case 499:
// Client Closed Request
return m;
case 500:
// Internal Server Error
return A;
// Other possibilities:
// return Code.INTERNAL;
// return Code.DATA_LOSS;
case 501:
// Unimplemented
return v;
case 503:
// Service Unavailable
return b;
case 504:
// Gateway Timeout
return R;
default:
return t >= 200 && t < 300 ? E : t >= 400 && t < 500 ? w : t >= 500 && t < 600 ? D : A;
}
}
/**
* @license
* Copyright 2020 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.
*/
/**
* A Rest-based connection that relies on the native HTTP stack
* (e.g. `fetch` or a polyfill).
*/ (B = q || (q = {}))[B.OK = 0] = "OK", B[B.CANCELLED = 1] = "CANCELLED", B[B.UNKNOWN = 2] = "UNKNOWN",
B[B.INVALID_ARGUMENT = 3] = "INVALID_ARGUMENT", B[B.DEADLINE_EXCEEDED = 4] = "DEADLINE_EXCEEDED",
B[B.NOT_FOUND = 5] = "NOT_FOUND", B[B.ALREADY_EXISTS = 6] = "ALREADY_EXISTS", B[B.PERMISSION_DENIED = 7] = "PERMISSION_DENIED",
B[B.UNAUTHENTICATED = 16] = "UNAUTHENTICATED", B[B.RESOURCE_EXHAUSTED = 8] = "RESOURCE_EXHAUSTED",
B[B.FAILED_PRECONDITION = 9] = "FAILED_PRECONDITION", B[B.ABORTED = 10] = "ABORTED",
B[B.OUT_OF_RANGE = 11] = "OUT_OF_RANGE", B[B.UNIMPLEMENTED = 12] = "UNIMPLEMENTED",
B[B.INTERNAL = 13] = "INTERNAL", B[B.UNAVAILABLE = 14] = "UNAVAILABLE", B[B.DATA_LOSS = 15] = "DATA_LOSS";
class __PRIVATE_FetchConnection extends
/**
* Base class for all Rest-based connections to the backend (WebChannel and
* HTTP).
*/
class __PRIVATE_RestConnection {
constructor(t) {
this.databaseInfo = t, this.databaseId = t.databaseId;
const e = t.ssl ? "https" : "http", r = encodeURIComponent(this.databaseId.projectId), n = encodeURIComponent(this.databaseId.database);
this.m = e + "://" + t.host, this.A = `projects/${r}/databases/${n}`, this.T = "(default)" === this.databaseId.database ? `project_id=${r}` : `project_id=${r}&database_id=${n}`;
}
get R() {
// Both `invokeRPC()` and `invokeStreamingRPC()` use their `path` arguments to determine
// where to run the query, and expect the `request` to NOT specify the "path".
return !1;
}
P(t, e, r, n, i) {
const s = __PRIVATE_generateUniqueDebugId(), o = this.I(t, e.toUriEncodedString());
__PRIVATE_logDebug("RestConnection", `Sending RPC '${t}' ${s}:`, o, r);
const a = {
"google-cloud-resource-prefix": this.A,
"x-goog-request-params": this.T
};
return this.V(a, n, i), this.p(t, o, a, r).then((e => (__PRIVATE_logDebug("RestConnection", `Received RPC '${t}' ${s}: `, e),
e)), (e => {
throw __PRIVATE_logWarn("RestConnection", `RPC '${t}' ${s} failed with error: `, e, "url: ", o, "request:", r),
e;
}));
}
g(t, e, r, n, i, s) {
// The REST API automatically aggregates all of the streamed results, so we
// can just use the normal invoke() method.
return this.P(t, e, r, n, i);
}
/**
* Modifies the headers for a request, adding any authorization token if
* present and any additional headers for the request.
*/ V(t, e, r) {
t["X-Goog-Api-Client"] =
// SDK_VERSION is updated to different value at runtime depending on the entry point,
// so we need to get its value when we need it in a function.
function __PRIVATE_getGoogApiClientValue() {
return "gl-js/ fire/" + d;
}(),
// Content-Type: text/plain will avoid preflight requests which might
// mess with CORS and redirects by proxies. If we add custom headers
// we will need to change this code to potentially use the $httpOverwrite
// parameter supported by ESF to avoid triggering preflight requests.
t["Content-Type"] = "text/plain", this.databaseInfo.appId && (t["X-Firebase-GMPID"] = this.databaseInfo.appId),
e && e.headers.forEach(((e, r) => t[r] = e)), r && r.headers.forEach(((e, r) => t[r] = e));
}
I(t, e) {
const r = O[t];
return `${this.m}/v1/${e}:${r}`;
}
/**
* Closes and cleans up any resources associated with the connection. This
* implementation is a no-op because there are no resources associated
* with the RestConnection that need to be cleaned up.
*/ terminate() {
// No-op
}
} {
/**
* @param databaseInfo - The connection info.
* @param fetchImpl - `fetch` or a Polyfill that implements the fetch API.
*/
constructor(t, e) {
super(t), this.F = e;
}
v(t, e) {
throw new Error("Not supported by FetchConnection");
}
async p(t, e, r, n) {
var i;
const s = JSON.stringify(n);
let o;
try {
o = await this.F(e, {
method: "POST",
headers: r,
body: s
});
} catch (t) {
const e = t;
throw new FirestoreError(__PRIVATE_mapCodeFromHttpStatus(e.status), "Request failed with error: " + e.statusText);
}
if (!o.ok) {
let t = await o.json();
Array.isArray(t) && (t = t[0]);
const e = null === (i = null == t ? void 0 : t.error) || void 0 === i ? void 0 : i.message;
throw new FirestoreError(__PRIVATE_mapCodeFromHttpStatus(o.status), `Request failed with error: ${null != e ? e : o.statusText}`);
}
return o.json();
}
}
/**
* @license
* Copyright 2020 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.
*/
/** Initializes the HTTP connection for the REST API. */
/**
* @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.
*/
/**
* Concrete implementation of the Aggregate type.
*/
class __PRIVATE_AggregateImpl {
constructor(t, e, r) {
this.alias = t, this.aggregateType = e, this.fieldPath = r;
}
}
/**
* @license
* Copyright 2020 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.
*/
/**
* Generates `nBytes` of random bytes.
*
* If `nBytes < 0` , an error will be thrown.
*/ function __PRIVATE_randomBytes(t) {
// Polyfills for IE and WebWorker by using `self` and `msCrypto` when `crypto` is not available.
const e =
// eslint-disable-next-line @typescript-eslint/no-explicit-any
"undefined" != typeof self && (self.crypto || self.msCrypto), r = new Uint8Array(t);
if (e && "function" == typeof e.getRandomValues) e.getRandomValues(r); else
// Falls back to Math.random
for (let e = 0; e < t; e++) r[e] = Math.floor(256 * Math.random());
return r;
}
/**
* @license
* Copyright 2017 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.
*/
/**
* A utility class for generating unique alphanumeric IDs of a specified length.
*
* @internal
* Exported internally for testing purposes.
*/ class __PRIVATE_AutoId {
static newId() {
// Alphanumeric characters
const t = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", e = Math.floor(256 / t.length) * t.length;
// The largest byte value that is a multiple of `char.length`.
let r = "";
for (;r.length < 20; ) {
const n = __PRIVATE_randomBytes(40);
for (let i = 0; i < n.length; ++i)
// Only accept values that are [0, maxMultiple), this ensures they can
// be evenly mapped to indices of `chars` via a modulo operation.
r.length < 20 && n[i] < e && (r += t.charAt(n[i] % t.length));
}
return r;
}
}
function __PRIVATE_primitiveComparator(t, e) {
return t < e ? -1 : t > e ? 1 : 0;
}
/** Helper to compare arrays using isEqual(). */ function __PRIVATE_arrayEquals(t, e, r) {
return t.length === e.length && t.every(((t, n) => r(t, e[n])));
}
/**
* @license
* Copyright 2017 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.
*/ function __PRIVATE_objectSize(t) {
let e = 0;
for (const r in t) Object.prototype.hasOwnProperty.call(t, r) && e++;
return e;
}
function forEach(t, e) {
for (const r in t) Object.prototype.hasOwnProperty.call(t, r) && e(r, t[r]);
}
/**
* @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.
*/
/**
* An error encountered while decoding base64 string.
*/
class __PRIVATE_Base64DecodeError extends Error {
constructor() {
super(...arguments), this.name = "Base64DecodeError";
}
}
/**
* @license
* Copyright 2020 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.
*/
/** Converts a Base64 encoded string to a binary string. */
/**
* @license
* Copyright 2020 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.
*/
/**
* Immutable class that represents a "proto" byte string.
*
* Proto byte strings can either be Base64-encoded strings or Uint8Arrays when
* sent on the wire. This class abstracts away this differentiation by holding
* the proto byte string in a common class that must be converted into a string
* before being sent as a proto.
* @internal
*/
class ByteString {
constructor(t) {
this.binaryString = t;
}
static fromBase64String(t) {
const e = function __PRIVATE_decodeBase64(t) {
try {
return atob(t);
} catch (t) {
// Check that `DOMException` is defined before using it to avoid
// "ReferenceError: Property 'DOMException' doesn't exist" in react-native.
// (https://github.com/firebase/firebase-js-sdk/issues/7115)
throw "undefined" != typeof DOMException && t instanceof DOMException ? new __PRIVATE_Base64DecodeError("Invalid base64 string: " + t) : t;
}
}
/** Converts a binary string to a Base64 encoded string. */ (t);
return new ByteString(e);
}
static fromUint8Array(t) {
// TODO(indexing); Remove the copy of the byte string here as this method
// is frequently called during indexing.
const e =
/**
* Helper function to convert an Uint8array to a binary string.
*/
function __PRIVATE_binaryStringFromUint8Array(t) {
let e = "";
for (let r = 0; r < t.length; ++r) e += String.fromCharCode(t[r]);
return e;
}
/**
* Helper function to convert a binary string to an Uint8Array.
*/ (t);
return new ByteString(e);
}
[Symbol.iterator]() {
let t = 0;
return {
next: () => t < this.binaryString.length ? {
value: this.binaryString.charCodeAt(t++),
done: !1
} : {
value: void 0,
done: !0
}
};
}
toBase64() {
return function __PRIVATE_encodeBase64(t) {
return btoa(t);
}(this.binaryString);
}
toUint8Array() {
return function __PRIVATE_uint8ArrayFromBinaryString(t) {
const e = new Uint8Array(t.length);
for (let r = 0; r < t.length; r++) e[r] = t.charCodeAt(r);
return e;
}
/**
* @license
* Copyright 2020 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.
*/
// A RegExp matching ISO 8601 UTC timestamps with optional fraction.
(this.binaryString);
}
approximateByteSize() {
return 2 * this.binaryString.length;
}
compareTo(t) {
return __PRIVATE_primitiveComparator(this.binaryString, t.binaryString);
}
isEqual(t) {
return this.binaryString === t.binaryString;
}
}
ByteString.EMPTY_BYTE_STRING = new ByteString("");
const $ = new RegExp(/^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d(?:\.(\d+))?Z$/);
/**
* Converts the possible Proto values for a timestamp value into a "seconds and
* nanos" representation.
*/ function __PRIVATE_normalizeTimestamp(t) {
// The json interface (for the browser) will return an iso timestamp string,
// while the proto js library (for node) will return a
// google.protobuf.Timestamp instance.
if (__PRIVATE_hardAssert(!!t), "string" == typeof t) {
// The date string can have higher precision (nanos) than the Date class
// (millis), so we do some custom parsing here.
// Parse the nanos right out of the string.
let e = 0;
const r = $.exec(t);
if (__PRIVATE_hardAssert(!!r), r[1]) {
// Pad the fraction out to 9 digits (nanos).
let t = r[1];
t = (t + "000000000").substr(0, 9), e = Number(t);
}
// Parse the date to get the seconds.
const n = new Date(t);
return {
seconds: Math.floor(n.getTime() / 1e3),
nanos: e
};
}
return {
seconds: __PRIVATE_normalizeNumber(t.seconds),
nanos: __PRIVATE_normalizeNumber(t.nanos)
};
}
/**
* Converts the possible Proto types for numbers into a JavaScript number.
* Returns 0 if the value is not numeric.
*/ function __PRIVATE_normalizeNumber(t) {
// TODO(bjornick): Handle int64 greater than 53 bits.
return "number" == typeof t ? t : "string" == typeof t ? Number(t) : 0;
}
/** Converts the possible Proto types for Blobs into a ByteString. */ function __PRIVATE_normalizeByteString(t) {
return "string" == typeof t ? ByteString.fromBase64String(t) : ByteString.fromUint8Array(t);
}
/**
* @license
* Copyright 2017 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 earliest date supported by Firestore timestamps (0001-01-01T00:00:00Z).
/**
* A `Timestamp` represents a point in time independent of any time zone or
* calendar, represented as seconds and fractions of seconds at nanosecond
* resolution in UTC Epoch time.
*
* It is encoded using the Proleptic Gregorian Calendar which extends the
* Gregorian calendar backwards to year one. It is encoded assuming all minutes
* are 60 seconds long, i.e. leap seconds are "smeared" so that no leap second
* table is needed for interpretation. Range is from 0001-01-01T00:00:00Z to
* 9999-12-31T23:59:59.999999999Z.
*
* For examples and further specifications, refer to the
* {@link https://github.com/google/protobuf/blob/master/src/google/protobuf/timestamp.proto | Timestamp definition}.
*/
class Timestamp {
/**
* Creates a new timestamp.
*
* @param seconds - The number of seconds of UTC time since Unix epoch
* 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
* 9999-12-31T23:59:59Z inclusive.
* @param nanoseconds - The non-negative fractions of a second at nanosecond
* resolution. Negative second values with fractions must still have
* non-negative nanoseconds values that count forward in time. Must be
* from 0 to 999,999,999 inclusive.
*/
constructor(
/**
* The number of seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z.
*/
t,
/**
* The fractions of a second at nanosecond resolution.*
*/
e) {
if (this.seconds = t, this.nanoseconds = e, e < 0) throw new FirestoreError(T, "Timestamp nanoseconds out of range: " + e);
if (e >= 1e9) throw new FirestoreError(T, "Timestamp nanoseconds out of range: " + e);
if (t < -62135596800) throw new FirestoreError(T, "Timestamp seconds out of range: " + t);
// This will break in the year 10,000.
if (t >= 253402300800) throw new FirestoreError(T, "Timestamp seconds out of range: " + t);
}
/**
* Creates a new timestamp with the current date, with millisecond precision.
*
* @returns a new timestamp representing the current date.
*/ static now() {
return Timestamp.fromMillis(Date.now());
}
/**
* Creates a new timestamp from the given date.
*
* @param date - The date to initialize the `Timestamp` from.
* @returns A new `Timestamp` representing the same point in time as the given
* date.
*/ static fromDate(t) {
return Timestamp.fromMillis(t.getTime());
}
/**
* Creates a new timestamp from the given number of milliseconds.
*
* @param milliseconds - Number of milliseconds since Unix epoch
* 1970-01-01T00:00:00Z.
* @returns A new `Timestamp` representing the same point in time as the given
* number of milliseconds.
*/ static fromMillis(t) {
const e = Math.floor(t / 1e3), r = Math.floor(1e6 * (t - 1e3 * e));
return new Timestamp(e, r);
}
/**
* Converts a `Timestamp` to a JavaScript `Date` object. This conversion
* causes a loss of precision since `Date` objects only support millisecond
* precision.
*
* @returns JavaScript `Date` object representing the same point in time as
* this `Timestamp`, with millisecond precision.
*/ toDate() {
return new Date(this.toMillis());
}
/**
* Converts a `Timestamp` to a numeric timestamp (in milliseconds since
* epoch). This operation causes a loss of precision.
*
* @returns The point in time corresponding to this timestamp, represented as
* the number of milliseconds since Unix epoch 1970-01-01T00:00:00Z.
*/ toMillis() {
return 1e3 * this.seconds + this.nanoseconds / 1e6;
}
_compareTo(t) {
return this.seconds === t.seconds ? __PRIVATE_primitiveComparator(this.nanoseconds, t.nanoseconds) : __PRIVATE_primitiveComparator(this.seconds, t.seconds);
}
/**
* Returns true if this `Timestamp` is equal to the provided one.
*
* @param other - The `Timestamp` to compare against.
* @returns true if this `Timestamp` is equal to the provided one.
*/ isEqual(t) {
return t.seconds === this.seconds && t.nanoseconds === this.nanoseconds;
}
/** Returns a textual representation of this `Timestamp`. */ toString() {
return "Timestamp(seconds=" + this.seconds + ", nanoseconds=" + this.nanoseconds + ")";
}
/** Returns a JSON-serializable representation of this `Timestamp`. */ toJSON() {
return {
seconds: this.seconds,
nanoseconds: this.nanoseconds
};
}
/**
* Converts this object to a primitive string, which allows `Timestamp` objects
* to be compared using the `>`, `<=`, `>=` and `>` operators.
*/ valueOf() {
// This method returns a string of the form . where
// is translated to have a non-negative value and both
// and are left-padded with zeroes to be a consistent length.
// Strings with this format then have a lexiographical ordering that matches
// the expected ordering. The translation is done to avoid having
// a leading negative sign (i.e. a leading '-' character) in its string
// representation, which would affect its lexiographical ordering.
const t = this.seconds - -62135596800;
// Note: Up to 12 decimal digits are required to represent all valid
// 'seconds' values.
return String(t).padStart(12, "0") + "." + String(this.nanoseconds).padStart(9, "0");
}
}
/**
* @license
* Copyright 2020 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.
*/
/**
* Represents a locally-applied ServerTimestamp.
*
* Server Timestamps are backed by MapValues that contain an internal field
* `__type__` with a value of `server_timestamp`. The previous value and local
* write time are stored in its `__previous_value__` and `__local_write_time__`
* fields respectively.
*
* Notes:
* - ServerTimestampValue instances are created as the result of applying a
* transform. They can only exist in the local view of a document. Therefore
* they do not need to be parsed or serialized.
* - When evaluated locally (e.g. for snapshot.data()), they by default
* evaluate to `null`. This behavior can be configured by passing custom
* FieldValueOptions to value().
* - With respect to other ServerTimestampValues, they sort by their
* localWriteTime.
*/ function __PRIVATE_isServerTimestamp(t) {
var e, r;
return "server_timestamp" === (null === (r = ((null === (e = null == t ? void 0 : t.mapValue) || void 0 === e ? void 0 : e.fields) || {}).__type__) || void 0 === r ? void 0 : r.stringValue);
}
/**
* Returns the value of the field before this ServerTimestamp was set.
*
* Preserving the previous values allows the user to display the last resoled
* value until the backend responds with the timestamp.
*/ function __PRIVATE_getPreviousValue(t) {
const e = t.mapValue.fields.__previous_value__;
return __PRIVATE_isServerTimestamp(e) ? __PRIVATE_getPreviousValue(e) : e;
}
/**
* Returns the local time at which this timestamp was first set.
*/ function __PRIVATE_getLocalWriteTime(t) {
const e = __PRIVATE_normalizeTimestamp(t.mapValue.fields.__local_write_time__.timestampValue);
return new Timestamp(e.seconds, e.nanos);
}
/**
* @license
* Copyright 2020 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.
*/ const Q = {
fields: {
__type__: {
stringValue: "__max__"
}
}
};
/** Extracts the backend's type order for the provided value. */
function __PRIVATE_typeOrder(t) {
return "nullValue" in t ? 0 /* TypeOrder.NullValue */ : "booleanValue" in t ? 1 /* TypeOrder.BooleanValue */ : "integerValue" in t || "doubleValue" in t ? 2 /* TypeOrder.NumberValue */ : "timestampValue" in t ? 3 /* TypeOrder.TimestampValue */ : "stringValue" in t ? 5 /* TypeOrder.StringValue */ : "bytesValue" in t ? 6 /* TypeOrder.BlobValue */ : "referenceValue" in t ? 7 /* TypeOrder.RefValue */ : "geoPointValue" in t ? 8 /* TypeOrder.GeoPointValue */ : "arrayValue" in t ? 9 /* TypeOrder.ArrayValue */ : "mapValue" in t ? __PRIVATE_isServerTimestamp(t) ? 4 /* TypeOrder.ServerTimestampValue */ :
/** Returns true if the Value represents the canonical {@link #MAX_VALUE} . */
function __PRIVATE_isMaxValue(t) {
return "__max__" === (((t.mapValue || {}).fields || {}).__type__ || {}).stringValue;
}
/**
* @license
* Copyright 2022 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.
*/
/**
* Represents a bound of a query.
*
* The bound is specified with the given components representing a position and
* whether it's just before or just after the position (relative to whatever the
* query order is).
*
* The position represents a logical index position for a query. It's a prefix
* of values for the (potentially implicit) order by clauses of a query.
*
* Bound provides a function to determine whether a document comes before or
* after a bound. This is influenced by whether the position is just before or
* just after the provided values.
*/ (t) ? 9007199254740991 /* TypeOrder.MaxValue */ : 10 /* TypeOrder.ObjectValue */ : fail();
}
/** Tests `left` and `right` for equality based on the backend semantics. */ function __PRIVATE_valueEquals(t, e) {
if (t === e) return !0;
const r = __PRIVATE_typeOrder(t);
if (r !== __PRIVATE_typeOrder(e)) return !1;
switch (r) {
case 0 /* TypeOrder.NullValue */ :
case 9007199254740991 /* TypeOrder.MaxValue */ :
return !0;
case 1 /* TypeOrder.BooleanValue */ :
return t.booleanValue === e.booleanValue;
case 4 /* TypeOrder.ServerTimestampValue */ :
return __PRIVATE_getLocalWriteTime(t).isEqual(__PRIVATE_getLocalWriteTime(e));
case 3 /* TypeOrder.TimestampValue */ :
return function __PRIVATE_timestampEquals(t, e) {
if ("string" == typeof t.timestampValue && "string" == typeof e.timestampValue && t.timestampValue.length === e.timestampValue.length)
// Use string equality for ISO 8601 timestamps
return t.timestampValue === e.timestampValue;
const r = __PRIVATE_normalizeTimestamp(t.timestampValue), n = __PRIVATE_normalizeTimestamp(e.timestampValue);
return r.seconds === n.seconds && r.nanos === n.nanos;
}(t, e);
case 5 /* TypeOrder.StringValue */ :
return t.stringValue === e.stringValue;
case 6 /* TypeOrder.BlobValue */ :
return function __PRIVATE_blobEquals(t, e) {
return __PRIVATE_normalizeByteString(t.bytesValue).isEqual(__PRIVATE_normalizeByteString(e.bytesValue));
}(t, e);
case 7 /* TypeOrder.RefValue */ :
return t.referenceValue === e.referenceValue;
case 8 /* TypeOrder.GeoPointValue */ :
return function __PRIVATE_geoPointEquals(t, e) {
return __PRIVATE_normalizeNumber(t.geoPointValue.latitude) === __PRIVATE_normalizeNumber(e.geoPointValue.latitude) && __PRIVATE_normalizeNumber(t.geoPointValue.longitude) === __PRIVATE_normalizeNumber(e.geoPointValue.longitude);
}(t, e);
case 2 /* TypeOrder.NumberValue */ :
return function __PRIVATE_numberEquals(t, e) {
if ("integerValue" in t && "integerValue" in e) return __PRIVATE_normalizeNumber(t.integerValue) === __PRIVATE_normalizeNumber(e.integerValue);
if ("doubleValue" in t && "doubleValue" in e) {
const r = __PRIVATE_normalizeNumber(t.doubleValue), n = __PRIVATE_normalizeNumber(e.doubleValue);
return r === n ? __PRIVATE_isNegativeZero(r) === __PRIVATE_isNegativeZero(n) : isNaN(r) && isNaN(n);
}
return !1;
}(t, e);
case 9 /* TypeOrder.ArrayValue */ :
return __PRIVATE_arrayEquals(t.arrayValue.values || [], e.arrayValue.values || [], __PRIVATE_valueEquals);
case 10 /* TypeOrder.ObjectValue */ :
return function __PRIVATE_objectEquals(t, e) {
const r = t.mapValue.fields || {}, n = e.mapValue.fields || {};
if (__PRIVATE_objectSize(r) !== __PRIVATE_objectSize(n)) return !1;
for (const t in r) if (r.hasOwnProperty(t) && (void 0 === n[t] || !__PRIVATE_valueEquals(r[t], n[t]))) return !1;
return !0;
}
/** Returns true if the ArrayValue contains the specified element. */ (t, e);
default:
return fail();
}
}
function __PRIVATE_arrayValueContains(t, e) {
return void 0 !== (t.values || []).find((t => __PRIVATE_valueEquals(t, e)));
}
function __PRIVATE_valueCompare(t, e) {
if (t === e) return 0;
const r = __PRIVATE_typeOrder(t), n = __PRIVATE_typeOrder(e);
if (r !== n) return __PRIVATE_primitiveComparator(r, n);
switch (r) {
case 0 /* TypeOrder.NullValue */ :
case 9007199254740991 /* TypeOrder.MaxValue */ :
return 0;
case 1 /* TypeOrder.BooleanValue */ :
return __PRIVATE_primitiveComparator(t.booleanValue, e.booleanValue);
case 2 /* TypeOrder.NumberValue */ :
return function __PRIVATE_compareNumbers(t, e) {
const r = __PRIVATE_normalizeNumber(t.integerValue || t.doubleValue), n = __PRIVATE_normalizeNumber(e.integerValue || e.doubleValue);
return r < n ? -1 : r > n ? 1 : r === n ? 0 :
// one or both are NaN.
isNaN(r) ? isNaN(n) ? 0 : -1 : 1;
}(t, e);
case 3 /* TypeOrder.TimestampValue */ :
return __PRIVATE_compareTimestamps(t.timestampValue, e.timestampValue);
case 4 /* TypeOrder.ServerTimestampValue */ :
return __PRIVATE_compareTimestamps(__PRIVATE_getLocalWriteTime(t), __PRIVATE_getLocalWriteTime(e));
case 5 /* TypeOrder.StringValue */ :
return __PRIVATE_primitiveComparator(t.stringValue, e.stringValue);
case 6 /* TypeOrder.BlobValue */ :
return function __PRIVATE_compareBlobs(t, e) {
const r = __PRIVATE_normalizeByteString(t), n = __PRIVATE_normalizeByteString(e);
return r.compareTo(n);
}(t.bytesValue, e.bytesValue);
case 7 /* TypeOrder.RefValue */ :
return function __PRIVATE_compareReferences(t, e) {
const r = t.split("/"), n = e.split("/");
for (let t = 0; t < r.length && t < n.length; t++) {
const e = __PRIVATE_primitiveComparator(r[t], n[t]);
if (0 !== e) return e;
}
return __PRIVATE_primitiveComparator(r.length, n.length);
}(t.referenceValue, e.referenceValue);
case 8 /* TypeOrder.GeoPointValue */ :
return function __PRIVATE_compareGeoPoints(t, e) {
const r = __PRIVATE_primitiveComparator(__PRIVATE_normalizeNumber(t.latitude), __PRIVATE_normalizeNumber(e.latitude));
if (0 !== r) return r;
return __PRIVATE_primitiveComparator(__PRIVATE_normalizeNumber(t.longitude), __PRIVATE_normalizeNumber(e.longitude));
}(t.geoPointValue, e.geoPointValue);
case 9 /* TypeOrder.ArrayValue */ :
return function __PRIVATE_compareArrays(t, e) {
const r = t.values || [], n = e.values || [];
for (let t = 0; t < r.length && t < n.length; ++t) {
const e = __PRIVATE_valueCompare(r[t], n[t]);
if (e) return e;
}
return __PRIVATE_primitiveComparator(r.length, n.length);
}(t.arrayValue, e.arrayValue);
case 10 /* TypeOrder.ObjectValue */ :
return function __PRIVATE_compareMaps(t, e) {
if (t === Q && e === Q) return 0;
if (t === Q) return 1;
if (e === Q) return -1;
const r = t.fields || {}, n = Object.keys(r), i = e.fields || {}, s = Object.keys(i);
// Even though MapValues are likely sorted correctly based on their insertion
// order (e.g. when received from the backend), local modifications can bring
// elements out of order. We need to re-sort the elements to ensure that
// canonical IDs are independent of insertion order.
n.sort(), s.sort();
for (let t = 0; t < n.length && t < s.length; ++t) {
const e = __PRIVATE_primitiveComparator(n[t], s[t]);
if (0 !== e) return e;
const o = __PRIVATE_valueCompare(r[n[t]], i[s[t]]);
if (0 !== o) return o;
}
return __PRIVATE_primitiveComparator(n.length, s.length);
}
/** Returns a reference value for the provided database and key. */ (t.mapValue, e.mapValue);
default:
throw fail();
}
}
function __PRIVATE_compareTimestamps(t, e) {
if ("string" == typeof t && "string" == typeof e && t.length === e.length) return __PRIVATE_primitiveComparator(t, e);
const r = __PRIVATE_normalizeTimestamp(t), n = __PRIVATE_normalizeTimestamp(e), i = __PRIVATE_primitiveComparator(r.seconds, n.seconds);
return 0 !== i ? i : __PRIVATE_primitiveComparator(r.nanos, n.nanos);
}
function __PRIVATE_refValue(t, e) {
return {
referenceValue: `projects/${t.projectId}/databases/${t.database}/documents/${e.path.canonicalString()}`
};
}
/** Returns true if `value` is an ArrayValue. */ function isArray(t) {
return !!t && "arrayValue" in t;
}
/** Returns true if `value` is a NullValue. */ function __PRIVATE_isNullValue(t) {
return !!t && "nullValue" in t;
}
/** Returns true if `value` is NaN. */ function __PRIVATE_isNanValue(t) {
return !!t && "doubleValue" in t && isNaN(Number(t.doubleValue));
}
/** Returns true if `value` is a MapValue. */ function __PRIVATE_isMapValue(t) {
return !!t && "mapValue" in t;
}
/** Creates a deep copy of `source`. */ function __PRIVATE_deepClone(t) {
if (t.geoPointValue) return {
geoPointValue: Object.assign({}, t.geoPointValue)
};
if (t.timestampValue && "object" == typeof t.timestampValue) return {
timestampValue: Object.assign({}, t.timestampValue)
};
if (t.mapValue) {
const e = {
mapValue: {
fields: {}
}
};
return forEach(t.mapValue.fields, ((t, r) => e.mapValue.fields[t] = __PRIVATE_deepClone(r))),
e;
}
if (t.arrayValue) {
const e = {
arrayValue: {
values: []
}
};
for (let r = 0; r < (t.arrayValue.values || []).length; ++r) e.arrayValue.values[r] = __PRIVATE_deepClone(t.arrayValue.values[r]);
return e;
}
return Object.assign({}, t);
}
class Bound {
constructor(t, e) {
this.position = t, this.inclusive = e;
}
}
function __PRIVATE_boundEquals(t, e) {
if (null === t) return null === e;
if (null === e) return !1;
if (t.inclusive !== e.inclusive || t.position.length !== e.position.length) return !1;
for (let r = 0; r < t.position.length; r++) {
if (!__PRIVATE_valueEquals(t.position[r], e.position[r])) return !1;
}
return !0;
}
/**
* @license
* Copyright 2022 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 Filter {}
class FieldFilter extends Filter {
constructor(t, e, r) {
super(), this.field = t, this.op = e, this.value = r;
}
/**
* Creates a filter based on the provided arguments.
*/ static create(t, e, r) {
return t.isKeyField() ? "in" /* Operator.IN */ === e || "not-in" /* Operator.NOT_IN */ === e ? this.createKeyFieldInFilter(t, e, r) : new __PRIVATE_KeyFieldFilter(t, e, r) : "array-contains" /* Operator.ARRAY_CONTAINS */ === e ? new __PRIVATE_ArrayContainsFilter(t, r) : "in" /* Operator.IN */ === e ? new __PRIVATE_InFilter(t, r) : "not-in" /* Operator.NOT_IN */ === e ? new __PRIVATE_NotInFilter(t, r) : "array-contains-any" /* Operator.ARRAY_CONTAINS_ANY */ === e ? new __PRIVATE_ArrayContainsAnyFilter(t, r) : new FieldFilter(t, e, r);
}
static createKeyFieldInFilter(t, e, r) {
return "in" /* Operator.IN */ === e ? new __PRIVATE_KeyFieldInFilter(t, r) : new __PRIVATE_KeyFieldNotInFilter(t, r);
}
matches(t) {
const e = t.data.field(this.field);
// Types do not have to match in NOT_EQUAL filters.
return "!=" /* Operator.NOT_EQUAL */ === this.op ? null !== e && this.matchesComparison(__PRIVATE_valueCompare(e, this.value)) : null !== e && __PRIVATE_typeOrder(this.value) === __PRIVATE_typeOrder(e) && this.matchesComparison(__PRIVATE_valueCompare(e, this.value));
// Only compare types with matching backend order (such as double and int).
}
matchesComparison(t) {
switch (this.op) {
case "<" /* Operator.LESS_THAN */ :
return t < 0;
case "<=" /* Operator.LESS_THAN_OR_EQUAL */ :
return t <= 0;
case "==" /* Operator.EQUAL */ :
return 0 === t;
case "!=" /* Operator.NOT_EQUAL */ :
return 0 !== t;
case ">" /* Operator.GREATER_THAN */ :
return t > 0;
case ">=" /* Operator.GREATER_THAN_OR_EQUAL */ :
return t >= 0;
default:
return fail();
}
}
isInequality() {
return [ "<" /* Operator.LESS_THAN */ , "<=" /* Operator.LESS_THAN_OR_EQUAL */ , ">" /* Operator.GREATER_THAN */ , ">=" /* Operator.GREATER_THAN_OR_EQUAL */ , "!=" /* Operator.NOT_EQUAL */ , "not-in" /* Operator.NOT_IN */ ].indexOf(this.op) >= 0;
}
getFlattenedFilters() {
return [ this ];
}
getFilters() {
return [ this ];
}
}
class CompositeFilter extends Filter {
constructor(t, e) {
super(), this.filters = t, this.op = e, this.D = null;
}
/**
* Creates a filter based on the provided arguments.
*/ static create(t, e) {
return new CompositeFilter(t, e);
}
matches(t) {
return function __PRIVATE_compositeFilterIsConjunction(t) {
return "and" /* CompositeOperator.AND */ === t.op;
}(this) ? void 0 === this.filters.find((e => !e.matches(t))) : void 0 !== this.filters.find((e => e.matches(t)));
}
getFlattenedFilters() {
return null !== this.D || (this.D = this.filters.reduce(((t, e) => t.concat(e.getFlattenedFilters())), [])),
this.D;
}
// Returns a mutable copy of `this.filters`
getFilters() {
return Object.assign([], this.filters);
}
}
function __PRIVATE_filterEquals(t, e) {
return t instanceof FieldFilter ? function __PRIVATE_fieldFilterEquals(t, e) {
return e instanceof FieldFilter && t.op === e.op && t.field.isEqual(e.field) && __PRIVATE_valueEquals(t.value, e.value);
}(t, e) : t instanceof CompositeFilter ? function __PRIVATE_compositeFilterEquals(t, e) {
if (e instanceof CompositeFilter && t.op === e.op && t.filters.length === e.filters.length) {
return t.filters.reduce(((t, r, n) => t && __PRIVATE_filterEquals(r, e.filters[n])), !0);
}
return !1;
}
/** Filter that matches on key fields (i.e. '__name__'). */ (t, e) : void fail();
}
class __PRIVATE_KeyFieldFilter extends FieldFilter {
constructor(t, e, r) {
super(t, e, r), this.key = DocumentKey.fromName(r.referenceValue);
}
matches(t) {
const e = DocumentKey.comparator(t.key, this.key);
return this.matchesComparison(e);
}
}
/** Filter that matches on key fields within an array. */ class __PRIVATE_KeyFieldInFilter extends FieldFilter {
constructor(t, e) {
super(t, "in" /* Operator.IN */ , e), this.keys = __PRIVATE_extractDocumentKeysFromArrayValue("in" /* Operator.IN */ , e);
}
matches(t) {
return this.keys.some((e => e.isEqual(t.key)));
}
}
/** Filter that matches on key fields not present within an array. */ class __PRIVATE_KeyFieldNotInFilter extends FieldFilter {
constructor(t, e) {
super(t, "not-in" /* Operator.NOT_IN */ , e), this.keys = __PRIVATE_extractDocumentKeysFromArrayValue("not-in" /* Operator.NOT_IN */ , e);
}
matches(t) {
return !this.keys.some((e => e.isEqual(t.key)));
}
}
function __PRIVATE_extractDocumentKeysFromArrayValue(t, e) {
var r;
return ((null === (r = e.arrayValue) || void 0 === r ? void 0 : r.values) || []).map((t => DocumentKey.fromName(t.referenceValue)));
}
/** A Filter that implements the array-contains operator. */ class __PRIVATE_ArrayContainsFilter extends FieldFilter {
constructor(t, e) {
super(t, "array-contains" /* Operator.ARRAY_CONTAINS */ , e);
}
matches(t) {
const e = t.data.field(this.field);
return isArray(e) && __PRIVATE_arrayValueContains(e.arrayValue, this.value);
}
}
/** A Filter that implements the IN operator. */ class __PRIVATE_InFilter extends FieldFilter {
constructor(t, e) {
super(t, "in" /* Operator.IN */ , e);
}
matches(t) {
const e = t.data.field(this.field);
return null !== e && __PRIVATE_arrayValueContains(this.value.arrayValue, e);
}
}
/** A Filter that implements the not-in operator. */ class __PRIVATE_NotInFilter extends FieldFilter {
constructor(t, e) {
super(t, "not-in" /* Operator.NOT_IN */ , e);
}
matches(t) {
if (__PRIVATE_arrayValueContains(this.value.arrayValue, {
nullValue: "NULL_VALUE"
})) return !1;
const e = t.data.field(this.field);
return null !== e && !__PRIVATE_arrayValueContains(this.value.arrayValue, e);
}
}
/** A Filter that implements the array-contains-any operator. */ class __PRIVATE_ArrayContainsAnyFilter extends FieldFilter {
constructor(t, e) {
super(t, "array-contains-any" /* Operator.ARRAY_CONTAINS_ANY */ , e);
}
matches(t) {
const e = t.data.field(this.field);
return !(!isArray(e) || !e.arrayValue.values) && e.arrayValue.values.some((t => __PRIVATE_arrayValueContains(this.value.arrayValue, t)));
}
}
/**
* @license
* Copyright 2022 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.
*/
/**
* An ordering on a field, in some Direction. Direction defaults to ASCENDING.
*/ class OrderBy {
constructor(t, e = "asc" /* Direction.ASCENDING */) {
this.field = t, this.dir = e;
}
}
function __PRIVATE_orderByEquals(t, e) {
return t.dir === e.dir && t.field.isEqual(e.field);
}
/**
* @license
* Copyright 2017 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.
*/
/**
* A version of a document in Firestore. This corresponds to the version
* timestamp, such as update_time or read_time.
*/ class SnapshotVersion {
constructor(t) {
this.timestamp = t;
}
static fromTimestamp(t) {
return new SnapshotVersion(t);
}
static min() {
return new SnapshotVersion(new Timestamp(0, 0));
}
static max() {
return new SnapshotVersion(new Timestamp(253402300799, 999999999));
}
compareTo(t) {
return this.timestamp._compareTo(t.timestamp);
}
isEqual(t) {
return this.timestamp.isEqual(t.timestamp);
}
/** Returns a number representation of the version for use in spec tests. */ toMicroseconds() {
// Convert to microseconds.
return 1e6 * this.timestamp.seconds + this.timestamp.nanoseconds / 1e3;
}
toString() {
return "SnapshotVersion(" + this.timestamp.toString() + ")";
}
toTimestamp() {
return this.timestamp;
}
}
/**
* @license
* Copyright 2017 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.
*/
// An immutable sorted map implementation, based on a Left-leaning Red-Black
// tree.
class SortedMap {
constructor(t, e) {
this.comparator = t, this.root = e || LLRBNode.EMPTY;
}
// Returns a copy of the map, with the specified key/value added or replaced.
insert(t, e) {
return new SortedMap(this.comparator, this.root.insert(t, e, this.comparator).copy(null, null, LLRBNode.BLACK, null, null));
}
// Returns a copy of the map, with the specified key removed.
remove(t) {
return new SortedMap(this.comparator, this.root.remove(t, this.comparator).copy(null, null, LLRBNode.BLACK, null, null));
}
// Returns the value of the node with the given key, or null.
get(t) {
let e = this.root;
for (;!e.isEmpty(); ) {
const r = this.comparator(t, e.key);
if (0 === r) return e.value;
r < 0 ? e = e.left : r > 0 && (e = e.right);
}
return null;
}
// Returns the index of the element in this sorted map, or -1 if it doesn't
// exist.
indexOf(t) {
// Number of nodes that were pruned when descending right
let e = 0, r = this.root;
for (;!r.isEmpty(); ) {
const n = this.comparator(t, r.key);
if (0 === n) return e + r.left.size;
n < 0 ? r = r.left : (
// Count all nodes left of the node plus the node itself
e += r.left.size + 1, r = r.right);
}
// Node not found
return -1;
}
isEmpty() {
return this.root.isEmpty();
}
// Returns the total number of nodes in the map.
get size() {
return this.root.size;
}
// Returns the minimum key in the map.
minKey() {
return this.root.minKey();
}
// Returns the maximum key in the map.
maxKey() {
return this.root.maxKey();
}
// Traverses the map in key order and calls the specified action function
// for each key/value pair. If action returns true, traversal is aborted.
// Returns the first truthy value returned by action, or the last falsey
// value returned by action.
inorderTraversal(t) {
return this.root.inorderTraversal(t);
}
forEach(t) {
this.inorderTraversal(((e, r) => (t(e, r), !1)));
}
toString() {
const t = [];
return this.inorderTraversal(((e, r) => (t.push(`${e}:${r}`), !1))), `{${t.join(", ")}}`;
}
// Traverses the map in reverse key order and calls the specified action
// function for each key/value pair. If action returns true, traversal is
// aborted.
// Returns the first truthy value returned by action, or the last falsey
// value returned by action.
reverseTraversal(t) {
return this.root.reverseTraversal(t);
}
// Returns an iterator over the SortedMap.
getIterator() {
return new SortedMapIterator(this.root, null, this.comparator, !1);
}
getIteratorFrom(t) {
return new SortedMapIterator(this.root, t, this.comparator, !1);
}
getReverseIterator() {
return new SortedMapIterator(this.root, null, this.comparator, !0);
}
getReverseIteratorFrom(t) {
return new SortedMapIterator(this.root, t, this.comparator, !0);
}
}
// end SortedMap
// An iterator over an LLRBNode.
class SortedMapIterator {
constructor(t, e, r, n) {
this.isReverse = n, this.nodeStack = [];
let i = 1;
for (;!t.isEmpty(); ) if (i = e ? r(t.key, e) : 1,
// flip the comparison if we're going in reverse
e && n && (i *= -1), i < 0)
// This node is less than our start key. ignore it
t = this.isReverse ? t.left : t.right; else {
if (0 === i) {
// This node is exactly equal to our start key. Push it on the stack,
// but stop iterating;
this.nodeStack.push(t);
break;
}
// This node is greater than our start key, add it to the stack and move
// to the next one
this.nodeStack.push(t), t = this.isReverse ? t.right : t.left;
}
}
getNext() {
let t = this.nodeStack.pop();
const e = {
key: t.key,
value: t.value
};
if (this.isReverse) for (t = t.left; !t.isEmpty(); ) this.nodeStack.push(t), t = t.right; else for (t = t.right; !t.isEmpty(); ) this.nodeStack.push(t),
t = t.left;
return e;
}
hasNext() {
return this.nodeStack.length > 0;
}
peek() {
if (0 === this.nodeStack.length) return null;
const t = this.nodeStack[this.nodeStack.length - 1];
return {
key: t.key,
value: t.value
};
}
}
// end SortedMapIterator
// Represents a node in a Left-leaning Red-Black tree.
class LLRBNode {
constructor(t, e, r, n, i) {
this.key = t, this.value = e, this.color = null != r ? r : LLRBNode.RED, this.left = null != n ? n : LLRBNode.EMPTY,
this.right = null != i ? i : LLRBNode.EMPTY, this.size = this.left.size + 1 + this.right.size;
}
// Returns a copy of the current node, optionally replacing pieces of it.
copy(t, e, r, n, i) {
return new LLRBNode(null != t ? t : this.key, null != e ? e : this.value, null != r ? r : this.color, null != n ? n : this.left, null != i ? i : this.right);
}
isEmpty() {
return !1;
}
// Traverses the tree in key order and calls the specified action function
// for each node. If action returns true, traversal is aborted.
// Returns the first truthy value returned by action, or the last falsey
// value returned by action.
inorderTraversal(t) {
return this.left.inorderTraversal(t) || t(this.key, this.value) || this.right.inorderTraversal(t);
}
// Traverses the tree in reverse key order and calls the specified action
// function for each node. If action returns true, traversal is aborted.
// Returns the first truthy value returned by action, or the last falsey
// value returned by action.
reverseTraversal(t) {
return this.right.reverseTraversal(t) || t(this.key, this.value) || this.left.reverseTraversal(t);
}
// Returns the minimum node in the tree.
min() {
return this.left.isEmpty() ? this : this.left.min();
}
// Returns the maximum key in the tree.
minKey() {
return this.min().key;
}
// Returns the maximum key in the tree.
maxKey() {
return this.right.isEmpty() ? this.key : this.right.maxKey();
}
// Returns new tree, with the key/value added.
insert(t, e, r) {
let n = this;
const i = r(t, n.key);
return n = i < 0 ? n.copy(null, null, null, n.left.insert(t, e, r), null) : 0 === i ? n.copy(null, e, null, null, null) : n.copy(null, null, null, null, n.right.insert(t, e, r)),
n.fixUp();
}
removeMin() {
if (this.left.isEmpty()) return LLRBNode.EMPTY;
let t = this;
return t.left.isRed() || t.left.left.isRed() || (t = t.moveRedLeft()), t = t.copy(null, null, null, t.left.removeMin(), null),
t.fixUp();
}
// Returns new tree, with the specified item removed.
remove(t, e) {
let r, n = this;
if (e(t, n.key) < 0) n.left.isEmpty() || n.left.isRed() || n.left.left.isRed() || (n = n.moveRedLeft()),
n = n.copy(null, null, null, n.left.remove(t, e), null); else {
if (n.left.isRed() && (n = n.rotateRight()), n.right.isEmpty() || n.right.isRed() || n.right.left.isRed() || (n = n.moveRedRight()),
0 === e(t, n.key)) {
if (n.right.isEmpty()) return LLRBNode.EMPTY;
r = n.right.min(), n = n.copy(r.key, r.value, null, null, n.right.removeMin());
}
n = n.copy(null, null, null, null, n.right.remove(t, e));
}
return n.fixUp();
}
isRed() {
return this.color;
}
// Returns new tree after performing any needed rotations.
fixUp() {
let t = this;
return t.right.isRed() && !t.left.isRed() && (t = t.rotateLeft()), t.left.isRed() && t.left.left.isRed() && (t = t.rotateRight()),
t.left.isRed() && t.right.isRed() && (t = t.colorFlip()), t;
}
moveRedLeft() {
let t = this.colorFlip();
return t.right.left.isRed() && (t = t.copy(null, null, null, null, t.right.rotateRight()),
t = t.rotateLeft(), t = t.colorFlip()), t;
}
moveRedRight() {
let t = this.colorFlip();
return t.left.left.isRed() && (t = t.rotateRight(), t = t.colorFlip()), t;
}
rotateLeft() {
const t = this.copy(null, null, LLRBNode.RED, null, this.right.left);
return this.right.copy(null, null, this.color, t, null);
}
rotateRight() {
const t = this.copy(null, null, LLRBNode.RED, this.left.right, null);
return this.left.copy(null, null, this.color, null, t);
}
colorFlip() {
const t = this.left.copy(null, null, !this.left.color, null, null), e = this.right.copy(null, null, !this.right.color, null, null);
return this.copy(null, null, !this.color, t, e);
}
// For testing.
checkMaxDepth() {
const t = this.check();
return Math.pow(2, t) <= this.size + 1;
}
// In a balanced RB tree, the black-depth (number of black nodes) from root to
// leaves is equal on both sides. This function verifies that or asserts.
check() {
if (this.isRed() && this.left.isRed()) throw fail();
if (this.right.isRed()) throw fail();
const t = this.left.check();
if (t !== this.right.check()) throw fail();
return t + (this.isRed() ? 0 : 1);
}
}
// end LLRBNode
// Empty node is shared between all LLRB trees.
// eslint-disable-next-line @typescript-eslint/no-explicit-any
LLRBNode.EMPTY = null, LLRBNode.RED = !0, LLRBNode.BLACK = !1;
// end LLRBEmptyNode
LLRBNode.EMPTY = new
// Represents an empty node (a leaf node in the Red-Black Tree).
class LLRBEmptyNode {
constructor() {
this.size = 0;
}
get key() {
throw fail();
}
get value() {
throw fail();
}
get color() {
throw fail();
}
get left() {
throw fail();
}
get right() {
throw fail();
}
// Returns a copy of the current node.
copy(t, e, r, n, i) {
return this;
}
// Returns a copy of the tree, with the specified key/value added.
insert(t, e, r) {
return new LLRBNode(t, e);
}
// Returns a copy of the tree, with the specified key removed.
remove(t, e) {
return this;
}
isEmpty() {
return !0;
}
inorderTraversal(t) {
return !1;
}
reverseTraversal(t) {
return !1;
}
minKey() {
return null;
}
maxKey() {
return null;
}
isRed() {
return !1;
}
// For testing.
checkMaxDepth() {
return !0;
}
check() {
return 0;
}
};
/**
* @license
* Copyright 2017 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.
*/
/**
* SortedSet is an immutable (copy-on-write) collection that holds elements
* in order specified by the provided comparator.
*
* NOTE: if provided comparator returns 0 for two elements, we consider them to
* be equal!
*/
class SortedSet {
constructor(t) {
this.comparator = t, this.data = new SortedMap(this.comparator);
}
has(t) {
return null !== this.data.get(t);
}
first() {
return this.data.minKey();
}
last() {
return this.data.maxKey();
}
get size() {
return this.data.size;
}
indexOf(t) {
return this.data.indexOf(t);
}
/** Iterates elements in order defined by "comparator" */ forEach(t) {
this.data.inorderTraversal(((e, r) => (t(e), !1)));
}
/** Iterates over `elem`s such that: range[0] <= elem < range[1]. */ forEachInRange(t, e) {
const r = this.data.getIteratorFrom(t[0]);
for (;r.hasNext(); ) {
const n = r.getNext();
if (this.comparator(n.key, t[1]) >= 0) return;
e(n.key);
}
}
/**
* Iterates over `elem`s such that: start <= elem until false is returned.
*/ forEachWhile(t, e) {
let r;
for (r = void 0 !== e ? this.data.getIteratorFrom(e) : this.data.getIterator(); r.hasNext(); ) {
if (!t(r.getNext().key)) return;
}
}
/** Finds the least element greater than or equal to `elem`. */ firstAfterOrEqual(t) {
const e = this.data.getIteratorFrom(t);
return e.hasNext() ? e.getNext().key : null;
}
getIterator() {
return new SortedSetIterator(this.data.getIterator());
}
getIteratorFrom(t) {
return new SortedSetIterator(this.data.getIteratorFrom(t));
}
/** Inserts or updates an element */ add(t) {
return this.copy(this.data.remove(t).insert(t, !0));
}
/** Deletes an element */ delete(t) {
return this.has(t) ? this.copy(this.data.remove(t)) : this;
}
isEmpty() {
return this.data.isEmpty();
}
unionWith(t) {
let e = this;
// Make sure `result` always refers to the larger one of the two sets.
return e.size < t.size && (e = t, t = this), t.forEach((t => {
e = e.add(t);
})), e;
}
isEqual(t) {
if (!(t instanceof SortedSet)) return !1;
if (this.size !== t.size) return !1;
const e = this.data.getIterator(), r = t.data.getIterator();
for (;e.hasNext(); ) {
const t = e.getNext().key, n = r.getNext().key;
if (0 !== this.comparator(t, n)) return !1;
}
return !0;
}
toArray() {
const t = [];
return this.forEach((e => {
t.push(e);
})), t;
}
toString() {
const t = [];
return this.forEach((e => t.push(e))), "SortedSet(" + t.toString() + ")";
}
copy(t) {
const e = new SortedSet(this.comparator);
return e.data = t, e;
}
}
class SortedSetIterator {
constructor(t) {
this.iter = t;
}
getNext() {
return this.iter.getNext().key;
}
hasNext() {
return this.iter.hasNext();
}
}
/**
* @license
* Copyright 2020 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.
*/
/**
* Provides a set of fields that can be used to partially patch a document.
* FieldMask is used in conjunction with ObjectValue.
* Examples:
* foo - Overwrites foo entirely with the provided value. If foo is not
* present in the companion ObjectValue, the field is deleted.
* foo.bar - Overwrites only the field bar of the object foo.
* If foo is not an object, foo is replaced with an object
* containing foo
*/ class FieldMask {
constructor(t) {
this.fields = t,
// TODO(dimond): validation of FieldMask
// Sort the field mask to support `FieldMask.isEqual()` and assert below.
t.sort(FieldPath$1.comparator);
}
static empty() {
return new FieldMask([]);
}
/**
* Returns a new FieldMask object that is the result of adding all the given
* fields paths to this field mask.
*/ unionWith(t) {
let e = new SortedSet(FieldPath$1.comparator);
for (const t of this.fields) e = e.add(t);
for (const r of t) e = e.add(r);
return new FieldMask(e.toArray());
}
/**
* Verifies that `fieldPath` is included by at least one field in this field
* mask.
*
* This is an O(n) operation, where `n` is the size of the field mask.
*/ covers(t) {
for (const e of this.fields) if (e.isPrefixOf(t)) return !0;
return !1;
}
isEqual(t) {
return __PRIVATE_arrayEquals(this.fields, t.fields, ((t, e) => t.isEqual(e)));
}
}
/**
* @license
* Copyright 2017 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.
*/
/**
* An ObjectValue represents a MapValue in the Firestore Proto and offers the
* ability to add and remove fields (via the ObjectValueBuilder).
*/ class ObjectValue {
constructor(t) {
this.value = t;
}
static empty() {
return new ObjectValue({
mapValue: {}
});
}
/**
* Returns the value at the given path or null.
*
* @param path - the path to search
* @returns The value at the path or null if the path is not set.
*/ field(t) {
if (t.isEmpty()) return this.value;
{
let e = this.value;
for (let r = 0; r < t.length - 1; ++r) if (e = (e.mapValue.fields || {})[t.get(r)],
!__PRIVATE_isMapValue(e)) return null;
return e = (e.mapValue.fields || {})[t.lastSegment()], e || null;
}
}
/**
* Sets the field to the provided value.
*
* @param path - The field path to set.
* @param value - The value to set.
*/ set(t, e) {
this.getFieldsMap(t.popLast())[t.lastSegment()] = __PRIVATE_deepClone(e);
}
/**
* Sets the provided fields to the provided values.
*
* @param data - A map of fields to values (or null for deletes).
*/ setAll(t) {
let e = FieldPath$1.emptyPath(), r = {}, n = [];
t.forEach(((t, i) => {
if (!e.isImmediateParentOf(i)) {
// Insert the accumulated changes at this parent location
const t = this.getFieldsMap(e);
this.applyChanges(t, r, n), r = {}, n = [], e = i.popLast();
}
t ? r[i.lastSegment()] = __PRIVATE_deepClone(t) : n.push(i.lastSegment());
}));
const i = this.getFieldsMap(e);
this.applyChanges(i, r, n);
}
/**
* Removes the field at the specified path. If there is no field at the
* specified path, nothing is changed.
*
* @param path - The field path to remove.
*/ delete(t) {
const e = this.field(t.popLast());
__PRIVATE_isMapValue(e) && e.mapValue.fields && delete e.mapValue.fields[t.lastSegment()];
}
isEqual(t) {
return __PRIVATE_valueEquals(this.value, t.value);
}
/**
* Returns the map that contains the leaf element of `path`. If the parent
* entry does not yet exist, or if it is not a map, a new map will be created.
*/ getFieldsMap(t) {
let e = this.value;
e.mapValue.fields || (e.mapValue = {
fields: {}
});
for (let r = 0; r < t.length; ++r) {
let n = e.mapValue.fields[t.get(r)];
__PRIVATE_isMapValue(n) && n.mapValue.fields || (n = {
mapValue: {
fields: {}
}
}, e.mapValue.fields[t.get(r)] = n), e = n;
}
return e.mapValue.fields;
}
/**
* Modifies `fieldsMap` by adding, replacing or deleting the specified
* entries.
*/ applyChanges(t, e, r) {
forEach(e, ((e, r) => t[e] = r));
for (const e of r) delete t[e];
}
clone() {
return new ObjectValue(__PRIVATE_deepClone(this.value));
}
}
/**
* @license
* Copyright 2017 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.
*/
/**
* Represents a document in Firestore with a key, version, data and whether it
* has local mutations applied to it.
*
* Documents can transition between states via `convertToFoundDocument()`,
* `convertToNoDocument()` and `convertToUnknownDocument()`. If a document does
* not transition to one of these states even after all mutations have been
* applied, `isValidDocument()` returns false and the document should be removed
* from all views.
*/ class MutableDocument {
constructor(t, e, r, n, i, s, o) {
this.key = t, this.documentType = e, this.version = r, this.readTime = n, this.createTime = i,
this.data = s, this.documentState = o;
}
/**
* Creates a document with no known version or data, but which can serve as
* base document for mutations.
*/ static newInvalidDocument(t) {
return new MutableDocument(t, 0 /* DocumentType.INVALID */ ,
/* version */ SnapshotVersion.min(),
/* readTime */ SnapshotVersion.min(),
/* createTime */ SnapshotVersion.min(), ObjectValue.empty(), 0 /* DocumentState.SYNCED */);
}
/**
* Creates a new document that is known to exist with the given data at the
* given version.
*/ static newFoundDocument(t, e, r, n) {
return new MutableDocument(t, 1 /* DocumentType.FOUND_DOCUMENT */ ,
/* version */ e,
/* readTime */ SnapshotVersion.min(),
/* createTime */ r, n, 0 /* DocumentState.SYNCED */);
}
/** Creates a new document that is known to not exist at the given version. */ static newNoDocument(t, e) {
return new MutableDocument(t, 2 /* DocumentType.NO_DOCUMENT */ ,
/* version */ e,
/* readTime */ SnapshotVersion.min(),
/* createTime */ SnapshotVersion.min(), ObjectValue.empty(), 0 /* DocumentState.SYNCED */);
}
/**
* Creates a new document that is known to exist at the given version but
* whose data is not known (e.g. a document that was updated without a known
* base document).
*/ static newUnknownDocument(t, e) {
return new MutableDocument(t, 3 /* DocumentType.UNKNOWN_DOCUMENT */ ,
/* version */ e,
/* readTime */ SnapshotVersion.min(),
/* createTime */ SnapshotVersion.min(), ObjectValue.empty(), 2 /* DocumentState.HAS_COMMITTED_MUTATIONS */);
}
/**
* Changes the document type to indicate that it exists and that its version
* and data are known.
*/ convertToFoundDocument(t, e) {
// If a document is switching state from being an invalid or deleted
// document to a valid (FOUND_DOCUMENT) document, either due to receiving an
// update from Watch or due to applying a local set mutation on top
// of a deleted document, our best guess about its createTime would be the
// version at which the document transitioned to a FOUND_DOCUMENT.
return !this.createTime.isEqual(SnapshotVersion.min()) || 2 /* DocumentType.NO_DOCUMENT */ !== this.documentType && 0 /* DocumentType.INVALID */ !== this.documentType || (this.createTime = t),
this.version = t, this.documentType = 1 /* DocumentType.FOUND_DOCUMENT */ , this.data = e,
this.documentState = 0 /* DocumentState.SYNCED */ , this;
}
/**
* Changes the document type to indicate that it doesn't exist at the given
* version.
*/ convertToNoDocument(t) {
return this.version = t, this.documentType = 2 /* DocumentType.NO_DOCUMENT */ ,
this.data = ObjectValue.empty(), this.documentState = 0 /* DocumentState.SYNCED */ ,
this;
}
/**
* Changes the document type to indicate that it exists at a given version but
* that its data is not known (e.g. a document that was updated without a known
* base document).
*/ convertToUnknownDocument(t) {
return this.version = t, this.documentType = 3 /* DocumentType.UNKNOWN_DOCUMENT */ ,
this.data = ObjectValue.empty(), this.documentState = 2 /* DocumentState.HAS_COMMITTED_MUTATIONS */ ,
this;
}
setHasCommittedMutations() {
return this.documentState = 2 /* DocumentState.HAS_COMMITTED_MUTATIONS */ , this;
}
setHasLocalMutations() {
return this.documentState = 1 /* DocumentState.HAS_LOCAL_MUTATIONS */ , this.version = SnapshotVersion.min(),
this;
}
setReadTime(t) {
return this.readTime = t, this;
}
get hasLocalMutations() {
return 1 /* DocumentState.HAS_LOCAL_MUTATIONS */ === this.documentState;
}
get hasCommittedMutations() {
return 2 /* DocumentState.HAS_COMMITTED_MUTATIONS */ === this.documentState;
}
get hasPendingWrites() {
return this.hasLocalMutations || this.hasCommittedMutations;
}
isValidDocument() {
return 0 /* DocumentType.INVALID */ !== this.documentType;
}
isFoundDocument() {
return 1 /* DocumentType.FOUND_DOCUMENT */ === this.documentType;
}
isNoDocument() {
return 2 /* DocumentType.NO_DOCUMENT */ === this.documentType;
}
isUnknownDocument() {
return 3 /* DocumentType.UNKNOWN_DOCUMENT */ === this.documentType;
}
isEqual(t) {
return t instanceof MutableDocument && this.key.isEqual(t.key) && this.version.isEqual(t.version) && this.documentType === t.documentType && this.documentState === t.documentState && this.data.isEqual(t.data);
}
mutableCopy() {
return new MutableDocument(this.key, this.documentType, this.version, this.readTime, this.createTime, this.data.clone(), this.documentState);
}
toString() {
return `Document(${this.key}, ${this.version}, ${JSON.stringify(this.data.value)}, {createTime: ${this.createTime}}), {documentType: ${this.documentType}}), {documentState: ${this.documentState}})`;
}
}
/**
* @license
* Copyright 2019 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.
*/
// Visible for testing
class __PRIVATE_TargetImpl {
constructor(t, e = null, r = [], n = [], i = null, s = null, o = null) {
this.path = t, this.collectionGroup = e, this.orderBy = r, this.filters = n, this.limit = i,
this.startAt = s, this.endAt = o, this.C = null;
}
}
/**
* Initializes a Target with a path and optional additional query constraints.
* Path must currently be empty if this is a collection group query.
*
* NOTE: you should always construct `Target` from `Query.toTarget` instead of
* using this factory method, because `Query` provides an implicit `orderBy`
* property.
*/ function __PRIVATE_newTarget(t, e = null, r = [], n = [], i = null, s = null, o = null) {
return new __PRIVATE_TargetImpl(t, e, r, n, i, s, o);
}
/**
* @license
* Copyright 2017 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.
*/
/**
* Query encapsulates all the query attributes we support in the SDK. It can
* be run against the LocalStore, as well as be converted to a `Target` to
* query the RemoteStore results.
*
* Visible for testing.
*/
class __PRIVATE_QueryImpl {
/**
* Initializes a Query with a path and optional additional query constraints.
* Path must currently be empty if this is a collection group query.
*/
constructor(t, e = null, r = [], n = [], i = null, s = "F" /* LimitType.First */ , o = null, a = null) {
this.path = t, this.collectionGroup = e, this.explicitOrderBy = r, this.filters = n,
this.limit = i, this.limitType = s, this.startAt = o, this.endAt = a, this.S = null,
// The corresponding `Target` of this `Query` instance, for use with
// non-aggregate queries.
this.N = null,
// The corresponding `Target` of this `Query` instance, for use with
// aggregate queries. Unlike targets for non-aggregate queries,
// aggregate query targets do not contain normalized order-bys, they only
// contain explicit order-bys.
this.O = null, this.startAt, this.endAt;
}
}
/** Creates a new Query for a query that matches all documents at `path` */
/**
* Returns whether the query matches a collection group rather than a specific
* collection.
*/
function __PRIVATE_isCollectionGroupQuery(t) {
return null !== t.collectionGroup;
}
/**
* Returns the normalized order-by constraint that is used to execute the Query,
* which can be different from the order-by constraints the user provided (e.g.
* the SDK and backend always orders by `__name__`). The normalized order-by
* includes implicit order-bys in addition to the explicit user provided
* order-bys.
*/ function __PRIVATE_queryNormalizedOrderBy(t) {
const e = __PRIVATE_debugCast(t);
if (null === e.S) {
e.S = [];
const t = new Set;
// Any explicit order by fields should be added as is.
for (const r of e.explicitOrderBy) e.S.push(r), t.add(r.field.canonicalString());
// The order of the implicit ordering always matches the last explicit order by.
const r = e.explicitOrderBy.length > 0 ? e.explicitOrderBy[e.explicitOrderBy.length - 1].dir : "asc" /* Direction.ASCENDING */ , n =
// Returns the sorted set of inequality filter fields used in this query.
function __PRIVATE_getInequalityFilterFields(t) {
let e = new SortedSet(FieldPath$1.comparator);
return t.filters.forEach((t => {
t.getFlattenedFilters().forEach((t => {
t.isInequality() && (e = e.add(t.field));
}));
})), e;
}
/**
* Creates a new Query for a collection group query that matches all documents
* within the provided collection group.
*/ (e);
// Any inequality fields not explicitly ordered should be implicitly ordered in a lexicographical
// order. When there are multiple inequality filters on the same field, the field should be added
// only once.
// Note: `SortedSet` sorts the key field before other fields. However, we want the key
// field to be sorted last.
n.forEach((n => {
t.has(n.canonicalString()) || n.isKeyField() || e.S.push(new OrderBy(n, r));
})),
// Add the document key field to the last if it is not explicitly ordered.
t.has(FieldPath$1.keyField().canonicalString()) || e.S.push(new OrderBy(FieldPath$1.keyField(), r));
}
return e.S;
}
/**
* Converts this `Query` instance to its corresponding `Target` representation.
*/ function __PRIVATE_queryToTarget(t) {
const e = __PRIVATE_debugCast(t);
return e.N || (e.N = __PRIVATE__queryToTarget(e, __PRIVATE_queryNormalizedOrderBy(t))),
e.N;
}
/**
* Converts this `Query` instance to its corresponding `Target` representation,
* for use within an aggregate query. Unlike targets for non-aggregate queries,
* aggregate query targets do not contain normalized order-bys, they only
* contain explicit order-bys.
*/ function __PRIVATE__queryToTarget(t, e) {
if ("F" /* LimitType.First */ === t.limitType) return __PRIVATE_newTarget(t.path, t.collectionGroup, e, t.filters, t.limit, t.startAt, t.endAt);
{
// Flip the orderBy directions since we want the last results
e = e.map((t => {
const e = "desc" /* Direction.DESCENDING */ === t.dir ? "asc" /* Direction.ASCENDING */ : "desc" /* Direction.DESCENDING */;
return new OrderBy(t.field, e);
}));
// We need to swap the cursors to match the now-flipped query ordering.
const r = t.endAt ? new Bound(t.endAt.position, t.endAt.inclusive) : null, n = t.startAt ? new Bound(t.startAt.position, t.startAt.inclusive) : null;
// Now return as a LimitType.First query.
return __PRIVATE_newTarget(t.path, t.collectionGroup, e, t.filters, t.limit, r, n);
}
}
function __PRIVATE_queryWithAddedFilter(t, e) {
const r = t.filters.concat([ e ]);
return new __PRIVATE_QueryImpl(t.path, t.collectionGroup, t.explicitOrderBy.slice(), r, t.limit, t.limitType, t.startAt, t.endAt);
}
function __PRIVATE_queryEquals(t, e) {
return function __PRIVATE_targetEquals(t, e) {
if (t.limit !== e.limit) return !1;
if (t.orderBy.length !== e.orderBy.length) return !1;
for (let r = 0; r < t.orderBy.length; r++) if (!__PRIVATE_orderByEquals(t.orderBy[r], e.orderBy[r])) return !1;
if (t.filters.length !== e.filters.length) return !1;
for (let r = 0; r < t.filters.length; r++) if (!__PRIVATE_filterEquals(t.filters[r], e.filters[r])) return !1;
return t.collectionGroup === e.collectionGroup && !!t.path.isEqual(e.path) && !!__PRIVATE_boundEquals(t.startAt, e.startAt) && __PRIVATE_boundEquals(t.endAt, e.endAt);
}(__PRIVATE_queryToTarget(t), __PRIVATE_queryToTarget(e)) && t.limitType === e.limitType;
}
/**
* @license
* Copyright 2020 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.
*/
/**
* Returns an DoubleValue for `value` that is encoded based the serializer's
* `useProto3Json` setting.
*/
/**
* Returns a value for a number that's appropriate to put into a proto.
* The return value is an IntegerValue if it can safely represent the value,
* otherwise a DoubleValue is returned.
*/
function toNumber(t, e) {
return function isSafeInteger(t) {
return "number" == typeof t && Number.isInteger(t) && !__PRIVATE_isNegativeZero(t) && t <= Number.MAX_SAFE_INTEGER && t >= Number.MIN_SAFE_INTEGER;
}(e) ?
/**
* Returns an IntegerValue for `value`.
*/
function __PRIVATE_toInteger(t) {
return {
integerValue: "" + t
};
}(e) : function __PRIVATE_toDouble(t, e) {
if (t.useProto3Json) {
if (isNaN(e)) return {
doubleValue: "NaN"
};
if (e === 1 / 0) return {
doubleValue: "Infinity"
};
if (e === -1 / 0) return {
doubleValue: "-Infinity"
};
}
return {
doubleValue: __PRIVATE_isNegativeZero(e) ? "-0" : e
};
}(t, e);
}
/**
* @license
* Copyright 2018 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.
*/
/** Used to represent a field transform on a mutation. */ class TransformOperation {
constructor() {
// Make sure that the structural type of `TransformOperation` is unique.
// See https://github.com/microsoft/TypeScript/issues/5451
this._ = void 0;
}
}
/** Transforms a value into a server-generated timestamp. */ class __PRIVATE_ServerTimestampTransform extends TransformOperation {}
/** Transforms an array value via a union operation. */ class __PRIVATE_ArrayUnionTransformOperation extends TransformOperation {
constructor(t) {
super(), this.elements = t;
}
}
/** Transforms an array value via a remove operation. */ class __PRIVATE_ArrayRemoveTransformOperation extends TransformOperation {
constructor(t) {
super(), this.elements = t;
}
}
/**
* Implements the backend semantics for locally computed NUMERIC_ADD (increment)
* transforms. Converts all field values to integers or doubles, but unlike the
* backend does not cap integer values at 2^63. Instead, JavaScript number
* arithmetic is used and precision loss can occur for values greater than 2^53.
*/ class __PRIVATE_NumericIncrementTransformOperation extends TransformOperation {
constructor(t, e) {
super(), this.serializer = t, this.q = e;
}
}
/**
* @license
* Copyright 2017 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.
*/
/** A field path and the TransformOperation to perform upon it. */ class FieldTransform {
constructor(t, e) {
this.field = t, this.transform = e;
}
}
/**
* Encodes a precondition for a mutation. This follows the model that the
* backend accepts with the special case of an explicit "empty" precondition
* (meaning no precondition).
*/ class Precondition {
constructor(t, e) {
this.updateTime = t, this.exists = e;
}
/** Creates a new empty Precondition. */ static none() {
return new Precondition;
}
/** Creates a new Precondition with an exists flag. */ static exists(t) {
return new Precondition(void 0, t);
}
/** Creates a new Precondition based on a version a document exists at. */ static updateTime(t) {
return new Precondition(t);
}
/** Returns whether this Precondition is empty. */ get isNone() {
return void 0 === this.updateTime && void 0 === this.exists;
}
isEqual(t) {
return this.exists === t.exists && (this.updateTime ? !!t.updateTime && this.updateTime.isEqual(t.updateTime) : !t.updateTime);
}
}
/**
* A mutation describes a self-contained change to a document. Mutations can
* create, replace, delete, and update subsets of documents.
*
* Mutations not only act on the value of the document but also its version.
*
* For local mutations (mutations that haven't been committed yet), we preserve
* the existing version for Set and Patch mutations. For Delete mutations, we
* reset the version to 0.
*
* Here's the expected transition table.
*
* MUTATION APPLIED TO RESULTS IN
*
* SetMutation Document(v3) Document(v3)
* SetMutation NoDocument(v3) Document(v0)
* SetMutation InvalidDocument(v0) Document(v0)
* PatchMutation Document(v3) Document(v3)
* PatchMutation NoDocument(v3) NoDocument(v3)
* PatchMutation InvalidDocument(v0) UnknownDocument(v3)
* DeleteMutation Document(v3) NoDocument(v0)
* DeleteMutation NoDocument(v3) NoDocument(v0)
* DeleteMutation InvalidDocument(v0) NoDocument(v0)
*
* For acknowledged mutations, we use the updateTime of the WriteResponse as
* the resulting version for Set and Patch mutations. As deletes have no
* explicit update time, we use the commitTime of the WriteResponse for
* Delete mutations.
*
* If a mutation is acknowledged by the backend but fails the precondition check
* locally, we transition to an `UnknownDocument` and rely on Watch to send us
* the updated version.
*
* Field transforms are used only with Patch and Set Mutations. We use the
* `updateTransforms` message to store transforms, rather than the `transforms`s
* messages.
*
* ## Subclassing Notes
*
* Every type of mutation needs to implement its own applyToRemoteDocument() and
* applyToLocalView() to implement the actual behavior of applying the mutation
* to some source document (see `setMutationApplyToRemoteDocument()` for an
* example).
*/ class Mutation {}
/**
* A mutation that creates or replaces the document at the given key with the
* object value contents.
*/ class __PRIVATE_SetMutation extends Mutation {
constructor(t, e, r, n = []) {
super(), this.key = t, this.value = e, this.precondition = r, this.fieldTransforms = n,
this.type = 0 /* MutationType.Set */;
}
getFieldMask() {
return null;
}
}
/**
* A mutation that modifies fields of the document at the given key with the
* given values. The values are applied through a field mask:
*
* * When a field is in both the mask and the values, the corresponding field
* is updated.
* * When a field is in neither the mask nor the values, the corresponding
* field is unmodified.
* * When a field is in the mask but not in the values, the corresponding field
* is deleted.
* * When a field is not in the mask but is in the values, the values map is
* ignored.
*/ class __PRIVATE_PatchMutation extends Mutation {
constructor(t, e, r, n, i = []) {
super(), this.key = t, this.data = e, this.fieldMask = r, this.precondition = n,
this.fieldTransforms = i, this.type = 1 /* MutationType.Patch */;
}
getFieldMask() {
return this.fieldMask;
}
}
/** A mutation that deletes the document at the given key. */ class __PRIVATE_DeleteMutation extends Mutation {
constructor(t, e) {
super(), this.key = t, this.precondition = e, this.type = 2 /* MutationType.Delete */ ,
this.fieldTransforms = [];
}
getFieldMask() {
return null;
}
}
/**
* A mutation that verifies the existence of the document at the given key with
* the provided precondition.
*
* The `verify` operation is only used in Transactions, and this class serves
* primarily to facilitate serialization into protos.
*/ class __PRIVATE_VerifyMutation extends Mutation {
constructor(t, e) {
super(), this.key = t, this.precondition = e, this.type = 3 /* MutationType.Verify */ ,
this.fieldTransforms = [];
}
getFieldMask() {
return null;
}
}
/**
* @license
* Copyright 2017 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.
*/ const L = (() => {
const t = {
asc: "ASCENDING",
desc: "DESCENDING"
};
return t;
})(), M = (() => {
const t = {
"<": "LESS_THAN",
"<=": "LESS_THAN_OR_EQUAL",
">": "GREATER_THAN",
">=": "GREATER_THAN_OR_EQUAL",
"==": "EQUAL",
"!=": "NOT_EQUAL",
"array-contains": "ARRAY_CONTAINS",
in: "IN",
"not-in": "NOT_IN",
"array-contains-any": "ARRAY_CONTAINS_ANY"
};
return t;
})(), x = (() => {
const t = {
and: "AND",
or: "OR"
};
return t;
})();
/**
* This class generates JsonObject values for the Datastore API suitable for
* sending to either GRPC stub methods or via the JSON/HTTP REST API.
*
* The serializer supports both Protobuf.js and Proto3 JSON formats. By
* setting `useProto3Json` to true, the serializer will use the Proto3 JSON
* format.
*
* For a description of the Proto3 JSON format check
* https://developers.google.com/protocol-buffers/docs/proto3#json
*
* TODO(klimt): We can remove the databaseId argument if we keep the full
* resource name in documents.
*/
class JsonProtoSerializer {
constructor(t, e) {
this.databaseId = t, this.useProto3Json = e;
}
}
/**
* Returns a value for a number (or null) that's appropriate to put into
* a google.protobuf.Int32Value proto.
* DO NOT USE THIS FOR ANYTHING ELSE.
* This method cheats. It's typed as returning "number" because that's what
* our generated proto interfaces say Int32Value must be. But GRPC actually
* expects a { value: } struct.
*/
/**
* Returns a value for a Date that's appropriate to put into a proto.
*/
function toTimestamp(t, e) {
if (t.useProto3Json) {
return `${new Date(1e3 * e.seconds).toISOString().replace(/\.\d*/, "").replace("Z", "")}.${("000000000" + e.nanoseconds).slice(-9)}Z`;
}
return {
seconds: "" + e.seconds,
nanos: e.nanoseconds
};
}
/**
* Returns a value for bytes that's appropriate to put in a proto.
*
* Visible for testing.
*/
function __PRIVATE_toBytes(t, e) {
return t.useProto3Json ? e.toBase64() : e.toUint8Array();
}
function __PRIVATE_toVersion(t, e) {
return toTimestamp(t, e.toTimestamp());
}
function __PRIVATE_fromVersion(t) {
return __PRIVATE_hardAssert(!!t), SnapshotVersion.fromTimestamp(function fromTimestamp(t) {
const e = __PRIVATE_normalizeTimestamp(t);
return new Timestamp(e.seconds, e.nanos);
}(t));
}
function __PRIVATE_toResourceName(t, e) {
return __PRIVATE_toResourcePath(t, e).canonicalString();
}
function __PRIVATE_toResourcePath(t, e) {
const r = function __PRIVATE_fullyQualifiedPrefixPath(t) {
return new ResourcePath([ "projects", t.projectId, "databases", t.database ]);
}(t).child("documents");
return void 0 === e ? r : r.child(e);
}
function __PRIVATE_toName(t, e) {
return __PRIVATE_toResourceName(t.databaseId, e.path);
}
function fromName(t, e) {
const r = function __PRIVATE_fromResourceName(t) {
const e = ResourcePath.fromString(t);
return __PRIVATE_hardAssert(__PRIVATE_isValidResourceName(e)), e;
}(e);
if (r.get(1) !== t.databaseId.projectId) throw new FirestoreError(T, "Tried to deserialize key from different project: " + r.get(1) + " vs " + t.databaseId.projectId);
if (r.get(3) !== t.databaseId.database) throw new FirestoreError(T, "Tried to deserialize key from different database: " + r.get(3) + " vs " + t.databaseId.database);
return new DocumentKey(function __PRIVATE_extractLocalPathFromResourceName(t) {
return __PRIVATE_hardAssert(t.length > 4 && "documents" === t.get(4)), t.popFirst(5);
}
/** Creates a Document proto from key and fields (but no create/update time) */ (r));
}
function __PRIVATE_toMutationDocument(t, e, r) {
return {
name: __PRIVATE_toName(t, e),
fields: r.value.mapValue.fields
};
}
function __PRIVATE_fromBatchGetDocumentsResponse(t, e) {
return "found" in e ? function __PRIVATE_fromFound(t, e) {
__PRIVATE_hardAssert(!!e.found), e.found.name, e.found.updateTime;
const r = fromName(t, e.found.name), n = __PRIVATE_fromVersion(e.found.updateTime), i = e.found.createTime ? __PRIVATE_fromVersion(e.found.createTime) : SnapshotVersion.min(), s = new ObjectValue({
mapValue: {
fields: e.found.fields
}
});
return MutableDocument.newFoundDocument(r, n, i, s);
}(t, e) : "missing" in e ? function __PRIVATE_fromMissing(t, e) {
__PRIVATE_hardAssert(!!e.missing), __PRIVATE_hardAssert(!!e.readTime);
const r = fromName(t, e.missing), n = __PRIVATE_fromVersion(e.readTime);
return MutableDocument.newNoDocument(r, n);
}(t, e) : fail();
}
function toMutation(t, e) {
let r;
if (e instanceof __PRIVATE_SetMutation) r = {
update: __PRIVATE_toMutationDocument(t, e.key, e.value)
}; else if (e instanceof __PRIVATE_DeleteMutation) r = {
delete: __PRIVATE_toName(t, e.key)
}; else if (e instanceof __PRIVATE_PatchMutation) r = {
update: __PRIVATE_toMutationDocument(t, e.key, e.data),
updateMask: __PRIVATE_toDocumentMask(e.fieldMask)
}; else {
if (!(e instanceof __PRIVATE_VerifyMutation)) return fail();
r = {
verify: __PRIVATE_toName(t, e.key)
};
}
return e.fieldTransforms.length > 0 && (r.updateTransforms = e.fieldTransforms.map((t => function __PRIVATE_toFieldTransform(t, e) {
const r = e.transform;
if (r instanceof __PRIVATE_ServerTimestampTransform) return {
fieldPath: e.field.canonicalString(),
setToServerValue: "REQUEST_TIME"
};
if (r instanceof __PRIVATE_ArrayUnionTransformOperation) return {
fieldPath: e.field.canonicalString(),
appendMissingElements: {
values: r.elements
}
};
if (r instanceof __PRIVATE_ArrayRemoveTransformOperation) return {
fieldPath: e.field.canonicalString(),
removeAllFromArray: {
values: r.elements
}
};
if (r instanceof __PRIVATE_NumericIncrementTransformOperation) return {
fieldPath: e.field.canonicalString(),
increment: r.q
};
throw fail();
}(0, t)))), e.precondition.isNone || (r.currentDocument = function __PRIVATE_toPrecondition(t, e) {
return void 0 !== e.updateTime ? {
updateTime: __PRIVATE_toVersion(t, e.updateTime)
} : void 0 !== e.exists ? {
exists: e.exists
} : fail();
}(t, e.precondition)), r;
}
function __PRIVATE_toQueryTarget(t, e) {
// Dissect the path into parent, collectionId, and optional key filter.
const r = {
structuredQuery: {}
}, n = e.path;
let i;
null !== e.collectionGroup ? (i = n, r.structuredQuery.from = [ {
collectionId: e.collectionGroup,
allDescendants: !0
} ]) : (i = n.popLast(), r.structuredQuery.from = [ {
collectionId: n.lastSegment()
} ]), r.parent = function __PRIVATE_toQueryPath(t, e) {
return __PRIVATE_toResourceName(t.databaseId, e);
}(t, i);
const s = function __PRIVATE_toFilters(t) {
if (0 === t.length) return;
return __PRIVATE_toFilter(CompositeFilter.create(t, "and" /* CompositeOperator.AND */));
}(e.filters);
s && (r.structuredQuery.where = s);
const o = function __PRIVATE_toOrder(t) {
if (0 === t.length) return;
return t.map((t =>
// visible for testing
function __PRIVATE_toPropertyOrder(t) {
return {
field: __PRIVATE_toFieldPathReference(t.field),
direction: __PRIVATE_toDirection(t.dir)
};
}
// visible for testing
(t)));
}(e.orderBy);
o && (r.structuredQuery.orderBy = o);
const a = function __PRIVATE_toInt32Proto(t, e) {
return t.useProto3Json || __PRIVATE_isNullOrUndefined(e) ? e : {
value: e
};
}(t, e.limit);
return null !== a && (r.structuredQuery.limit = a), e.startAt && (r.structuredQuery.startAt = function __PRIVATE_toStartAtCursor(t) {
return {
before: t.inclusive,
values: t.position
};
}(e.startAt)), e.endAt && (r.structuredQuery.endAt = function __PRIVATE_toEndAtCursor(t) {
return {
before: !t.inclusive,
values: t.position
};
}
// visible for testing
(e.endAt)), {
B: r,
parent: i
};
}
function __PRIVATE_toDirection(t) {
return L[t];
}
// visible for testing
function __PRIVATE_toOperatorName(t) {
return M[t];
}
function __PRIVATE_toCompositeOperatorName(t) {
return x[t];
}
function __PRIVATE_toFieldPathReference(t) {
return {
fieldPath: t.canonicalString()
};
}
function __PRIVATE_toFilter(t) {
return t instanceof FieldFilter ? function __PRIVATE_toUnaryOrFieldFilter(t) {
if ("==" /* Operator.EQUAL */ === t.op) {
if (__PRIVATE_isNanValue(t.value)) return {
unaryFilter: {
field: __PRIVATE_toFieldPathReference(t.field),
op: "IS_NAN"
}
};
if (__PRIVATE_isNullValue(t.value)) return {
unaryFilter: {
field: __PRIVATE_toFieldPathReference(t.field),
op: "IS_NULL"
}
};
} else if ("!=" /* Operator.NOT_EQUAL */ === t.op) {
if (__PRIVATE_isNanValue(t.value)) return {
unaryFilter: {
field: __PRIVATE_toFieldPathReference(t.field),
op: "IS_NOT_NAN"
}
};
if (__PRIVATE_isNullValue(t.value)) return {
unaryFilter: {
field: __PRIVATE_toFieldPathReference(t.field),
op: "IS_NOT_NULL"
}
};
}
return {
fieldFilter: {
field: __PRIVATE_toFieldPathReference(t.field),
op: __PRIVATE_toOperatorName(t.op),
value: t.value
}
};
}(t) : t instanceof CompositeFilter ? function __PRIVATE_toCompositeFilter(t) {
const e = t.getFilters().map((t => __PRIVATE_toFilter(t)));
if (1 === e.length) return e[0];
return {
compositeFilter: {
op: __PRIVATE_toCompositeOperatorName(t.op),
filters: e
}
};
}(t) : fail();
}
function __PRIVATE_toDocumentMask(t) {
const e = [];
return t.fields.forEach((t => e.push(t.canonicalString()))), {
fieldPaths: e
};
}
function __PRIVATE_isValidResourceName(t) {
// Resource names have at least 4 components (project ID, database ID)
return t.length >= 4 && "projects" === t.get(0) && "databases" === t.get(2);
}
/**
* @license
* Copyright 2020 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.
*/ function __PRIVATE_newSerializer(t) {
return new JsonProtoSerializer(t, /* useProto3Json= */ !0);
}
/**
* @license
* Copyright 2017 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.
*/
/**
* A helper for running delayed tasks following an exponential backoff curve
* between attempts.
*
* Each delay is made up of a "base" delay which follows the exponential
* backoff curve, and a +/- 50% "jitter" that is calculated and added to the
* base delay. This prevents clients from accidentally synchronizing their
* delays causing spikes of load to the backend.
*/
class __PRIVATE_ExponentialBackoff {
constructor(
/**
* The AsyncQueue to run backoff operations on.
*/
t,
/**
* The ID to use when scheduling backoff operations on the AsyncQueue.
*/
e,
/**
* The initial delay (used as the base delay on the first retry attempt).
* Note that jitter will still be applied, so the actual delay could be as
* little as 0.5*initialDelayMs.
*/
r = 1e3
/**
* The multiplier to use to determine the extended base delay after each
* attempt.
*/ , n = 1.5
/**
* The maximum base delay after which no further backoff is performed.
* Note that jitter will still be applied, so the actual delay could be as
* much as 1.5*maxDelayMs.
*/ , i = 6e4) {
this.$ = t, this.timerId = e, this.L = r, this.M = n, this.k = i, this.U = 0, this.j = null,
/** The last backoff attempt, as epoch milliseconds. */
this.W = Date.now(), this.reset();
}
/**
* Resets the backoff delay.
*
* The very next backoffAndWait() will have no delay. If it is called again
* (i.e. due to an error), initialDelayMs (plus jitter) will be used, and
* subsequent ones will increase according to the backoffFactor.
*/ reset() {
this.U = 0;
}
/**
* Resets the backoff delay to the maximum delay (e.g. for use after a
* RESOURCE_EXHAUSTED error).
*/ K() {
this.U = this.k;
}
/**
* Returns a promise that resolves after currentDelayMs, and increases the
* delay for any subsequent attempts. If there was a pending backoff operation
* already, it will be canceled.
*/ G(t) {
// Cancel any pending backoff operation.
this.cancel();
// First schedule using the current base (which may be 0 and should be
// honored as such).
const e = Math.floor(this.U + this.H()), r = Math.max(0, Date.now() - this.W), n = Math.max(0, e - r);
// Guard against lastAttemptTime being in the future due to a clock change.
n > 0 && __PRIVATE_logDebug("ExponentialBackoff", `Backing off for ${n} ms (base delay: ${this.U} ms, delay with jitter: ${e} ms, last attempt: ${r} ms ago)`),
this.j = this.$.enqueueAfterDelay(this.timerId, n, (() => (this.W = Date.now(),
t()))),
// Apply backoff factor to determine next delay and ensure it is within
// bounds.
this.U *= this.M, this.U < this.L && (this.U = this.L), this.U > this.k && (this.U = this.k);
}
J() {
null !== this.j && (this.j.skipDelay(), this.j = null);
}
cancel() {
null !== this.j && (this.j.cancel(), this.j = null);
}
/** Returns a random value in the range [-currentBaseMs/2, currentBaseMs/2] */ H() {
return (Math.random() - .5) * this.U;
}
}
/**
* @license
* Copyright 2017 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.
*/
/**
* Datastore and its related methods are a wrapper around the external Google
* Cloud Datastore grpc API, which provides an interface that is more convenient
* for the rest of the client SDK architecture to consume.
*/
/**
* An implementation of Datastore that exposes additional state for internal
* consumption.
*/
class __PRIVATE_DatastoreImpl extends class Datastore {} {
constructor(t, e, r, n) {
super(), this.authCredentials = t, this.appCheckCredentials = e, this.connection = r,
this.serializer = n, this.Y = !1;
}
Z() {
if (this.Y) throw new FirestoreError(w, "The client has already been terminated.");
}
/** Invokes the provided RPC with auth and AppCheck tokens. */ P(t, e, r, n) {
return this.Z(), Promise.all([ this.authCredentials.getToken(), this.appCheckCredentials.getToken() ]).then((([i, s]) => this.connection.P(t, __PRIVATE_toResourcePath(e, r), n, i, s))).catch((t => {
throw "FirebaseError" === t.name ? (t.code === p && (this.authCredentials.invalidateToken(),
this.appCheckCredentials.invalidateToken()), t) : new FirestoreError(A, t.toString());
}));
}
/** Invokes the provided RPC with streamed results with auth and AppCheck tokens. */ g(t, e, r, n, i) {
return this.Z(), Promise.all([ this.authCredentials.getToken(), this.appCheckCredentials.getToken() ]).then((([s, o]) => this.connection.g(t, __PRIVATE_toResourcePath(e, r), n, s, o, i))).catch((t => {
throw "FirebaseError" === t.name ? (t.code === p && (this.authCredentials.invalidateToken(),
this.appCheckCredentials.invalidateToken()), t) : new FirestoreError(A, t.toString());
}));
}
terminate() {
this.Y = !0, this.connection.terminate();
}
}
// TODO(firestorexp): Make sure there is only one Datastore instance per
// firestore-exp client.
async function __PRIVATE_invokeCommitRpc(t, e) {
const r = __PRIVATE_debugCast(t), n = {
writes: e.map((t => toMutation(r.serializer, t)))
};
await r.P("Commit", r.serializer.databaseId, ResourcePath.emptyPath(), n);
}
async function __PRIVATE_invokeBatchGetDocumentsRpc(t, e) {
const r = __PRIVATE_debugCast(t), n = {
documents: e.map((t => __PRIVATE_toName(r.serializer, t)))
}, i = await r.g("BatchGetDocuments", r.serializer.databaseId, ResourcePath.emptyPath(), n, e.length), s = new Map;
i.forEach((t => {
const e = __PRIVATE_fromBatchGetDocumentsResponse(r.serializer, t);
s.set(e.key.toString(), e);
}));
const o = [];
return e.forEach((t => {
const e = s.get(t.toString());
__PRIVATE_hardAssert(!!e), o.push(e);
})), o;
}
async function __PRIVATE_invokeRunQueryRpc(t, e) {
const r = __PRIVATE_debugCast(t), {B: n, parent: i} = __PRIVATE_toQueryTarget(r.serializer, __PRIVATE_queryToTarget(e));
return (await r.g("RunQuery", r.serializer.databaseId, i, {
structuredQuery: n.structuredQuery
})).filter((t => !!t.document)).map((t => function __PRIVATE_fromDocument(t, e, r) {
const n = fromName(t, e.name), i = __PRIVATE_fromVersion(e.updateTime), s = e.createTime ? __PRIVATE_fromVersion(e.createTime) : SnapshotVersion.min(), o = new ObjectValue({
mapValue: {
fields: e.fields
}
}), a = MutableDocument.newFoundDocument(n, i, s, o);
return r && a.setHasCommittedMutations(), r ? a.setHasCommittedMutations() : a;
}(r.serializer, t.document, void 0)));
}
async function __PRIVATE_invokeRunAggregationQueryRpc(t, e, r) {
var n;
const i = __PRIVATE_debugCast(t), {request: s, X: o, parent: a} = function __PRIVATE_toRunAggregationQueryRequest(t, e, r) {
const {B: n, parent: i} = __PRIVATE_toQueryTarget(t, e), s = {}, o = [];
let a = 0;
return r.forEach((t => {
// Map all client-side aliases to a unique short-form
// alias. This avoids issues with client-side aliases that
// exceed the 1500-byte string size limit.
const e = "aggregate_" + a++;
s[e] = t.alias, "count" === t.aggregateType ? o.push({
alias: e,
count: {}
}) : "avg" === t.aggregateType ? o.push({
alias: e,
avg: {
field: __PRIVATE_toFieldPathReference(t.fieldPath)
}
}) : "sum" === t.aggregateType && o.push({
alias: e,
sum: {
field: __PRIVATE_toFieldPathReference(t.fieldPath)
}
});
})), {
request: {
structuredAggregationQuery: {
aggregations: o,
structuredQuery: n.structuredQuery
},
parent: n.parent
},
X: s,
parent: i
};
}(i.serializer, function __PRIVATE_queryToAggregateTarget(t) {
const e = __PRIVATE_debugCast(t);
return e.O || (
// Do not include implicit order-bys for aggregate queries.
e.O = __PRIVATE__queryToTarget(e, t.explicitOrderBy)), e.O;
}(e), r);
i.connection.R || delete s.parent;
const u = (await i.g("RunAggregationQuery", i.serializer.databaseId, a, s,
/*expectedResponseCount=*/ 1)).filter((t => !!t.result));
// Omit RunAggregationQueryResponse that only contain readTimes.
__PRIVATE_hardAssert(1 === u.length);
// Remap the short-form aliases that were sent to the server
// to the client-side aliases. Users will access the results
// using the client-side alias.
const _ = null === (n = u[0].result) || void 0 === n ? void 0 : n.aggregateFields;
return Object.keys(_).reduce(((t, e) => (t[o[e]] = _[e], t)), {});
}
/**
* @license
* Copyright 2020 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.
*/ const k = new Map;
/**
* An instance map that ensures only one Datastore exists per Firestore
* instance.
*/
/**
* Returns an initialized and started Datastore for the given Firestore
* instance. Callers must invoke removeComponents() when the Firestore
* instance is terminated.
*/
function __PRIVATE_getDatastore(t) {
if (t._terminated) throw new FirestoreError(w, "The client has already been terminated.");
if (!k.has(t)) {
__PRIVATE_logDebug("ComponentProvider", "Initializing Datastore");
const e = function __PRIVATE_newConnection(t) {
return new __PRIVATE_FetchConnection(t, fetch.bind(null));
}(function __PRIVATE_makeDatabaseInfo(t, e, r, n) {
return new DatabaseInfo(t, e, r, n.host, n.ssl, n.experimentalForceLongPolling, n.experimentalAutoDetectLongPolling, __PRIVATE_cloneLongPollingOptions(n.experimentalLongPollingOptions), n.useFetchStreams);
}
/**
* @license
* Copyright 2018 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.
*/ (t._databaseId, t.app.options.appId || "", t._persistenceKey, t._freezeSettings())), r = __PRIVATE_newSerializer(t._databaseId), n = function __PRIVATE_newDatastore(t, e, r, n) {
return new __PRIVATE_DatastoreImpl(t, e, r, n);
}(t._authCredentials, t._appCheckCredentials, e, r);
k.set(t, n);
}
return k.get(t);
}
/**
* Removes all components associated with the provided instance. Must be called
* when the `Firestore` instance is terminated.
*/
/**
* A concrete type describing all the values that can be applied via a
* user-supplied `FirestoreSettings` object. This is a separate type so that
* defaults can be supplied and the value can be checked for equality.
*/
class FirestoreSettingsImpl {
constructor(t) {
var e, r;
if (void 0 === t.host) {
if (void 0 !== t.ssl) throw new FirestoreError(T, "Can't provide ssl option if host option is not set");
this.host = "firestore.googleapis.com", this.ssl = true;
} else this.host = t.host, this.ssl = null === (e = t.ssl) || void 0 === e || e;
if (this.credentials = t.credentials, this.ignoreUndefinedProperties = !!t.ignoreUndefinedProperties,
this.localCache = t.localCache, void 0 === t.cacheSizeBytes) this.cacheSizeBytes = 41943040; else {
if (-1 !== t.cacheSizeBytes && t.cacheSizeBytes < 1048576) throw new FirestoreError(T, "cacheSizeBytes must be at least 1048576");
this.cacheSizeBytes = t.cacheSizeBytes;
}
!function __PRIVATE_validateIsNotUsedTogether(t, e, r, n) {
if (!0 === e && !0 === n) throw new FirestoreError(T, `${t} and ${r} cannot be used together.`);
}("experimentalForceLongPolling", t.experimentalForceLongPolling, "experimentalAutoDetectLongPolling", t.experimentalAutoDetectLongPolling),
this.experimentalForceLongPolling = !!t.experimentalForceLongPolling, this.experimentalForceLongPolling ? this.experimentalAutoDetectLongPolling = !1 : void 0 === t.experimentalAutoDetectLongPolling ? this.experimentalAutoDetectLongPolling = true :
// For backwards compatibility, coerce the value to boolean even though
// the TypeScript compiler has narrowed the type to boolean already.
// noinspection PointlessBooleanExpressionJS
this.experimentalAutoDetectLongPolling = !!t.experimentalAutoDetectLongPolling,
this.experimentalLongPollingOptions = __PRIVATE_cloneLongPollingOptions(null !== (r = t.experimentalLongPollingOptions) && void 0 !== r ? r : {}),
function __PRIVATE_validateLongPollingOptions(t) {
if (void 0 !== t.timeoutSeconds) {
if (isNaN(t.timeoutSeconds)) throw new FirestoreError(T, `invalid long polling timeout: ${t.timeoutSeconds} (must not be NaN)`);
if (t.timeoutSeconds < 5) throw new FirestoreError(T, `invalid long polling timeout: ${t.timeoutSeconds} (minimum allowed value is 5)`);
if (t.timeoutSeconds > 30) throw new FirestoreError(T, `invalid long polling timeout: ${t.timeoutSeconds} (maximum allowed value is 30)`);
}
}
/**
* @license
* Copyright 2020 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 Cloud Firestore service interface.
*
* Do not call this constructor directly. Instead, use {@link (getFirestore:1)}.
*/ (this.experimentalLongPollingOptions), this.useFetchStreams = !!t.useFetchStreams;
}
isEqual(t) {
return this.host === t.host && this.ssl === t.ssl && this.credentials === t.credentials && this.cacheSizeBytes === t.cacheSizeBytes && this.experimentalForceLongPolling === t.experimentalForceLongPolling && this.experimentalAutoDetectLongPolling === t.experimentalAutoDetectLongPolling && function __PRIVATE_longPollingOptionsEqual(t, e) {
return t.timeoutSeconds === e.timeoutSeconds;
}(this.experimentalLongPollingOptions, t.experimentalLongPollingOptions) && this.ignoreUndefinedProperties === t.ignoreUndefinedProperties && this.useFetchStreams === t.useFetchStreams;
}
}
class Firestore {
/** @hideconstructor */
constructor(t, e, r, n) {
this._authCredentials = t, this._appCheckCredentials = e, this._databaseId = r,
this._app = n,
/**
* Whether it's a Firestore or Firestore Lite instance.
*/
this.type = "firestore-lite", this._persistenceKey = "(lite)", this._settings = new FirestoreSettingsImpl({}),
this._settingsFrozen = !1;
}
/**
* The {@link @firebase/app#FirebaseApp} associated with this `Firestore` service
* instance.
*/ get app() {
if (!this._app) throw new FirestoreError(w, "Firestore was not initialized using the Firebase SDK. 'app' is not available");
return this._app;
}
get _initialized() {
return this._settingsFrozen;
}
get _terminated() {
return void 0 !== this._terminateTask;
}
_setSettings(t) {
if (this._settingsFrozen) throw new FirestoreError(w, "Firestore has already been started and its settings can no longer be changed. You can only modify settings before calling any other methods on a Firestore object.");
this._settings = new FirestoreSettingsImpl(t), void 0 !== t.credentials && (this._authCredentials = function __PRIVATE_makeAuthCredentialsProvider(t) {
if (!t) return new __PRIVATE_EmptyAuthCredentialsProvider;
switch (t.type) {
case "firstParty":
return new __PRIVATE_FirstPartyAuthCredentialsProvider(t.sessionIndex || "0", t.iamToken || null, t.authTokenFactory || null);
case "provider":
return t.client;
default:
throw new FirestoreError(T, "makeAuthCredentialsProvider failed due to invalid credential type");
}
}(t.credentials));
}
_getSettings() {
return this._settings;
}
_freezeSettings() {
return this._settingsFrozen = !0, this._settings;
}
_delete() {
return this._terminateTask || (this._terminateTask = this._terminate()), this._terminateTask;
}
/** Returns a JSON-serializable representation of this `Firestore` instance. */ toJSON() {
return {
app: this._app,
databaseId: this._databaseId,
settings: this._settings
};
}
/**
* Terminates all components used by this client. Subclasses can override
* this method to clean up their own dependencies, but must also call this
* method.
*
* Only ever called once.
*/ _terminate() {
return function __PRIVATE_removeComponents(t) {
const e = k.get(t);
e && (__PRIVATE_logDebug("ComponentProvider", "Removing Datastore"), k.delete(t),
e.terminate());
}(this), Promise.resolve();
}
}
function initializeFirestore(t, e, r) {
r || (r = "(default)");
const n = _getProvider(t, "firestore/lite");
if (n.isInitialized(r)) throw new FirestoreError(w, "Firestore can only be initialized once per app.");
return n.initialize({
options: e,
instanceIdentifier: r
});
}
function getFirestore(e, r) {
const n = "object" == typeof e ? e : getApp(), i = "string" == typeof e ? e : r || "(default)", s = _getProvider(n, "firestore/lite").getImmediate({
identifier: i
});
if (!s._initialized) {
const t = getDefaultEmulatorHostnameAndPort("firestore");
t && connectFirestoreEmulator(s, ...t);
}
return s;
}
/**
* Modify this instance to communicate with the Cloud Firestore emulator.
*
* Note: This must be called before this instance has been used to do any
* operations.
*
* @param firestore - The `Firestore` instance to configure to connect to the
* emulator.
* @param host - the emulator host (ex: localhost).
* @param port - the emulator port (ex: 9000).
* @param options.mockUserToken - the mock auth token to use for unit testing
* Security Rules.
*/ function connectFirestoreEmulator(t, e, r, n = {}) {
var i;
const s = (t = __PRIVATE_cast(t, Firestore))._getSettings(), o = `${e}:${r}`;
if ("firestore.googleapis.com" !== s.host && s.host !== o && __PRIVATE_logWarn("Host has been set in both settings() and connectFirestoreEmulator(), emulator host will be used."),
t._setSettings(Object.assign(Object.assign({}, s), {
host: o,
ssl: !1
})), n.mockUserToken) {
let e, r;
if ("string" == typeof n.mockUserToken) e = n.mockUserToken, r = User.MOCK_USER; else {
// Let createMockUserToken validate first (catches common mistakes like
// invalid field "uid" and missing field "sub" / "user_id".)
e = createMockUserToken(n.mockUserToken, null === (i = t._app) || void 0 === i ? void 0 : i.options.projectId);
const s = n.mockUserToken.sub || n.mockUserToken.user_id;
if (!s) throw new FirestoreError(T, "mockUserToken must contain 'sub' or 'user_id' field!");
r = new User(s);
}
t._authCredentials = new __PRIVATE_EmulatorAuthCredentialsProvider(new __PRIVATE_OAuthToken(e, r));
}
}
/**
* Terminates the provided `Firestore` instance.
*
* After calling `terminate()` only the `clearIndexedDbPersistence()` functions
* may be used. Any other function will throw a `FirestoreError`. Termination
* does not cancel any pending writes, and any promises that are awaiting a
* response from the server will not be resolved.
*
* To restart after termination, create a new instance of `Firestore` with
* {@link (getFirestore:1)}.
*
* Note: Under normal circumstances, calling `terminate()` is not required. This
* function is useful only when you want to force this instance to release all of
* its resources or in combination with {@link clearIndexedDbPersistence} to
* ensure that all local state is destroyed between test runs.
*
* @param firestore - The `Firestore` instance to terminate.
* @returns A `Promise` that is resolved when the instance has been successfully
* terminated.
*/ function terminate(t) {
return t = __PRIVATE_cast(t, Firestore), _removeServiceInstance(t.app, "firestore/lite"), t._delete();
}
/**
* @license
* Copyright 2020 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.
*/
/**
* @license
* Copyright 2022 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.
*/
/**
* Represents an aggregation that can be performed by Firestore.
*/
// eslint-disable-next-line @typescript-eslint/no-unused-vars
class AggregateField {
/**
* Create a new AggregateField
* @param aggregateType Specifies the type of aggregation operation to perform.
* @param _internalFieldPath Optionally specifies the field that is aggregated.
* @internal
*/
constructor(t = "count", e) {
this._internalFieldPath = e,
/** A type string to uniquely identify instances of this class. */
this.type = "AggregateField", this.aggregateType = t;
}
}
/**
* The results of executing an aggregation query.
*/ class AggregateQuerySnapshot {
/** @hideconstructor */
constructor(t, e, r) {
this._userDataWriter = e, this._data = r,
/** A type string to uniquely identify instances of this class. */
this.type = "AggregateQuerySnapshot", this.query = t;
}
/**
* Returns the results of the aggregations performed over the underlying
* query.
*
* The keys of the returned object will be the same as those of the
* `AggregateSpec` object specified to the aggregation method, and the values
* will be the corresponding aggregation result.
*
* @returns The results of the aggregations performed over the underlying
* query.
*/ data() {
return this._userDataWriter.convertObjectMap(this._data);
}
}
/**
* @license
* Copyright 2020 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.
*/
/**
* A `Query` refers to a query which you can read or listen to. You can also
* construct refined `Query` objects by adding filters and ordering.
*/ class Query {
// This is the lite version of the Query class in the main SDK.
/** @hideconstructor protected */
constructor(t,
/**
* If provided, the `FirestoreDataConverter` associated with this instance.
*/
e, r) {
this.converter = e, this._query = r,
/** The type of this Firestore reference. */
this.type = "query", this.firestore = t;
}
withConverter(t) {
return new Query(this.firestore, t, this._query);
}
}
/**
* A `DocumentReference` refers to a document location in a Firestore database
* and can be used to write, read, or listen to the location. The document at
* the referenced location may or may not exist.
*/ class DocumentReference {
/** @hideconstructor */
constructor(t,
/**
* If provided, the `FirestoreDataConverter` associated with this instance.
*/
e, r) {
this.converter = e, this._key = r,
/** The type of this Firestore reference. */
this.type = "document", this.firestore = t;
}
get _path() {
return this._key.path;
}
/**
* The document's identifier within its collection.
*/ get id() {
return this._key.path.lastSegment();
}
/**
* A string representing the path of the referenced document (relative
* to the root of the database).
*/ get path() {
return this._key.path.canonicalString();
}
/**
* The collection this `DocumentReference` belongs to.
*/ get parent() {
return new CollectionReference(this.firestore, this.converter, this._key.path.popLast());
}
withConverter(t) {
return new DocumentReference(this.firestore, t, this._key);
}
}
/**
* A `CollectionReference` object can be used for adding documents, getting
* document references, and querying for documents (using {@link (query:1)}).
*/ class CollectionReference extends Query {
/** @hideconstructor */
constructor(t, e, r) {
super(t, e, function __PRIVATE_newQueryForPath(t) {
return new __PRIVATE_QueryImpl(t);
}(r)), this._path = r,
/** The type of this Firestore reference. */
this.type = "collection";
}
/** The collection's identifier. */ get id() {
return this._query.path.lastSegment();
}
/**
* A string representing the path of the referenced collection (relative
* to the root of the database).
*/ get path() {
return this._query.path.canonicalString();
}
/**
* A reference to the containing `DocumentReference` if this is a
* subcollection. If this isn't a subcollection, the reference is null.
*/ get parent() {
const t = this._path.popLast();
return t.isEmpty() ? null : new DocumentReference(this.firestore,
/* converter= */ null, new DocumentKey(t));
}
withConverter(t) {
return new CollectionReference(this.firestore, t, this._path);
}
}
function collection(t, e, ...r) {
if (t = getModularInstance(t), __PRIVATE_validateNonEmptyArgument("collection", "path", e), t instanceof Firestore) {
const n = ResourcePath.fromString(e, ...r);
return __PRIVATE_validateCollectionPath(n), new CollectionReference(t, /* converter= */ null, n);
}
{
if (!(t instanceof DocumentReference || t instanceof CollectionReference)) throw new FirestoreError(T, "Expected first argument to collection() to be a CollectionReference, a DocumentReference or FirebaseFirestore");
const n = t._path.child(ResourcePath.fromString(e, ...r));
return __PRIVATE_validateCollectionPath(n), new CollectionReference(t.firestore,
/* converter= */ null, n);
}
}
// TODO(firestorelite): Consider using ErrorFactory -
// https://github.com/firebase/firebase-js-sdk/blob/0131e1f/packages/util/src/errors.ts#L106
/**
* Creates and returns a new `Query` instance that includes all documents in the
* database that are contained in a collection or subcollection with the
* given `collectionId`.
*
* @param firestore - A reference to the root `Firestore` instance.
* @param collectionId - Identifies the collections to query over. Every
* collection or subcollection with this ID as the last segment of its path
* will be included. Cannot contain a slash.
* @returns The created `Query`.
*/ function collectionGroup(t, e) {
if (t = __PRIVATE_cast(t, Firestore), __PRIVATE_validateNonEmptyArgument("collectionGroup", "collection id", e),
e.indexOf("/") >= 0) throw new FirestoreError(T, `Invalid collection ID '${e}' passed to function collectionGroup(). Collection IDs must not contain '/'.`);
return new Query(t,
/* converter= */ null, function __PRIVATE_newQueryForCollectionGroup(t) {
return new __PRIVATE_QueryImpl(ResourcePath.emptyPath(), t);
}(e));
}
function doc(t, e, ...r) {
if (t = getModularInstance(t),
// We allow omission of 'pathString' but explicitly prohibit passing in both
// 'undefined' and 'null'.
1 === arguments.length && (e = __PRIVATE_AutoId.newId()), __PRIVATE_validateNonEmptyArgument("doc", "path", e),
t instanceof Firestore) {
const n = ResourcePath.fromString(e, ...r);
return __PRIVATE_validateDocumentPath(n), new DocumentReference(t,
/* converter= */ null, new DocumentKey(n));
}
{
if (!(t instanceof DocumentReference || t instanceof CollectionReference)) throw new FirestoreError(T, "Expected first argument to collection() to be a CollectionReference, a DocumentReference or FirebaseFirestore");
const n = t._path.child(ResourcePath.fromString(e, ...r));
return __PRIVATE_validateDocumentPath(n), new DocumentReference(t.firestore, t instanceof CollectionReference ? t.converter : null, new DocumentKey(n));
}
}
/**
* Returns true if the provided references are equal.
*
* @param left - A reference to compare.
* @param right - A reference to compare.
* @returns true if the references point to the same location in the same
* Firestore database.
*/ function refEqual(t, e) {
return t = getModularInstance(t), e = getModularInstance(e), (t instanceof DocumentReference || t instanceof CollectionReference) && (e instanceof DocumentReference || e instanceof CollectionReference) && (t.firestore === e.firestore && t.path === e.path && t.converter === e.converter);
}
/**
* Returns true if the provided queries point to the same collection and apply
* the same constraints.
*
* @param left - A `Query` to compare.
* @param right - A `Query` to compare.
* @returns true if the references point to the same location in the same
* Firestore database.
*/ function queryEqual(t, e) {
return t = getModularInstance(t), e = getModularInstance(e), t instanceof Query && e instanceof Query && (t.firestore === e.firestore && __PRIVATE_queryEquals(t._query, e._query) && t.converter === e.converter);
}
/**
* @license
* Copyright 2020 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.
*/
/**
* An immutable object representing an array of bytes.
*/ class Bytes {
/** @hideconstructor */
constructor(t) {
this._byteString = t;
}
/**
* Creates a new `Bytes` object from the given Base64 string, converting it to
* bytes.
*
* @param base64 - The Base64 string used to create the `Bytes` object.
*/ static fromBase64String(t) {
try {
return new Bytes(ByteString.fromBase64String(t));
} catch (t) {
throw new FirestoreError(T, "Failed to construct data from Base64 string: " + t);
}
}
/**
* Creates a new `Bytes` object from the given Uint8Array.
*
* @param array - The Uint8Array used to create the `Bytes` object.
*/ static fromUint8Array(t) {
return new Bytes(ByteString.fromUint8Array(t));
}
/**
* Returns the underlying bytes as a Base64-encoded string.
*
* @returns The Base64-encoded string created from the `Bytes` object.
*/ toBase64() {
return this._byteString.toBase64();
}
/**
* Returns the underlying bytes in a new `Uint8Array`.
*
* @returns The Uint8Array created from the `Bytes` object.
*/ toUint8Array() {
return this._byteString.toUint8Array();
}
/**
* Returns a string representation of the `Bytes` object.
*
* @returns A string representation of the `Bytes` object.
*/ toString() {
return "Bytes(base64: " + this.toBase64() + ")";
}
/**
* Returns true if this `Bytes` object is equal to the provided one.
*
* @param other - The `Bytes` object to compare against.
* @returns true if this `Bytes` object is equal to the provided one.
*/ isEqual(t) {
return this._byteString.isEqual(t._byteString);
}
}
/**
* @license
* Copyright 2020 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.
*/
/**
* A `FieldPath` refers to a field in a document. The path may consist of a
* single field name (referring to a top-level field in the document), or a
* list of field names (referring to a nested field in the document).
*
* Create a `FieldPath` by providing field names. If more than one field
* name is provided, the path will point to a nested field in a document.
*/ class FieldPath {
/**
* Creates a `FieldPath` from the provided field names. If more than one field
* name is provided, the path will point to a nested field in a document.
*
* @param fieldNames - A list of field names.
*/
constructor(...t) {
for (let e = 0; e < t.length; ++e) if (0 === t[e].length) throw new FirestoreError(T, "Invalid field name at argument $(i + 1). Field names must not be empty.");
this._internalPath = new FieldPath$1(t);
}
/**
* Returns true if this `FieldPath` is equal to the provided one.
*
* @param other - The `FieldPath` to compare against.
* @returns true if this `FieldPath` is equal to the provided one.
*/ isEqual(t) {
return this._internalPath.isEqual(t._internalPath);
}
}
/**
* Returns a special sentinel `FieldPath` to refer to the ID of a document.
* It can be used in queries to sort or filter by the document ID.
*/ function documentId() {
return new FieldPath("__name__");
}
/**
* @license
* Copyright 2020 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.
*/
/**
* Sentinel values that can be used when writing document fields with `set()`
* or `update()`.
*/ class FieldValue {
/**
* @param _methodName - The public API endpoint that returns this class.
* @hideconstructor
*/
constructor(t) {
this._methodName = t;
}
}
/**
* @license
* Copyright 2017 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.
*/
/**
* An immutable object representing a geographic location in Firestore. The
* location is represented as latitude/longitude pair.
*
* Latitude values are in the range of [-90, 90].
* Longitude values are in the range of [-180, 180].
*/ class GeoPoint {
/**
* Creates a new immutable `GeoPoint` object with the provided latitude and
* longitude values.
* @param latitude - The latitude as number between -90 and 90.
* @param longitude - The longitude as number between -180 and 180.
*/
constructor(t, e) {
if (!isFinite(t) || t < -90 || t > 90) throw new FirestoreError(T, "Latitude must be a number between -90 and 90, but was: " + t);
if (!isFinite(e) || e < -180 || e > 180) throw new FirestoreError(T, "Longitude must be a number between -180 and 180, but was: " + e);
this._lat = t, this._long = e;
}
/**
* The latitude of this `GeoPoint` instance.
*/ get latitude() {
return this._lat;
}
/**
* The longitude of this `GeoPoint` instance.
*/ get longitude() {
return this._long;
}
/**
* Returns true if this `GeoPoint` is equal to the provided one.
*
* @param other - The `GeoPoint` to compare against.
* @returns true if this `GeoPoint` is equal to the provided one.
*/ isEqual(t) {
return this._lat === t._lat && this._long === t._long;
}
/** Returns a JSON-serializable representation of this GeoPoint. */ toJSON() {
return {
latitude: this._lat,
longitude: this._long
};
}
/**
* Actually private to JS consumers of our API, so this function is prefixed
* with an underscore.
*/ _compareTo(t) {
return __PRIVATE_primitiveComparator(this._lat, t._lat) || __PRIVATE_primitiveComparator(this._long, t._long);
}
}
/**
* @license
* Copyright 2017 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.
*/ const U = /^__.*__$/;
/** The result of parsing document data (e.g. for a setData call). */ class ParsedSetData {
constructor(t, e, r) {
this.data = t, this.fieldMask = e, this.fieldTransforms = r;
}
toMutation(t, e) {
return null !== this.fieldMask ? new __PRIVATE_PatchMutation(t, this.data, this.fieldMask, e, this.fieldTransforms) : new __PRIVATE_SetMutation(t, this.data, e, this.fieldTransforms);
}
}
/** The result of parsing "update" data (i.e. for an updateData call). */ class ParsedUpdateData {
constructor(t,
// The fieldMask does not include document transforms.
e, r) {
this.data = t, this.fieldMask = e, this.fieldTransforms = r;
}
toMutation(t, e) {
return new __PRIVATE_PatchMutation(t, this.data, this.fieldMask, e, this.fieldTransforms);
}
}
function __PRIVATE_isWrite(t) {
switch (t) {
case 0 /* UserDataSource.Set */ :
// fall through
case 2 /* UserDataSource.MergeSet */ :
// fall through
case 1 /* UserDataSource.Update */ :
return !0;
case 3 /* UserDataSource.Argument */ :
case 4 /* UserDataSource.ArrayArgument */ :
return !1;
default:
throw fail();
}
}
/** A "context" object passed around while parsing user data. */ class __PRIVATE_ParseContextImpl {
/**
* Initializes a ParseContext with the given source and path.
*
* @param settings - The settings for the parser.
* @param databaseId - The database ID of the Firestore instance.
* @param serializer - The serializer to use to generate the Value proto.
* @param ignoreUndefinedProperties - Whether to ignore undefined properties
* rather than throw.
* @param fieldTransforms - A mutable list of field transforms encountered
* while parsing the data.
* @param fieldMask - A mutable list of field paths encountered while parsing
* the data.
*
* TODO(b/34871131): We don't support array paths right now, so path can be
* null to indicate the context represents any location within an array (in
* which case certain features will not work and errors will be somewhat
* compromised).
*/
constructor(t, e, r, n, i, s) {
this.settings = t, this.databaseId = e, this.serializer = r, this.ignoreUndefinedProperties = n,
// Minor hack: If fieldTransforms is undefined, we assume this is an
// external call and we need to validate the entire path.
void 0 === i && this.tt(), this.fieldTransforms = i || [], this.fieldMask = s || [];
}
get path() {
return this.settings.path;
}
get et() {
return this.settings.et;
}
/** Returns a new context with the specified settings overwritten. */ rt(t) {
return new __PRIVATE_ParseContextImpl(Object.assign(Object.assign({}, this.settings), t), this.databaseId, this.serializer, this.ignoreUndefinedProperties, this.fieldTransforms, this.fieldMask);
}
nt(t) {
var e;
const r = null === (e = this.path) || void 0 === e ? void 0 : e.child(t), n = this.rt({
path: r,
it: !1
});
return n.st(t), n;
}
ot(t) {
var e;
const r = null === (e = this.path) || void 0 === e ? void 0 : e.child(t), n = this.rt({
path: r,
it: !1
});
return n.tt(), n;
}
ut(t) {
// TODO(b/34871131): We don't support array paths right now; so make path
// undefined.
return this.rt({
path: void 0,
it: !0
});
}
_t(t) {
return __PRIVATE_createError(t, this.settings.methodName, this.settings.ct || !1, this.path, this.settings.lt);
}
/** Returns 'true' if 'fieldPath' was traversed when creating this context. */ contains(t) {
return void 0 !== this.fieldMask.find((e => t.isPrefixOf(e))) || void 0 !== this.fieldTransforms.find((e => t.isPrefixOf(e.field)));
}
tt() {
// TODO(b/34871131): Remove null check once we have proper paths for fields
// within arrays.
if (this.path) for (let t = 0; t < this.path.length; t++) this.st(this.path.get(t));
}
st(t) {
if (0 === t.length) throw this._t("Document fields must not be empty");
if (__PRIVATE_isWrite(this.et) && U.test(t)) throw this._t('Document fields cannot begin and end with "__"');
}
}
/**
* Helper for parsing raw user input (provided via the API) into internal model
* classes.
*/ class __PRIVATE_UserDataReader {
constructor(t, e, r) {
this.databaseId = t, this.ignoreUndefinedProperties = e, this.serializer = r || __PRIVATE_newSerializer(t);
}
/** Creates a new top-level parse context. */ ht(t, e, r, n = !1) {
return new __PRIVATE_ParseContextImpl({
et: t,
methodName: e,
lt: r,
path: FieldPath$1.emptyPath(),
it: !1,
ct: n
}, this.databaseId, this.serializer, this.ignoreUndefinedProperties);
}
}
function __PRIVATE_newUserDataReader(t) {
const e = t._freezeSettings(), r = __PRIVATE_newSerializer(t._databaseId);
return new __PRIVATE_UserDataReader(t._databaseId, !!e.ignoreUndefinedProperties, r);
}
/** Parse document data from a set() call. */ function __PRIVATE_parseSetData(t, e, r, n, i, s = {}) {
const o = t.ht(s.merge || s.mergeFields ? 2 /* UserDataSource.MergeSet */ : 0 /* UserDataSource.Set */ , e, r, i);
__PRIVATE_validatePlainObject("Data must be an object, but it was:", o, n);
const a = __PRIVATE_parseObject(n, o);
let u, _;
if (s.merge) u = new FieldMask(o.fieldMask), _ = o.fieldTransforms; else if (s.mergeFields) {
const t = [];
for (const n of s.mergeFields) {
const i = __PRIVATE_fieldPathFromArgument$1(e, n, r);
if (!o.contains(i)) throw new FirestoreError(T, `Field '${i}' is specified in your field mask but missing from your input data.`);
__PRIVATE_fieldMaskContains(t, i) || t.push(i);
}
u = new FieldMask(t), _ = o.fieldTransforms.filter((t => u.covers(t.field)));
} else u = null, _ = o.fieldTransforms;
return new ParsedSetData(new ObjectValue(a), u, _);
}
class __PRIVATE_DeleteFieldValueImpl extends FieldValue {
_toFieldTransform(t) {
if (2 /* UserDataSource.MergeSet */ !== t.et) throw 1 /* UserDataSource.Update */ === t.et ? t._t(`${this._methodName}() can only appear at the top level of your update data`) : t._t(`${this._methodName}() cannot be used with set() unless you pass {merge:true}`);
// No transform to add for a delete, but we need to add it to our
// fieldMask so it gets deleted.
return t.fieldMask.push(t.path), null;
}
isEqual(t) {
return t instanceof __PRIVATE_DeleteFieldValueImpl;
}
}
/**
* Creates a child context for parsing SerializableFieldValues.
*
* This is different than calling `ParseContext.contextWith` because it keeps
* the fieldTransforms and fieldMask separate.
*
* The created context has its `dataSource` set to `UserDataSource.Argument`.
* Although these values are used with writes, any elements in these FieldValues
* are not considered writes since they cannot contain any FieldValue sentinels,
* etc.
*
* @param fieldValue - The sentinel FieldValue for which to create a child
* context.
* @param context - The parent context.
* @param arrayElement - Whether or not the FieldValue has an array.
*/ function __PRIVATE_createSentinelChildContext(t, e, r) {
return new __PRIVATE_ParseContextImpl({
et: 3 /* UserDataSource.Argument */ ,
lt: e.settings.lt,
methodName: t._methodName,
it: r
}, e.databaseId, e.serializer, e.ignoreUndefinedProperties);
}
class __PRIVATE_ServerTimestampFieldValueImpl extends FieldValue {
_toFieldTransform(t) {
return new FieldTransform(t.path, new __PRIVATE_ServerTimestampTransform);
}
isEqual(t) {
return t instanceof __PRIVATE_ServerTimestampFieldValueImpl;
}
}
class __PRIVATE_ArrayUnionFieldValueImpl extends FieldValue {
constructor(t, e) {
super(t), this.dt = e;
}
_toFieldTransform(t) {
const e = __PRIVATE_createSentinelChildContext(this, t,
/*array=*/ !0), r = this.dt.map((t => __PRIVATE_parseData(t, e))), n = new __PRIVATE_ArrayUnionTransformOperation(r);
return new FieldTransform(t.path, n);
}
isEqual(t) {
return t instanceof __PRIVATE_ArrayUnionFieldValueImpl && deepEqual(this.dt, t.dt);
}
}
class __PRIVATE_ArrayRemoveFieldValueImpl extends FieldValue {
constructor(t, e) {
super(t), this.dt = e;
}
_toFieldTransform(t) {
const e = __PRIVATE_createSentinelChildContext(this, t,
/*array=*/ !0), r = this.dt.map((t => __PRIVATE_parseData(t, e))), n = new __PRIVATE_ArrayRemoveTransformOperation(r);
return new FieldTransform(t.path, n);
}
isEqual(t) {
return t instanceof __PRIVATE_ArrayRemoveFieldValueImpl && deepEqual(this.dt, t.dt);
}
}
class __PRIVATE_NumericIncrementFieldValueImpl extends FieldValue {
constructor(t, e) {
super(t), this.ft = e;
}
_toFieldTransform(t) {
const e = new __PRIVATE_NumericIncrementTransformOperation(t.serializer, toNumber(t.serializer, this.ft));
return new FieldTransform(t.path, e);
}
isEqual(t) {
return t instanceof __PRIVATE_NumericIncrementFieldValueImpl && this.ft === t.ft;
}
}
/** Parse update data from an update() call. */ function __PRIVATE_parseUpdateData(t, e, r, n) {
const i = t.ht(1 /* UserDataSource.Update */ , e, r);
__PRIVATE_validatePlainObject("Data must be an object, but it was:", i, n);
const s = [], o = ObjectValue.empty();
forEach(n, ((t, n) => {
const a = __PRIVATE_fieldPathFromDotSeparatedString(e, t, r);
// For Compat types, we have to "extract" the underlying types before
// performing validation.
n = getModularInstance(n);
const u = i.ot(a);
if (n instanceof __PRIVATE_DeleteFieldValueImpl)
// Add it to the field mask, but don't add anything to updateData.
s.push(a); else {
const t = __PRIVATE_parseData(n, u);
null != t && (s.push(a), o.set(a, t));
}
}));
const a = new FieldMask(s);
return new ParsedUpdateData(o, a, i.fieldTransforms);
}
/** Parse update data from a list of field/value arguments. */ function __PRIVATE_parseUpdateVarargs(t, e, r, n, i, s) {
const o = t.ht(1 /* UserDataSource.Update */ , e, r), a = [ __PRIVATE_fieldPathFromArgument$1(e, n, r) ], u = [ i ];
if (s.length % 2 != 0) throw new FirestoreError(T, `Function ${e}() needs to be called with an even number of arguments that alternate between field names and values.`);
for (let t = 0; t < s.length; t += 2) a.push(__PRIVATE_fieldPathFromArgument$1(e, s[t])),
u.push(s[t + 1]);
const _ = [], c = ObjectValue.empty();
// We iterate in reverse order to pick the last value for a field if the
// user specified the field multiple times.
for (let t = a.length - 1; t >= 0; --t) if (!__PRIVATE_fieldMaskContains(_, a[t])) {
const e = a[t];
let r = u[t];
// For Compat types, we have to "extract" the underlying types before
// performing validation.
r = getModularInstance(r);
const n = o.ot(e);
if (r instanceof __PRIVATE_DeleteFieldValueImpl)
// Add it to the field mask, but don't add anything to updateData.
_.push(e); else {
const t = __PRIVATE_parseData(r, n);
null != t && (_.push(e), c.set(e, t));
}
}
const h = new FieldMask(_);
return new ParsedUpdateData(c, h, o.fieldTransforms);
}
/**
* Parse a "query value" (e.g. value in a where filter or a value in a cursor
* bound).
*
* @param allowArrays - Whether the query value is an array that may directly
* contain additional arrays (e.g. the operand of an `in` query).
*/ function __PRIVATE_parseQueryValue(t, e, r, n = !1) {
return __PRIVATE_parseData(r, t.ht(n ? 4 /* UserDataSource.ArrayArgument */ : 3 /* UserDataSource.Argument */ , e));
}
/**
* Parses user data to Protobuf Values.
*
* @param input - Data to be parsed.
* @param context - A context object representing the current path being parsed,
* the source of the data being parsed, etc.
* @returns The parsed value, or null if the value was a FieldValue sentinel
* that should not be included in the resulting parsed data.
*/ function __PRIVATE_parseData(t, e) {
if (__PRIVATE_looksLikeJsonObject(
// Unwrap the API type from the Compat SDK. This will return the API type
// from firestore-exp.
t = getModularInstance(t))) return __PRIVATE_validatePlainObject("Unsupported field value:", e, t),
__PRIVATE_parseObject(t, e);
if (t instanceof FieldValue)
// FieldValues usually parse into transforms (except deleteField())
// in which case we do not want to include this field in our parsed data
// (as doing so will overwrite the field directly prior to the transform
// trying to transform it). So we don't add this location to
// context.fieldMask and we return null as our parsing result.
/**
* "Parses" the provided FieldValueImpl, adding any necessary transforms to
* context.fieldTransforms.
*/
return function __PRIVATE_parseSentinelFieldValue(t, e) {
// Sentinels are only supported with writes, and not within arrays.
if (!__PRIVATE_isWrite(e.et)) throw e._t(`${t._methodName}() can only be used with update() and set()`);
if (!e.path) throw e._t(`${t._methodName}() is not currently supported inside arrays`);
const r = t._toFieldTransform(e);
r && e.fieldTransforms.push(r);
}
/**
* Helper to parse a scalar value (i.e. not an Object, Array, or FieldValue)
*
* @returns The parsed value
*/ (t, e), null;
if (void 0 === t && e.ignoreUndefinedProperties)
// If the input is undefined it can never participate in the fieldMask, so
// don't handle this below. If `ignoreUndefinedProperties` is false,
// `parseScalarValue` will reject an undefined value.
return null;
if (
// If context.path is null we are inside an array and we don't support
// field mask paths more granular than the top-level array.
e.path && e.fieldMask.push(e.path), t instanceof Array) {
// TODO(b/34871131): Include the path containing the array in the error
// message.
// In the case of IN queries, the parsed data is an array (representing
// the set of values to be included for the IN query) that may directly
// contain additional arrays (each representing an individual field
// value), so we disable this validation.
if (e.settings.it && 4 /* UserDataSource.ArrayArgument */ !== e.et) throw e._t("Nested arrays are not supported");
return function __PRIVATE_parseArray(t, e) {
const r = [];
let n = 0;
for (const i of t) {
let t = __PRIVATE_parseData(i, e.ut(n));
null == t && (
// Just include nulls in the array for fields being replaced with a
// sentinel.
t = {
nullValue: "NULL_VALUE"
}), r.push(t), n++;
}
return {
arrayValue: {
values: r
}
};
}(t, e);
}
return function __PRIVATE_parseScalarValue(t, e) {
if (null === (t = getModularInstance(t))) return {
nullValue: "NULL_VALUE"
};
if ("number" == typeof t) return toNumber(e.serializer, t);
if ("boolean" == typeof t) return {
booleanValue: t
};
if ("string" == typeof t) return {
stringValue: t
};
if (t instanceof Date) {
const r = Timestamp.fromDate(t);
return {
timestampValue: toTimestamp(e.serializer, r)
};
}
if (t instanceof Timestamp) {
// Firestore backend truncates precision down to microseconds. To ensure
// offline mode works the same with regards to truncation, perform the
// truncation immediately without waiting for the backend to do that.
const r = new Timestamp(t.seconds, 1e3 * Math.floor(t.nanoseconds / 1e3));
return {
timestampValue: toTimestamp(e.serializer, r)
};
}
if (t instanceof GeoPoint) return {
geoPointValue: {
latitude: t.latitude,
longitude: t.longitude
}
};
if (t instanceof Bytes) return {
bytesValue: __PRIVATE_toBytes(e.serializer, t._byteString)
};
if (t instanceof DocumentReference) {
const r = e.databaseId, n = t.firestore._databaseId;
if (!n.isEqual(r)) throw e._t(`Document reference is for database ${n.projectId}/${n.database} but should be for database ${r.projectId}/${r.database}`);
return {
referenceValue: __PRIVATE_toResourceName(t.firestore._databaseId || e.databaseId, t._key.path)
};
}
throw e._t(`Unsupported field value: ${__PRIVATE_valueDescription(t)}`);
}
/**
* Checks whether an object looks like a JSON object that should be converted
* into a struct. Normal class/prototype instances are considered to look like
* JSON objects since they should be converted to a struct value. Arrays, Dates,
* GeoPoints, etc. are not considered to look like JSON objects since they map
* to specific FieldValue types other than ObjectValue.
*/ (t, e);
}
function __PRIVATE_parseObject(t, e) {
const r = {};
return !function isEmpty(t) {
for (const e in t) if (Object.prototype.hasOwnProperty.call(t, e)) return !1;
return !0;
}(t) ? forEach(t, ((t, n) => {
const i = __PRIVATE_parseData(n, e.nt(t));
null != i && (r[t] = i);
})) :
// If we encounter an empty object, we explicitly add it to the update
// mask to ensure that the server creates a map entry.
e.path && e.path.length > 0 && e.fieldMask.push(e.path), {
mapValue: {
fields: r
}
};
}
function __PRIVATE_looksLikeJsonObject(t) {
return !("object" != typeof t || null === t || t instanceof Array || t instanceof Date || t instanceof Timestamp || t instanceof GeoPoint || t instanceof Bytes || t instanceof DocumentReference || t instanceof FieldValue);
}
function __PRIVATE_validatePlainObject(t, e, r) {
if (!__PRIVATE_looksLikeJsonObject(r) || !function __PRIVATE_isPlainObject(t) {
return "object" == typeof t && null !== t && (Object.getPrototypeOf(t) === Object.prototype || null === Object.getPrototypeOf(t));
}(r)) {
const n = __PRIVATE_valueDescription(r);
throw "an object" === n ? e._t(t + " a custom object") : e._t(t + " " + n);
}
}
/**
* Helper that calls fromDotSeparatedString() but wraps any error thrown.
*/ function __PRIVATE_fieldPathFromArgument$1(t, e, r) {
if ((
// If required, replace the FieldPath Compat class with with the firestore-exp
// FieldPath.
e = getModularInstance(e)) instanceof FieldPath) return e._internalPath;
if ("string" == typeof e) return __PRIVATE_fieldPathFromDotSeparatedString(t, e);
throw __PRIVATE_createError("Field path arguments must be of type string or ", t,
/* hasConverter= */ !1,
/* path= */ void 0, r);
}
/**
* Matches any characters in a field path string that are reserved.
*/ const j = new RegExp("[~\\*/\\[\\]]");
/**
* Wraps fromDotSeparatedString with an error message about the method that
* was thrown.
* @param methodName - The publicly visible method name
* @param path - The dot-separated string form of a field path which will be
* split on dots.
* @param targetDoc - The document against which the field path will be
* evaluated.
*/ function __PRIVATE_fieldPathFromDotSeparatedString(t, e, r) {
if (e.search(j) >= 0) throw __PRIVATE_createError(`Invalid field path (${e}). Paths must not contain '~', '*', '/', '[', or ']'`, t,
/* hasConverter= */ !1,
/* path= */ void 0, r);
try {
return new FieldPath(...e.split("."))._internalPath;
} catch (n) {
throw __PRIVATE_createError(`Invalid field path (${e}). Paths must not be empty, begin with '.', end with '.', or contain '..'`, t,
/* hasConverter= */ !1,
/* path= */ void 0, r);
}
}
function __PRIVATE_createError(t, e, r, n, i) {
const s = n && !n.isEmpty(), o = void 0 !== i;
let a = `Function ${e}() called with invalid data`;
r && (a += " (via `toFirestore()`)"), a += ". ";
let u = "";
return (s || o) && (u += " (found", s && (u += ` in field ${n}`), o && (u += ` in document ${i}`),
u += ")"), new FirestoreError(T, a + t + u);
}
/** Checks `haystack` if FieldPath `needle` is present. Runs in O(n). */ function __PRIVATE_fieldMaskContains(t, e) {
return t.some((t => t.isEqual(e)));
}
/**
* @license
* Copyright 2020 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.
*/
/**
* A `DocumentSnapshot` contains data read from a document in your Firestore
* database. The data can be extracted with `.data()` or `.get()` to
* get a specific field.
*
* For a `DocumentSnapshot` that points to a non-existing document, any data
* access will return 'undefined'. You can use the `exists()` method to
* explicitly verify a document's existence.
*/ class DocumentSnapshot {
// Note: This class is stripped down version of the DocumentSnapshot in
// the legacy SDK. The changes are:
// - No support for SnapshotMetadata.
// - No support for SnapshotOptions.
/** @hideconstructor protected */
constructor(t, e, r, n, i) {
this._firestore = t, this._userDataWriter = e, this._key = r, this._document = n,
this._converter = i;
}
/** Property of the `DocumentSnapshot` that provides the document's ID. */ get id() {
return this._key.path.lastSegment();
}
/**
* The `DocumentReference` for the document included in the `DocumentSnapshot`.
*/ get ref() {
return new DocumentReference(this._firestore, this._converter, this._key);
}
/**
* Signals whether or not the document at the snapshot's location exists.
*
* @returns true if the document exists.
*/ exists() {
return null !== this._document;
}
/**
* Retrieves all fields in the document as an `Object`. Returns `undefined` if
* the document doesn't exist.
*
* @returns An `Object` containing all fields in the document or `undefined`
* if the document doesn't exist.
*/ data() {
if (this._document) {
if (this._converter) {
// We only want to use the converter and create a new DocumentSnapshot
// if a converter has been provided.
const t = new QueryDocumentSnapshot(this._firestore, this._userDataWriter, this._key, this._document,
/* converter= */ null);
return this._converter.fromFirestore(t);
}
return this._userDataWriter.convertValue(this._document.data.value);
}
}
/**
* Retrieves the field specified by `fieldPath`. Returns `undefined` if the
* document or field doesn't exist.
*
* @param fieldPath - The path (for example 'foo' or 'foo.bar') to a specific
* field.
* @returns The data at the specified field location or undefined if no such
* field exists in the document.
*/
// We are using `any` here to avoid an explicit cast by our users.
// eslint-disable-next-line @typescript-eslint/no-explicit-any
get(t) {
if (this._document) {
const e = this._document.data.field(__PRIVATE_fieldPathFromArgument("DocumentSnapshot.get", t));
if (null !== e) return this._userDataWriter.convertValue(e);
}
}
}
/**
* A `QueryDocumentSnapshot` contains data read from a document in your
* Firestore database as part of a query. The document is guaranteed to exist
* and its data can be extracted with `.data()` or `.get()` to get a
* specific field.
*
* A `QueryDocumentSnapshot` offers the same API surface as a
* `DocumentSnapshot`. Since query results contain only existing documents, the
* `exists` property will always be true and `data()` will never return
* 'undefined'.
*/ class QueryDocumentSnapshot extends DocumentSnapshot {
/**
* Retrieves all fields in the document as an `Object`.
*
* @override
* @returns An `Object` containing all fields in the document.
*/
data() {
return super.data();
}
}
/**
* A `QuerySnapshot` contains zero or more `DocumentSnapshot` objects
* representing the results of a query. The documents can be accessed as an
* array via the `docs` property or enumerated using the `forEach` method. The
* number of documents can be determined via the `empty` and `size`
* properties.
*/ class QuerySnapshot {
/** @hideconstructor */
constructor(t, e) {
this._docs = e, this.query = t;
}
/** An array of all the documents in the `QuerySnapshot`. */ get docs() {
return [ ...this._docs ];
}
/** The number of documents in the `QuerySnapshot`. */ get size() {
return this.docs.length;
}
/** True if there are no documents in the `QuerySnapshot`. */ get empty() {
return 0 === this.docs.length;
}
/**
* Enumerates all of the documents in the `QuerySnapshot`.
*
* @param callback - A callback to be called with a `QueryDocumentSnapshot` for
* each document in the snapshot.
* @param thisArg - The `this` binding for the callback.
*/ forEach(t, e) {
this._docs.forEach(t, e);
}
}
/**
* Returns true if the provided snapshots are equal.
*
* @param left - A snapshot to compare.
* @param right - A snapshot to compare.
* @returns true if the snapshots are equal.
*/ function snapshotEqual(t, e) {
return t = getModularInstance(t), e = getModularInstance(e), t instanceof DocumentSnapshot && e instanceof DocumentSnapshot ? t._firestore === e._firestore && t._key.isEqual(e._key) && (null === t._document ? null === e._document : t._document.isEqual(e._document)) && t._converter === e._converter : t instanceof QuerySnapshot && e instanceof QuerySnapshot && (queryEqual(t.query, e.query) && __PRIVATE_arrayEquals(t.docs, e.docs, snapshotEqual));
}
/**
* Helper that calls `fromDotSeparatedString()` but wraps any error thrown.
*/ function __PRIVATE_fieldPathFromArgument(t, e) {
return "string" == typeof e ? __PRIVATE_fieldPathFromDotSeparatedString(t, e) : e instanceof FieldPath ? e._internalPath : e._delegate._internalPath;
}
/**
* @license
* Copyright 2020 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.
*/
/**
* An `AppliableConstraint` is an abstraction of a constraint that can be applied
* to a Firestore query.
*/
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: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 {}
function query(t, e, ...r) {
let n = [];
e instanceof AppliableConstraint && n.push(e), n = n.concat(r), function __PRIVATE_validateQueryConstraintArray(t) {
const e = t.filter((t => t instanceof QueryCompositeFilterConstraint)).length, r = t.filter((t => t instanceof QueryFieldFilterConstraint)).length;
if (e > 1 || e > 0 && r > 0) throw new FirestoreError(T, "InvalidQuery. When using composite filters, you cannot use more than one filter at the top level. Consider nesting the multiple filters within an `and(...)` statement. For example: change `query(query, where(...), or(...))` to `query(query, and(where(...), or(...)))`.");
}
/**
* @license
* Copyright 2020 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.
*/
/**
* Converts Firestore's internal types to the JavaScript types that we expose
* to the user.
*
* @internal
*/ (n);
for (const e of n) t = e._apply(t);
return t;
}
/**
* 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:1)} to create a new query instance that also contains
* this `QueryFieldFilterConstraint`.
*/ class QueryFieldFilterConstraint extends QueryConstraint {
/**
* @internal
*/
constructor(t, e, r) {
super(), this._field = t, this._op = e, this._value = r,
/** The type of this query constraint */
this.type = "where";
}
static _create(t, e, r) {
return new QueryFieldFilterConstraint(t, e, r);
}
_apply(t) {
const e = this._parse(t);
return __PRIVATE_validateNewFieldFilter(t._query, e), new Query(t.firestore, t.converter, __PRIVATE_queryWithAddedFilter(t._query, e));
}
_parse(t) {
const e = __PRIVATE_newUserDataReader(t.firestore), r = function __PRIVATE_newQueryFilter(t, e, r, n, i, s, o) {
let a;
if (i.isKeyField()) {
if ("array-contains" /* Operator.ARRAY_CONTAINS */ === s || "array-contains-any" /* Operator.ARRAY_CONTAINS_ANY */ === s) throw new FirestoreError(T, `Invalid Query. You can't perform '${s}' queries on documentId().`);
if ("in" /* Operator.IN */ === s || "not-in" /* Operator.NOT_IN */ === s) {
__PRIVATE_validateDisjunctiveFilterElements(o, s);
const e = [];
for (const r of o) e.push(__PRIVATE_parseDocumentIdValue(n, t, r));
a = {
arrayValue: {
values: e
}
};
} else a = __PRIVATE_parseDocumentIdValue(n, t, o);
} else "in" /* Operator.IN */ !== s && "not-in" /* Operator.NOT_IN */ !== s && "array-contains-any" /* Operator.ARRAY_CONTAINS_ANY */ !== s || __PRIVATE_validateDisjunctiveFilterElements(o, s),
a = __PRIVATE_parseQueryValue(r, e, o,
/* allowArrays= */ "in" /* Operator.IN */ === s || "not-in" /* Operator.NOT_IN */ === s);
return FieldFilter.create(i, s, a);
}(t._query, "where", e, t.firestore._databaseId, this._field, this._op, this._value);
return r;
}
}
/**
* Creates a {@link QueryFieldFilterConstraint} that enforces that documents
* must contain the specified field and that the value should satisfy the
* relation constraint provided.
*
* @param fieldPath - The path to compare
* @param opStr - The operation string (e.g "<", "<=", "==", "<",
* "<=", "!=").
* @param value - The value for comparison
* @returns The created {@link QueryFieldFilterConstraint}.
*/ function where(t, e, r) {
const n = e, i = __PRIVATE_fieldPathFromArgument("where", t);
return QueryFieldFilterConstraint._create(i, n, r);
}
/**
* A `QueryCompositeFilterConstraint` is used to narrow the set of documents
* 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:1)} to create a new query
* instance that also contains the `QueryCompositeFilterConstraint`.
*/ class QueryCompositeFilterConstraint extends AppliableConstraint {
/**
* @internal
*/
constructor(
/** The type of this query constraint */
t, e) {
super(), this.type = t, this._queryConstraints = e;
}
static _create(t, e) {
return new QueryCompositeFilterConstraint(t, e);
}
_parse(t) {
const e = this._queryConstraints.map((e => e._parse(t))).filter((t => t.getFilters().length > 0));
return 1 === e.length ? e[0] : CompositeFilter.create(e, this._getOperator());
}
_apply(t) {
const e = this._parse(t);
return 0 === e.getFilters().length ? t : (function __PRIVATE_validateNewFilter(t, e) {
let r = t;
const n = e.getFlattenedFilters();
for (const t of n) __PRIVATE_validateNewFieldFilter(r, t), r = __PRIVATE_queryWithAddedFilter(r, t);
}
// Checks if any of the provided filter operators are included in the given list of filters and
// returns the first one that is, or null if none are.
(t._query, e), new Query(t.firestore, t.converter, __PRIVATE_queryWithAddedFilter(t._query, e)));
}
_getQueryConstraints() {
return this._queryConstraints;
}
_getOperator() {
return "and" === this.type ? "and" /* CompositeOperator.AND */ : "or" /* CompositeOperator.OR */;
}
}
/**
* 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 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}.
*/ function or(...t) {
// Only support QueryFilterConstraints
return t.forEach((t => __PRIVATE_validateQueryFilterConstraint("or", t))), QueryCompositeFilterConstraint._create("or" /* CompositeOperator.OR */ , t);
}
/**
* 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 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}.
*/ function and(...t) {
// Only support QueryFilterConstraints
return t.forEach((t => __PRIVATE_validateQueryFilterConstraint("and", t))), QueryCompositeFilterConstraint._create("and" /* CompositeOperator.AND */ , t);
}
/**
* 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: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
* the query result.
*/ class QueryOrderByConstraint extends QueryConstraint {
/**
* @internal
*/
constructor(t, e) {
super(), this._field = t, this._direction = e,
/** The type of this query constraint */
this.type = "orderBy";
}
static _create(t, e) {
return new QueryOrderByConstraint(t, e);
}
_apply(t) {
const e = function __PRIVATE_newQueryOrderBy(t, e, r) {
if (null !== t.startAt) throw new FirestoreError(T, "Invalid query. You must not call startAt() or startAfter() before calling orderBy().");
if (null !== t.endAt) throw new FirestoreError(T, "Invalid query. You must not call endAt() or endBefore() before calling orderBy().");
return new OrderBy(e, r);
}
/**
* Create a `Bound` from a query and a document.
*
* Note that the `Bound` will always include the key of the document
* and so only the provided document will compare equal to the returned
* position.
*
* Will throw if the document does not contain all fields of the order by
* of the query or if any of the fields in the order by are an uncommitted
* server timestamp.
*/ (t._query, this._field, this._direction);
return new Query(t.firestore, t.converter, function __PRIVATE_queryWithAddedOrderBy(t, e) {
// TODO(dimond): validate that orderBy does not list the same key twice.
const r = t.explicitOrderBy.concat([ e ]);
return new __PRIVATE_QueryImpl(t.path, t.collectionGroup, r, t.filters.slice(), t.limit, t.limitType, t.startAt, t.endAt);
}(t._query, e));
}
}
/**
* Creates a {@link QueryOrderByConstraint} that sorts the query result by the
* specified field, optionally in descending order instead of ascending.
*
* Note: Documents that do not contain the specified field will not be present
* in the query result.
*
* @param fieldPath - The field to sort by.
* @param directionStr - Optional direction to sort by ('asc' or 'desc'). If
* not specified, order will be ascending.
* @returns The created {@link QueryOrderByConstraint}.
*/ function orderBy(t, e = "asc") {
const r = e, n = __PRIVATE_fieldPathFromArgument("orderBy", t);
return QueryOrderByConstraint._create(n, r);
}
/**
* 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:1)} to create a new
* query instance that also contains this `QueryLimitConstraint`.
*/ class QueryLimitConstraint extends QueryConstraint {
/**
* @internal
*/
constructor(
/** The type of this query constraint */
t, e, r) {
super(), this.type = t, this._limit = e, this._limitType = r;
}
static _create(t, e, r) {
return new QueryLimitConstraint(t, e, r);
}
_apply(t) {
return new Query(t.firestore, t.converter, function __PRIVATE_queryWithLimit(t, e, r) {
return new __PRIVATE_QueryImpl(t.path, t.collectionGroup, t.explicitOrderBy.slice(), t.filters.slice(), e, r, t.startAt, t.endAt);
}(t._query, this._limit, this._limitType));
}
}
/**
* Creates a {@link QueryLimitConstraint} that only returns the first matching
* documents.
*
* @param limit - The maximum number of items to return.
* @returns The created {@link QueryLimitConstraint}.
*/ function limit(t) {
return __PRIVATE_validatePositiveNumber("limit", t), QueryLimitConstraint._create("limit", t, "F" /* LimitType.First */);
}
/**
* Creates a {@link QueryLimitConstraint} that only returns the last matching
* documents.
*
* You must specify at least one `orderBy` clause for `limitToLast` queries,
* otherwise an exception will be thrown during execution.
*
* @param limit - The maximum number of items to return.
* @returns The created {@link QueryLimitConstraint}.
*/ function limitToLast(t) {
return __PRIVATE_validatePositiveNumber("limitToLast", t), QueryLimitConstraint._create("limitToLast", t, "L" /* LimitType.Last */);
}
/**
* 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:1)} to create a
* new query instance that also contains this `QueryStartAtConstraint`.
*/ class QueryStartAtConstraint extends QueryConstraint {
/**
* @internal
*/
constructor(
/** The type of this query constraint */
t, e, r) {
super(), this.type = t, this._docOrFields = e, this._inclusive = r;
}
static _create(t, e, r) {
return new QueryStartAtConstraint(t, e, r);
}
_apply(t) {
const e = __PRIVATE_newQueryBoundFromDocOrFields(t, this.type, this._docOrFields, this._inclusive);
return new Query(t.firestore, t.converter, function __PRIVATE_queryWithStartAt(t, e) {
return new __PRIVATE_QueryImpl(t.path, t.collectionGroup, t.explicitOrderBy.slice(), t.filters.slice(), t.limit, t.limitType, e, t.endAt);
}(t._query, e));
}
}
function startAt(...t) {
return QueryStartAtConstraint._create("startAt", t,
/*inclusive=*/ !0);
}
function startAfter(...t) {
return QueryStartAtConstraint._create("startAfter", t,
/*inclusive=*/ !1);
}
/**
* 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:1)} to create a new
* query instance that also contains this `QueryEndAtConstraint`.
*/ class QueryEndAtConstraint extends QueryConstraint {
/**
* @internal
*/
constructor(
/** The type of this query constraint */
t, e, r) {
super(), this.type = t, this._docOrFields = e, this._inclusive = r;
}
static _create(t, e, r) {
return new QueryEndAtConstraint(t, e, r);
}
_apply(t) {
const e = __PRIVATE_newQueryBoundFromDocOrFields(t, this.type, this._docOrFields, this._inclusive);
return new Query(t.firestore, t.converter, function __PRIVATE_queryWithEndAt(t, e) {
return new __PRIVATE_QueryImpl(t.path, t.collectionGroup, t.explicitOrderBy.slice(), t.filters.slice(), t.limit, t.limitType, t.startAt, e);
}(t._query, e));
}
}
function endBefore(...t) {
return QueryEndAtConstraint._create("endBefore", t,
/*inclusive=*/ !1);
}
function endAt(...t) {
return QueryEndAtConstraint._create("endAt", t,
/*inclusive=*/ !0);
}
/** Helper function to create a bound from a document or fields */ function __PRIVATE_newQueryBoundFromDocOrFields(t, e, r, n) {
if (r[0] = getModularInstance(r[0]), r[0] instanceof DocumentSnapshot) return function __PRIVATE_newQueryBoundFromDocument(t, e, r, n, i) {
if (!n) throw new FirestoreError(P, `Can't use a DocumentSnapshot that doesn't exist for ${r}().`);
const s = [];
// Because people expect to continue/end a query at the exact document
// provided, we need to use the implicit sort order rather than the explicit
// sort order, because it's guaranteed to contain the document key. That way
// the position becomes unambiguous and the query continues/ends exactly at
// the provided document. Without the key (by using the explicit sort
// orders), multiple documents could match the position, yielding duplicate
// results.
for (const r of __PRIVATE_queryNormalizedOrderBy(t)) if (r.field.isKeyField()) s.push(__PRIVATE_refValue(e, n.key)); else {
const t = n.data.field(r.field);
if (__PRIVATE_isServerTimestamp(t)) throw new FirestoreError(T, 'Invalid query. You are trying to start or end a query using a document for which the field "' + r.field + '" is an uncommitted server timestamp. (Since the value of this field is unknown, you cannot start/end a query with it.)');
if (null === t) {
const t = r.field.canonicalString();
throw new FirestoreError(T, `Invalid query. You are trying to start or end a query using a document for which the field '${t}' (used as the orderBy) does not exist.`);
}
s.push(t);
}
return new Bound(s, i);
}
/**
* Converts a list of field values to a `Bound` for the given query.
*/ (t._query, t.firestore._databaseId, e, r[0]._document, n);
{
const i = __PRIVATE_newUserDataReader(t.firestore);
return function __PRIVATE_newQueryBoundFromFields(t, e, r, n, i, s) {
// Use explicit order by's because it has to match the query the user made
const o = t.explicitOrderBy;
if (i.length > o.length) throw new FirestoreError(T, `Too many arguments provided to ${n}(). The number of arguments must be less than or equal to the number of orderBy() clauses`);
const a = [];
for (let s = 0; s < i.length; s++) {
const u = i[s];
if (o[s].field.isKeyField()) {
if ("string" != typeof u) throw new FirestoreError(T, `Invalid query. Expected a string for document ID in ${n}(), but got a ${typeof u}`);
if (!__PRIVATE_isCollectionGroupQuery(t) && -1 !== u.indexOf("/")) throw new FirestoreError(T, `Invalid query. When querying a collection and ordering by documentId(), the value passed to ${n}() must be a plain document ID, but '${u}' contains a slash.`);
const r = t.path.child(ResourcePath.fromString(u));
if (!DocumentKey.isDocumentKey(r)) throw new FirestoreError(T, `Invalid query. When querying a collection group and ordering by documentId(), the value passed to ${n}() must result in a valid document path, but '${r}' is not because it contains an odd number of segments.`);
const i = new DocumentKey(r);
a.push(__PRIVATE_refValue(e, i));
} else {
const t = __PRIVATE_parseQueryValue(r, n, u);
a.push(t);
}
}
return new Bound(a, s);
}
/**
* Parses the given `documentIdValue` into a `ReferenceValue`, throwing
* appropriate errors if the value is anything other than a `DocumentReference`
* or `string`, or if the string is malformed.
*/ (t._query, t.firestore._databaseId, i, e, r, n);
}
}
function __PRIVATE_parseDocumentIdValue(t, e, r) {
if ("string" == typeof (r = getModularInstance(r))) {
if ("" === r) throw new FirestoreError(T, "Invalid query. When querying with documentId(), you must provide a valid document ID, but it was an empty string.");
if (!__PRIVATE_isCollectionGroupQuery(e) && -1 !== r.indexOf("/")) throw new FirestoreError(T, `Invalid query. When querying a collection by documentId(), you must provide a plain document ID, but '${r}' contains a '/' character.`);
const n = e.path.child(ResourcePath.fromString(r));
if (!DocumentKey.isDocumentKey(n)) throw new FirestoreError(T, `Invalid query. When querying a collection group by documentId(), the value provided must result in a valid document path, but '${n}' is not because it has an odd number of segments (${n.length}).`);
return __PRIVATE_refValue(t, new DocumentKey(n));
}
if (r instanceof DocumentReference) return __PRIVATE_refValue(t, r._key);
throw new FirestoreError(T, `Invalid query. When querying with documentId(), you must provide a valid string or a DocumentReference, but it was: ${__PRIVATE_valueDescription(r)}.`);
}
/**
* Validates that the value passed into a disjunctive filter satisfies all
* array requirements.
*/ function __PRIVATE_validateDisjunctiveFilterElements(t, e) {
if (!Array.isArray(t) || 0 === t.length) throw new FirestoreError(T, `Invalid Query. A non-empty array is required for '${e.toString()}' filters.`);
}
/**
* Given an operator, returns the set of operators that cannot be used with it.
*
* This is not a comprehensive check, and this function should be removed in the
* long term. Validations should occur in the Firestore backend.
*
* Operators in a query must adhere to the following set of rules:
* 1. Only one inequality per query.
* 2. `NOT_IN` cannot be used with array, disjunctive, or `NOT_EQUAL` operators.
*/ function __PRIVATE_validateNewFieldFilter(t, e) {
const r = function __PRIVATE_findOpInsideFilters(t, e) {
for (const r of t) for (const t of r.getFlattenedFilters()) if (e.indexOf(t.op) >= 0) return t.op;
return null;
}(t.filters, function __PRIVATE_conflictingOps(t) {
switch (t) {
case "!=" /* Operator.NOT_EQUAL */ :
return [ "!=" /* Operator.NOT_EQUAL */ , "not-in" /* Operator.NOT_IN */ ];
case "array-contains-any" /* Operator.ARRAY_CONTAINS_ANY */ :
case "in" /* Operator.IN */ :
return [ "not-in" /* Operator.NOT_IN */ ];
case "not-in" /* Operator.NOT_IN */ :
return [ "array-contains-any" /* Operator.ARRAY_CONTAINS_ANY */ , "in" /* Operator.IN */ , "not-in" /* Operator.NOT_IN */ , "!=" /* Operator.NOT_EQUAL */ ];
default:
return [];
}
}(e.op));
if (null !== r)
// Special case when it's a duplicate op to give a slightly clearer error message.
throw r === e.op ? new FirestoreError(T, `Invalid query. You cannot use more than one '${e.op.toString()}' filter.`) : new FirestoreError(T, `Invalid query. You cannot use '${e.op.toString()}' filters with '${r.toString()}' filters.`);
}
function __PRIVATE_validateQueryFilterConstraint(t, e) {
if (!(e instanceof QueryFieldFilterConstraint || e instanceof QueryCompositeFilterConstraint)) throw new FirestoreError(T, `Function ${t}() requires AppliableConstraints created with a call to 'where(...)', 'or(...)', or 'and(...)'.`);
}
/**
* @license
* Copyright 2020 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.
*/
/**
* Converts custom model object of type T into `DocumentData` by applying the
* converter if it exists.
*
* This function is used when converting user objects to `DocumentData`
* because we want to provide the user with a more specific error message if
* their `set()` or fails due to invalid data originating from a `toFirestore()`
* call.
*/
function __PRIVATE_applyFirestoreDataConverter(t, e, r) {
let n;
// Cast to `any` in order to satisfy the union type constraint on
// toFirestore().
// eslint-disable-next-line @typescript-eslint/no-explicit-any
return n = t ? r && (r.merge || r.mergeFields) ? t.toFirestore(e, r) : t.toFirestore(e) : e,
n;
}
class __PRIVATE_LiteUserDataWriter extends class AbstractUserDataWriter {
convertValue(t, e = "none") {
switch (__PRIVATE_typeOrder(t)) {
case 0 /* TypeOrder.NullValue */ :
return null;
case 1 /* TypeOrder.BooleanValue */ :
return t.booleanValue;
case 2 /* TypeOrder.NumberValue */ :
return __PRIVATE_normalizeNumber(t.integerValue || t.doubleValue);
case 3 /* TypeOrder.TimestampValue */ :
return this.convertTimestamp(t.timestampValue);
case 4 /* TypeOrder.ServerTimestampValue */ :
return this.convertServerTimestamp(t, e);
case 5 /* TypeOrder.StringValue */ :
return t.stringValue;
case 6 /* TypeOrder.BlobValue */ :
return this.convertBytes(__PRIVATE_normalizeByteString(t.bytesValue));
case 7 /* TypeOrder.RefValue */ :
return this.convertReference(t.referenceValue);
case 8 /* TypeOrder.GeoPointValue */ :
return this.convertGeoPoint(t.geoPointValue);
case 9 /* TypeOrder.ArrayValue */ :
return this.convertArray(t.arrayValue, e);
case 10 /* TypeOrder.ObjectValue */ :
return this.convertObject(t.mapValue, e);
default:
throw fail();
}
}
convertObject(t, e) {
return this.convertObjectMap(t.fields, e);
}
/**
* @internal
*/ convertObjectMap(t, e = "none") {
const r = {};
return forEach(t, ((t, n) => {
r[t] = this.convertValue(n, e);
})), r;
}
convertGeoPoint(t) {
return new GeoPoint(__PRIVATE_normalizeNumber(t.latitude), __PRIVATE_normalizeNumber(t.longitude));
}
convertArray(t, e) {
return (t.values || []).map((t => this.convertValue(t, e)));
}
convertServerTimestamp(t, e) {
switch (e) {
case "previous":
const r = __PRIVATE_getPreviousValue(t);
return null == r ? null : this.convertValue(r, e);
case "estimate":
return this.convertTimestamp(__PRIVATE_getLocalWriteTime(t));
default:
return null;
}
}
convertTimestamp(t) {
const e = __PRIVATE_normalizeTimestamp(t);
return new Timestamp(e.seconds, e.nanos);
}
convertDocumentKey(t, e) {
const r = ResourcePath.fromString(t);
__PRIVATE_hardAssert(__PRIVATE_isValidResourceName(r));
const n = new DatabaseId(r.get(1), r.get(3)), i = new DocumentKey(r.popFirst(5));
return n.isEqual(e) ||
// TODO(b/64130202): Somehow support foreign references.
__PRIVATE_logError(`Document ${i} contains a document reference within a different database (${n.projectId}/${n.database}) which is not supported. It will be treated as a reference in the current database (${e.projectId}/${e.database}) instead.`),
i;
}
} {
constructor(t) {
super(), this.firestore = t;
}
convertBytes(t) {
return new Bytes(t);
}
convertReference(t) {
const e = this.convertDocumentKey(t, this.firestore._databaseId);
return new DocumentReference(this.firestore, /* converter= */ null, e);
}
}
/**
* Reads the document referred to by the specified document reference.
*
* All documents are directly fetched from the server, even if the document was
* previously read or modified. Recent modifications are only reflected in the
* retrieved `DocumentSnapshot` if they have already been applied by the
* backend. If the client is offline, the read fails. If you like to use
* caching or see local modifications, please use the full Firestore SDK.
*
* @param reference - The reference of the document to fetch.
* @returns A Promise resolved with a `DocumentSnapshot` containing the current
* document contents.
*/ function getDoc(t) {
const e = __PRIVATE_getDatastore((t = __PRIVATE_cast(t, DocumentReference)).firestore), r = new __PRIVATE_LiteUserDataWriter(t.firestore);
return __PRIVATE_invokeBatchGetDocumentsRpc(e, [ t._key ]).then((e => {
__PRIVATE_hardAssert(1 === e.length);
const n = e[0];
return new DocumentSnapshot(t.firestore, r, t._key, n.isFoundDocument() ? n : null, t.converter);
}));
}
/**
* Executes the query and returns the results as a {@link QuerySnapshot}.
*
* All queries are executed directly by the server, even if the the query was
* previously executed. Recent modifications are only reflected in the retrieved
* results if they have already been applied by the backend. If the client is
* offline, the operation fails. To see previously cached result and local
* modifications, use the full Firestore SDK.
*
* @param query - The `Query` to execute.
* @returns A Promise that will be resolved with the results of the query.
*/ function getDocs(t) {
(function __PRIVATE_validateHasExplicitOrderByForLimitToLast(t) {
if ("L" /* LimitType.Last */ === t.limitType && 0 === t.explicitOrderBy.length) throw new FirestoreError(v, "limitToLast() queries require specifying at least one orderBy() clause");
})((t = __PRIVATE_cast(t, Query))._query);
const e = __PRIVATE_getDatastore(t.firestore), r = new __PRIVATE_LiteUserDataWriter(t.firestore);
return __PRIVATE_invokeRunQueryRpc(e, t._query).then((e => {
const n = e.map((e => new QueryDocumentSnapshot(t.firestore, r, e.key, e, t.converter)));
return "L" /* LimitType.Last */ === t._query.limitType &&
// Limit to last queries reverse the orderBy constraint that was
// specified by the user. As such, we need to reverse the order of the
// results to return the documents in the expected order.
n.reverse(), new QuerySnapshot(t, n);
}));
}
function setDoc(t, e, r) {
const n = __PRIVATE_applyFirestoreDataConverter((t = __PRIVATE_cast(t, DocumentReference)).converter, e, r), i = __PRIVATE_parseSetData(__PRIVATE_newUserDataReader(t.firestore), "setDoc", t._key, n, null !== t.converter, r);
return __PRIVATE_invokeCommitRpc(__PRIVATE_getDatastore(t.firestore), [ i.toMutation(t._key, Precondition.none()) ]);
}
function updateDoc(t, e, r, ...n) {
const i = __PRIVATE_newUserDataReader((t = __PRIVATE_cast(t, DocumentReference)).firestore);
// For Compat types, we have to "extract" the underlying types before
// performing validation.
let s;
s = "string" == typeof (e = getModularInstance(e)) || e instanceof FieldPath ? __PRIVATE_parseUpdateVarargs(i, "updateDoc", t._key, e, r, n) : __PRIVATE_parseUpdateData(i, "updateDoc", t._key, e);
return __PRIVATE_invokeCommitRpc(__PRIVATE_getDatastore(t.firestore), [ s.toMutation(t._key, Precondition.exists(!0)) ]);
}
/**
* Deletes the document referred to by the specified `DocumentReference`.
*
* The deletion will only be reflected in document reads that occur after the
* returned promise resolves. If the client is offline, the
* delete fails. If you would like to see local modifications or buffer writes
* until the client is online, use the full Firestore SDK.
*
* @param reference - A reference to the document to delete.
* @returns A `Promise` resolved once the document has been successfully
* deleted from the backend.
*/ function deleteDoc(t) {
return __PRIVATE_invokeCommitRpc(__PRIVATE_getDatastore((t = __PRIVATE_cast(t, DocumentReference)).firestore), [ new __PRIVATE_DeleteMutation(t._key, Precondition.none()) ]);
}
/**
* Add a new document to specified `CollectionReference` with the given data,
* assigning it a document ID automatically.
*
* The result of this write will only be reflected in document reads that occur
* after the returned promise resolves. If the client is offline, the
* write fails. If you would like to see local modifications or buffer writes
* until the client is online, use the full Firestore SDK.
*
* @param reference - A reference to the collection to add this document to.
* @param data - An Object containing the data for the new document.
* @throws Error - If the provided input is not a valid Firestore document.
* @returns A `Promise` resolved with a `DocumentReference` pointing to the
* newly created document after it has been written to the backend.
*/ function addDoc(t, e) {
const r = doc(t = __PRIVATE_cast(t, CollectionReference)), n = __PRIVATE_applyFirestoreDataConverter(t.converter, e), i = __PRIVATE_parseSetData(__PRIVATE_newUserDataReader(t.firestore), "addDoc", r._key, n, null !== r.converter, {});
return __PRIVATE_invokeCommitRpc(__PRIVATE_getDatastore(t.firestore), [ i.toMutation(r._key, Precondition.exists(!1)) ]).then((() => r));
}
/**
* @license
* Copyright 2022 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.
*/
/**
* Calculates the number of documents in the result set of the given query
* without actually downloading the documents.
*
* Using this function to count the documents is efficient because only the
* final count, not the documents' data, is downloaded. This function can
* count the documents in cases where the result set is prohibitively large to
* download entirely (thousands of documents).
*
* @param query The query whose result set size is calculated.
* @returns A Promise that will be resolved with the count; the count can be
* retrieved from `snapshot.data().count`, where `snapshot` is the
* `AggregateQuerySnapshot` to which the returned Promise resolves.
*/ function getCount(t) {
return getAggregate(t, {
count: count()
});
}
/**
* Calculates the specified aggregations over the documents in the result
* set of the given query without actually downloading the documents.
*
* Using this function to perform aggregations is efficient because only the
* final aggregation values, not the documents' data, are downloaded. This
* function can perform aggregations of the documents in cases where the result
* set is prohibitively large to download entirely (thousands of documents).
*
* @param query The query whose result set is aggregated over.
* @param aggregateSpec An `AggregateSpec` object that specifies the aggregates
* to perform over the result set. The AggregateSpec specifies aliases for each
* aggregate, which can be used to retrieve the aggregate result.
* @example
* ```typescript
* const aggregateSnapshot = await getAggregate(query, {
* countOfDocs: count(),
* totalHours: sum('hours'),
* averageScore: average('score')
* });
*
* const countOfDocs: number = aggregateSnapshot.data().countOfDocs;
* const totalHours: number = aggregateSnapshot.data().totalHours;
* const averageScore: number | null = aggregateSnapshot.data().averageScore;
* ```
*/ function getAggregate(t, e) {
const r = __PRIVATE_cast(t.firestore, Firestore), n = __PRIVATE_getDatastore(r), i = function __PRIVATE_mapToArray(t, e) {
const r = [];
for (const n in t) Object.prototype.hasOwnProperty.call(t, n) && r.push(e(t[n], n, t));
return r;
}(e, ((t, e) => new __PRIVATE_AggregateImpl(e, t.aggregateType, t._internalFieldPath)));
// Run the aggregation and convert the results
return __PRIVATE_invokeRunAggregationQueryRpc(n, t._query, i).then((e => function __PRIVATE_convertToAggregateQuerySnapshot(t, e, r) {
const n = new __PRIVATE_LiteUserDataWriter(t);
return new AggregateQuerySnapshot(e, n, r);
}
/**
* Create an AggregateField object that can be used to compute the sum of
* a specified field over a range of documents in the result set of a query.
* @param field Specifies the field to sum across the result set.
*/ (r, t, e)));
}
function sum(t) {
return new AggregateField("sum", __PRIVATE_fieldPathFromArgument$1("sum", t));
}
/**
* Create an AggregateField object that can be used to compute the average of
* a specified field over a range of documents in the result set of a query.
* @param field Specifies the field to average across the result set.
*/ function average(t) {
return new AggregateField("avg", __PRIVATE_fieldPathFromArgument$1("average", t));
}
/**
* Create an AggregateField object that can be used to compute the count of
* documents in the result set of a query.
*/ function count() {
return new AggregateField("count");
}
/**
* Compares two 'AggregateField` instances for equality.
*
* @param left Compare this AggregateField to the `right`.
* @param right Compare this AggregateField to the `left`.
*/ function aggregateFieldEqual(t, e) {
var r, n;
return t instanceof AggregateField && e instanceof AggregateField && t.aggregateType === e.aggregateType && (null === (r = t._internalFieldPath) || void 0 === r ? void 0 : r.canonicalString()) === (null === (n = e._internalFieldPath) || void 0 === n ? void 0 : n.canonicalString());
}
/**
* Compares two `AggregateQuerySnapshot` instances for equality.
*
* Two `AggregateQuerySnapshot` instances are considered "equal" if they have
* underlying queries that compare equal, and the same data.
*
* @param left - The first `AggregateQuerySnapshot` to compare.
* @param right - The second `AggregateQuerySnapshot` to compare.
*
* @returns `true` if the objects are "equal", as defined above, or `false`
* otherwise.
*/ function aggregateQuerySnapshotEqual(t, e) {
return queryEqual(t.query, e.query) && deepEqual(t.data(), e.data());
}
/**
* @license
* Copyright 2020 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.
*/
/**
* Returns a sentinel for use with {@link @firebase/firestore/lite#(updateDoc:1)} or
* {@link @firebase/firestore/lite#(setDoc:1)} with `{merge: true}` to mark a field for deletion.
*/ function deleteField() {
return new __PRIVATE_DeleteFieldValueImpl("deleteField");
}
/**
* Returns a sentinel used with {@link @firebase/firestore/lite#(setDoc:1)} or {@link @firebase/firestore/lite#(updateDoc:1)} to
* include a server-generated timestamp in the written data.
*/ function serverTimestamp() {
return new __PRIVATE_ServerTimestampFieldValueImpl("serverTimestamp");
}
/**
* Returns a special value that can be used with {@link @firebase/firestore/lite#(setDoc:1)} or {@link
* @firebase/firestore/lite#(updateDoc:1)} that tells the server to union the given elements with any array
* value that already exists on the server. Each specified element that doesn't
* already exist in the array will be added to the end. If the field being
* modified is not already an array it will be overwritten with an array
* containing exactly the specified elements.
*
* @param elements - The elements to union into the array.
* @returns The `FieldValue` sentinel for use in a call to `setDoc()` or
* `updateDoc()`.
*/ function arrayUnion(...t) {
// NOTE: We don't actually parse the data until it's used in set() or
// update() since we'd need the Firestore instance to do this.
return new __PRIVATE_ArrayUnionFieldValueImpl("arrayUnion", t);
}
/**
* Returns a special value that can be used with {@link (setDoc:1)} or {@link
* updateDoc:1} that tells the server to remove the given elements from any
* array value that already exists on the server. All instances of each element
* specified will be removed from the array. If the field being modified is not
* already an array it will be overwritten with an empty array.
*
* @param elements - The elements to remove from the array.
* @returns The `FieldValue` sentinel for use in a call to `setDoc()` or
* `updateDoc()`
*/ function arrayRemove(...t) {
// NOTE: We don't actually parse the data until it's used in set() or
// update() since we'd need the Firestore instance to do this.
return new __PRIVATE_ArrayRemoveFieldValueImpl("arrayRemove", t);
}
/**
* Returns a special value that can be used with {@link @firebase/firestore/lite#(setDoc:1)} or {@link
* @firebase/firestore/lite#(updateDoc:1)} that tells the server to increment the field's current value by
* the given value.
*
* If either the operand or the current field value uses floating point
* precision, all arithmetic follows IEEE 754 semantics. If both values are
* integers, values outside of JavaScript's safe number range
* (`Number.MIN_SAFE_INTEGER` to `Number.MAX_SAFE_INTEGER`) are also subject to
* precision loss. Furthermore, once processed by the Firestore backend, all
* integer operations are capped between -2^63 and 2^63-1.
*
* If the current field value is not of type `number`, or if the field does not
* yet exist, the transformation sets the field to the given value.
*
* @param n - The value to increment by.
* @returns The `FieldValue` sentinel for use in a call to `setDoc()` or
* `updateDoc()`
*/ function increment(t) {
return new __PRIVATE_NumericIncrementFieldValueImpl("increment", t);
}
/**
* @license
* Copyright 2020 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.
*/
/**
* A write batch, used to perform multiple writes as a single atomic unit.
*
* A `WriteBatch` object can be acquired by calling {@link writeBatch}. It
* provides methods for adding writes to the write batch. None of the writes
* will be committed (or visible locally) until {@link WriteBatch.commit} is
* called.
*/ class WriteBatch {
/** @hideconstructor */
constructor(t, e) {
this._firestore = t, this._commitHandler = e, this._mutations = [], this._committed = !1,
this._dataReader = __PRIVATE_newUserDataReader(t);
}
set(t, e, r) {
this._verifyNotCommitted();
const n = __PRIVATE_validateReference(t, this._firestore), i = __PRIVATE_applyFirestoreDataConverter(n.converter, e, r), s = __PRIVATE_parseSetData(this._dataReader, "WriteBatch.set", n._key, i, null !== n.converter, r);
return this._mutations.push(s.toMutation(n._key, Precondition.none())), this;
}
update(t, e, r, ...n) {
this._verifyNotCommitted();
const i = __PRIVATE_validateReference(t, this._firestore);
// For Compat types, we have to "extract" the underlying types before
// performing validation.
let s;
return s = "string" == typeof (e = getModularInstance(e)) || e instanceof FieldPath ? __PRIVATE_parseUpdateVarargs(this._dataReader, "WriteBatch.update", i._key, e, r, n) : __PRIVATE_parseUpdateData(this._dataReader, "WriteBatch.update", i._key, e),
this._mutations.push(s.toMutation(i._key, Precondition.exists(!0))), this;
}
/**
* Deletes the document referred to by the provided {@link DocumentReference}.
*
* @param documentRef - A reference to the document to be deleted.
* @returns This `WriteBatch` instance. Used for chaining method calls.
*/ delete(t) {
this._verifyNotCommitted();
const e = __PRIVATE_validateReference(t, this._firestore);
return this._mutations = this._mutations.concat(new __PRIVATE_DeleteMutation(e._key, Precondition.none())),
this;
}
/**
* Commits all of the writes in this write batch as a single atomic unit.
*
* The result of these writes will only be reflected in document reads that
* occur after the returned promise resolves. If the client is offline, the
* write fails. If you would like to see local modifications or buffer writes
* until the client is online, use the full Firestore SDK.
*
* @returns A `Promise` resolved once all of the writes in the batch have been
* successfully written to the backend as an atomic unit (note that it won't
* resolve while you're offline).
*/ commit() {
return this._verifyNotCommitted(), this._committed = !0, this._mutations.length > 0 ? this._commitHandler(this._mutations) : Promise.resolve();
}
_verifyNotCommitted() {
if (this._committed) throw new FirestoreError(w, "A write batch can no longer be used after commit() has been called.");
}
}
function __PRIVATE_validateReference(t, e) {
if ((t = getModularInstance(t)).firestore !== e) throw new FirestoreError(T, "Provided document reference is from a different Firestore instance.");
return t;
}
/**
* Creates a write batch, used for performing multiple writes as a single
* atomic operation. The maximum number of writes allowed in a single WriteBatch
* is 500.
*
* The result of these writes will only be reflected in document reads that
* occur after the returned promise resolves. If the client is offline, the
* write fails. If you would like to see local modifications or buffer writes
* until the client is online, use the full Firestore SDK.
*
* @returns A `WriteBatch` that can be used to atomically execute multiple
* writes.
*/ function writeBatch(t) {
const e = __PRIVATE_getDatastore(t = __PRIVATE_cast(t, Firestore));
return new WriteBatch(t, (t => __PRIVATE_invokeCommitRpc(e, t)));
}
/**
* @license
* Copyright 2017 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.
*/
/**
* Internal transaction object responsible for accumulating the mutations to
* perform and the base versions for any documents read.
*/ class Transaction$1 {
constructor(t) {
this.datastore = t,
// The version of each document that was read during this transaction.
this.readVersions = new Map, this.mutations = [], this.committed = !1,
/**
* A deferred usage error that occurred previously in this transaction that
* will cause the transaction to fail once it actually commits.
*/
this.lastTransactionError = null,
/**
* Set of documents that have been written in the transaction.
*
* When there's more than one write to the same key in a transaction, any
* writes after the first are handled differently.
*/
this.writtenDocs = new Set;
}
async lookup(t) {
if (this.ensureCommitNotCalled(), this.mutations.length > 0) throw this.lastTransactionError = new FirestoreError(T, "Firestore transactions require all reads to be executed before all writes."),
this.lastTransactionError;
const e = await __PRIVATE_invokeBatchGetDocumentsRpc(this.datastore, t);
return e.forEach((t => this.recordVersion(t))), e;
}
set(t, e) {
this.write(e.toMutation(t, this.precondition(t))), this.writtenDocs.add(t.toString());
}
update(t, e) {
try {
this.write(e.toMutation(t, this.preconditionForUpdate(t)));
} catch (t) {
this.lastTransactionError = t;
}
this.writtenDocs.add(t.toString());
}
delete(t) {
this.write(new __PRIVATE_DeleteMutation(t, this.precondition(t))), this.writtenDocs.add(t.toString());
}
async commit() {
if (this.ensureCommitNotCalled(), this.lastTransactionError) throw this.lastTransactionError;
const t = this.readVersions;
// For each mutation, note that the doc was written.
this.mutations.forEach((e => {
t.delete(e.key.toString());
})),
// For each document that was read but not written to, we want to perform
// a `verify` operation.
t.forEach(((t, e) => {
const r = DocumentKey.fromPath(e);
this.mutations.push(new __PRIVATE_VerifyMutation(r, this.precondition(r)));
})), await __PRIVATE_invokeCommitRpc(this.datastore, this.mutations), this.committed = !0;
}
recordVersion(t) {
let e;
if (t.isFoundDocument()) e = t.version; else {
if (!t.isNoDocument()) throw fail();
// Represent a deleted doc using SnapshotVersion.min().
e = SnapshotVersion.min();
}
const r = this.readVersions.get(t.key.toString());
if (r) {
if (!e.isEqual(r))
// This transaction will fail no matter what.
throw new FirestoreError(g, "Document version changed between two reads.");
} else this.readVersions.set(t.key.toString(), e);
}
/**
* Returns the version of this document when it was read in this transaction,
* as a precondition, or no precondition if it was not read.
*/ precondition(t) {
const e = this.readVersions.get(t.toString());
return !this.writtenDocs.has(t.toString()) && e ? e.isEqual(SnapshotVersion.min()) ? Precondition.exists(!1) : Precondition.updateTime(e) : Precondition.none();
}
/**
* Returns the precondition for a document if the operation is an update.
*/ preconditionForUpdate(t) {
const e = this.readVersions.get(t.toString());
// The first time a document is written, we want to take into account the
// read time and existence
if (!this.writtenDocs.has(t.toString()) && e) {
if (e.isEqual(SnapshotVersion.min()))
// The document doesn't exist, so fail the transaction.
// This has to be validated locally because you can't send a
// precondition that a document does not exist without changing the
// semantics of the backend write to be an insert. This is the reverse
// of what we want, since we want to assert that the document doesn't
// exist but then send the update and have it fail. Since we can't
// express that to the backend, we have to validate locally.
// Note: this can change once we can send separate verify writes in the
// transaction.
throw new FirestoreError(T, "Can't update a document that doesn't exist.");
// Document exists, base precondition on document update time.
return Precondition.updateTime(e);
}
// Document was not read, so we just use the preconditions for a blind
// update.
return Precondition.exists(!0);
}
write(t) {
this.ensureCommitNotCalled(), this.mutations.push(t);
}
ensureCommitNotCalled() {}
}
/**
* @license
* Copyright 2022 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.
*/ const z = {
maxAttempts: 5
};
/**
* @license
* Copyright 2019 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.
*/
/**
* TransactionRunner encapsulates the logic needed to run and retry transactions
* with backoff.
*/
class __PRIVATE_TransactionRunner {
constructor(t, e, r, n, i) {
this.asyncQueue = t, this.datastore = e, this.options = r, this.updateFunction = n,
this.deferred = i, this.Et = r.maxAttempts, this.At = new __PRIVATE_ExponentialBackoff(this.asyncQueue, "transaction_retry" /* TimerId.TransactionRetry */);
}
/** Runs the transaction and sets the result on deferred. */ Tt() {
this.Et -= 1, this.Rt();
}
Rt() {
this.At.G((async () => {
const t = new Transaction$1(this.datastore), e = this.Pt(t);
e && e.then((e => {
this.asyncQueue.enqueueAndForget((() => t.commit().then((() => {
this.deferred.resolve(e);
})).catch((t => {
this.It(t);
}))));
})).catch((t => {
this.It(t);
}));
}));
}
Pt(t) {
try {
const e = this.updateFunction(t);
return !__PRIVATE_isNullOrUndefined(e) && e.catch && e.then ? e : (this.deferred.reject(Error("Transaction callback must return a Promise")),
null);
} catch (t) {
// Do not retry errors thrown by user provided updateFunction.
return this.deferred.reject(t), null;
}
}
It(t) {
this.Et > 0 && this.Vt(t) ? (this.Et -= 1, this.asyncQueue.enqueueAndForget((() => (this.Rt(),
Promise.resolve())))) : this.deferred.reject(t);
}
Vt(t) {
if ("FirebaseError" === t.name) {
// In transactions, the backend will fail outdated reads with FAILED_PRECONDITION and
// non-matching document versions with ABORTED. These errors should be retried.
const e = t.code;
return "aborted" === e || "failed-precondition" === e || "already-exists" === e || !
/**
* Determines whether an error code represents a permanent error when received
* in response to a non-write operation.
*
* See isPermanentWriteError for classifying write errors.
*/
function __PRIVATE_isPermanentError(t) {
switch (t) {
default:
return fail();
case m:
case A:
case R:
case y:
case D:
case b:
// Unauthenticated means something went wrong with our token and we need
// to retry with new credentials which will happen automatically.
case p:
return !1;
case T:
case P:
case I:
case V:
case w:
// Aborted might be retried in some scenarios, but that is dependant on
// the context and should handled individually by the calling code.
// See https://cloud.google.com/apis/design/errors.
case g:
case F:
case v:
case C:
return !0;
}
}(e);
}
return !1;
}
}
/**
* @license
* Copyright 2020 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 Platform's 'document' implementation or null if not available. */ function getDocument() {
// `document` is not always available, e.g. in ReactNative and WebWorkers.
// eslint-disable-next-line no-restricted-globals
return "undefined" != typeof document ? document : null;
}
/**
* @license
* Copyright 2017 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.
*/
/**
* Represents an operation scheduled to be run in the future on an AsyncQueue.
*
* It is created via DelayedOperation.createAndSchedule().
*
* Supports cancellation (via cancel()) and early execution (via skipDelay()).
*
* Note: We implement `PromiseLike` instead of `Promise`, as the `Promise` type
* in newer versions of TypeScript defines `finally`, which is not available in
* IE.
*/ class DelayedOperation {
constructor(t, e, r, n, i) {
this.asyncQueue = t, this.timerId = e, this.targetTimeMs = r, this.op = n, this.removalCallback = i,
this.deferred = new __PRIVATE_Deferred, this.then = this.deferred.promise.then.bind(this.deferred.promise),
// It's normal for the deferred promise to be canceled (due to cancellation)
// and so we attach a dummy catch callback to avoid
// 'UnhandledPromiseRejectionWarning' log spam.
this.deferred.promise.catch((t => {}));
}
get promise() {
return this.deferred.promise;
}
/**
* Creates and returns a DelayedOperation that has been scheduled to be
* executed on the provided asyncQueue after the provided delayMs.
*
* @param asyncQueue - The queue to schedule the operation on.
* @param id - A Timer ID identifying the type of operation this is.
* @param delayMs - The delay (ms) before the operation should be scheduled.
* @param op - The operation to run.
* @param removalCallback - A callback to be called synchronously once the
* operation is executed or canceled, notifying the AsyncQueue to remove it
* from its delayedOperations list.
* PORTING NOTE: This exists to prevent making removeDelayedOperation() and
* the DelayedOperation class public.
*/ static createAndSchedule(t, e, r, n, i) {
const s = Date.now() + r, o = new DelayedOperation(t, e, s, n, i);
return o.start(r), o;
}
/**
* Starts the timer. This is called immediately after construction by
* createAndSchedule().
*/ start(t) {
this.timerHandle = setTimeout((() => this.handleDelayElapsed()), t);
}
/**
* Queues the operation to run immediately (if it hasn't already been run or
* canceled).
*/ skipDelay() {
return this.handleDelayElapsed();
}
/**
* Cancels the operation if it hasn't already been executed or canceled. The
* promise will be rejected.
*
* As long as the operation has not yet been run, calling cancel() provides a
* guarantee that the operation will not be run.
*/ cancel(t) {
null !== this.timerHandle && (this.clearTimeout(), this.deferred.reject(new FirestoreError(m, "Operation cancelled" + (t ? ": " + t : ""))));
}
handleDelayElapsed() {
this.asyncQueue.enqueueAndForget((() => null !== this.timerHandle ? (this.clearTimeout(),
this.op().then((t => this.deferred.resolve(t)))) : Promise.resolve()));
}
clearTimeout() {
null !== this.timerHandle && (this.removalCallback(this), clearTimeout(this.timerHandle),
this.timerHandle = null);
}
}
/**
* @license
* Copyright 2020 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 __PRIVATE_AsyncQueueImpl {
constructor() {
// The last promise in the queue.
this.yt = Promise.resolve(),
// A list of retryable operations. Retryable operations are run in order and
// retried with backoff.
this.wt = [],
// Is this AsyncQueue being shut down? Once it is set to true, it will not
// be changed again.
this.gt = !1,
// Operations scheduled to be queued in the future. Operations are
// automatically removed after they are run or canceled.
this.Ft = [],
// visible for testing
this.vt = null,
// Flag set while there's an outstanding AsyncQueue operation, used for
// assertion sanity-checks.
this.Dt = !1,
// Enabled during shutdown on Safari to prevent future access to IndexedDB.
this.bt = !1,
// List of TimerIds to fast-forward delays for.
this.Ct = [],
// Backoff timer used to schedule retries for retryable operations
this.At = new __PRIVATE_ExponentialBackoff(this, "async_queue_retry" /* TimerId.AsyncQueueRetry */),
// Visibility handler that triggers an immediate retry of all retryable
// operations. Meant to speed up recovery when we regain file system access
// after page comes into foreground.
this.St = () => {
const t = getDocument();
t && __PRIVATE_logDebug("AsyncQueue", "Visibility state changed to " + t.visibilityState),
this.At.J();
};
const t = getDocument();
t && "function" == typeof t.addEventListener && t.addEventListener("visibilitychange", this.St);
}
get isShuttingDown() {
return this.gt;
}
/**
* Adds a new operation to the queue without waiting for it to complete (i.e.
* we ignore the Promise result).
*/ enqueueAndForget(t) {
// eslint-disable-next-line @typescript-eslint/no-floating-promises
this.enqueue(t);
}
enqueueAndForgetEvenWhileRestricted(t) {
this.Nt(),
// eslint-disable-next-line @typescript-eslint/no-floating-promises
this.Ot(t);
}
enterRestrictedMode(t) {
if (!this.gt) {
this.gt = !0, this.bt = t || !1;
const e = getDocument();
e && "function" == typeof e.removeEventListener && e.removeEventListener("visibilitychange", this.St);
}
}
enqueue(t) {
if (this.Nt(), this.gt)
// Return a Promise which never resolves.
return new Promise((() => {}));
// Create a deferred Promise that we can return to the callee. This
// allows us to return a "hanging Promise" only to the callee and still
// advance the queue even when the operation is not run.
const e = new __PRIVATE_Deferred;
return this.Ot((() => this.gt && this.bt ? Promise.resolve() : (t().then(e.resolve, e.reject),
e.promise))).then((() => e.promise));
}
enqueueRetryable(t) {
this.enqueueAndForget((() => (this.wt.push(t), this.qt())));
}
/**
* Runs the next operation from the retryable queue. If the operation fails,
* reschedules with backoff.
*/ async qt() {
if (0 !== this.wt.length) {
try {
await this.wt[0](), this.wt.shift(), this.At.reset();
} catch (t) {
if (!
/**
* @license
* Copyright 2017 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.
*/
/** Verifies whether `e` is an IndexedDbTransactionError. */
function __PRIVATE_isIndexedDbTransactionError(t) {
// Use name equality, as instanceof checks on errors don't work with errors
// that wrap other errors.
return "IndexedDbTransactionError" === t.name;
}
/**
* @license
* Copyright 2020 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.
*/ (t)) throw t;
// Failure will be handled by AsyncQueue
__PRIVATE_logDebug("AsyncQueue", "Operation failed with retryable error: " + t);
}
this.wt.length > 0 &&
// If there are additional operations, we re-schedule `retryNextOp()`.
// This is necessary to run retryable operations that failed during
// their initial attempt since we don't know whether they are already
// enqueued. If, for example, `op1`, `op2`, `op3` are enqueued and `op1`
// needs to be re-run, we will run `op1`, `op1`, `op2` using the
// already enqueued calls to `retryNextOp()`. `op3()` will then run in the
// call scheduled here.
// Since `backoffAndRun()` cancels an existing backoff and schedules a
// new backoff on every call, there is only ever a single additional
// operation in the queue.
this.At.G((() => this.qt()));
}
}
Ot(t) {
const e = this.yt.then((() => (this.Dt = !0, t().catch((t => {
this.vt = t, this.Dt = !1;
const e =
/**
* Chrome includes Error.message in Error.stack. Other browsers do not.
* This returns expected output of message + stack when available.
* @param error - Error or FirestoreError
*/
function __PRIVATE_getMessageOrStack(t) {
let e = t.message || "";
t.stack && (e = t.stack.includes(t.message) ? t.stack : t.message + "\n" + t.stack);
return e;
}
/**
* @license
* Copyright 2020 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.
*/
// TODO(mrschmidt) Consider using `BaseTransaction` as the base class in the
// legacy SDK.
/**
* A reference to a transaction.
*
* The `Transaction` object passed to a transaction's `updateFunction` provides
* the methods to read and write data within the transaction context. See
* {@link runTransaction}.
*/ (t);
// Re-throw the error so that this.tail becomes a rejected Promise and
// all further attempts to chain (via .then) will just short-circuit
// and return the rejected Promise.
throw __PRIVATE_logError("INTERNAL UNHANDLED ERROR: ", e), t;
})).then((t => (this.Dt = !1, t))))));
return this.yt = e, e;
}
enqueueAfterDelay(t, e, r) {
this.Nt(),
// Fast-forward delays for timerIds that have been overriden.
this.Ct.indexOf(t) > -1 && (e = 0);
const n = DelayedOperation.createAndSchedule(this, t, e, r, (t => this.Bt(t)));
return this.Ft.push(n), n;
}
Nt() {
this.vt && fail();
}
verifyOperationInProgress() {}
/**
* Waits until all currently queued tasks are finished executing. Delayed
* operations are not run.
*/ async $t() {
// Operations in the queue prior to draining may have enqueued additional
// operations. Keep draining the queue until the tail is no longer advanced,
// which indicates that no more new operations were enqueued and that all
// operations were executed.
let t;
do {
t = this.yt, await t;
} while (t !== this.yt);
}
/**
* For Tests: Determine if a delayed operation with a particular TimerId
* exists.
*/ Qt(t) {
for (const e of this.Ft) if (e.timerId === t) return !0;
return !1;
}
/**
* For Tests: Runs some or all delayed operations early.
*
* @param lastTimerId - Delayed operations up to and including this TimerId
* will be drained. Pass TimerId.All to run all delayed operations.
* @returns a Promise that resolves once all operations have been run.
*/ Lt(t) {
// Note that draining may generate more delayed ops, so we do that first.
return this.$t().then((() => {
// Run ops in the same order they'd run if they ran naturally.
this.Ft.sort(((t, e) => t.targetTimeMs - e.targetTimeMs));
for (const e of this.Ft) if (e.skipDelay(), "all" /* TimerId.All */ !== t && e.timerId === t) break;
return this.$t();
}));
}
/**
* For Tests: Skip all subsequent delays for a timer id.
*/ Mt(t) {
this.Ct.push(t);
}
/** Called once a DelayedOperation is run or canceled. */ Bt(t) {
// NOTE: indexOf / slice are O(n), but delayedOperations is expected to be small.
const e = this.Ft.indexOf(t);
this.Ft.splice(e, 1);
}
}
class Transaction {
/** @hideconstructor */
constructor(t, e) {
this._firestore = t, this._transaction = e, this._dataReader = __PRIVATE_newUserDataReader(t);
}
/**
* Reads the document referenced by the provided {@link DocumentReference}.
*
* @param documentRef - A reference to the document to be read.
* @returns A `DocumentSnapshot` with the read data.
*/ get(t) {
const e = __PRIVATE_validateReference(t, this._firestore), r = new __PRIVATE_LiteUserDataWriter(this._firestore);
return this._transaction.lookup([ e._key ]).then((t => {
if (!t || 1 !== t.length) return fail();
const n = t[0];
if (n.isFoundDocument()) return new DocumentSnapshot(this._firestore, r, n.key, n, e.converter);
if (n.isNoDocument()) return new DocumentSnapshot(this._firestore, r, e._key, null, e.converter);
throw fail();
}));
}
set(t, e, r) {
const n = __PRIVATE_validateReference(t, this._firestore), i = __PRIVATE_applyFirestoreDataConverter(n.converter, e, r), s = __PRIVATE_parseSetData(this._dataReader, "Transaction.set", n._key, i, null !== n.converter, r);
return this._transaction.set(n._key, s), this;
}
update(t, e, r, ...n) {
const i = __PRIVATE_validateReference(t, this._firestore);
// For Compat types, we have to "extract" the underlying types before
// performing validation.
let s;
return s = "string" == typeof (e = getModularInstance(e)) || e instanceof FieldPath ? __PRIVATE_parseUpdateVarargs(this._dataReader, "Transaction.update", i._key, e, r, n) : __PRIVATE_parseUpdateData(this._dataReader, "Transaction.update", i._key, e),
this._transaction.update(i._key, s), this;
}
/**
* Deletes the document referred to by the provided {@link DocumentReference}.
*
* @param documentRef - A reference to the document to be deleted.
* @returns This `Transaction` instance. Used for chaining method calls.
*/ delete(t) {
const e = __PRIVATE_validateReference(t, this._firestore);
return this._transaction.delete(e._key), this;
}
}
/**
* Executes the given `updateFunction` and then attempts to commit the changes
* applied within the transaction. If any document read within the transaction
* has changed, Cloud Firestore retries the `updateFunction`. If it fails to
* commit after 5 attempts, the transaction fails.
*
* The maximum number of writes allowed in a single transaction is 500.
*
* @param firestore - A reference to the Firestore database to run this
* transaction against.
* @param updateFunction - The function to execute within the transaction
* context.
* @param options - An options object to configure maximum number of attempts to
* commit.
* @returns If the transaction completed successfully or was explicitly aborted
* (the `updateFunction` returned a failed promise), the promise returned by the
* `updateFunction `is returned here. Otherwise, if the transaction failed, a
* rejected promise with the corresponding failure error is returned.
*/ function runTransaction(t, e, r) {
const n = __PRIVATE_getDatastore(t = __PRIVATE_cast(t, Firestore)), i = Object.assign(Object.assign({}, z), r);
!function __PRIVATE_validateTransactionOptions(t) {
if (t.maxAttempts < 1) throw new FirestoreError(T, "Max attempts must be at least 1");
}(i);
const s = new __PRIVATE_Deferred;
return new __PRIVATE_TransactionRunner(function __PRIVATE_newAsyncQueue() {
return new __PRIVATE_AsyncQueueImpl;
}(), n, i, (r => e(new Transaction(t, r))), s).Tt(), s.promise;
}
/**
* Firestore Lite
*
* @remarks Firestore Lite is a small online-only SDK that allows read
* and write access to your Firestore database. All operations connect
* directly to the backend, and `onSnapshot()` APIs are not supported.
* @packageDocumentation
*/ !function __PRIVATE_registerFirestore() {
!function __PRIVATE_setSDKVersion(t) {
d = t;
}(`${SDK_VERSION}_lite`), _registerComponent(new Component("firestore/lite", ((t, {instanceIdentifier: e, options: r}) => {
const n = t.getProvider("app").getImmediate(), i = new Firestore(new __PRIVATE_LiteAuthCredentialsProvider(t.getProvider("auth-internal")), new __PRIVATE_LiteAppCheckTokenProvider(t.getProvider("app-check-internal")), function __PRIVATE_databaseIdFromApp(t, e) {
if (!Object.prototype.hasOwnProperty.apply(t.options, [ "projectId" ])) throw new FirestoreError(T, '"projectId" not provided in firebase.initializeApp.');
return new DatabaseId(t.options.projectId, e);
}
/**
* @license
* Copyright 2017 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.
*/ (n, e), n);
return r && i._setSettings(r), i;
}), "PUBLIC").setMultipleInstances(!0)),
// RUNTIME_ENV and BUILD_TARGET are replaced by real values during the compilation
registerVersion("firestore-lite", "4.4.2", ""), registerVersion("firestore-lite", "4.4.2", "esm2017");
}();
export { AggregateField, AggregateQuerySnapshot, Bytes, CollectionReference, DocumentReference, DocumentSnapshot, FieldPath, FieldValue, Firestore, FirestoreError, GeoPoint, Query, QueryCompositeFilterConstraint, QueryConstraint, QueryDocumentSnapshot, QueryEndAtConstraint, QueryFieldFilterConstraint, QueryLimitConstraint, QueryOrderByConstraint, QuerySnapshot, QueryStartAtConstraint, Timestamp, Transaction, WriteBatch, addDoc, aggregateFieldEqual, aggregateQuerySnapshotEqual, and, arrayRemove, arrayUnion, average, collection, collectionGroup, connectFirestoreEmulator, count, deleteDoc, deleteField, doc, documentId, endAt, endBefore, getAggregate, getCount, getDoc, getDocs, getFirestore, increment, initializeFirestore, limit, limitToLast, or, orderBy, query, queryEqual, refEqual, runTransaction, serverTimestamp, setDoc, setLogLevel, snapshotEqual, startAfter, startAt, sum, terminate, updateDoc, where, writeBatch };
//# sourceMappingURL=index.browser.esm2017.js.map