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: * * */ 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