mirror of
https://github.com/musix-org/musix-oss
synced 2024-12-24 01:43:18 +00:00
1 line
1.3 MiB
1 line
1.3 MiB
{"version":3,"file":"index.esm.min.js","sources":["../src/core/version.ts","../src/util/log.ts","../src/util/assert.ts","../src/util/misc.ts","../src/core/database_info.ts","../src/core/types.ts","../src/auth/user.ts","../src/util/error.ts","../src/api/credentials.ts","../src/util/obj.ts","../src/util/input_validation.ts","../src/api/geo_point.ts","../src/api/timestamp.ts","../src/core/snapshot_version.ts","../src/model/path.ts","../src/model/document_key.ts","../src/util/sorted_map.ts","../src/util/sorted_set.ts","../src/model/transform_operation.ts","../src/model/mutation.ts","../src/model/field_value.ts","../src/model/document.ts","../src/util/types.ts","../src/core/target.ts","../src/core/query.ts","../src/local/target_data.ts","../src/remote/existence_filter.ts","../src/remote/rpc_error.ts","../src/model/collections.ts","../src/model/document_set.ts","../src/core/view_snapshot.ts","../src/remote/remote_event.ts","../src/remote/watch_change.ts","../src/remote/serializer.ts","../src/platform/platform.ts","../src/util/api.ts","../src/api/blob.ts","../src/util/obj_map.ts","../src/model/mutation_batch.ts","../src/local/reference_set.ts","../src/local/persistence_promise.ts","../src/local/remote_document_change_buffer.ts","../src/local/persistence.ts","../src/local/local_documents_view.ts","../src/local/local_view_changes.ts","../src/core/listen_sequence.ts","../src/util/promise.ts","../src/util/async_queue.ts","../src/local/lru_garbage_collector.ts","../src/local/local_store.ts","../src/api/field_path.ts","../src/api/field_value.ts","../src/api/user_data_converter.ts","../src/remote/backoff.ts","../src/remote/persistent_stream.ts","../src/remote/datastore.ts","../src/core/transaction.ts","../src/remote/online_state_tracker.ts","../src/remote/remote_store.ts","../src/local/shared_client_state_schema.ts","../src/local/shared_client_state.ts","../src/core/target_id_generator.ts","../src/core/view.ts","../src/core/transaction_runner.ts","../src/core/sync_engine.ts","../src/core/event_manager.ts","../src/local/encoded_resource_path.ts","../src/local/simple_db.ts","../src/local/indexeddb_mutation_queue.ts","../src/local/indexeddb_target_cache.ts","../src/local/indexeddb_remote_document_cache.ts","../src/local/memory_index_manager.ts","../src/local/indexeddb_schema.ts","../src/local/indexeddb_index_manager.ts","../src/local/local_serializer.ts","../src/local/indexeddb_persistence.ts","../src/local/index_free_query_engine.ts","../src/local/memory_mutation_queue.ts","../src/local/memory_remote_document_cache.ts","../src/local/memory_target_cache.ts","../src/local/memory_persistence.ts","../src/core/firestore_client.ts","../src/util/async_observer.ts","../src/api/observer.ts","../src/api/database.ts","../src/platform/config.ts","../src/remote/connectivity_monitor_noop.ts","../src/platform_browser/browser_connectivity_monitor.ts","../src/remote/stream_bridge.ts","../src/platform_browser/webchannel_connection.ts","../src/platform_browser/browser_platform.ts","../src/platform_browser/browser_init.ts","../index.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport firebase from '@firebase/app';\n\n/** The semver (www.semver.org) version of the SDK. */\nexport const SDK_VERSION = firebase.SDK_VERSION;\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Logger, LogLevel as FirebaseLogLevel } from '@firebase/logger';\nimport { SDK_VERSION } from '../core/version';\nimport { PlatformSupport } from '../platform/platform';\n\nconst logClient = new Logger('@firebase/firestore');\n\nexport enum LogLevel {\n DEBUG,\n ERROR,\n SILENT\n}\n\n// Helper methods are needed because variables can't be exported as read/write\nexport function getLogLevel(): LogLevel {\n if (logClient.logLevel === FirebaseLogLevel.DEBUG) {\n return LogLevel.DEBUG;\n } else if (logClient.logLevel === FirebaseLogLevel.SILENT) {\n return LogLevel.SILENT;\n } else {\n return LogLevel.ERROR;\n }\n}\nexport function setLogLevel(newLevel: LogLevel): void {\n /**\n * Map the new log level to the associated Firebase Log Level\n */\n switch (newLevel) {\n case LogLevel.DEBUG:\n logClient.logLevel = FirebaseLogLevel.DEBUG;\n break;\n case LogLevel.ERROR:\n logClient.logLevel = FirebaseLogLevel.ERROR;\n break;\n case LogLevel.SILENT:\n logClient.logLevel = FirebaseLogLevel.SILENT;\n break;\n default:\n logClient.error(\n `Firestore (${SDK_VERSION}): Invalid value passed to \\`setLogLevel\\``\n );\n }\n}\n\nexport function debug(tag: string, msg: string, ...obj: unknown[]): void {\n if (logClient.logLevel <= FirebaseLogLevel.DEBUG) {\n const args = obj.map(argToString);\n logClient.debug(`Firestore (${SDK_VERSION}) [${tag}]: ${msg}`, ...args);\n }\n}\n\nexport function error(msg: string, ...obj: unknown[]): void {\n if (logClient.logLevel <= FirebaseLogLevel.ERROR) {\n const args = obj.map(argToString);\n logClient.error(`Firestore (${SDK_VERSION}): ${msg}`, ...args);\n }\n}\n\n/**\n * Converts an additional log parameter to a string representation.\n */\nfunction argToString(obj: unknown): string | unknown {\n if (typeof obj === 'string') {\n return obj;\n } else {\n const platform = PlatformSupport.getPlatform();\n try {\n return platform.formatJSON(obj);\n } catch (e) {\n // Converting to JSON failed, just log the object directly\n return obj;\n }\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { SDK_VERSION } from '../core/version';\n\nimport { error } from './log';\n\n/**\n * Unconditionally fails, throwing an Error with the given message.\n *\n * Returns any so it can be used in expressions:\n * @example\n * let futureVar = fail('not implemented yet');\n */\nexport function fail(failure: string): never {\n // Log the failure in addition to throw an exception, just in case the\n // exception is swallowed.\n const message =\n `FIRESTORE (${SDK_VERSION}) INTERNAL ASSERTION FAILED: ` + failure;\n error(message);\n\n // NOTE: We don't use FirestoreError here because these are internal failures\n // that cannot be handled by the user. (Also it would create a circular\n // dependency between the error and assert modules which doesn't work.)\n throw new Error(message);\n}\n\n/**\n * Fails if the given assertion condition is false, throwing an Error with the\n * given message if it did.\n */\nexport function assert(assertion: boolean, message: string): asserts assertion {\n if (!assertion) {\n fail(message);\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { assert } from './assert';\n\nexport type EventHandler<E> = (value: E) => void;\nexport interface Indexable {\n [k: string]: unknown;\n}\n\nexport class AutoId {\n static newId(): string {\n // Alphanumeric characters\n const chars =\n 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';\n let autoId = '';\n for (let i = 0; i < 20; i++) {\n autoId += chars.charAt(Math.floor(Math.random() * chars.length));\n }\n assert(autoId.length === 20, 'Invalid auto ID: ' + autoId);\n return autoId;\n }\n}\n\nexport function primitiveComparator<T>(left: T, right: T): number {\n if (left < right) {\n return -1;\n }\n if (left > right) {\n return 1;\n }\n return 0;\n}\n\n/** Duck-typed interface for objects that have an isEqual() method. */\nexport interface Equatable<T> {\n isEqual(other: T): boolean;\n}\n\n/** Helper to compare nullable (or undefined-able) objects using isEqual(). */\nexport function equals<T>(\n left: Equatable<T> | null | undefined,\n right: T | null | undefined\n): boolean {\n if (left !== null && left !== undefined) {\n return !!(right && left.isEqual(right));\n } else {\n // HACK: Explicitly cast since TypeScript's type narrowing apparently isn't\n // smart enough.\n return (left as null | undefined) === right;\n }\n}\n\n/** Helper to compare arrays using isEqual(). */\nexport function arrayEquals<T>(left: Array<Equatable<T>>, right: T[]): boolean {\n if (left.length !== right.length) {\n return false;\n }\n\n for (let i = 0; i < left.length; i++) {\n if (!left[i].isEqual(right[i])) {\n return false;\n }\n }\n\n return true;\n}\n/**\n * Returns the immediate lexicographically-following string. This is useful to\n * construct an inclusive range for indexeddb iterators.\n */\nexport function immediateSuccessor(s: string): string {\n // Return the input string, with an additional NUL byte appended.\n return s + '\\0';\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { primitiveComparator } from '../util/misc';\n\nexport class DatabaseInfo {\n /**\n * Constructs a DatabaseInfo using the provided host, databaseId and\n * persistenceKey.\n *\n * @param databaseId The database to use.\n * @param persistenceKey A unique identifier for this Firestore's local\n * storage (used in conjunction with the databaseId).\n * @param host The Firestore backend host to connect to.\n * @param ssl Whether to use SSL when connecting.\n * @param forceLongPolling Whether to use the forceLongPolling option\n * when using WebChannel as the network transport.\n */\n constructor(\n readonly databaseId: DatabaseId,\n readonly persistenceKey: string,\n readonly host: string,\n readonly ssl: boolean,\n readonly forceLongPolling: boolean\n ) {}\n}\n\n/** The default database name for a project. */\nconst DEFAULT_DATABASE_NAME = '(default)';\n\n/** Represents the database ID a Firestore client is associated with. */\nexport class DatabaseId {\n readonly database: string;\n constructor(readonly projectId: string, database?: string) {\n this.database = database ? database : DEFAULT_DATABASE_NAME;\n }\n\n get isDefaultDatabase(): boolean {\n return this.database === DEFAULT_DATABASE_NAME;\n }\n\n isEqual(other: {}): boolean {\n return (\n other instanceof DatabaseId &&\n other.projectId === this.projectId &&\n other.database === this.database\n );\n }\n\n compareTo(other: DatabaseId): number {\n return (\n primitiveComparator(this.projectId, other.projectId) ||\n primitiveComparator(this.database, other.database)\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * BatchID is a locally assigned ID for a batch of mutations that have been\n * applied.\n */\nexport type BatchId = number;\n\n/**\n * A locally-assigned ID used to refer to a target being watched via the\n * Watch service.\n */\nexport type TargetId = number;\n\nexport type ListenSequenceNumber = number;\n\n// TODO(b/35918695): In GRPC / node, tokens are Uint8Array. In WebChannel,\n// they're strings. We should probably (de-)serialize to a common internal type.\nexport type ProtoByteString = Uint8Array | string;\n\n/** The different states of a mutation batch. */\nexport type MutationBatchState = 'pending' | 'acknowledged' | 'rejected';\n\n/**\n * Describes the online state of the Firestore client. Note that this does not\n * indicate whether or not the remote store is trying to connect or not. This is\n * primarily used by the View / EventManager code to change their behavior while\n * offline (e.g. get() calls shouldn't wait for data from the server and\n * snapshot events should set metadata.isFromCache=true).\n */\nexport enum OnlineState {\n /**\n * The Firestore client is in an unknown online state. This means the client\n * is either not actively trying to establish a connection or it is currently\n * trying to establish a connection, but it has not succeeded or failed yet.\n * Higher-level components should not operate in offline mode.\n */\n Unknown,\n\n /**\n * The client is connected and the connections are healthy. This state is\n * reached after a successful connection and there has been at least one\n * successful message received from the backends.\n */\n Online,\n\n /**\n * The client is either trying to establish a connection but failing, or it\n * has been explicitly marked offline via a call to disableNetwork().\n * Higher-level components should operate in offline mode.\n */\n Offline\n}\n\n/** The source of an online state event. */\nexport enum OnlineStateSource {\n RemoteStore,\n SharedClientState\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Simple wrapper around a nullable UID. Mostly exists to make code more\n * readable.\n */\nexport class User {\n /** A user with a null UID. */\n static readonly UNAUTHENTICATED = new User(null);\n\n // TODO(mikelehen): Look into getting a proper uid-equivalent for\n // non-FirebaseAuth providers.\n static readonly GOOGLE_CREDENTIALS = new User('google-credentials-uid');\n static readonly FIRST_PARTY = new User('first-party-uid');\n\n constructor(readonly uid: string | null) {}\n\n isAuthenticated(): boolean {\n return this.uid != null;\n }\n\n /**\n * Returns a key representing this user, suitable for inclusion in a\n * dictionary.\n */\n toKey(): string {\n if (this.isAuthenticated()) {\n return 'uid:' + this.uid;\n } else {\n return 'anonymous-user';\n }\n }\n\n isEqual(otherUser: User): boolean {\n return otherUser.uid === this.uid;\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport * as firestore from '@firebase/firestore-types';\n\n/**\n * Error Codes describing the different ways Firestore can fail. These come\n * directly from GRPC.\n */\nexport type Code = firestore.FirestoreErrorCode;\n\nexport const Code = {\n // Causes are copied from:\n // https://github.com/grpc/grpc/blob/bceec94ea4fc5f0085d81235d8e1c06798dc341a/include/grpc%2B%2B/impl/codegen/status_code_enum.h\n /** Not an error; returned on success. */\n OK: 'ok' as Code,\n\n /** The operation was cancelled (typically by the caller). */\n CANCELLED: 'cancelled' as Code,\n\n /** Unknown error or an error from a different error domain. */\n UNKNOWN: 'unknown' as Code,\n\n /**\n * Client specified an invalid argument. Note that this differs from\n * FAILED_PRECONDITION. INVALID_ARGUMENT indicates arguments that are\n * problematic regardless of the state of the system (e.g., a malformed file\n * name).\n */\n INVALID_ARGUMENT: 'invalid-argument' as Code,\n\n /**\n * Deadline expired before operation could complete. For operations that\n * change the state of the system, this error may be returned even if the\n * operation has completed successfully. For example, a successful response\n * from a server could have been delayed long enough for the deadline to\n * expire.\n */\n DEADLINE_EXCEEDED: 'deadline-exceeded' as Code,\n\n /** Some requested entity (e.g., file or directory) was not found. */\n NOT_FOUND: 'not-found' as Code,\n\n /**\n * Some entity that we attempted to create (e.g., file or directory) already\n * exists.\n */\n ALREADY_EXISTS: 'already-exists' as Code,\n\n /**\n * The caller does not have permission to execute the specified operation.\n * PERMISSION_DENIED must not be used for rejections caused by exhausting\n * some resource (use RESOURCE_EXHAUSTED instead for those errors).\n * PERMISSION_DENIED must not be used if the caller can not be identified\n * (use UNAUTHENTICATED instead for those errors).\n */\n PERMISSION_DENIED: 'permission-denied' as Code,\n\n /**\n * The request does not have valid authentication credentials for the\n * operation.\n */\n UNAUTHENTICATED: 'unauthenticated' as Code,\n\n /**\n * Some resource has been exhausted, perhaps a per-user quota, or perhaps the\n * entire file system is out of space.\n */\n RESOURCE_EXHAUSTED: 'resource-exhausted' as Code,\n\n /**\n * Operation was rejected because the system is not in a state required for\n * the operation's execution. For example, directory to be deleted may be\n * non-empty, an rmdir operation is applied to a non-directory, etc.\n *\n * A litmus test that may help a service implementor in deciding\n * between FAILED_PRECONDITION, ABORTED, and UNAVAILABLE:\n * (a) Use UNAVAILABLE if the client can retry just the failing call.\n * (b) Use ABORTED if the client should retry at a higher-level\n * (e.g., restarting a read-modify-write sequence).\n * (c) Use FAILED_PRECONDITION if the client should not retry until\n * the system state has been explicitly fixed. E.g., if an \"rmdir\"\n * fails because the directory is non-empty, FAILED_PRECONDITION\n * should be returned since the client should not retry unless\n * they have first fixed up the directory by deleting files from it.\n * (d) Use FAILED_PRECONDITION if the client performs conditional\n * REST Get/Update/Delete on a resource and the resource on the\n * server does not match the condition. E.g., conflicting\n * read-modify-write on the same resource.\n */\n FAILED_PRECONDITION: 'failed-precondition' as Code,\n\n /**\n * The operation was aborted, typically due to a concurrency issue like\n * sequencer check failures, transaction aborts, etc.\n *\n * See litmus test above for deciding between FAILED_PRECONDITION, ABORTED,\n * and UNAVAILABLE.\n */\n ABORTED: 'aborted' as Code,\n\n /**\n * Operation was attempted past the valid range. E.g., seeking or reading\n * past end of file.\n *\n * Unlike INVALID_ARGUMENT, this error indicates a problem that may be fixed\n * if the system state changes. For example, a 32-bit file system will\n * generate INVALID_ARGUMENT if asked to read at an offset that is not in the\n * range [0,2^32-1], but it will generate OUT_OF_RANGE if asked to read from\n * an offset past the current file size.\n *\n * There is a fair bit of overlap between FAILED_PRECONDITION and\n * OUT_OF_RANGE. We recommend using OUT_OF_RANGE (the more specific error)\n * when it applies so that callers who are iterating through a space can\n * easily look for an OUT_OF_RANGE error to detect when they are done.\n */\n OUT_OF_RANGE: 'out-of-range' as Code,\n\n /** Operation is not implemented or not supported/enabled in this service. */\n UNIMPLEMENTED: 'unimplemented' as Code,\n\n /**\n * Internal errors. Means some invariants expected by underlying System has\n * been broken. If you see one of these errors, Something is very broken.\n */\n INTERNAL: 'internal' as Code,\n\n /**\n * The service is currently unavailable. This is a most likely a transient\n * condition and may be corrected by retrying with a backoff.\n *\n * See litmus test above for deciding between FAILED_PRECONDITION, ABORTED,\n * and UNAVAILABLE.\n */\n UNAVAILABLE: 'unavailable' as Code,\n\n /** Unrecoverable data loss or corruption. */\n DATA_LOSS: 'data-loss' as Code\n};\n\n/**\n * An error class used for Firestore-generated errors. Ideally we should be\n * using FirebaseError, but integrating with it is overly arduous at the moment,\n * so we define our own compatible error class (with a `name` of 'FirebaseError'\n * and compatible `code` and `message` fields.)\n */\nexport class FirestoreError extends Error implements firestore.FirestoreError {\n name = 'FirebaseError';\n stack?: string;\n\n constructor(readonly code: Code, readonly message: string) {\n super(message);\n\n // HACK: We write a toString property directly because Error is not a real\n // class and so inheritance does not work correctly. We could alternatively\n // do the same \"back-door inheritance\" trick that FirebaseError does.\n this.toString = () => `${this.name}: [code=${this.code}]: ${this.message}`;\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { User } from '../auth/user';\nimport { assert } from '../util/assert';\nimport { Code, FirestoreError } from '../util/error';\nimport {\n FirebaseAuthInternal,\n FirebaseAuthInternalName\n} from '@firebase/auth-interop-types';\nimport { Provider } from '@firebase/component';\n\n// TODO(mikelehen): This should be split into multiple files and probably\n// moved to an auth/ folder to match other platforms.\n\nexport interface FirstPartyCredentialsSettings {\n type: 'gapi';\n client: unknown;\n sessionIndex: string;\n}\n\nexport interface ProviderCredentialsSettings {\n type: 'provider';\n client: CredentialsProvider;\n}\n\n/** Settings for private credentials */\nexport type CredentialsSettings =\n | FirstPartyCredentialsSettings\n | ProviderCredentialsSettings;\n\nexport type TokenType = 'OAuth' | 'FirstParty';\nexport interface Token {\n /** Type of token. */\n type: TokenType;\n\n /**\n * The user with which the token is associated (used for persisting user\n * state on disk, etc.).\n */\n user: User;\n\n /** Extra header values to be passed along with a request */\n authHeaders: { [header: string]: string };\n}\n\nexport class OAuthToken implements Token {\n type = 'OAuth' as TokenType;\n authHeaders: { [header: string]: string };\n constructor(value: string, public user: User) {\n this.authHeaders = {};\n // Set the headers using Object Literal notation to avoid minification\n this.authHeaders['Authorization'] = `Bearer ${value}`;\n }\n}\n\n/**\n * A Listener for credential change events. The listener should fetch a new\n * token and may need to invalidate other state if the current user has also\n * changed.\n */\nexport type CredentialChangeListener = (user: User) => void;\n\n/**\n * Provides methods for getting the uid and token for the current user and\n * listening for changes.\n */\nexport interface CredentialsProvider {\n /** Requests a token for the current user. */\n getToken(): Promise<Token | null>;\n\n /**\n * Marks the last retrieved token as invalid, making the next GetToken request\n * force-refresh the token.\n */\n invalidateToken(): void;\n\n /**\n * Specifies a listener to be notified of credential changes\n * (sign-in / sign-out, token changes). It is immediately called once with the\n * initial user.\n */\n setChangeListener(changeListener: CredentialChangeListener): void;\n\n /** Removes the previously-set change listener. */\n removeChangeListener(): void;\n}\n\n/** A CredentialsProvider that always yields an empty token. */\nexport class EmptyCredentialsProvider implements CredentialsProvider {\n /**\n * Stores the listener registered with setChangeListener()\n * This isn't actually necessary since the UID never changes, but we use this\n * to verify the listen contract is adhered to in tests.\n */\n private changeListener: CredentialChangeListener | null = null;\n\n getToken(): Promise<Token | null> {\n return Promise.resolve<Token | null>(null);\n }\n\n invalidateToken(): void {}\n\n setChangeListener(changeListener: CredentialChangeListener): void {\n assert(!this.changeListener, 'Can only call setChangeListener() once.');\n this.changeListener = changeListener;\n // Fire with initial user.\n changeListener(User.UNAUTHENTICATED);\n }\n\n removeChangeListener(): void {\n assert(\n this.changeListener !== null,\n 'removeChangeListener() when no listener registered'\n );\n this.changeListener = null;\n }\n}\n\nexport class FirebaseCredentialsProvider implements CredentialsProvider {\n /**\n * The auth token listener registered with FirebaseApp, retained here so we\n * can unregister it.\n */\n private tokenListener: ((token: string | null) => void) | null = null;\n\n /** Tracks the current User. */\n private currentUser: User = User.UNAUTHENTICATED;\n private receivedInitialUser: boolean = false;\n\n /**\n * Counter used to detect if the token changed while a getToken request was\n * outstanding.\n */\n private tokenCounter = 0;\n\n /** The listener registered with setChangeListener(). */\n private changeListener: CredentialChangeListener | null = null;\n\n private forceRefresh = false;\n\n private auth: FirebaseAuthInternal | null;\n\n constructor(authProvider: Provider<FirebaseAuthInternalName>) {\n this.tokenListener = () => {\n this.tokenCounter++;\n this.currentUser = this.getUser();\n this.receivedInitialUser = true;\n if (this.changeListener) {\n this.changeListener(this.currentUser);\n }\n };\n\n this.tokenCounter = 0;\n\n this.auth = authProvider.getImmediate({ optional: true });\n\n if (this.auth) {\n this.auth.addAuthTokenListener(this.tokenListener!);\n } else {\n // if auth is not available, invoke tokenListener once with null token\n this.tokenListener(null);\n authProvider.get().then(\n auth => {\n this.auth = auth;\n if (this.tokenListener) {\n // tokenListener can be removed by removeChangeListener()\n this.auth.addAuthTokenListener(this.tokenListener);\n }\n },\n () => {\n /* this.authProvider.get() never rejects */\n }\n );\n }\n }\n\n getToken(): Promise<Token | null> {\n assert(\n this.tokenListener != null,\n 'getToken cannot be called after listener removed.'\n );\n\n // Take note of the current value of the tokenCounter so that this method\n // can fail (with an ABORTED error) if there is a token change while the\n // request is outstanding.\n const initialTokenCounter = this.tokenCounter;\n const forceRefresh = this.forceRefresh;\n this.forceRefresh = false;\n\n if (!this.auth) {\n return Promise.resolve(null);\n }\n\n return this.auth.getToken(forceRefresh).then(tokenData => {\n // Cancel the request since the token changed while the request was\n // outstanding so the response is potentially for a previous user (which\n // user, we can't be sure).\n if (this.tokenCounter !== initialTokenCounter) {\n throw new FirestoreError(\n Code.ABORTED,\n 'getToken aborted due to token change.'\n );\n } else {\n if (tokenData) {\n assert(\n typeof tokenData.accessToken === 'string',\n 'Invalid tokenData returned from getToken():' + tokenData\n );\n return new OAuthToken(tokenData.accessToken, this.currentUser);\n } else {\n return null;\n }\n }\n });\n }\n\n invalidateToken(): void {\n this.forceRefresh = true;\n }\n\n setChangeListener(changeListener: CredentialChangeListener): void {\n assert(!this.changeListener, 'Can only call setChangeListener() once.');\n this.changeListener = changeListener;\n\n // Fire the initial event\n if (this.receivedInitialUser) {\n changeListener(this.currentUser);\n }\n }\n\n removeChangeListener(): void {\n assert(this.tokenListener != null, 'removeChangeListener() called twice');\n assert(\n this.changeListener !== null,\n 'removeChangeListener() called when no listener registered'\n );\n\n if (this.auth) {\n this.auth.removeAuthTokenListener(this.tokenListener!);\n }\n this.tokenListener = null;\n this.changeListener = null;\n }\n\n // Auth.getUid() can return null even with a user logged in. It is because\n // getUid() is synchronous, but the auth code populating Uid is asynchronous.\n // This method should only be called in the AuthTokenListener callback\n // to guarantee to get the actual user.\n private getUser(): User {\n const currentUid = this.auth && this.auth.getUid();\n assert(\n currentUid === null || typeof currentUid === 'string',\n 'Received invalid UID: ' + currentUid\n );\n return new User(currentUid);\n }\n}\n\n// Manual type definition for the subset of Gapi we use.\ninterface Gapi {\n auth: {\n getAuthHeaderValueForFirstParty: (\n userIdentifiers: Array<{ [key: string]: string }>\n ) => string | null;\n };\n}\n\n/*\n * FirstPartyToken provides a fresh token each time its value\n * is requested, because if the token is too old, requests will be rejected.\n * Technically this may no longer be necessary since the SDK should gracefully\n * recover from unauthenticated errors (see b/33147818 for context), but it's\n * safer to keep the implementation as-is.\n */\nexport class FirstPartyToken implements Token {\n type = 'FirstParty' as TokenType;\n user = User.FIRST_PARTY;\n\n constructor(private gapi: Gapi, private sessionIndex: string) {}\n\n get authHeaders(): { [header: string]: string } {\n const headers: { [header: string]: string } = {\n 'X-Goog-AuthUser': this.sessionIndex\n };\n const authHeader = this.gapi.auth.getAuthHeaderValueForFirstParty([]);\n if (authHeader) {\n headers['Authorization'] = authHeader;\n }\n return headers;\n }\n}\n\n/*\n * Provides user credentials required for the Firestore JavaScript SDK\n * to authenticate the user, using technique that is only available\n * to applications hosted by Google.\n */\nexport class FirstPartyCredentialsProvider implements CredentialsProvider {\n constructor(private gapi: Gapi, private sessionIndex: string) {}\n\n getToken(): Promise<Token | null> {\n return Promise.resolve(new FirstPartyToken(this.gapi, this.sessionIndex));\n }\n\n setChangeListener(changeListener: CredentialChangeListener): void {\n // Fire with initial uid.\n changeListener(User.FIRST_PARTY);\n }\n\n removeChangeListener(): void {}\n\n invalidateToken(): void {}\n}\n\n/**\n * Builds a CredentialsProvider depending on the type of\n * the credentials passed in.\n */\nexport function makeCredentialsProvider(\n credentials?: CredentialsSettings\n): CredentialsProvider {\n if (!credentials) {\n return new EmptyCredentialsProvider();\n }\n\n switch (credentials.type) {\n case 'gapi':\n const client = credentials.client as Gapi;\n // Make sure this really is a Gapi client.\n assert(\n !!(\n typeof client === 'object' &&\n client !== null &&\n client['auth'] &&\n client['auth']['getAuthHeaderValueForFirstParty']\n ),\n 'unexpected gapi interface'\n );\n return new FirstPartyCredentialsProvider(\n client,\n credentials.sessionIndex || '0'\n );\n\n case 'provider':\n return credentials.client;\n\n default:\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'makeCredentialsProvider failed due to invalid credential type'\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { assert } from './assert';\n\nexport interface Dict<V> {\n [stringKey: string]: V;\n [numberKey: number]: V;\n}\n\nexport function contains<V>(obj: Dict<V>, key: string | number): boolean {\n return Object.prototype.hasOwnProperty.call(obj, key);\n}\n\nexport function get<V>(obj: Dict<V>, key: string | number): V | null {\n return Object.prototype.hasOwnProperty.call(obj, key) ? obj[key] : null;\n}\n\nexport function size<V>(obj: Dict<V>): number {\n let count = 0;\n for (const key in obj) {\n if (Object.prototype.hasOwnProperty.call(obj, key)) {\n count++;\n }\n }\n return count;\n}\n\n/** Returns the given value if it's defined or the defaultValue otherwise. */\nexport function defaulted<V>(value: V | undefined, defaultValue: V): V {\n return value !== undefined ? value : defaultValue;\n}\n\nexport function forEachNumber<V>(\n obj: Dict<V>,\n fn: (key: number, val: V) => void\n): void {\n for (const key in obj) {\n if (Object.prototype.hasOwnProperty.call(obj, key)) {\n const num = Number(key);\n if (!isNaN(num)) {\n fn(num, obj[key]);\n }\n }\n }\n}\n\nexport function values<V>(obj: Dict<V>): V[] {\n const vs: V[] = [];\n forEach(obj, (_, v) => vs.push(v));\n return vs;\n}\n\nexport function forEach<V>(\n obj: Dict<V>,\n fn: (key: string, val: V) => void\n): void {\n for (const key in obj) {\n if (Object.prototype.hasOwnProperty.call(obj, key)) {\n fn(key, obj[key]);\n }\n }\n}\n\nexport function lookupOrInsert<V>(\n obj: Dict<V>,\n key: string | number,\n valFn: () => V\n): V {\n if (!contains(obj, key)) {\n obj[key] = valFn();\n }\n return obj[key];\n}\n\nexport function isEmpty<V>(obj: Dict<V>): boolean {\n assert(\n obj != null && typeof obj === 'object',\n 'isEmpty() expects object parameter.'\n );\n for (const key in obj) {\n if (Object.prototype.hasOwnProperty.call(obj, key)) {\n return false;\n }\n }\n return true;\n}\n\nexport function shallowCopy<V>(obj: Dict<V>): Dict<V> {\n assert(\n obj && typeof obj === 'object',\n 'shallowCopy() expects object parameter.'\n );\n const result: Dict<V> = {};\n for (const key in obj) {\n if (Object.prototype.hasOwnProperty.call(obj, key)) {\n result[key] = obj[key];\n }\n }\n return result;\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { fail } from './assert';\nimport { Code, FirestoreError } from './error';\nimport * as obj from './obj';\n\n/** Types accepted by validateType() and related methods for validation. */\nexport type ValidationType =\n | 'undefined'\n | 'object'\n | 'function'\n | 'boolean'\n | 'number'\n | 'string'\n | 'non-empty string';\n\n/**\n * Validates that no arguments were passed in the invocation of functionName.\n *\n * Forward the magic \"arguments\" variable as second parameter on which the\n * parameter validation is performed:\n * validateNoArgs('myFunction', arguments);\n */\nexport function validateNoArgs(functionName: string, args: IArguments): void {\n if (args.length !== 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function ${functionName}() does not support arguments, ` +\n 'but was called with ' +\n formatPlural(args.length, 'argument') +\n '.'\n );\n }\n}\n\n/**\n * Validates the invocation of functionName has the exact number of arguments.\n *\n * Forward the magic \"arguments\" variable as second parameter on which the\n * parameter validation is performed:\n * validateExactNumberOfArgs('myFunction', arguments, 2);\n */\nexport function validateExactNumberOfArgs(\n functionName: string,\n args: IArguments,\n numberOfArgs: number\n): void {\n if (args.length !== numberOfArgs) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function ${functionName}() requires ` +\n formatPlural(numberOfArgs, 'argument') +\n ', but was called with ' +\n formatPlural(args.length, 'argument') +\n '.'\n );\n }\n}\n\n/**\n * Validates the invocation of functionName has at least the provided number of\n * arguments (but can have many more).\n *\n * Forward the magic \"arguments\" variable as second parameter on which the\n * parameter validation is performed:\n * validateAtLeastNumberOfArgs('myFunction', arguments, 2);\n */\nexport function validateAtLeastNumberOfArgs(\n functionName: string,\n args: IArguments,\n minNumberOfArgs: number\n): void {\n if (args.length < minNumberOfArgs) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function ${functionName}() requires at least ` +\n formatPlural(minNumberOfArgs, 'argument') +\n ', but was called with ' +\n formatPlural(args.length, 'argument') +\n '.'\n );\n }\n}\n\n/**\n * Validates the invocation of functionName has number of arguments between\n * the values provided.\n *\n * Forward the magic \"arguments\" variable as second parameter on which the\n * parameter validation is performed:\n * validateBetweenNumberOfArgs('myFunction', arguments, 2, 3);\n */\nexport function validateBetweenNumberOfArgs(\n functionName: string,\n args: IArguments,\n minNumberOfArgs: number,\n maxNumberOfArgs: number\n): void {\n if (args.length < minNumberOfArgs || args.length > maxNumberOfArgs) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function ${functionName}() requires between ${minNumberOfArgs} and ` +\n `${maxNumberOfArgs} arguments, but was called with ` +\n formatPlural(args.length, 'argument') +\n '.'\n );\n }\n}\n\n/**\n * Validates the provided argument is an array and has as least the expected\n * number of elements.\n */\nexport function validateNamedArrayAtLeastNumberOfElements<T>(\n functionName: string,\n value: T[],\n name: string,\n minNumberOfElements: number\n): void {\n if (!(value instanceof Array) || value.length < minNumberOfElements) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function ${functionName}() requires its ${name} argument to be an ` +\n 'array with at least ' +\n `${formatPlural(minNumberOfElements, 'element')}.`\n );\n }\n}\n\n/**\n * Validates the provided positional argument has the native JavaScript type\n * using typeof checks.\n */\nexport function validateArgType(\n functionName: string,\n type: ValidationType,\n position: number,\n argument: unknown\n): void {\n validateType(functionName, type, `${ordinal(position)} argument`, argument);\n}\n\n/**\n * Validates the provided argument has the native JavaScript type using\n * typeof checks or is undefined.\n */\nexport function validateOptionalArgType(\n functionName: string,\n type: ValidationType,\n position: number,\n argument: unknown\n): void {\n if (argument !== undefined) {\n validateArgType(functionName, type, position, argument);\n }\n}\n\n/**\n * Validates the provided named option has the native JavaScript type using\n * typeof checks.\n */\nexport function validateNamedType(\n functionName: string,\n type: ValidationType,\n optionName: string,\n argument: unknown\n): void {\n validateType(functionName, type, `${optionName} option`, argument);\n}\n\n/**\n * Validates the provided named option has the native JavaScript type using\n * typeof checks or is undefined.\n */\nexport function validateNamedOptionalType(\n functionName: string,\n type: ValidationType,\n optionName: string,\n argument: unknown\n): void {\n if (argument !== undefined) {\n validateNamedType(functionName, type, optionName, argument);\n }\n}\n\nexport function validateArrayElements<T>(\n functionName: string,\n optionName: string,\n typeDescription: string,\n argument: T[],\n validator: (arg0: T) => boolean\n): void {\n if (!(argument instanceof Array)) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function ${functionName}() requires its ${optionName} ` +\n `option to be an array, but it was: ${valueDescription(argument)}`\n );\n }\n\n for (let i = 0; i < argument.length; ++i) {\n if (!validator(argument[i])) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function ${functionName}() requires all ${optionName} ` +\n `elements to be ${typeDescription}, but the value at index ${i} ` +\n `was: ${valueDescription(argument[i])}`\n );\n }\n }\n}\n\nexport function validateOptionalArrayElements<T>(\n functionName: string,\n optionName: string,\n typeDescription: string,\n argument: T[] | undefined,\n validator: (arg0: T) => boolean\n): void {\n if (argument !== undefined) {\n validateArrayElements(\n functionName,\n optionName,\n typeDescription,\n argument,\n validator\n );\n }\n}\n\n/**\n * Validates that the provided named option equals one of the expected values.\n */\nexport function validateNamedPropertyEquals<T>(\n functionName: string,\n inputName: string,\n optionName: string,\n input: T,\n expected: T[]\n): void {\n const expectedDescription: string[] = [];\n\n for (const val of expected) {\n if (val === input) {\n return;\n }\n expectedDescription.push(valueDescription(val));\n }\n\n const actualDescription = valueDescription(input);\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid value ${actualDescription} provided to function ${functionName}() for option ` +\n `\"${optionName}\". Acceptable values: ${expectedDescription.join(', ')}`\n );\n}\n\n/**\n * Validates that the provided named option equals one of the expected values or\n * is undefined.\n */\nexport function validateNamedOptionalPropertyEquals<T>(\n functionName: string,\n inputName: string,\n optionName: string,\n input: T,\n expected: T[]\n): void {\n if (input !== undefined) {\n validateNamedPropertyEquals(\n functionName,\n inputName,\n optionName,\n input,\n expected\n );\n }\n}\n\n/**\n * Validates that the provided argument is a valid enum.\n *\n * @param functionName Function making the validation call.\n * @param enums Array containing all possible values for the enum.\n * @param position Position of the argument in `functionName`.\n * @param argument Arugment to validate.\n */\nexport function validateStringEnum<T>(\n functionName: string,\n enums: string[],\n position: number,\n argument: unknown\n): void {\n if (!enums.some(element => element === argument)) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid value ${valueDescription(argument)} provided to function ` +\n `${functionName}() for its ${ordinal(position)} argument. Acceptable ` +\n `values: ${enums.join(', ')}`\n );\n }\n}\n\n/** Helper to validate the type of a provided input. */\nfunction validateType(\n functionName: string,\n type: ValidationType,\n inputName: string,\n input: unknown\n): void {\n let valid = false;\n if (type === 'object') {\n valid = isPlainObject(input);\n } else if (type === 'non-empty string') {\n valid = typeof input === 'string' && input !== '';\n } else {\n valid = typeof input === type;\n }\n\n if (!valid) {\n const description = valueDescription(input);\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function ${functionName}() requires its ${inputName} ` +\n `to be of type ${type}, but it was: ${description}`\n );\n }\n}\n\n/**\n * Returns true if it's a non-null object without a custom prototype\n * (i.e. excludes Array, Date, etc.).\n */\nexport function isPlainObject(input: unknown): boolean {\n return (\n typeof input === 'object' &&\n input !== null &&\n (Object.getPrototypeOf(input) === Object.prototype ||\n Object.getPrototypeOf(input) === null)\n );\n}\n\n/** Returns a string describing the type / value of the provided input. */\nexport function valueDescription(input: unknown): string {\n if (input === undefined) {\n return 'undefined';\n } else if (input === null) {\n return 'null';\n } else if (typeof input === 'string') {\n if (input.length > 20) {\n input = `${input.substring(0, 20)}...`;\n }\n return JSON.stringify(input);\n } else if (typeof input === 'number' || typeof input === 'boolean') {\n return '' + input;\n } else if (typeof input === 'object') {\n if (input instanceof Array) {\n return 'an array';\n } else {\n const customObjectName = tryGetCustomObjectType(input!);\n if (customObjectName) {\n return `a custom ${customObjectName} object`;\n } else {\n return 'an object';\n }\n }\n } else if (typeof input === 'function') {\n return 'a function';\n } else {\n return fail('Unknown wrong type: ' + typeof input);\n }\n}\n\n/** Hacky method to try to get the constructor name for an object. */\nexport function tryGetCustomObjectType(input: object): string | null {\n if (input.constructor) {\n const funcNameRegex = /function\\s+([^\\s(]+)\\s*\\(/;\n const results = funcNameRegex.exec(input.constructor.toString());\n if (results && results.length > 1) {\n return results[1];\n }\n }\n return null;\n}\n\n/** Validates the provided argument is defined. */\nexport function validateDefined(\n functionName: string,\n position: number,\n argument: unknown\n): void {\n if (argument === undefined) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function ${functionName}() requires a valid ${ordinal(position)} ` +\n `argument, but it was undefined.`\n );\n }\n}\n\n/**\n * Validates the provided positional argument is an object, and its keys and\n * values match the expected keys and types provided in optionTypes.\n */\nexport function validateOptionNames(\n functionName: string,\n options: object,\n optionNames: string[]\n): void {\n obj.forEach(options as obj.Dict<unknown>, (key, _) => {\n if (optionNames.indexOf(key) < 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Unknown option '${key}' passed to function ${functionName}(). ` +\n 'Available options: ' +\n optionNames.join(', ')\n );\n }\n });\n}\n\n/**\n * Helper method to throw an error that the provided argument did not pass\n * an instanceof check.\n */\nexport function invalidClassError(\n functionName: string,\n type: string,\n position: number,\n argument: unknown\n): Error {\n const description = valueDescription(argument);\n return new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function ${functionName}() requires its ${ordinal(position)} ` +\n `argument to be a ${type}, but it was: ${description}`\n );\n}\n\nexport function validatePositiveNumber(\n functionName: string,\n position: number,\n n: number\n): void {\n if (n <= 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function \"${functionName}()\" requires its ${ordinal(\n position\n )} argument to be a positive number, but it was: ${n}.`\n );\n }\n}\n\n/** Converts a number to its english word representation */\nfunction ordinal(num: number): string {\n switch (num) {\n case 1:\n return 'first';\n case 2:\n return 'second';\n case 3:\n return 'third';\n default:\n return num + 'th';\n }\n}\n\n/**\n * Formats the given word as plural conditionally given the preceding number.\n */\nfunction formatPlural(num: number, str: string): string {\n return `${num} ${str}` + (num === 1 ? '' : 's');\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Code, FirestoreError } from '../util/error';\nimport {\n validateArgType,\n validateExactNumberOfArgs\n} from '../util/input_validation';\nimport { primitiveComparator } from '../util/misc';\n\n/**\n * Immutable class representing a geo point as latitude-longitude pair.\n * This class is directly exposed in the public API, including its constructor.\n */\nexport class GeoPoint {\n // Prefix with underscore to signal this is a private variable in JS and\n // prevent it showing up for autocompletion when typing latitude or longitude.\n private _lat: number;\n private _long: number;\n\n constructor(latitude: number, longitude: number) {\n validateExactNumberOfArgs('GeoPoint', arguments, 2);\n validateArgType('GeoPoint', 'number', 1, latitude);\n validateArgType('GeoPoint', 'number', 2, longitude);\n if (!isFinite(latitude) || latitude < -90 || latitude > 90) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Latitude must be a number between -90 and 90, but was: ' + latitude\n );\n }\n if (!isFinite(longitude) || longitude < -180 || longitude > 180) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Longitude must be a number between -180 and 180, but was: ' + longitude\n );\n }\n\n this._lat = latitude;\n this._long = longitude;\n }\n\n /**\n * Returns the latitude of this geo point, a number between -90 and 90.\n */\n get latitude(): number {\n return this._lat;\n }\n\n /**\n * Returns the longitude of this geo point, a number between -180 and 180.\n */\n get longitude(): number {\n return this._long;\n }\n\n isEqual(other: GeoPoint): boolean {\n return this._lat === other._lat && this._long === other._long;\n }\n\n /**\n * Actually private to JS consumers of our API, so this function is prefixed\n * with an underscore.\n */\n _compareTo(other: GeoPoint): number {\n return (\n primitiveComparator(this._lat, other._lat) ||\n primitiveComparator(this._long, other._long)\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Code, FirestoreError } from '../util/error';\nimport { primitiveComparator } from '../util/misc';\n\nexport class Timestamp {\n static now(): Timestamp {\n return Timestamp.fromMillis(Date.now());\n }\n\n static fromDate(date: Date): Timestamp {\n return Timestamp.fromMillis(date.getTime());\n }\n\n static fromMillis(milliseconds: number): Timestamp {\n const seconds = Math.floor(milliseconds / 1000);\n const nanos = (milliseconds - seconds * 1000) * 1e6;\n return new Timestamp(seconds, nanos);\n }\n\n constructor(readonly seconds: number, readonly nanoseconds: number) {\n if (nanoseconds < 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Timestamp nanoseconds out of range: ' + nanoseconds\n );\n }\n if (nanoseconds >= 1e9) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Timestamp nanoseconds out of range: ' + nanoseconds\n );\n }\n // Midnight at the beginning of 1/1/1 is the earliest Firestore supports.\n if (seconds < -62135596800) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Timestamp seconds out of range: ' + seconds\n );\n }\n // This will break in the year 10,000.\n if (seconds >= 253402300800) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Timestamp seconds out of range: ' + seconds\n );\n }\n }\n\n toDate(): Date {\n return new Date(this.toMillis());\n }\n\n toMillis(): number {\n return this.seconds * 1000 + this.nanoseconds / 1e6;\n }\n\n _compareTo(other: Timestamp): number {\n if (this.seconds === other.seconds) {\n return primitiveComparator(this.nanoseconds, other.nanoseconds);\n }\n return primitiveComparator(this.seconds, other.seconds);\n }\n\n isEqual(other: Timestamp): boolean {\n return (\n other.seconds === this.seconds && other.nanoseconds === this.nanoseconds\n );\n }\n\n toString(): string {\n return (\n 'Timestamp(seconds=' +\n this.seconds +\n ', nanoseconds=' +\n this.nanoseconds +\n ')'\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Timestamp } from '../api/timestamp';\n\n/**\n * A version of a document in Firestore. This corresponds to the version\n * timestamp, such as update_time or read_time.\n */\nexport class SnapshotVersion {\n static readonly MIN = new SnapshotVersion(new Timestamp(0, 0));\n\n // TODO(b/34176344): Once we no longer need to use the old alpha protos,\n // delete this constructor and use a timestamp-backed version everywhere.\n static fromMicroseconds(value: number): SnapshotVersion {\n const seconds = Math.floor(value / 1e6);\n const nanos = (value % 1e6) * 1e3;\n return new SnapshotVersion(new Timestamp(seconds, nanos));\n }\n\n static fromTimestamp(value: Timestamp): SnapshotVersion {\n return new SnapshotVersion(value);\n }\n\n static forDeletedDoc(): SnapshotVersion {\n return SnapshotVersion.MIN;\n }\n\n private constructor(private timestamp: Timestamp) {}\n\n compareTo(other: SnapshotVersion): number {\n return this.timestamp._compareTo(other.timestamp);\n }\n\n isEqual(other: SnapshotVersion): boolean {\n return this.timestamp.isEqual(other.timestamp);\n }\n\n /** Returns a number representation of the version for use in spec tests. */\n toMicroseconds(): number {\n // Convert to microseconds.\n return this.timestamp.seconds * 1e6 + this.timestamp.nanoseconds / 1000;\n }\n\n toString(): string {\n return 'SnapshotVersion(' + this.timestamp.toString() + ')';\n }\n\n toTimestamp(): Timestamp {\n return this.timestamp;\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { assert, fail } from '../util/assert';\nimport { Code, FirestoreError } from '../util/error';\n\nexport const DOCUMENT_KEY_NAME = '__name__';\n\n/**\n * Path represents an ordered sequence of string segments.\n */\nabstract class BasePath<B extends BasePath<B>> {\n private segments: string[];\n private offset: number;\n private len: number;\n\n constructor(segments: string[], offset?: number, length?: number) {\n if (offset === undefined) {\n offset = 0;\n } else if (offset > segments.length) {\n fail('offset ' + offset + ' out of range ' + segments.length);\n }\n\n if (length === undefined) {\n length = segments.length - offset;\n } else if (length > segments.length - offset) {\n fail('length ' + length + ' out of range ' + (segments.length - offset));\n }\n this.segments = segments;\n this.offset = offset;\n this.len = length;\n }\n\n /**\n * Abstract constructor method to construct an instance of B with the given\n * parameters.\n */\n protected abstract construct(\n segments: string[],\n offset?: number,\n length?: number\n ): B;\n\n /**\n * Returns a String representation.\n *\n * Implementing classes are required to provide deterministic implementations as\n * the String representation is used to obtain canonical Query IDs.\n */\n abstract toString(): string;\n\n get length(): number {\n return this.len;\n }\n\n isEqual(other: B): boolean {\n return BasePath.comparator(this, other) === 0;\n }\n\n child(nameOrPath: string | B): B {\n const segments = this.segments.slice(this.offset, this.limit());\n if (nameOrPath instanceof BasePath) {\n nameOrPath.forEach(segment => {\n segments.push(segment);\n });\n } else {\n segments.push(nameOrPath);\n }\n return this.construct(segments);\n }\n\n /** The index of one past the last segment of the path. */\n private limit(): number {\n return this.offset + this.length;\n }\n\n popFirst(size?: number): B {\n size = size === undefined ? 1 : size;\n assert(this.length >= size, \"Can't call popFirst() with less segments\");\n return this.construct(\n this.segments,\n this.offset + size,\n this.length - size\n );\n }\n\n popLast(): B {\n assert(!this.isEmpty(), \"Can't call popLast() on empty path\");\n return this.construct(this.segments, this.offset, this.length - 1);\n }\n\n firstSegment(): string {\n assert(!this.isEmpty(), \"Can't call firstSegment() on empty path\");\n return this.segments[this.offset];\n }\n\n lastSegment(): string {\n return this.get(this.length - 1);\n }\n\n get(index: number): string {\n assert(index < this.length, 'Index out of range');\n return this.segments[this.offset + index];\n }\n\n isEmpty(): boolean {\n return this.length === 0;\n }\n\n isPrefixOf(other: this): boolean {\n if (other.length < this.length) {\n return false;\n }\n\n for (let i = 0; i < this.length; i++) {\n if (this.get(i) !== other.get(i)) {\n return false;\n }\n }\n\n return true;\n }\n\n isImmediateParentOf(potentialChild: this): boolean {\n if (this.length + 1 !== potentialChild.length) {\n return false;\n }\n\n for (let i = 0; i < this.length; i++) {\n if (this.get(i) !== potentialChild.get(i)) {\n return false;\n }\n }\n\n return true;\n }\n\n forEach(fn: (segment: string) => void): void {\n for (let i = this.offset, end = this.limit(); i < end; i++) {\n fn(this.segments[i]);\n }\n }\n\n toArray(): string[] {\n return this.segments.slice(this.offset, this.limit());\n }\n\n static comparator<T extends BasePath<T>>(\n p1: BasePath<T>,\n p2: BasePath<T>\n ): number {\n const len = Math.min(p1.length, p2.length);\n for (let i = 0; i < len; i++) {\n const left = p1.get(i);\n const right = p2.get(i);\n if (left < right) {\n return -1;\n }\n if (left > right) {\n return 1;\n }\n }\n if (p1.length < p2.length) {\n return -1;\n }\n if (p1.length > p2.length) {\n return 1;\n }\n return 0;\n }\n}\n\n/**\n * A slash-separated path for navigating resources (documents and collections)\n * within Firestore.\n */\nexport class ResourcePath extends BasePath<ResourcePath> {\n protected construct(\n segments: string[],\n offset?: number,\n length?: number\n ): ResourcePath {\n return new ResourcePath(segments, offset, length);\n }\n\n canonicalString(): string {\n // NOTE: The client is ignorant of any path segments containing escape\n // sequences (e.g. __id123__) and just passes them through raw (they exist\n // for legacy reasons and should not be used frequently).\n\n return this.toArray().join('/');\n }\n\n toString(): string {\n return this.canonicalString();\n }\n\n /**\n * Creates a resource path from the given slash-delimited string.\n */\n static fromString(path: string): ResourcePath {\n // NOTE: The client is ignorant of any path segments containing escape\n // sequences (e.g. __id123__) and just passes them through raw (they exist\n // for legacy reasons and should not be used frequently).\n\n if (path.indexOf('//') >= 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid path (${path}). Paths must not contain // in them.`\n );\n }\n\n // We may still have an empty segment at the beginning or end if they had a\n // leading or trailing slash (which we allow).\n const segments = path.split('/').filter(segment => segment.length > 0);\n\n return new ResourcePath(segments);\n }\n\n static EMPTY_PATH = new ResourcePath([]);\n}\n\nconst identifierRegExp = /^[_a-zA-Z][_a-zA-Z0-9]*$/;\n\n/** A dot-separated path for navigating sub-objects within a document. */\nexport class FieldPath extends BasePath<FieldPath> {\n protected construct(\n segments: string[],\n offset?: number,\n length?: number\n ): FieldPath {\n return new FieldPath(segments, offset, length);\n }\n\n /**\n * Returns true if the string could be used as a segment in a field path\n * without escaping.\n */\n private static isValidIdentifier(segment: string): boolean {\n return identifierRegExp.test(segment);\n }\n\n canonicalString(): string {\n return this.toArray()\n .map(str => {\n str = str.replace('\\\\', '\\\\\\\\').replace('`', '\\\\`');\n if (!FieldPath.isValidIdentifier(str)) {\n str = '`' + str + '`';\n }\n return str;\n })\n .join('.');\n }\n\n toString(): string {\n return this.canonicalString();\n }\n\n /**\n * Returns true if this field references the key of a document.\n */\n isKeyField(): boolean {\n return this.length === 1 && this.get(0) === DOCUMENT_KEY_NAME;\n }\n\n /**\n * The field designating the key of a document.\n */\n static keyField(): FieldPath {\n return new FieldPath([DOCUMENT_KEY_NAME]);\n }\n\n /**\n * Parses a field string from the given server-formatted string.\n *\n * - Splitting the empty string is not allowed (for now at least).\n * - Empty segments within the string (e.g. if there are two consecutive\n * separators) are not allowed.\n *\n * TODO(b/37244157): we should make this more strict. Right now, it allows\n * non-identifier path components, even if they aren't escaped.\n */\n static fromServerFormat(path: string): FieldPath {\n const segments: string[] = [];\n let current = '';\n let i = 0;\n\n const addCurrentSegment = (): void => {\n if (current.length === 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid field path (${path}). Paths must not be empty, begin ` +\n `with '.', end with '.', or contain '..'`\n );\n }\n segments.push(current);\n current = '';\n };\n\n let inBackticks = false;\n\n while (i < path.length) {\n const c = path[i];\n if (c === '\\\\') {\n if (i + 1 === path.length) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Path has trailing escape character: ' + path\n );\n }\n const next = path[i + 1];\n if (!(next === '\\\\' || next === '.' || next === '`')) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Path has invalid escape sequence: ' + path\n );\n }\n current += next;\n i += 2;\n } else if (c === '`') {\n inBackticks = !inBackticks;\n i++;\n } else if (c === '.' && !inBackticks) {\n addCurrentSegment();\n i++;\n } else {\n current += c;\n i++;\n }\n }\n addCurrentSegment();\n\n if (inBackticks) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Unterminated ` in path: ' + path\n );\n }\n\n return new FieldPath(segments);\n }\n\n static EMPTY_PATH = new FieldPath([]);\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { assert } from '../util/assert';\n\nimport { ResourcePath } from './path';\n\nexport class DocumentKey {\n constructor(readonly path: ResourcePath) {\n assert(\n DocumentKey.isDocumentKey(path),\n 'Invalid DocumentKey with an odd number of segments: ' +\n path.toArray().join('/')\n );\n }\n\n /** Returns true if the document is in the specified collectionId. */\n hasCollectionId(collectionId: string): boolean {\n return (\n this.path.length >= 2 &&\n this.path.get(this.path.length - 2) === collectionId\n );\n }\n\n isEqual(other: DocumentKey | null): boolean {\n return (\n other !== null && ResourcePath.comparator(this.path, other.path) === 0\n );\n }\n\n toString(): string {\n return this.path.toString();\n }\n\n static EMPTY = new DocumentKey(new ResourcePath([]));\n\n static comparator(k1: DocumentKey, k2: DocumentKey): number {\n return ResourcePath.comparator(k1.path, k2.path);\n }\n\n static isDocumentKey(path: ResourcePath): boolean {\n return path.length % 2 === 0;\n }\n\n /**\n * Creates and returns a new document key with the given segments.\n *\n * @param path The segments of the path to the document\n * @return A new instance of DocumentKey\n */\n static fromSegments(segments: string[]): DocumentKey {\n return new DocumentKey(new ResourcePath(segments.slice()));\n }\n\n /**\n * Creates and returns a new document key using '/' to split the string into\n * segments.\n *\n * @param path The slash-separated path string to the document\n * @return A new instance of DocumentKey\n */\n static fromPathString(path: string): DocumentKey {\n return new DocumentKey(ResourcePath.fromString(path));\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { assert, fail } from './assert';\n\n/*\n * Implementation of an immutable SortedMap using a Left-leaning\n * Red-Black Tree, adapted from the implementation in Mugs\n * (http://mads379.github.com/mugs/) by Mads Hartmann Jensen\n * (mads379@gmail.com).\n *\n * Original paper on Left-leaning Red-Black Trees:\n * http://www.cs.princeton.edu/~rs/talks/LLRB/LLRB.pdf\n *\n * Invariant 1: No red node has a red child\n * Invariant 2: Every leaf path has the same number of black nodes\n * Invariant 3: Only the left child can be red (left leaning)\n */\n\nexport type Comparator<K> = (key1: K, key2: K) => number;\n\nexport interface Entry<K, V> {\n key: K;\n value: V;\n}\n\n// An immutable sorted map implementation, based on a Left-leaning Red-Black\n// tree.\nexport class SortedMap<K, V> {\n // visible for testing\n root: LLRBNode<K, V> | LLRBEmptyNode<K, V>;\n\n constructor(\n public comparator: Comparator<K>,\n root?: LLRBNode<K, V> | LLRBEmptyNode<K, V>\n ) {\n this.root = root ? root : LLRBNode.EMPTY;\n }\n\n // Returns a copy of the map, with the specified key/value added or replaced.\n insert(key: K, value: V): SortedMap<K, V> {\n return new SortedMap<K, V>(\n this.comparator,\n this.root\n .insert(key, value, this.comparator)\n .copy(null, null, LLRBNode.BLACK, null, null)\n );\n }\n\n // Returns a copy of the map, with the specified key removed.\n remove(key: K): SortedMap<K, V> {\n return new SortedMap<K, V>(\n this.comparator,\n this.root\n .remove(key, this.comparator)\n .copy(null, null, LLRBNode.BLACK, null, null)\n );\n }\n\n // Returns the value of the node with the given key, or null.\n get(key: K): V | null {\n let node = this.root;\n while (!node.isEmpty()) {\n const cmp = this.comparator(key, node.key);\n if (cmp === 0) {\n return node.value;\n } else if (cmp < 0) {\n node = node.left;\n } else if (cmp > 0) {\n node = node.right;\n }\n }\n return null;\n }\n\n // Returns the index of the element in this sorted map, or -1 if it doesn't\n // exist.\n indexOf(key: K): number {\n // Number of nodes that were pruned when descending right\n let prunedNodes = 0;\n let node = this.root;\n while (!node.isEmpty()) {\n const cmp = this.comparator(key, node.key);\n if (cmp === 0) {\n return prunedNodes + node.left.size;\n } else if (cmp < 0) {\n node = node.left;\n } else {\n // Count all nodes left of the node plus the node itself\n prunedNodes += node.left.size + 1;\n node = node.right;\n }\n }\n // Node not found\n return -1;\n }\n\n isEmpty(): boolean {\n return this.root.isEmpty();\n }\n\n // Returns the total number of nodes in the map.\n get size(): number {\n return this.root.size;\n }\n\n // Returns the minimum key in the map.\n minKey(): K | null {\n return this.root.minKey();\n }\n\n // Returns the maximum key in the map.\n maxKey(): K | null {\n return this.root.maxKey();\n }\n\n // Traverses the map in key order and calls the specified action function\n // for each key/value pair. If action returns true, traversal is aborted.\n // Returns the first truthy value returned by action, or the last falsey\n // value returned by action.\n inorderTraversal<T>(action: (k: K, v: V) => T): T {\n return (this.root as LLRBNode<K, V>).inorderTraversal(action);\n }\n\n forEach(fn: (k: K, v: V) => void): void {\n this.inorderTraversal((k, v) => {\n fn(k, v);\n return false;\n });\n }\n\n toString(): string {\n const descriptions: string[] = [];\n this.inorderTraversal((k, v) => {\n descriptions.push(`${k}:${v}`);\n return false;\n });\n return `{${descriptions.join(', ')}}`;\n }\n\n // Traverses the map in reverse key order and calls the specified action\n // function for each key/value pair. If action returns true, traversal is\n // aborted.\n // Returns the first truthy value returned by action, or the last falsey\n // value returned by action.\n reverseTraversal<T>(action: (k: K, v: V) => T): T {\n return (this.root as LLRBNode<K, V>).reverseTraversal(action);\n }\n\n // Returns an iterator over the SortedMap.\n getIterator(): SortedMapIterator<K, V> {\n return new SortedMapIterator<K, V>(this.root, null, this.comparator, false);\n }\n\n getIteratorFrom(key: K): SortedMapIterator<K, V> {\n return new SortedMapIterator<K, V>(this.root, key, this.comparator, false);\n }\n\n getReverseIterator(): SortedMapIterator<K, V> {\n return new SortedMapIterator<K, V>(this.root, null, this.comparator, true);\n }\n\n getReverseIteratorFrom(key: K): SortedMapIterator<K, V> {\n return new SortedMapIterator<K, V>(this.root, key, this.comparator, true);\n }\n} // end SortedMap\n\n// An iterator over an LLRBNode.\nexport class SortedMapIterator<K, V> {\n private isReverse: boolean;\n private nodeStack: Array<LLRBNode<K, V> | LLRBEmptyNode<K, V>>;\n\n constructor(\n node: LLRBNode<K, V> | LLRBEmptyNode<K, V>,\n startKey: K | null,\n comparator: Comparator<K>,\n isReverse: boolean\n ) {\n this.isReverse = isReverse;\n this.nodeStack = [];\n\n let cmp = 1;\n while (!node.isEmpty()) {\n cmp = startKey ? comparator(node.key, startKey) : 1;\n // flip the comparison if we're going in reverse\n if (isReverse) {\n cmp *= -1;\n }\n\n if (cmp < 0) {\n // This node is less than our start key. ignore it\n if (this.isReverse) {\n node = node.left;\n } else {\n node = node.right;\n }\n } else if (cmp === 0) {\n // This node is exactly equal to our start key. Push it on the stack,\n // but stop iterating;\n this.nodeStack.push(node);\n break;\n } else {\n // This node is greater than our start key, add it to the stack and move\n // to the next one\n this.nodeStack.push(node);\n if (this.isReverse) {\n node = node.right;\n } else {\n node = node.left;\n }\n }\n }\n }\n\n getNext(): Entry<K, V> {\n assert(\n this.nodeStack.length > 0,\n 'getNext() called on iterator when hasNext() is false.'\n );\n\n let node = this.nodeStack.pop()!;\n const result = { key: node.key, value: node.value };\n\n if (this.isReverse) {\n node = node.left;\n while (!node.isEmpty()) {\n this.nodeStack.push(node);\n node = node.right;\n }\n } else {\n node = node.right;\n while (!node.isEmpty()) {\n this.nodeStack.push(node);\n node = node.left;\n }\n }\n\n return result;\n }\n\n hasNext(): boolean {\n return this.nodeStack.length > 0;\n }\n\n peek(): Entry<K, V> | null {\n if (this.nodeStack.length === 0) {\n return null;\n }\n\n const node = this.nodeStack[this.nodeStack.length - 1];\n return { key: node.key, value: node.value };\n }\n} // end SortedMapIterator\n\n// Represents a node in a Left-leaning Red-Black tree.\nexport class LLRBNode<K, V> {\n readonly color: boolean;\n readonly left: LLRBNode<K, V> | LLRBEmptyNode<K, V>;\n readonly right: LLRBNode<K, V> | LLRBEmptyNode<K, V>;\n readonly size: number;\n\n // Empty node is shared between all LLRB trees.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n static EMPTY: LLRBEmptyNode<any, any> = null as any;\n\n static RED = true;\n static BLACK = false;\n\n constructor(\n public key: K,\n public value: V,\n color?: boolean,\n left?: LLRBNode<K, V> | LLRBEmptyNode<K, V>,\n right?: LLRBNode<K, V> | LLRBEmptyNode<K, V>\n ) {\n this.color = color != null ? color : LLRBNode.RED;\n this.left = left != null ? left : LLRBNode.EMPTY;\n this.right = right != null ? right : LLRBNode.EMPTY;\n this.size = this.left.size + 1 + this.right.size;\n }\n\n // Returns a copy of the current node, optionally replacing pieces of it.\n copy(\n key: K | null,\n value: V | null,\n color: boolean | null,\n left: LLRBNode<K, V> | LLRBEmptyNode<K, V> | null,\n right: LLRBNode<K, V> | LLRBEmptyNode<K, V> | null\n ): LLRBNode<K, V> {\n return new LLRBNode<K, V>(\n key != null ? key : this.key,\n value != null ? value : this.value,\n color != null ? color : this.color,\n left != null ? left : this.left,\n right != null ? right : this.right\n );\n }\n\n isEmpty(): boolean {\n return false;\n }\n\n // Traverses the tree in key order and calls the specified action function\n // for each node. If action returns true, traversal is aborted.\n // Returns the first truthy value returned by action, or the last falsey\n // value returned by action.\n inorderTraversal<T>(action: (k: K, v: V) => T): T {\n return (\n (this.left as LLRBNode<K, V>).inorderTraversal(action) ||\n action(this.key, this.value) ||\n (this.right as LLRBNode<K, V>).inorderTraversal(action)\n );\n }\n\n // Traverses the tree in reverse key order and calls the specified action\n // function for each node. If action returns true, traversal is aborted.\n // Returns the first truthy value returned by action, or the last falsey\n // value returned by action.\n reverseTraversal<T>(action: (k: K, v: V) => T): T {\n return (\n (this.right as LLRBNode<K, V>).reverseTraversal(action) ||\n action(this.key, this.value) ||\n (this.left as LLRBNode<K, V>).reverseTraversal(action)\n );\n }\n\n // Returns the minimum node in the tree.\n private min(): LLRBNode<K, V> {\n if (this.left.isEmpty()) {\n return this;\n } else {\n return (this.left as LLRBNode<K, V>).min();\n }\n }\n\n // Returns the maximum key in the tree.\n minKey(): K | null {\n return this.min().key;\n }\n\n // Returns the maximum key in the tree.\n maxKey(): K | null {\n if (this.right.isEmpty()) {\n return this.key;\n } else {\n return this.right.maxKey();\n }\n }\n\n // Returns new tree, with the key/value added.\n insert(key: K, value: V, comparator: Comparator<K>): LLRBNode<K, V> {\n let n: LLRBNode<K, V> = this;\n const cmp = comparator(key, n.key);\n if (cmp < 0) {\n n = n.copy(null, null, null, n.left.insert(key, value, comparator), null);\n } else if (cmp === 0) {\n n = n.copy(null, value, null, null, null);\n } else {\n n = n.copy(\n null,\n null,\n null,\n null,\n n.right.insert(key, value, comparator)\n );\n }\n return n.fixUp();\n }\n\n private removeMin(): LLRBNode<K, V> | LLRBEmptyNode<K, V> {\n if (this.left.isEmpty()) {\n return LLRBNode.EMPTY;\n }\n let n: LLRBNode<K, V> = this;\n if (!n.left.isRed() && !n.left.left.isRed()) {\n n = n.moveRedLeft();\n }\n n = n.copy(null, null, null, (n.left as LLRBNode<K, V>).removeMin(), null);\n return n.fixUp();\n }\n\n // Returns new tree, with the specified item removed.\n remove(\n key: K,\n comparator: Comparator<K>\n ): LLRBNode<K, V> | LLRBEmptyNode<K, V> {\n let smallest: LLRBNode<K, V>;\n let n: LLRBNode<K, V> = this;\n if (comparator(key, n.key) < 0) {\n if (!n.left.isEmpty() && !n.left.isRed() && !n.left.left.isRed()) {\n n = n.moveRedLeft();\n }\n n = n.copy(null, null, null, n.left.remove(key, comparator), null);\n } else {\n if (n.left.isRed()) {\n n = n.rotateRight();\n }\n if (!n.right.isEmpty() && !n.right.isRed() && !n.right.left.isRed()) {\n n = n.moveRedRight();\n }\n if (comparator(key, n.key) === 0) {\n if (n.right.isEmpty()) {\n return LLRBNode.EMPTY;\n } else {\n smallest = (n.right as LLRBNode<K, V>).min();\n n = n.copy(\n smallest.key,\n smallest.value,\n null,\n null,\n (n.right as LLRBNode<K, V>).removeMin()\n );\n }\n }\n n = n.copy(null, null, null, null, n.right.remove(key, comparator));\n }\n return n.fixUp();\n }\n\n isRed(): boolean {\n return this.color;\n }\n\n // Returns new tree after performing any needed rotations.\n private fixUp(): LLRBNode<K, V> {\n let n: LLRBNode<K, V> = this;\n if (n.right.isRed() && !n.left.isRed()) {\n n = n.rotateLeft();\n }\n if (n.left.isRed() && n.left.left.isRed()) {\n n = n.rotateRight();\n }\n if (n.left.isRed() && n.right.isRed()) {\n n = n.colorFlip();\n }\n return n;\n }\n\n private moveRedLeft(): LLRBNode<K, V> {\n let n = this.colorFlip();\n if (n.right.left.isRed()) {\n n = n.copy(\n null,\n null,\n null,\n null,\n (n.right as LLRBNode<K, V>).rotateRight()\n );\n n = n.rotateLeft();\n n = n.colorFlip();\n }\n return n;\n }\n\n private moveRedRight(): LLRBNode<K, V> {\n let n = this.colorFlip();\n if (n.left.left.isRed()) {\n n = n.rotateRight();\n n = n.colorFlip();\n }\n return n;\n }\n\n private rotateLeft(): LLRBNode<K, V> {\n const nl = this.copy(null, null, LLRBNode.RED, null, this.right.left);\n return (this.right as LLRBNode<K, V>).copy(\n null,\n null,\n this.color,\n nl,\n null\n );\n }\n\n private rotateRight(): LLRBNode<K, V> {\n const nr = this.copy(null, null, LLRBNode.RED, this.left.right, null);\n return (this.left as LLRBNode<K, V>).copy(null, null, this.color, null, nr);\n }\n\n private colorFlip(): LLRBNode<K, V> {\n const left = this.left.copy(null, null, !this.left.color, null, null);\n const right = this.right.copy(null, null, !this.right.color, null, null);\n return this.copy(null, null, !this.color, left, right);\n }\n\n // For testing.\n checkMaxDepth(): boolean {\n const blackDepth = this.check();\n if (Math.pow(2.0, blackDepth) <= this.size + 1) {\n return true;\n } else {\n return false;\n }\n }\n\n // In a balanced RB tree, the black-depth (number of black nodes) from root to\n // leaves is equal on both sides. This function verifies that or asserts.\n protected check(): number {\n if (this.isRed() && this.left.isRed()) {\n throw fail('Red node has red child(' + this.key + ',' + this.value + ')');\n }\n if (this.right.isRed()) {\n throw fail('Right child of (' + this.key + ',' + this.value + ') is red');\n }\n const blackDepth = (this.left as LLRBNode<K, V>).check();\n if (blackDepth !== (this.right as LLRBNode<K, V>).check()) {\n throw fail('Black depths differ');\n } else {\n return blackDepth + (this.isRed() ? 0 : 1);\n }\n }\n} // end LLRBNode\n\n// Represents an empty node (a leaf node in the Red-Black Tree).\nexport class LLRBEmptyNode<K, V> {\n get key(): never {\n throw fail('LLRBEmptyNode has no key.');\n }\n get value(): never {\n throw fail('LLRBEmptyNode has no value.');\n }\n get color(): never {\n throw fail('LLRBEmptyNode has no color.');\n }\n get left(): never {\n throw fail('LLRBEmptyNode has no left child.');\n }\n get right(): never {\n throw fail('LLRBEmptyNode has no right child.');\n }\n size = 0;\n\n // Returns a copy of the current node.\n copy(\n key: K | null,\n value: V | null,\n color: boolean | null,\n left: LLRBNode<K, V> | LLRBEmptyNode<K, V> | null,\n right: LLRBNode<K, V> | LLRBEmptyNode<K, V> | null\n ): LLRBEmptyNode<K, V> {\n return this;\n }\n\n // Returns a copy of the tree, with the specified key/value added.\n insert(key: K, value: V, comparator: Comparator<K>): LLRBNode<K, V> {\n return new LLRBNode<K, V>(key, value);\n }\n\n // Returns a copy of the tree, with the specified key removed.\n remove(key: K, comparator: Comparator<K>): LLRBEmptyNode<K, V> {\n return this;\n }\n\n isEmpty(): boolean {\n return true;\n }\n\n inorderTraversal(action: (k: K, v: V) => boolean): boolean {\n return false;\n }\n\n reverseTraversal(action: (k: K, v: V) => boolean): boolean {\n return false;\n }\n\n minKey(): K | null {\n return null;\n }\n\n maxKey(): K | null {\n return null;\n }\n\n isRed(): boolean {\n return false;\n }\n\n // For testing.\n checkMaxDepth(): boolean {\n return true;\n }\n\n protected check(): 0 {\n return 0;\n }\n} // end LLRBEmptyNode\n\nLLRBNode.EMPTY = new LLRBEmptyNode<unknown, unknown>();\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { SortedMap, SortedMapIterator } from './sorted_map';\n\n/**\n * SortedSet is an immutable (copy-on-write) collection that holds elements\n * in order specified by the provided comparator.\n *\n * NOTE: if provided comparator returns 0 for two elements, we consider them to\n * be equal!\n */\nexport class SortedSet<T> {\n private data: SortedMap<T, boolean>;\n\n constructor(private comparator: (left: T, right: T) => number) {\n this.data = new SortedMap<T, boolean>(this.comparator);\n }\n\n /**\n * Creates a SortedSet from the keys of the map.\n * This is currently implemented as an O(n) copy.\n */\n static fromMapKeys<K, V>(map: SortedMap<K, V>): SortedSet<K> {\n let keys = new SortedSet<K>(map.comparator);\n map.forEach(key => {\n keys = keys.add(key);\n });\n return keys;\n }\n\n has(elem: T): boolean {\n return this.data.get(elem) !== null;\n }\n\n first(): T | null {\n return this.data.minKey();\n }\n\n last(): T | null {\n return this.data.maxKey();\n }\n\n get size(): number {\n return this.data.size;\n }\n\n indexOf(elem: T): number {\n return this.data.indexOf(elem);\n }\n\n /** Iterates elements in order defined by \"comparator\" */\n forEach(cb: (elem: T) => void): void {\n this.data.inorderTraversal((k: T, v: boolean) => {\n cb(k);\n return false;\n });\n }\n\n /** Iterates over `elem`s such that: range[0] <= elem < range[1]. */\n forEachInRange(range: [T, T], cb: (elem: T) => void): void {\n const iter = this.data.getIteratorFrom(range[0]);\n while (iter.hasNext()) {\n const elem = iter.getNext();\n if (this.comparator(elem.key, range[1]) >= 0) {\n return;\n }\n cb(elem.key);\n }\n }\n\n /**\n * Iterates over `elem`s such that: start <= elem until false is returned.\n */\n forEachWhile(cb: (elem: T) => boolean, start?: T): void {\n let iter: SortedMapIterator<T, boolean>;\n if (start !== undefined) {\n iter = this.data.getIteratorFrom(start);\n } else {\n iter = this.data.getIterator();\n }\n while (iter.hasNext()) {\n const elem = iter.getNext();\n const result = cb(elem.key);\n if (!result) {\n return;\n }\n }\n }\n\n /** Finds the least element greater than or equal to `elem`. */\n firstAfterOrEqual(elem: T): T | null {\n const iter = this.data.getIteratorFrom(elem);\n return iter.hasNext() ? iter.getNext().key : null;\n }\n\n getIterator(): SortedSetIterator<T> {\n return new SortedSetIterator<T>(this.data.getIterator());\n }\n\n getIteratorFrom(key: T): SortedSetIterator<T> {\n return new SortedSetIterator<T>(this.data.getIteratorFrom(key));\n }\n\n /** Inserts or updates an element */\n add(elem: T): SortedSet<T> {\n return this.copy(this.data.remove(elem).insert(elem, true));\n }\n\n /** Deletes an element */\n delete(elem: T): SortedSet<T> {\n if (!this.has(elem)) {\n return this;\n }\n return this.copy(this.data.remove(elem));\n }\n\n isEmpty(): boolean {\n return this.data.isEmpty();\n }\n\n unionWith(other: SortedSet<T>): SortedSet<T> {\n let result: SortedSet<T> = this;\n other.forEach(elem => {\n result = result.add(elem);\n });\n return result;\n }\n\n isEqual(other: SortedSet<T>): boolean {\n if (!(other instanceof SortedSet)) {\n return false;\n }\n if (this.size !== other.size) {\n return false;\n }\n\n const thisIt = this.data.getIterator();\n const otherIt = other.data.getIterator();\n while (thisIt.hasNext()) {\n const thisElem = thisIt.getNext().key;\n const otherElem = otherIt.getNext().key;\n if (this.comparator(thisElem, otherElem) !== 0) {\n return false;\n }\n }\n return true;\n }\n\n toArray(): T[] {\n const res: T[] = [];\n this.forEach(targetId => {\n res.push(targetId);\n });\n return res;\n }\n\n toString(): string {\n const result: T[] = [];\n this.forEach(elem => result.push(elem));\n return 'SortedSet(' + result.toString() + ')';\n }\n\n private copy(data: SortedMap<T, boolean>): SortedSet<T> {\n const result = new SortedSet(this.comparator);\n result.data = data;\n return result;\n }\n}\n\nexport class SortedSetIterator<T> {\n constructor(private iter: SortedMapIterator<T, boolean>) {}\n\n getNext(): T {\n return this.iter.getNext().key;\n }\n\n hasNext(): boolean {\n return this.iter.hasNext();\n }\n}\n","/**\n * @license\n * Copyright 2018 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Timestamp } from '../api/timestamp';\nimport { assert } from '../util/assert';\nimport * as misc from '../util/misc';\nimport {\n ArrayValue,\n DoubleValue,\n FieldValue,\n IntegerValue,\n NumberValue,\n ServerTimestampValue\n} from './field_value';\n\n/** Represents a transform within a TransformMutation. */\nexport interface TransformOperation {\n /**\n * Computes the local transform result against the provided `previousValue`,\n * optionally using the provided localWriteTime.\n */\n applyToLocalView(\n previousValue: FieldValue | null,\n localWriteTime: Timestamp\n ): FieldValue;\n\n /**\n * Computes a final transform result after the transform has been acknowledged\n * by the server, potentially using the server-provided transformResult.\n */\n applyToRemoteDocument(\n previousValue: FieldValue | null,\n transformResult: FieldValue | null\n ): FieldValue;\n\n /**\n * If this transform operation is not idempotent, returns the base value to\n * persist for this transform. If a base value is returned, the transform\n * operation is always applied to this base value, even if document has\n * already been updated.\n *\n * Base values provide consistent behavior for non-idempotent transforms and\n * allow us to return the same latency-compensated value even if the backend\n * has already applied the transform operation. The base value is null for\n * idempotent transforms, as they can be re-played even if the backend has\n * already applied them.\n *\n * @return a base value to store along with the mutation, or null for\n * idempotent transforms.\n */\n computeBaseValue(previousValue: FieldValue | null): FieldValue | null;\n\n isEqual(other: TransformOperation): boolean;\n}\n\n/** Transforms a value into a server-generated timestamp. */\nexport class ServerTimestampTransform implements TransformOperation {\n private constructor() {}\n static instance = new ServerTimestampTransform();\n\n applyToLocalView(\n previousValue: FieldValue | null,\n localWriteTime: Timestamp\n ): FieldValue {\n return new ServerTimestampValue(localWriteTime!, previousValue);\n }\n\n applyToRemoteDocument(\n previousValue: FieldValue | null,\n transformResult: FieldValue | null\n ): FieldValue {\n return transformResult!;\n }\n\n computeBaseValue(previousValue: FieldValue | null): FieldValue | null {\n return null; // Server timestamps are idempotent and don't require a base value.\n }\n\n isEqual(other: TransformOperation): boolean {\n return other instanceof ServerTimestampTransform;\n }\n}\n\n/** Transforms an array value via a union operation. */\nexport class ArrayUnionTransformOperation implements TransformOperation {\n constructor(readonly elements: FieldValue[]) {}\n\n applyToLocalView(\n previousValue: FieldValue | null,\n localWriteTime: Timestamp\n ): FieldValue {\n return this.apply(previousValue);\n }\n\n applyToRemoteDocument(\n previousValue: FieldValue | null,\n transformResult: FieldValue | null\n ): FieldValue {\n // The server just sends null as the transform result for array operations,\n // so we have to calculate a result the same as we do for local\n // applications.\n return this.apply(previousValue);\n }\n\n private apply(previousValue: FieldValue | null): FieldValue {\n const result = coercedFieldValuesArray(previousValue);\n for (const toUnion of this.elements) {\n if (!result.find(element => element.isEqual(toUnion))) {\n result.push(toUnion);\n }\n }\n return new ArrayValue(result);\n }\n\n computeBaseValue(previousValue: FieldValue | null): FieldValue | null {\n return null; // Array transforms are idempotent and don't require a base value.\n }\n\n isEqual(other: TransformOperation): boolean {\n return (\n other instanceof ArrayUnionTransformOperation &&\n misc.arrayEquals(other.elements, this.elements)\n );\n }\n}\n\n/** Transforms an array value via a remove operation. */\nexport class ArrayRemoveTransformOperation implements TransformOperation {\n constructor(readonly elements: FieldValue[]) {}\n\n applyToLocalView(\n previousValue: FieldValue | null,\n localWriteTime: Timestamp\n ): FieldValue {\n return this.apply(previousValue);\n }\n\n applyToRemoteDocument(\n previousValue: FieldValue | null,\n transformResult: FieldValue | null\n ): FieldValue {\n // The server just sends null as the transform result for array operations,\n // so we have to calculate a result the same as we do for local\n // applications.\n return this.apply(previousValue);\n }\n\n private apply(previousValue: FieldValue | null): FieldValue {\n let result = coercedFieldValuesArray(previousValue);\n for (const toRemove of this.elements) {\n result = result.filter(element => !element.isEqual(toRemove));\n }\n return new ArrayValue(result);\n }\n\n computeBaseValue(previousValue: FieldValue | null): FieldValue | null {\n return null; // Array transforms are idempotent and don't require a base value.\n }\n\n isEqual(other: TransformOperation): boolean {\n return (\n other instanceof ArrayRemoveTransformOperation &&\n misc.arrayEquals(other.elements, this.elements)\n );\n }\n}\n\n/**\n * Implements the backend semantics for locally computed NUMERIC_ADD (increment)\n * transforms. Converts all field values to integers or doubles, but unlike the\n * backend does not cap integer values at 2^63. Instead, JavaScript number\n * arithmetic is used and precision loss can occur for values greater than 2^53.\n */\nexport class NumericIncrementTransformOperation implements TransformOperation {\n constructor(readonly operand: NumberValue) {}\n\n applyToLocalView(\n previousValue: FieldValue | null,\n localWriteTime: Timestamp\n ): FieldValue {\n const baseValue = this.computeBaseValue(previousValue);\n // PORTING NOTE: Since JavaScript's integer arithmetic is limited to 53 bit\n // precision and resolves overflows by reducing precision, we do not\n // manually cap overflows at 2^63.\n\n // Return an integer value iff the previous value and the operand is an\n // integer.\n if (\n baseValue instanceof IntegerValue &&\n this.operand instanceof IntegerValue\n ) {\n const sum = baseValue.internalValue + this.operand.internalValue;\n return new IntegerValue(sum);\n } else {\n const sum = baseValue.internalValue + this.operand.internalValue;\n return new DoubleValue(sum);\n }\n }\n\n applyToRemoteDocument(\n previousValue: FieldValue | null,\n transformResult: FieldValue | null\n ): FieldValue {\n assert(\n transformResult !== null,\n \"Didn't receive transformResult for NUMERIC_ADD transform\"\n );\n return transformResult;\n }\n\n /**\n * Inspects the provided value, returning the provided value if it is already\n * a NumberValue, otherwise returning a coerced IntegerValue of 0.\n */\n computeBaseValue(previousValue: FieldValue | null): NumberValue {\n return previousValue instanceof NumberValue\n ? previousValue\n : new IntegerValue(0);\n }\n\n isEqual(other: TransformOperation): boolean {\n return (\n other instanceof NumericIncrementTransformOperation &&\n this.operand.isEqual(other.operand)\n );\n }\n}\n\nfunction coercedFieldValuesArray(value: FieldValue | null): FieldValue[] {\n if (value instanceof ArrayValue) {\n return value.internalValue.slice();\n } else {\n // coerce to empty array.\n return [];\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Timestamp } from '../api/timestamp';\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { assert, fail } from '../util/assert';\nimport * as misc from '../util/misc';\nimport { SortedSet } from '../util/sorted_set';\n\nimport {\n Document,\n MaybeDocument,\n NoDocument,\n UnknownDocument\n} from './document';\nimport { DocumentKey } from './document_key';\nimport { FieldValue, ObjectValue } from './field_value';\nimport { FieldPath } from './path';\nimport { TransformOperation } from './transform_operation';\n\n/**\n * Provides a set of fields that can be used to partially patch a document.\n * FieldMask is used in conjunction with ObjectValue.\n * Examples:\n * foo - Overwrites foo entirely with the provided value. If foo is not\n * present in the companion ObjectValue, the field is deleted.\n * foo.bar - Overwrites only the field bar of the object foo.\n * If foo is not an object, foo is replaced with an object\n * containing foo\n */\nexport class FieldMask {\n constructor(readonly fields: SortedSet<FieldPath>) {\n // TODO(dimond): validation of FieldMask\n }\n\n static fromSet(fields: SortedSet<FieldPath>): FieldMask {\n return new FieldMask(fields);\n }\n\n static fromArray(fields: FieldPath[]): FieldMask {\n let fieldsAsSet = new SortedSet<FieldPath>(FieldPath.comparator);\n fields.forEach(fieldPath => (fieldsAsSet = fieldsAsSet.add(fieldPath)));\n return new FieldMask(fieldsAsSet);\n }\n\n /**\n * Verifies that `fieldPath` is included by at least one field in this field\n * mask.\n *\n * This is an O(n) operation, where `n` is the size of the field mask.\n */\n covers(fieldPath: FieldPath): boolean {\n let found = false;\n this.fields.forEach(fieldMaskPath => {\n if (fieldMaskPath.isPrefixOf(fieldPath)) {\n found = true;\n }\n });\n return found;\n }\n\n isEqual(other: FieldMask): boolean {\n return this.fields.isEqual(other.fields);\n }\n}\n\n/** A field path and the TransformOperation to perform upon it. */\nexport class FieldTransform {\n constructor(\n readonly field: FieldPath,\n readonly transform: TransformOperation\n ) {}\n\n isEqual(other: FieldTransform): boolean {\n return (\n this.field.isEqual(other.field) && this.transform.isEqual(other.transform)\n );\n }\n}\n\n/** The result of successfully applying a mutation to the backend. */\nexport class MutationResult {\n constructor(\n /**\n * The version at which the mutation was committed:\n *\n * - For most operations, this is the updateTime in the WriteResult.\n * - For deletes, the commitTime of the WriteResponse (because deletes are\n * not stored and have no updateTime).\n *\n * Note that these versions can be different: No-op writes will not change\n * the updateTime even though the commitTime advances.\n */\n readonly version: SnapshotVersion,\n /**\n * The resulting fields returned from the backend after a\n * TransformMutation has been committed. Contains one FieldValue for each\n * FieldTransform that was in the mutation.\n *\n * Will be null if the mutation was not a TransformMutation.\n */\n readonly transformResults: Array<FieldValue | null> | null\n ) {}\n}\n\nexport enum MutationType {\n Set,\n Patch,\n Transform,\n Delete,\n Verify\n}\n\n/**\n * Encodes a precondition for a mutation. This follows the model that the\n * backend accepts with the special case of an explicit \"empty\" precondition\n * (meaning no precondition).\n */\nexport class Precondition {\n static readonly NONE = new Precondition();\n\n private constructor(\n readonly updateTime?: SnapshotVersion,\n readonly exists?: boolean\n ) {\n assert(\n updateTime === undefined || exists === undefined,\n 'Precondition can specify \"exists\" or \"updateTime\" but not both'\n );\n }\n\n /** Creates a new Precondition with an exists flag. */\n static exists(exists: boolean): Precondition {\n return new Precondition(undefined, exists);\n }\n\n /** Creates a new Precondition based on a version a document exists at. */\n static updateTime(version: SnapshotVersion): Precondition {\n return new Precondition(version);\n }\n\n /** Returns whether this Precondition is empty. */\n get isNone(): boolean {\n return this.updateTime === undefined && this.exists === undefined;\n }\n\n /**\n * Returns true if the preconditions is valid for the given document\n * (or null if no document is available).\n */\n isValidFor(maybeDoc: MaybeDocument | null): boolean {\n if (this.updateTime !== undefined) {\n return (\n maybeDoc instanceof Document &&\n maybeDoc.version.isEqual(this.updateTime)\n );\n } else if (this.exists !== undefined) {\n return this.exists === maybeDoc instanceof Document;\n } else {\n assert(this.isNone, 'Precondition should be empty');\n return true;\n }\n }\n\n isEqual(other: Precondition): boolean {\n return (\n misc.equals(this.updateTime, other.updateTime) &&\n this.exists === other.exists\n );\n }\n}\n\n/**\n * A mutation describes a self-contained change to a document. Mutations can\n * create, replace, delete, and update subsets of documents.\n *\n * Mutations not only act on the value of the document but also its version.\n *\n * For local mutations (mutations that haven't been committed yet), we preserve\n * the existing version for Set, Patch, and Transform mutations. For Delete\n * mutations, we reset the version to 0.\n *\n * Here's the expected transition table.\n *\n * MUTATION APPLIED TO RESULTS IN\n *\n * SetMutation Document(v3) Document(v3)\n * SetMutation NoDocument(v3) Document(v0)\n * SetMutation null Document(v0)\n * PatchMutation Document(v3) Document(v3)\n * PatchMutation NoDocument(v3) NoDocument(v3)\n * PatchMutation null null\n * TransformMutation Document(v3) Document(v3)\n * TransformMutation NoDocument(v3) NoDocument(v3)\n * TransformMutation null null\n * DeleteMutation Document(v3) NoDocument(v0)\n * DeleteMutation NoDocument(v3) NoDocument(v0)\n * DeleteMutation null NoDocument(v0)\n *\n * For acknowledged mutations, we use the updateTime of the WriteResponse as\n * the resulting version for Set, Patch, and Transform mutations. As deletes\n * have no explicit update time, we use the commitTime of the WriteResponse for\n * Delete mutations.\n *\n * If a mutation is acknowledged by the backend but fails the precondition check\n * locally, we return an `UnknownDocument` and rely on Watch to send us the\n * updated version.\n *\n * Note that TransformMutations don't create Documents (in the case of being\n * applied to a NoDocument), even though they would on the backend. This is\n * because the client always combines the TransformMutation with a SetMutation\n * or PatchMutation and we only want to apply the transform if the prior\n * mutation resulted in a Document (always true for a SetMutation, but not\n * necessarily for a PatchMutation).\n *\n * ## Subclassing Notes\n *\n * Subclasses of Mutation need to implement applyToRemoteDocument() and\n * applyToLocalView() to implement the actual behavior of applying the mutation\n * to some source document.\n */\nexport abstract class Mutation {\n abstract readonly type: MutationType;\n abstract readonly key: DocumentKey;\n abstract readonly precondition: Precondition;\n\n /**\n * Applies this mutation to the given MaybeDocument or null for the purposes\n * of computing a new remote document. If the input document doesn't match the\n * expected state (e.g. it is null or outdated), an `UnknownDocument` can be\n * returned.\n *\n * @param maybeDoc The document to mutate. The input document can be null if\n * the client has no knowledge of the pre-mutation state of the document.\n * @param mutationResult The result of applying the mutation from the backend.\n * @return The mutated document. The returned document may be an\n * UnknownDocument if the mutation could not be applied to the locally\n * cached base document.\n */\n abstract applyToRemoteDocument(\n maybeDoc: MaybeDocument | null,\n mutationResult: MutationResult\n ): MaybeDocument;\n\n /**\n * Applies this mutation to the given MaybeDocument or null for the purposes\n * of computing the new local view of a document. Both the input and returned\n * documents can be null.\n *\n * @param maybeDoc The document to mutate. The input document can be null if\n * the client has no knowledge of the pre-mutation state of the document.\n * @param baseDoc The state of the document prior to this mutation batch. The\n * input document can be null if the client has no knowledge of the\n * pre-mutation state of the document.\n * @param localWriteTime A timestamp indicating the local write time of the\n * batch this mutation is a part of.\n * @return The mutated document. The returned document may be null, but only\n * if maybeDoc was null and the mutation would not create a new document.\n */\n abstract applyToLocalView(\n maybeDoc: MaybeDocument | null,\n baseDoc: MaybeDocument | null,\n localWriteTime: Timestamp\n ): MaybeDocument | null;\n\n /**\n * If this mutation is not idempotent, returns the base value to persist with\n * this mutation. If a base value is returned, the mutation is always applied\n * to this base value, even if document has already been updated.\n *\n * The base value is a sparse object that consists of only the document\n * fields for which this mutation contains a non-idempotent transformation\n * (e.g. a numeric increment). The provided value guarantees consistent\n * behavior for non-idempotent transforms and allow us to return the same\n * latency-compensated value even if the backend has already applied the\n * mutation. The base value is null for idempotent mutations, as they can be\n * re-played even if the backend has already applied them.\n *\n * @return a base value to store along with the mutation, or null for\n * idempotent mutations.\n */\n abstract extractBaseValue(maybeDoc: MaybeDocument | null): ObjectValue | null;\n\n abstract isEqual(other: Mutation): boolean;\n\n protected verifyKeyMatches(maybeDoc: MaybeDocument | null): void {\n if (maybeDoc != null) {\n assert(\n maybeDoc.key.isEqual(this.key),\n 'Can only apply a mutation to a document with the same key'\n );\n }\n }\n\n /**\n * Returns the version from the given document for use as the result of a\n * mutation. Mutations are defined to return the version of the base document\n * only if it is an existing document. Deleted and unknown documents have a\n * post-mutation version of SnapshotVersion.MIN.\n */\n protected static getPostMutationVersion(\n maybeDoc: MaybeDocument | null\n ): SnapshotVersion {\n if (maybeDoc instanceof Document) {\n return maybeDoc.version;\n } else {\n return SnapshotVersion.MIN;\n }\n }\n}\n\n/**\n * A mutation that creates or replaces the document at the given key with the\n * object value contents.\n */\nexport class SetMutation extends Mutation {\n constructor(\n readonly key: DocumentKey,\n readonly value: ObjectValue,\n readonly precondition: Precondition\n ) {\n super();\n }\n\n readonly type: MutationType = MutationType.Set;\n\n applyToRemoteDocument(\n maybeDoc: MaybeDocument | null,\n mutationResult: MutationResult\n ): MaybeDocument {\n this.verifyKeyMatches(maybeDoc);\n\n assert(\n mutationResult.transformResults == null,\n 'Transform results received by SetMutation.'\n );\n\n // Unlike applyToLocalView, if we're applying a mutation to a remote\n // document the server has accepted the mutation so the precondition must\n // have held.\n\n const version = mutationResult.version;\n return new Document(\n this.key,\n version,\n {\n hasCommittedMutations: true\n },\n this.value\n );\n }\n\n applyToLocalView(\n maybeDoc: MaybeDocument | null,\n baseDoc: MaybeDocument | null,\n localWriteTime: Timestamp\n ): MaybeDocument | null {\n this.verifyKeyMatches(maybeDoc);\n\n if (!this.precondition.isValidFor(maybeDoc)) {\n return maybeDoc;\n }\n\n const version = Mutation.getPostMutationVersion(maybeDoc);\n return new Document(\n this.key,\n version,\n {\n hasLocalMutations: true\n },\n this.value\n );\n }\n\n extractBaseValue(maybeDoc: MaybeDocument | null): null {\n return null;\n }\n\n isEqual(other: Mutation): boolean {\n return (\n other instanceof SetMutation &&\n this.key.isEqual(other.key) &&\n this.value.isEqual(other.value) &&\n this.precondition.isEqual(other.precondition)\n );\n }\n}\n\n/**\n * A mutation that modifies fields of the document at the given key with the\n * given values. The values are applied through a field mask:\n *\n * * When a field is in both the mask and the values, the corresponding field\n * is updated.\n * * When a field is in neither the mask nor the values, the corresponding\n * field is unmodified.\n * * When a field is in the mask but not in the values, the corresponding field\n * is deleted.\n * * When a field is not in the mask but is in the values, the values map is\n * ignored.\n */\nexport class PatchMutation extends Mutation {\n constructor(\n readonly key: DocumentKey,\n readonly data: ObjectValue,\n readonly fieldMask: FieldMask,\n readonly precondition: Precondition\n ) {\n super();\n }\n\n readonly type: MutationType = MutationType.Patch;\n\n applyToRemoteDocument(\n maybeDoc: MaybeDocument | null,\n mutationResult: MutationResult\n ): MaybeDocument {\n this.verifyKeyMatches(maybeDoc);\n\n assert(\n mutationResult.transformResults == null,\n 'Transform results received by PatchMutation.'\n );\n\n if (!this.precondition.isValidFor(maybeDoc)) {\n // Since the mutation was not rejected, we know that the precondition\n // matched on the backend. We therefore must not have the expected version\n // of the document in our cache and return an UnknownDocument with the\n // known updateTime.\n return new UnknownDocument(this.key, mutationResult.version);\n }\n\n const newData = this.patchDocument(maybeDoc);\n return new Document(\n this.key,\n mutationResult.version,\n {\n hasCommittedMutations: true\n },\n newData\n );\n }\n\n applyToLocalView(\n maybeDoc: MaybeDocument | null,\n baseDoc: MaybeDocument | null,\n localWriteTime: Timestamp\n ): MaybeDocument | null {\n this.verifyKeyMatches(maybeDoc);\n\n if (!this.precondition.isValidFor(maybeDoc)) {\n return maybeDoc;\n }\n\n const version = Mutation.getPostMutationVersion(maybeDoc);\n const newData = this.patchDocument(maybeDoc);\n return new Document(\n this.key,\n version,\n {\n hasLocalMutations: true\n },\n newData\n );\n }\n\n extractBaseValue(maybeDoc: MaybeDocument | null): null {\n return null;\n }\n\n isEqual(other: Mutation): boolean {\n return (\n other instanceof PatchMutation &&\n this.key.isEqual(other.key) &&\n this.fieldMask.isEqual(other.fieldMask) &&\n this.precondition.isEqual(other.precondition)\n );\n }\n\n /**\n * Patches the data of document if available or creates a new document. Note\n * that this does not check whether or not the precondition of this patch\n * holds.\n */\n private patchDocument(maybeDoc: MaybeDocument | null): ObjectValue {\n let data: ObjectValue;\n if (maybeDoc instanceof Document) {\n data = maybeDoc.data();\n } else {\n data = ObjectValue.EMPTY;\n }\n return this.patchObject(data);\n }\n\n private patchObject(data: ObjectValue): ObjectValue {\n this.fieldMask.fields.forEach(fieldPath => {\n if (!fieldPath.isEmpty()) {\n const newValue = this.data.field(fieldPath);\n if (newValue !== null) {\n data = data.set(fieldPath, newValue);\n } else {\n data = data.delete(fieldPath);\n }\n }\n });\n return data;\n }\n}\n\n/**\n * A mutation that modifies specific fields of the document with transform\n * operations. Currently the only supported transform is a server timestamp, but\n * IP Address, increment(n), etc. could be supported in the future.\n *\n * It is somewhat similar to a PatchMutation in that it patches specific fields\n * and has no effect when applied to a null or NoDocument (see comment on\n * Mutation for rationale).\n */\nexport class TransformMutation extends Mutation {\n readonly type: MutationType = MutationType.Transform;\n\n // NOTE: We set a precondition of exists: true as a safety-check, since we\n // always combine TransformMutations with a SetMutation or PatchMutation which\n // (if successful) should end up with an existing document.\n readonly precondition = Precondition.exists(true);\n\n constructor(\n readonly key: DocumentKey,\n readonly fieldTransforms: FieldTransform[]\n ) {\n super();\n }\n\n applyToRemoteDocument(\n maybeDoc: MaybeDocument | null,\n mutationResult: MutationResult\n ): MaybeDocument {\n this.verifyKeyMatches(maybeDoc);\n\n assert(\n mutationResult.transformResults != null,\n 'Transform results missing for TransformMutation.'\n );\n\n if (!this.precondition.isValidFor(maybeDoc)) {\n // Since the mutation was not rejected, we know that the precondition\n // matched on the backend. We therefore must not have the expected version\n // of the document in our cache and return an UnknownDocument with the\n // known updateTime.\n return new UnknownDocument(this.key, mutationResult.version);\n }\n\n const doc = this.requireDocument(maybeDoc);\n const transformResults = this.serverTransformResults(\n maybeDoc,\n mutationResult.transformResults!\n );\n\n const version = mutationResult.version;\n const newData = this.transformObject(doc.data(), transformResults);\n return new Document(\n this.key,\n version,\n {\n hasCommittedMutations: true\n },\n newData\n );\n }\n\n applyToLocalView(\n maybeDoc: MaybeDocument | null,\n baseDoc: MaybeDocument | null,\n localWriteTime: Timestamp\n ): MaybeDocument | null {\n this.verifyKeyMatches(maybeDoc);\n\n if (!this.precondition.isValidFor(maybeDoc)) {\n return maybeDoc;\n }\n\n const doc = this.requireDocument(maybeDoc);\n const transformResults = this.localTransformResults(\n localWriteTime,\n maybeDoc,\n baseDoc\n );\n const newData = this.transformObject(doc.data(), transformResults);\n return new Document(\n this.key,\n doc.version,\n {\n hasLocalMutations: true\n },\n newData\n );\n }\n\n extractBaseValue(maybeDoc: MaybeDocument | null): ObjectValue | null {\n let baseObject: ObjectValue | null = null;\n for (const fieldTransform of this.fieldTransforms) {\n const existingValue =\n maybeDoc instanceof Document\n ? maybeDoc.field(fieldTransform.field)\n : undefined;\n const coercedValue = fieldTransform.transform.computeBaseValue(\n existingValue || null\n );\n\n if (coercedValue != null) {\n if (baseObject == null) {\n baseObject = ObjectValue.EMPTY.set(\n fieldTransform.field,\n coercedValue\n );\n } else {\n baseObject = baseObject.set(fieldTransform.field, coercedValue);\n }\n }\n }\n return baseObject;\n }\n\n isEqual(other: Mutation): boolean {\n return (\n other instanceof TransformMutation &&\n this.key.isEqual(other.key) &&\n misc.arrayEquals(this.fieldTransforms, other.fieldTransforms) &&\n this.precondition.isEqual(other.precondition)\n );\n }\n\n /**\n * Asserts that the given MaybeDocument is actually a Document and verifies\n * that it matches the key for this mutation. Since we only support\n * transformations with precondition exists this method is guaranteed to be\n * safe.\n */\n private requireDocument(maybeDoc: MaybeDocument | null): Document {\n assert(\n maybeDoc instanceof Document,\n 'Unknown MaybeDocument type ' + maybeDoc\n );\n assert(\n maybeDoc.key.isEqual(this.key),\n 'Can only transform a document with the same key'\n );\n return maybeDoc;\n }\n\n /**\n * Creates a list of \"transform results\" (a transform result is a field value\n * representing the result of applying a transform) for use after a\n * TransformMutation has been acknowledged by the server.\n *\n * @param baseDoc The document prior to applying this mutation batch.\n * @param serverTransformResults The transform results received by the server.\n * @return The transform results list.\n */\n private serverTransformResults(\n baseDoc: MaybeDocument | null,\n serverTransformResults: Array<FieldValue | null>\n ): FieldValue[] {\n const transformResults = [] as FieldValue[];\n assert(\n this.fieldTransforms.length === serverTransformResults.length,\n `server transform result count (${serverTransformResults.length}) ` +\n `should match field transform count (${this.fieldTransforms.length})`\n );\n\n for (let i = 0; i < serverTransformResults.length; i++) {\n const fieldTransform = this.fieldTransforms[i];\n const transform = fieldTransform.transform;\n let previousValue: FieldValue | null = null;\n if (baseDoc instanceof Document) {\n previousValue = baseDoc.field(fieldTransform.field);\n }\n transformResults.push(\n transform.applyToRemoteDocument(\n previousValue,\n serverTransformResults[i]\n )\n );\n }\n return transformResults;\n }\n\n /**\n * Creates a list of \"transform results\" (a transform result is a field value\n * representing the result of applying a transform) for use when applying a\n * TransformMutation locally.\n *\n * @param localWriteTime The local time of the transform mutation (used to\n * generate ServerTimestampValues).\n * @param maybeDoc The current state of the document after applying all\n * previous mutations.\n * @param baseDoc The document prior to applying this mutation batch.\n * @return The transform results list.\n */\n private localTransformResults(\n localWriteTime: Timestamp,\n maybeDoc: MaybeDocument | null,\n baseDoc: MaybeDocument | null\n ): FieldValue[] {\n const transformResults = [] as FieldValue[];\n for (const fieldTransform of this.fieldTransforms) {\n const transform = fieldTransform.transform;\n\n let previousValue: FieldValue | null = null;\n if (maybeDoc instanceof Document) {\n previousValue = maybeDoc.field(fieldTransform.field);\n }\n\n if (previousValue === null && baseDoc instanceof Document) {\n // If the current document does not contain a value for the mutated\n // field, use the value that existed before applying this mutation\n // batch. This solves an edge case where a PatchMutation clears the\n // values in a nested map before the TransformMutation is applied.\n previousValue = baseDoc.field(fieldTransform.field);\n }\n\n transformResults.push(\n transform.applyToLocalView(previousValue, localWriteTime)\n );\n }\n return transformResults;\n }\n\n private transformObject(\n data: ObjectValue,\n transformResults: FieldValue[]\n ): ObjectValue {\n assert(\n transformResults.length === this.fieldTransforms.length,\n 'TransformResults length mismatch.'\n );\n\n for (let i = 0; i < this.fieldTransforms.length; i++) {\n const fieldTransform = this.fieldTransforms[i];\n const fieldPath = fieldTransform.field;\n data = data.set(fieldPath, transformResults[i]);\n }\n return data;\n }\n}\n\n/** A mutation that deletes the document at the given key. */\nexport class DeleteMutation extends Mutation {\n constructor(readonly key: DocumentKey, readonly precondition: Precondition) {\n super();\n }\n\n readonly type: MutationType = MutationType.Delete;\n\n applyToRemoteDocument(\n maybeDoc: MaybeDocument | null,\n mutationResult: MutationResult\n ): MaybeDocument {\n this.verifyKeyMatches(maybeDoc);\n\n assert(\n mutationResult.transformResults == null,\n 'Transform results received by DeleteMutation.'\n );\n\n // Unlike applyToLocalView, if we're applying a mutation to a remote\n // document the server has accepted the mutation so the precondition must\n // have held.\n\n return new NoDocument(this.key, mutationResult.version, {\n hasCommittedMutations: true\n });\n }\n\n applyToLocalView(\n maybeDoc: MaybeDocument | null,\n baseDoc: MaybeDocument | null,\n localWriteTime: Timestamp\n ): MaybeDocument | null {\n this.verifyKeyMatches(maybeDoc);\n\n if (!this.precondition.isValidFor(maybeDoc)) {\n return maybeDoc;\n }\n\n if (maybeDoc) {\n assert(\n maybeDoc.key.isEqual(this.key),\n 'Can only apply mutation to document with same key'\n );\n }\n return new NoDocument(this.key, SnapshotVersion.forDeletedDoc());\n }\n\n extractBaseValue(maybeDoc: MaybeDocument | null): null {\n return null;\n }\n\n isEqual(other: Mutation): boolean {\n return (\n other instanceof DeleteMutation &&\n this.key.isEqual(other.key) &&\n this.precondition.isEqual(other.precondition)\n );\n }\n}\n\n/**\n * A mutation that verifies the existence of the document at the given key with\n * the provided precondition.\n *\n * The `verify` operation is only used in Transactions, and this class serves\n * primarily to facilitate serialization into protos.\n */\nexport class VerifyMutation extends Mutation {\n constructor(readonly key: DocumentKey, readonly precondition: Precondition) {\n super();\n }\n\n readonly type: MutationType = MutationType.Verify;\n\n applyToRemoteDocument(\n maybeDoc: MaybeDocument | null,\n mutationResult: MutationResult\n ): MaybeDocument {\n fail('VerifyMutation should only be used in Transactions.');\n }\n\n applyToLocalView(\n maybeDoc: MaybeDocument | null,\n baseDoc: MaybeDocument | null,\n localWriteTime: Timestamp\n ): MaybeDocument | null {\n fail('VerifyMutation should only be used in Transactions.');\n }\n\n extractBaseValue(maybeDoc: MaybeDocument | null): null {\n fail('VerifyMutation should only be used in Transactions.');\n }\n\n isEqual(other: Mutation): boolean {\n return (\n other instanceof VerifyMutation &&\n this.key.isEqual(other.key) &&\n this.precondition.isEqual(other.precondition)\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Blob } from '../api/blob';\nimport { SnapshotOptions } from '../api/database';\nimport { GeoPoint } from '../api/geo_point';\nimport { Timestamp } from '../api/timestamp';\nimport { DatabaseId } from '../core/database_info';\nimport { assert, fail } from '../util/assert';\nimport { primitiveComparator } from '../util/misc';\nimport { DocumentKey } from './document_key';\nimport { FieldMask } from './mutation';\nimport { FieldPath } from './path';\nimport { SortedMap } from '../util/sorted_map';\nimport { SortedSet } from '../util/sorted_set';\n\n/**\n * Supported data value types:\n * - Null\n * - Boolean\n * - Long\n * - Double\n * - String\n * - Object\n * - Array\n * - Binary\n * - Timestamp\n * - ServerTimestamp (a sentinel used in uncommitted writes)\n * - GeoPoint\n * - (Document) References\n */\n\nexport interface JsonObject<T> {\n [name: string]: T;\n}\n\nexport enum TypeOrder {\n // This order is defined by the backend.\n NullValue = 0,\n BooleanValue = 1,\n NumberValue = 2,\n TimestampValue = 3,\n StringValue = 4,\n BlobValue = 5,\n RefValue = 6,\n GeoPointValue = 7,\n ArrayValue = 8,\n ObjectValue = 9\n}\n\n/** Defines the return value for pending server timestamps. */\nexport enum ServerTimestampBehavior {\n Default,\n Estimate,\n Previous\n}\n\n/** Holds properties that define field value deserialization options. */\nexport class FieldValueOptions {\n constructor(\n readonly serverTimestampBehavior: ServerTimestampBehavior,\n readonly timestampsInSnapshots: boolean\n ) {}\n\n static fromSnapshotOptions(\n options: SnapshotOptions,\n timestampsInSnapshots: boolean\n ): FieldValueOptions {\n switch (options.serverTimestamps) {\n case 'estimate':\n return new FieldValueOptions(\n ServerTimestampBehavior.Estimate,\n timestampsInSnapshots\n );\n case 'previous':\n return new FieldValueOptions(\n ServerTimestampBehavior.Previous,\n timestampsInSnapshots\n );\n case 'none': // Fall-through intended.\n case undefined:\n return new FieldValueOptions(\n ServerTimestampBehavior.Default,\n timestampsInSnapshots\n );\n default:\n return fail('fromSnapshotOptions() called with invalid options.');\n }\n }\n}\n\n/**\n * Potential types returned by FieldValue.value(). This could be stricter\n * (instead of using {}), but there's little benefit.\n *\n * Note that currently we use AnyJs (which is identical except includes\n * undefined) for incoming user data as a convenience to the calling code (but\n * we'll throw if the data contains undefined). This should probably be changed\n * to use FieldType, but all consuming code will have to be updated to\n * explicitly handle undefined and then cast to FieldType or similar. Perhaps\n * we should tackle this when adding robust argument validation to the API.\n */\nexport type FieldType = null | boolean | number | string | {};\n\n/**\n * A field value represents a datatype as stored by Firestore.\n */\nexport abstract class FieldValue {\n abstract readonly typeOrder: TypeOrder;\n\n abstract value(options?: FieldValueOptions): FieldType;\n abstract isEqual(other: FieldValue): boolean;\n abstract compareTo(other: FieldValue): number;\n\n /**\n * Returns an approximate (and wildly inaccurate) in-memory size for the field\n * value.\n *\n * The memory size takes into account only the actual user data as it resides\n * in memory and ignores object overhead.\n */\n abstract approximateByteSize(): number;\n\n toString(): string {\n const val = this.value();\n return val === null ? 'null' : val.toString();\n }\n\n defaultCompareTo(other: FieldValue): number {\n assert(\n this.typeOrder !== other.typeOrder,\n 'Default compareTo should not be used for values of same type.'\n );\n const cmp = primitiveComparator(this.typeOrder, other.typeOrder);\n return cmp;\n }\n}\n\nexport class NullValue extends FieldValue {\n typeOrder = TypeOrder.NullValue;\n\n // internalValue is unused but we add it to work around\n // https://github.com/Microsoft/TypeScript/issues/15585\n readonly internalValue = null;\n\n private constructor() {\n super();\n }\n\n value(options?: FieldValueOptions): null {\n return null;\n }\n\n isEqual(other: FieldValue): boolean {\n return other instanceof NullValue;\n }\n\n compareTo(other: FieldValue): number {\n if (other instanceof NullValue) {\n return 0;\n }\n return this.defaultCompareTo(other);\n }\n\n approximateByteSize(): number {\n return 4;\n }\n\n static INSTANCE = new NullValue();\n}\n\nexport class BooleanValue extends FieldValue {\n typeOrder = TypeOrder.BooleanValue;\n\n private constructor(readonly internalValue: boolean) {\n super();\n }\n\n value(options?: FieldValueOptions): boolean {\n return this.internalValue;\n }\n\n isEqual(other: FieldValue): boolean {\n return (\n other instanceof BooleanValue &&\n this.internalValue === other.internalValue\n );\n }\n\n compareTo(other: FieldValue): number {\n if (other instanceof BooleanValue) {\n return primitiveComparator(this, other);\n }\n return this.defaultCompareTo(other);\n }\n\n approximateByteSize(): number {\n return 4;\n }\n\n static of(value: boolean): BooleanValue {\n return value ? BooleanValue.TRUE : BooleanValue.FALSE;\n }\n\n static TRUE = new BooleanValue(true);\n static FALSE = new BooleanValue(false);\n}\n\n/** Base class for IntegerValue and DoubleValue. */\nexport abstract class NumberValue extends FieldValue {\n typeOrder = TypeOrder.NumberValue;\n\n constructor(readonly internalValue: number) {\n super();\n }\n\n value(options?: FieldValueOptions): number {\n return this.internalValue;\n }\n\n compareTo(other: FieldValue): number {\n if (other instanceof NumberValue) {\n return numericComparator(this.internalValue, other.internalValue);\n }\n return this.defaultCompareTo(other);\n }\n\n approximateByteSize(): number {\n return 8;\n }\n}\n\n/** Utility function to compare doubles (using Firestore semantics for NaN). */\nfunction numericComparator(left: number, right: number): number {\n if (left < right) {\n return -1;\n } else if (left > right) {\n return 1;\n } else if (left === right) {\n return 0;\n } else {\n // one or both are NaN.\n if (isNaN(left)) {\n return isNaN(right) ? 0 : -1;\n } else {\n return 1;\n }\n }\n}\n\n/**\n * Utility function to check numbers for equality using Firestore semantics\n * (NaN === NaN, -0.0 !== 0.0).\n */\nfunction numericEquals(left: number, right: number): boolean {\n // Implemented based on Object.is() polyfill from\n // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/is\n if (left === right) {\n // +0 != -0\n return left !== 0 || 1 / left === 1 / right;\n } else {\n // NaN == NaN\n return left !== left && right !== right;\n }\n}\n\nexport class IntegerValue extends NumberValue {\n isEqual(other: FieldValue): boolean {\n // NOTE: DoubleValue and IntegerValue instances may compareTo() the same,\n // but that doesn't make them equal via isEqual().\n if (other instanceof IntegerValue) {\n return numericEquals(this.internalValue, other.internalValue);\n } else {\n return false;\n }\n }\n\n // NOTE: compareTo() is implemented in NumberValue.\n}\n\nexport class DoubleValue extends NumberValue {\n static NAN = new DoubleValue(NaN);\n static POSITIVE_INFINITY = new DoubleValue(Infinity);\n static NEGATIVE_INFINITY = new DoubleValue(-Infinity);\n\n isEqual(other: FieldValue): boolean {\n // NOTE: DoubleValue and IntegerValue instances may compareTo() the same,\n // but that doesn't make them equal via isEqual().\n if (other instanceof DoubleValue) {\n return numericEquals(this.internalValue, other.internalValue);\n } else {\n return false;\n }\n }\n\n // NOTE: compareTo() is implemented in NumberValue.\n}\n\n// TODO(b/37267885): Add truncation support\nexport class StringValue extends FieldValue {\n typeOrder = TypeOrder.StringValue;\n\n constructor(readonly internalValue: string) {\n super();\n }\n\n value(options?: FieldValueOptions): string {\n return this.internalValue;\n }\n\n isEqual(other: FieldValue): boolean {\n return (\n other instanceof StringValue && this.internalValue === other.internalValue\n );\n }\n\n compareTo(other: FieldValue): number {\n if (other instanceof StringValue) {\n return primitiveComparator(this.internalValue, other.internalValue);\n }\n return this.defaultCompareTo(other);\n }\n\n approximateByteSize(): number {\n // See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures:\n // \"JavaScript's String type is [...] a set of elements of 16-bit unsigned\n // integer values\"\n return this.internalValue.length * 2;\n }\n}\n\nexport class TimestampValue extends FieldValue {\n typeOrder = TypeOrder.TimestampValue;\n\n constructor(readonly internalValue: Timestamp) {\n super();\n }\n\n value(options?: FieldValueOptions): Date | Timestamp {\n if (!options || options.timestampsInSnapshots) {\n return this.internalValue;\n } else {\n return this.internalValue.toDate();\n }\n }\n\n isEqual(other: FieldValue): boolean {\n return (\n other instanceof TimestampValue &&\n this.internalValue.isEqual(other.internalValue)\n );\n }\n\n compareTo(other: FieldValue): number {\n if (other instanceof TimestampValue) {\n return this.internalValue._compareTo(other.internalValue);\n } else if (other instanceof ServerTimestampValue) {\n // Concrete timestamps come before server timestamps.\n return -1;\n } else {\n return this.defaultCompareTo(other);\n }\n }\n\n approximateByteSize(): number {\n // Timestamps are made up of two distinct numbers (seconds + nanoseconds)\n return 16;\n }\n}\n\n/**\n * Represents a locally-applied ServerTimestamp.\n *\n * Notes:\n * - ServerTimestampValue instances are created as the result of applying a\n * TransformMutation (see TransformMutation.applyTo()). They can only exist in\n * the local view of a document. Therefore they do not need to be parsed or\n * serialized.\n * - When evaluated locally (e.g. for snapshot.data()), they by default\n * evaluate to `null`. This behavior can be configured by passing custom\n * FieldValueOptions to value().\n * - With respect to other ServerTimestampValues, they sort by their\n * localWriteTime.\n */\nexport class ServerTimestampValue extends FieldValue {\n typeOrder = TypeOrder.TimestampValue;\n\n constructor(\n readonly localWriteTime: Timestamp,\n readonly previousValue: FieldValue | null\n ) {\n super();\n }\n\n value(options?: FieldValueOptions): FieldType {\n if (\n options &&\n options.serverTimestampBehavior === ServerTimestampBehavior.Estimate\n ) {\n return new TimestampValue(this.localWriteTime).value(options);\n } else if (\n options &&\n options.serverTimestampBehavior === ServerTimestampBehavior.Previous\n ) {\n return this.previousValue ? this.previousValue.value(options) : null;\n } else {\n return null;\n }\n }\n\n isEqual(other: FieldValue): boolean {\n return (\n other instanceof ServerTimestampValue &&\n this.localWriteTime.isEqual(other.localWriteTime)\n );\n }\n\n compareTo(other: FieldValue): number {\n if (other instanceof ServerTimestampValue) {\n return this.localWriteTime._compareTo(other.localWriteTime);\n } else if (other instanceof TimestampValue) {\n // Server timestamps come after all concrete timestamps.\n return 1;\n } else {\n return this.defaultCompareTo(other);\n }\n }\n\n toString(): string {\n return '<ServerTimestamp localTime=' + this.localWriteTime.toString() + '>';\n }\n\n approximateByteSize(): number {\n return (\n /* localWriteTime */ 16 +\n (this.previousValue ? this.previousValue.approximateByteSize() : 0)\n );\n }\n}\n\nexport class BlobValue extends FieldValue {\n typeOrder = TypeOrder.BlobValue;\n\n constructor(readonly internalValue: Blob) {\n super();\n }\n\n value(options?: FieldValueOptions): Blob {\n return this.internalValue;\n }\n\n isEqual(other: FieldValue): boolean {\n return (\n other instanceof BlobValue &&\n this.internalValue.isEqual(other.internalValue)\n );\n }\n\n compareTo(other: FieldValue): number {\n if (other instanceof BlobValue) {\n return this.internalValue._compareTo(other.internalValue);\n }\n return this.defaultCompareTo(other);\n }\n\n approximateByteSize(): number {\n return this.internalValue._approximateByteSize();\n }\n}\n\nexport class RefValue extends FieldValue {\n typeOrder = TypeOrder.RefValue;\n\n constructor(readonly databaseId: DatabaseId, readonly key: DocumentKey) {\n super();\n }\n\n value(options?: FieldValueOptions): DocumentKey {\n return this.key;\n }\n\n isEqual(other: FieldValue): boolean {\n if (other instanceof RefValue) {\n return (\n this.key.isEqual(other.key) && this.databaseId.isEqual(other.databaseId)\n );\n } else {\n return false;\n }\n }\n\n compareTo(other: FieldValue): number {\n if (other instanceof RefValue) {\n const cmp = this.databaseId.compareTo(other.databaseId);\n return cmp !== 0 ? cmp : DocumentKey.comparator(this.key, other.key);\n }\n return this.defaultCompareTo(other);\n }\n\n approximateByteSize(): number {\n return (\n this.databaseId.projectId.length +\n this.databaseId.database.length +\n this.key.toString().length\n );\n }\n}\n\nexport class GeoPointValue extends FieldValue {\n typeOrder = TypeOrder.GeoPointValue;\n\n constructor(readonly internalValue: GeoPoint) {\n super();\n }\n\n value(options?: FieldValueOptions): GeoPoint {\n return this.internalValue;\n }\n\n isEqual(other: FieldValue): boolean {\n return (\n other instanceof GeoPointValue &&\n this.internalValue.isEqual(other.internalValue)\n );\n }\n\n compareTo(other: FieldValue): number {\n if (other instanceof GeoPointValue) {\n return this.internalValue._compareTo(other.internalValue);\n }\n return this.defaultCompareTo(other);\n }\n\n approximateByteSize(): number {\n // GeoPoints are made up of two distinct numbers (latitude + longitude)\n return 16;\n }\n}\n\nexport class ObjectValue extends FieldValue {\n typeOrder = TypeOrder.ObjectValue;\n\n constructor(readonly internalValue: SortedMap<string, FieldValue>) {\n super();\n }\n\n value(options?: FieldValueOptions): JsonObject<FieldType> {\n const result: JsonObject<FieldType> = {};\n this.internalValue.inorderTraversal((key, val) => {\n result[key] = val.value(options);\n });\n return result;\n }\n\n forEach(action: (key: string, value: FieldValue) => void): void {\n this.internalValue.inorderTraversal(action);\n }\n\n isEqual(other: FieldValue): boolean {\n if (other instanceof ObjectValue) {\n const it1 = this.internalValue.getIterator();\n const it2 = other.internalValue.getIterator();\n while (it1.hasNext() && it2.hasNext()) {\n const next1 = it1.getNext();\n const next2 = it2.getNext();\n if (next1.key !== next2.key || !next1.value.isEqual(next2.value)) {\n return false;\n }\n }\n\n return !it1.hasNext() && !it2.hasNext();\n }\n\n return false;\n }\n\n compareTo(other: FieldValue): number {\n if (other instanceof ObjectValue) {\n const it1 = this.internalValue.getIterator();\n const it2 = other.internalValue.getIterator();\n while (it1.hasNext() && it2.hasNext()) {\n const next1: { key: string; value: FieldValue } = it1.getNext();\n const next2: { key: string; value: FieldValue } = it2.getNext();\n const cmp =\n primitiveComparator(next1.key, next2.key) ||\n next1.value.compareTo(next2.value);\n if (cmp) {\n return cmp;\n }\n }\n\n // Only equal if both iterators are exhausted\n return primitiveComparator(it1.hasNext(), it2.hasNext());\n } else {\n return this.defaultCompareTo(other);\n }\n }\n\n set(path: FieldPath, to: FieldValue): ObjectValue {\n assert(!path.isEmpty(), 'Cannot set field for empty path on ObjectValue');\n if (path.length === 1) {\n return this.setChild(path.firstSegment(), to);\n } else {\n let child = this.child(path.firstSegment());\n if (!(child instanceof ObjectValue)) {\n child = ObjectValue.EMPTY;\n }\n const newChild = (child as ObjectValue).set(path.popFirst(), to);\n return this.setChild(path.firstSegment(), newChild);\n }\n }\n\n delete(path: FieldPath): ObjectValue {\n assert(\n !path.isEmpty(),\n 'Cannot delete field for empty path on ObjectValue'\n );\n if (path.length === 1) {\n return new ObjectValue(this.internalValue.remove(path.firstSegment()));\n } else {\n // nested field\n const child = this.child(path.firstSegment());\n if (child instanceof ObjectValue) {\n const newChild = child.delete(path.popFirst());\n return new ObjectValue(\n this.internalValue.insert(path.firstSegment(), newChild)\n );\n } else {\n // Don't actually change a primitive value to an object for a delete\n return this;\n }\n }\n }\n\n contains(path: FieldPath): boolean {\n return this.field(path) !== null;\n }\n\n field(path: FieldPath): FieldValue | null {\n assert(!path.isEmpty(), \"Can't get field of empty path\");\n let field: FieldValue | null = this;\n path.forEach((pathSegment: string) => {\n if (field instanceof ObjectValue) {\n field = field.internalValue.get(pathSegment);\n } else {\n field = null;\n }\n });\n return field;\n }\n\n /**\n * Returns a FieldMask built from all FieldPaths starting from this ObjectValue,\n * including paths from nested objects.\n */\n fieldMask(): FieldMask {\n let fields = new SortedSet<FieldPath>(FieldPath.comparator);\n this.internalValue.forEach((key, value) => {\n const currentPath = new FieldPath([key]);\n if (value instanceof ObjectValue) {\n const nestedMask = value.fieldMask();\n const nestedFields = nestedMask.fields;\n if (nestedFields.isEmpty()) {\n // Preserve the empty map by adding it to the FieldMask.\n fields = fields.add(currentPath);\n } else {\n // For nested and non-empty ObjectValues, add the FieldPath of the\n // leaf nodes.\n nestedFields.forEach(nestedPath => {\n fields = fields.add(currentPath.child(nestedPath));\n });\n }\n } else {\n fields = fields.add(currentPath);\n }\n });\n return FieldMask.fromSet(fields);\n }\n\n approximateByteSize(): number {\n let size = 0;\n this.internalValue.inorderTraversal((key, val) => {\n size += key.length + val.approximateByteSize();\n });\n return size;\n }\n\n toString(): string {\n return this.internalValue.toString();\n }\n\n private child(childName: string): FieldValue | undefined {\n return this.internalValue.get(childName) || undefined;\n }\n\n private setChild(childName: string, value: FieldValue): ObjectValue {\n return new ObjectValue(this.internalValue.insert(childName, value));\n }\n\n static EMPTY = new ObjectValue(\n new SortedMap<string, FieldValue>(primitiveComparator)\n );\n}\n\nexport class ArrayValue extends FieldValue {\n typeOrder = TypeOrder.ArrayValue;\n\n constructor(readonly internalValue: FieldValue[]) {\n super();\n }\n\n value(options?: FieldValueOptions): FieldType[] {\n return this.internalValue.map(v => v.value(options));\n }\n\n /**\n * Returns true if the given value is contained in this array.\n */\n contains(value: FieldValue): boolean {\n for (const element of this.internalValue) {\n if (element.isEqual(value)) {\n return true;\n }\n }\n return false;\n }\n\n forEach(action: (value: FieldValue) => void): void {\n this.internalValue.forEach(action);\n }\n\n isEqual(other: FieldValue): boolean {\n if (other instanceof ArrayValue) {\n if (this.internalValue.length !== other.internalValue.length) {\n return false;\n }\n\n for (let i = 0; i < this.internalValue.length; i++) {\n if (!this.internalValue[i].isEqual(other.internalValue[i])) {\n return false;\n }\n }\n\n return true;\n }\n\n return false;\n }\n\n compareTo(other: FieldValue): number {\n if (other instanceof ArrayValue) {\n const minLength = Math.min(\n this.internalValue.length,\n other.internalValue.length\n );\n\n for (let i = 0; i < minLength; i++) {\n const cmp = this.internalValue[i].compareTo(other.internalValue[i]);\n\n if (cmp) {\n return cmp;\n }\n }\n\n return primitiveComparator(\n this.internalValue.length,\n other.internalValue.length\n );\n } else {\n return this.defaultCompareTo(other);\n }\n }\n\n approximateByteSize(): number {\n return this.internalValue.reduce(\n (totalSize, value) => totalSize + value.approximateByteSize(),\n 0\n );\n }\n\n toString(): string {\n const descriptions = this.internalValue.map(v => v.toString());\n return `[${descriptions.join(',')}]`;\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { assert, fail } from '../util/assert';\n\nimport { DocumentKey } from './document_key';\nimport { FieldValue, JsonObject, ObjectValue } from './field_value';\nimport { FieldPath } from './path';\n\nimport * as api from '../protos/firestore_proto_api';\nimport * as obj from '../util/obj';\n\nexport interface DocumentOptions {\n hasLocalMutations?: boolean;\n hasCommittedMutations?: boolean;\n}\n\n/**\n * The result of a lookup for a given path may be an existing document or a\n * marker that this document does not exist at a given version.\n */\nexport abstract class MaybeDocument {\n constructor(readonly key: DocumentKey, readonly version: SnapshotVersion) {}\n\n static compareByKey(d1: MaybeDocument, d2: MaybeDocument): number {\n return DocumentKey.comparator(d1.key, d2.key);\n }\n\n /**\n * Whether this document had a local mutation applied that has not yet been\n * acknowledged by Watch.\n */\n abstract get hasPendingWrites(): boolean;\n\n abstract isEqual(other: MaybeDocument | null | undefined): boolean;\n\n abstract toString(): string;\n}\n\n/**\n * Represents a document in Firestore with a key, version, data and whether the\n * data has local mutations applied to it.\n */\nexport class Document extends MaybeDocument {\n readonly hasLocalMutations: boolean;\n readonly hasCommittedMutations: boolean;\n\n /**\n * A cache of canonicalized FieldPaths to FieldValues that have already been\n * deserialized in `getField()`.\n */\n private fieldValueCache?: Map<string, FieldValue | null>;\n\n constructor(\n key: DocumentKey,\n version: SnapshotVersion,\n options: DocumentOptions,\n private objectValue?: ObjectValue,\n readonly proto?: api.Document,\n private readonly converter?: (value: api.Value) => FieldValue\n ) {\n super(key, version);\n assert(\n this.objectValue !== undefined ||\n (this.proto !== undefined && this.converter !== undefined),\n 'If objectValue is not defined, proto and converter need to be set.'\n );\n\n this.hasLocalMutations = !!options.hasLocalMutations;\n this.hasCommittedMutations = !!options.hasCommittedMutations;\n }\n\n field(path: FieldPath): FieldValue | null {\n if (this.objectValue) {\n return this.objectValue.field(path);\n } else {\n if (!this.fieldValueCache) {\n // TODO(b/136090445): Remove the cache when `getField` is no longer\n // called during Query ordering.\n this.fieldValueCache = new Map<string, FieldValue>();\n }\n\n const canonicalPath = path.canonicalString();\n\n let fieldValue = this.fieldValueCache.get(canonicalPath);\n\n if (fieldValue === undefined) {\n // Instead of deserializing the full Document proto, we only\n // deserialize the value at the requested field path. This speeds up\n // Query execution as query filters can discard documents based on a\n // single field.\n const protoValue = this.getProtoField(path);\n if (protoValue === undefined) {\n fieldValue = null;\n } else {\n fieldValue = this.converter!(protoValue);\n }\n this.fieldValueCache.set(canonicalPath, fieldValue);\n }\n\n return fieldValue!;\n }\n }\n\n data(): ObjectValue {\n if (!this.objectValue) {\n let result = ObjectValue.EMPTY;\n obj.forEach(this.proto!.fields || {}, (key: string, value: api.Value) => {\n result = result.set(new FieldPath([key]), this.converter!(value));\n });\n this.objectValue = result;\n\n // Once objectValue is computed, values inside the fieldValueCache are no\n // longer accessed.\n this.fieldValueCache = undefined;\n }\n\n return this.objectValue;\n }\n\n value(): JsonObject<unknown> {\n return this.data().value();\n }\n\n isEqual(other: MaybeDocument | null | undefined): boolean {\n return (\n other instanceof Document &&\n this.key.isEqual(other.key) &&\n this.version.isEqual(other.version) &&\n this.hasLocalMutations === other.hasLocalMutations &&\n this.hasCommittedMutations === other.hasCommittedMutations &&\n this.data().isEqual(other.data())\n );\n }\n\n toString(): string {\n return (\n `Document(${this.key}, ${this.version}, ${this.data().toString()}, ` +\n `{hasLocalMutations: ${this.hasLocalMutations}}), ` +\n `{hasCommittedMutations: ${this.hasCommittedMutations}})`\n );\n }\n\n get hasPendingWrites(): boolean {\n return this.hasLocalMutations || this.hasCommittedMutations;\n }\n\n /**\n * Returns the nested Protobuf value for 'path`. Can only be called if\n * `proto` was provided at construction time.\n */\n private getProtoField(path: FieldPath): api.Value | undefined {\n assert(\n this.proto !== undefined,\n 'Can only call getProtoField() when proto is defined'\n );\n\n let protoValue: api.Value | undefined = this.proto!.fields\n ? this.proto!.fields[path.firstSegment()]\n : undefined;\n for (let i = 1; i < path.length; ++i) {\n if (!protoValue || !protoValue.mapValue || !protoValue.mapValue.fields) {\n return undefined;\n }\n protoValue = protoValue.mapValue.fields[path.get(i)];\n }\n\n return protoValue;\n }\n\n static compareByField(field: FieldPath, d1: Document, d2: Document): number {\n const v1 = d1.field(field);\n const v2 = d2.field(field);\n if (v1 !== null && v2 !== null) {\n return v1.compareTo(v2);\n } else {\n return fail(\"Trying to compare documents on fields that don't exist\");\n }\n }\n}\n\n/**\n * A class representing a deleted document.\n * Version is set to 0 if we don't point to any specific time, otherwise it\n * denotes time we know it didn't exist at.\n */\nexport class NoDocument extends MaybeDocument {\n readonly hasCommittedMutations: boolean;\n\n constructor(\n key: DocumentKey,\n version: SnapshotVersion,\n options?: DocumentOptions\n ) {\n super(key, version);\n this.hasCommittedMutations = !!(options && options.hasCommittedMutations);\n }\n\n toString(): string {\n return `NoDocument(${this.key}, ${this.version})`;\n }\n\n get hasPendingWrites(): boolean {\n return this.hasCommittedMutations;\n }\n\n isEqual(other: MaybeDocument | null | undefined): boolean {\n return (\n other instanceof NoDocument &&\n other.hasCommittedMutations === this.hasCommittedMutations &&\n other.version.isEqual(this.version) &&\n other.key.isEqual(this.key)\n );\n }\n}\n\n/**\n * A class representing an existing document whose data is unknown (e.g. a\n * document that was updated without a known base document).\n */\nexport class UnknownDocument extends MaybeDocument {\n toString(): string {\n return `UnknownDocument(${this.key}, ${this.version})`;\n }\n\n get hasPendingWrites(): boolean {\n return true;\n }\n\n isEqual(other: MaybeDocument | null | undefined): boolean {\n return (\n other instanceof UnknownDocument &&\n other.version.isEqual(this.version) &&\n other.key.isEqual(this.key)\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Untyped Number alias we can use to check for ES6 methods / properties.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst NumberAsAny = Number as any;\n\n// An Object whose keys and values are strings.\nexport interface StringMap {\n [key: string]: string;\n}\n\n/**\n * Minimum safe integer in Javascript because of floating point precision.\n * Added to not rely on ES6 features.\n */\nexport const MIN_SAFE_INTEGER: number =\n NumberAsAny.MIN_SAFE_INTEGER || -(Math.pow(2, 53) - 1);\n\n/**\n * Maximum safe integer in Javascript because of floating point precision.\n * Added to not rely on ES6 features.\n */\nexport const MAX_SAFE_INTEGER: number =\n NumberAsAny.MAX_SAFE_INTEGER || Math.pow(2, 53) - 1;\n\n/**\n * Returns whether an number is an integer, uses native implementation if\n * available.\n * Added to not rely on ES6 features.\n * @param value The value to test for being an integer\n */\nexport const isInteger: (value: unknown) => boolean =\n NumberAsAny.isInteger ||\n (value =>\n typeof value === 'number' &&\n isFinite(value) &&\n Math.floor(value) === value);\n\n/**\n * Returns whether a variable is either undefined or null.\n */\nexport function isNullOrUndefined(value: unknown): boolean {\n return value === null || value === undefined;\n}\n\n/**\n * Returns whether a value is an integer and in the safe integer range\n * @param value The value to test for being an integer and in the safe range\n */\nexport function isSafeInteger(value: unknown): boolean {\n return (\n isInteger(value) &&\n (value as number) <= MAX_SAFE_INTEGER &&\n (value as number) >= MIN_SAFE_INTEGER\n );\n}\n\n/**\n * Safely checks if the number is NaN.\n */\nexport function safeIsNaN(value: unknown): boolean {\n if (NumberAsAny.IsNaN) {\n return NumberAsAny.IsNaN(value);\n } else {\n return typeof value === 'number' && isNaN(value);\n }\n}\n","/**\n * @license\n * Copyright 2019 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { DocumentKey } from '../model/document_key';\nimport { ResourcePath } from '../model/path';\nimport { isNullOrUndefined } from '../util/types';\nimport { Bound, Filter, OrderBy } from './query';\n\n/**\n * A Target represents the WatchTarget representation of a Query, which is used\n * by the LocalStore and the RemoteStore to keep track of and to execute\n * backend queries. While a Query can represent multiple Targets, each Targets\n * maps to a single WatchTarget in RemoteStore and a single TargetData entry\n * in persistence.\n */\nexport class Target {\n private memoizedCanonicalId: string | null = null;\n\n /**\n * Initializes a Target with a path and optional additional query constraints.\n * Path must currently be empty if this is a collection group query.\n *\n * NOTE: you should always construct `Target` from `Query.toTarget` instead of\n * using this constructor, because `Query` provides an implicit `orderBy`\n * property.\n */\n constructor(\n readonly path: ResourcePath,\n readonly collectionGroup: string | null = null,\n readonly orderBy: OrderBy[] = [],\n readonly filters: Filter[] = [],\n readonly limit: number | null = null,\n readonly startAt: Bound | null = null,\n readonly endAt: Bound | null = null\n ) {}\n\n canonicalId(): string {\n if (this.memoizedCanonicalId === null) {\n let canonicalId = this.path.canonicalString();\n if (this.collectionGroup !== null) {\n canonicalId += '|cg:' + this.collectionGroup;\n }\n canonicalId += '|f:';\n for (const filter of this.filters) {\n canonicalId += filter.canonicalId();\n canonicalId += ',';\n }\n canonicalId += '|ob:';\n // TODO(dimond): make this collision resistant\n for (const orderBy of this.orderBy) {\n canonicalId += orderBy.canonicalId();\n canonicalId += ',';\n }\n if (!isNullOrUndefined(this.limit)) {\n canonicalId += '|l:';\n canonicalId += this.limit!;\n }\n if (this.startAt) {\n canonicalId += '|lb:';\n canonicalId += this.startAt.canonicalId();\n }\n if (this.endAt) {\n canonicalId += '|ub:';\n canonicalId += this.endAt.canonicalId();\n }\n this.memoizedCanonicalId = canonicalId;\n }\n return this.memoizedCanonicalId;\n }\n\n toString(): string {\n let str = this.path.canonicalString();\n if (this.collectionGroup !== null) {\n str += ' collectionGroup=' + this.collectionGroup;\n }\n if (this.filters.length > 0) {\n str += `, filters: [${this.filters.join(', ')}]`;\n }\n if (!isNullOrUndefined(this.limit)) {\n str += ', limit: ' + this.limit;\n }\n if (this.orderBy.length > 0) {\n str += `, orderBy: [${this.orderBy.join(', ')}]`;\n }\n if (this.startAt) {\n str += ', startAt: ' + this.startAt.canonicalId();\n }\n if (this.endAt) {\n str += ', endAt: ' + this.endAt.canonicalId();\n }\n return `Target(${str})`;\n }\n\n isEqual(other: Target): boolean {\n if (this.limit !== other.limit) {\n return false;\n }\n\n if (this.orderBy.length !== other.orderBy.length) {\n return false;\n }\n\n for (let i = 0; i < this.orderBy.length; i++) {\n if (!this.orderBy[i].isEqual(other.orderBy[i])) {\n return false;\n }\n }\n\n if (this.filters.length !== other.filters.length) {\n return false;\n }\n\n for (let i = 0; i < this.filters.length; i++) {\n if (!this.filters[i].isEqual(other.filters[i])) {\n return false;\n }\n }\n\n if (this.collectionGroup !== other.collectionGroup) {\n return false;\n }\n\n if (!this.path.isEqual(other.path)) {\n return false;\n }\n\n if (\n this.startAt !== null\n ? !this.startAt.isEqual(other.startAt)\n : other.startAt !== null\n ) {\n return false;\n }\n\n return this.endAt !== null\n ? this.endAt.isEqual(other.endAt)\n : other.endAt === null;\n }\n\n isDocumentQuery(): boolean {\n return (\n DocumentKey.isDocumentKey(this.path) &&\n this.collectionGroup === null &&\n this.filters.length === 0\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Document } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport {\n ArrayValue,\n DoubleValue,\n FieldValue,\n NullValue,\n RefValue\n} from '../model/field_value';\nimport { FieldPath, ResourcePath } from '../model/path';\nimport { assert, fail } from '../util/assert';\nimport { Code, FirestoreError } from '../util/error';\nimport { isNullOrUndefined } from '../util/types';\nimport { Target } from './target';\n\nexport enum LimitType {\n First = 'F',\n Last = 'L'\n}\n\n/**\n * Query encapsulates all the query attributes we support in the SDK. It can\n * be run against the LocalStore, as well as be converted to a `Target` to\n * query the RemoteStore results.\n */\nexport class Query {\n static atPath(path: ResourcePath): Query {\n return new Query(path);\n }\n\n private memoizedOrderBy: OrderBy[] | null = null;\n\n // The corresponding `Target` of this `Query` instance.\n private memoizedTarget: Target | null = null;\n\n /**\n * Initializes a Query with a path and optional additional query constraints.\n * Path must currently be empty if this is a collection group query.\n */\n constructor(\n readonly path: ResourcePath,\n readonly collectionGroup: string | null = null,\n readonly explicitOrderBy: OrderBy[] = [],\n readonly filters: Filter[] = [],\n readonly limit: number | null = null,\n readonly limitType: LimitType = LimitType.First,\n readonly startAt: Bound | null = null,\n readonly endAt: Bound | null = null\n ) {\n if (this.startAt) {\n this.assertValidBound(this.startAt);\n }\n if (this.endAt) {\n this.assertValidBound(this.endAt);\n }\n }\n\n get orderBy(): OrderBy[] {\n if (this.memoizedOrderBy === null) {\n const inequalityField = this.getInequalityFilterField();\n const firstOrderByField = this.getFirstOrderByField();\n if (inequalityField !== null && firstOrderByField === null) {\n // In order to implicitly add key ordering, we must also add the\n // inequality filter field for it to be a valid query.\n // Note that the default inequality field and key ordering is ascending.\n if (inequalityField.isKeyField()) {\n this.memoizedOrderBy = [KEY_ORDERING_ASC];\n } else {\n this.memoizedOrderBy = [\n new OrderBy(inequalityField),\n KEY_ORDERING_ASC\n ];\n }\n } else {\n assert(\n inequalityField === null ||\n (firstOrderByField !== null &&\n inequalityField.isEqual(firstOrderByField)),\n 'First orderBy should match inequality field.'\n );\n this.memoizedOrderBy = [];\n let foundKeyOrdering = false;\n for (const orderBy of this.explicitOrderBy) {\n this.memoizedOrderBy.push(orderBy);\n if (orderBy.field.isKeyField()) {\n foundKeyOrdering = true;\n }\n }\n if (!foundKeyOrdering) {\n // The order of the implicit key ordering always matches the last\n // explicit order by\n const lastDirection =\n this.explicitOrderBy.length > 0\n ? this.explicitOrderBy[this.explicitOrderBy.length - 1].dir\n : Direction.ASCENDING;\n this.memoizedOrderBy.push(\n lastDirection === Direction.ASCENDING\n ? KEY_ORDERING_ASC\n : KEY_ORDERING_DESC\n );\n }\n }\n }\n return this.memoizedOrderBy;\n }\n\n addFilter(filter: Filter): Query {\n assert(\n this.getInequalityFilterField() == null ||\n !(filter instanceof FieldFilter) ||\n !filter.isInequality() ||\n filter.field.isEqual(this.getInequalityFilterField()!),\n 'Query must only have one inequality field.'\n );\n\n assert(!this.isDocumentQuery(), 'No filtering allowed for document query');\n\n const newFilters = this.filters.concat([filter]);\n return new Query(\n this.path,\n this.collectionGroup,\n this.explicitOrderBy.slice(),\n newFilters,\n this.limit,\n this.limitType,\n this.startAt,\n this.endAt\n );\n }\n\n addOrderBy(orderBy: OrderBy): Query {\n assert(!this.startAt && !this.endAt, 'Bounds must be set after orderBy');\n // TODO(dimond): validate that orderBy does not list the same key twice.\n const newOrderBy = this.explicitOrderBy.concat([orderBy]);\n return new Query(\n this.path,\n this.collectionGroup,\n newOrderBy,\n this.filters.slice(),\n this.limit,\n this.limitType,\n this.startAt,\n this.endAt\n );\n }\n\n withLimitToFirst(limit: number | null): Query {\n return new Query(\n this.path,\n this.collectionGroup,\n this.explicitOrderBy.slice(),\n this.filters.slice(),\n limit,\n LimitType.First,\n this.startAt,\n this.endAt\n );\n }\n\n withLimitToLast(limit: number | null): Query {\n return new Query(\n this.path,\n this.collectionGroup,\n this.explicitOrderBy.slice(),\n this.filters.slice(),\n limit,\n LimitType.Last,\n this.startAt,\n this.endAt\n );\n }\n\n withStartAt(bound: Bound): Query {\n return new Query(\n this.path,\n this.collectionGroup,\n this.explicitOrderBy.slice(),\n this.filters.slice(),\n this.limit,\n this.limitType,\n bound,\n this.endAt\n );\n }\n\n withEndAt(bound: Bound): Query {\n return new Query(\n this.path,\n this.collectionGroup,\n this.explicitOrderBy.slice(),\n this.filters.slice(),\n this.limit,\n this.limitType,\n this.startAt,\n bound\n );\n }\n\n /**\n * Helper to convert a collection group query into a collection query at a\n * specific path. This is used when executing collection group queries, since\n * we have to split the query into a set of collection queries at multiple\n * paths.\n */\n asCollectionQueryAtPath(path: ResourcePath): Query {\n return new Query(\n path,\n /*collectionGroup=*/ null,\n this.explicitOrderBy.slice(),\n this.filters.slice(),\n this.limit,\n this.limitType,\n this.startAt,\n this.endAt\n );\n }\n\n /**\n * Returns true if this query does not specify any query constraints that\n * could remove results.\n */\n matchesAllDocuments(): boolean {\n return (\n this.filters.length === 0 &&\n this.limit === null &&\n this.startAt == null &&\n this.endAt == null &&\n (this.explicitOrderBy.length === 0 ||\n (this.explicitOrderBy.length === 1 &&\n this.explicitOrderBy[0].field.isKeyField()))\n );\n }\n\n // TODO(b/29183165): This is used to get a unique string from a query to, for\n // example, use as a dictionary key, but the implementation is subject to\n // collisions. Make it collision-free.\n canonicalId(): string {\n return `${this.toTarget().canonicalId()}|lt:${this.limitType}`;\n }\n\n toString(): string {\n return `Query(target=${this.toTarget().toString()}; limitType=${\n this.limitType\n })`;\n }\n\n isEqual(other: Query): boolean {\n return (\n this.toTarget().isEqual(other.toTarget()) &&\n this.limitType === other.limitType\n );\n }\n\n docComparator(d1: Document, d2: Document): number {\n let comparedOnKeyField = false;\n for (const orderBy of this.orderBy) {\n const comp = orderBy.compare(d1, d2);\n if (comp !== 0) {\n return comp;\n }\n comparedOnKeyField = comparedOnKeyField || orderBy.field.isKeyField();\n }\n // Assert that we actually compared by key\n assert(\n comparedOnKeyField,\n \"orderBy used that doesn't compare on key field\"\n );\n return 0;\n }\n\n matches(doc: Document): boolean {\n return (\n this.matchesPathAndCollectionGroup(doc) &&\n this.matchesOrderBy(doc) &&\n this.matchesFilters(doc) &&\n this.matchesBounds(doc)\n );\n }\n\n hasLimitToFirst(): boolean {\n return !isNullOrUndefined(this.limit) && this.limitType === LimitType.First;\n }\n\n hasLimitToLast(): boolean {\n return !isNullOrUndefined(this.limit) && this.limitType === LimitType.Last;\n }\n\n getFirstOrderByField(): FieldPath | null {\n return this.explicitOrderBy.length > 0\n ? this.explicitOrderBy[0].field\n : null;\n }\n\n getInequalityFilterField(): FieldPath | null {\n for (const filter of this.filters) {\n if (filter instanceof FieldFilter && filter.isInequality()) {\n return filter.field;\n }\n }\n return null;\n }\n\n // Checks if any of the provided Operators are included in the query and\n // returns the first one that is, or null if none are.\n findFilterOperator(operators: Operator[]): Operator | null {\n for (const filter of this.filters) {\n if (filter instanceof FieldFilter) {\n if (operators.indexOf(filter.op) >= 0) {\n return filter.op;\n }\n }\n }\n return null;\n }\n\n isDocumentQuery(): boolean {\n return this.toTarget().isDocumentQuery();\n }\n\n isCollectionGroupQuery(): boolean {\n return this.collectionGroup !== null;\n }\n\n /**\n * Converts this `Query` instance to it's corresponding `Target`\n * representation.\n */\n toTarget(): Target {\n if (!this.memoizedTarget) {\n if (this.limitType === LimitType.First) {\n this.memoizedTarget = new Target(\n this.path,\n this.collectionGroup,\n this.orderBy,\n this.filters,\n this.limit,\n this.startAt,\n this.endAt\n );\n } else {\n // Flip the orderBy directions since we want the last results\n const orderBys = [] as OrderBy[];\n for (const orderBy of this.orderBy) {\n const dir =\n orderBy.dir === Direction.DESCENDING\n ? Direction.ASCENDING\n : Direction.DESCENDING;\n orderBys.push(new OrderBy(orderBy.field, dir));\n }\n\n // We need to swap the cursors to match the now-flipped query ordering.\n const startAt = this.endAt\n ? new Bound(this.endAt.position, !this.endAt.before)\n : null;\n const endAt = this.startAt\n ? new Bound(this.startAt.position, !this.startAt.before)\n : null;\n\n // Now return as a LimitType.First query.\n this.memoizedTarget = new Target(\n this.path,\n this.collectionGroup,\n orderBys,\n this.filters,\n this.limit,\n startAt,\n endAt\n );\n }\n }\n return this.memoizedTarget!;\n }\n\n private matchesPathAndCollectionGroup(doc: Document): boolean {\n const docPath = doc.key.path;\n if (this.collectionGroup !== null) {\n // NOTE: this.path is currently always empty since we don't expose Collection\n // Group queries rooted at a document path yet.\n return (\n doc.key.hasCollectionId(this.collectionGroup) &&\n this.path.isPrefixOf(docPath)\n );\n } else if (DocumentKey.isDocumentKey(this.path)) {\n // exact match for document queries\n return this.path.isEqual(docPath);\n } else {\n // shallow ancestor queries by default\n return this.path.isImmediateParentOf(docPath);\n }\n }\n\n /**\n * A document must have a value for every ordering clause in order to show up\n * in the results.\n */\n private matchesOrderBy(doc: Document): boolean {\n for (const orderBy of this.explicitOrderBy) {\n // order by key always matches\n if (!orderBy.field.isKeyField() && doc.field(orderBy.field) === null) {\n return false;\n }\n }\n return true;\n }\n\n private matchesFilters(doc: Document): boolean {\n for (const filter of this.filters) {\n if (!filter.matches(doc)) {\n return false;\n }\n }\n return true;\n }\n\n /**\n * Makes sure a document is within the bounds, if provided.\n */\n private matchesBounds(doc: Document): boolean {\n if (this.startAt && !this.startAt.sortsBeforeDocument(this.orderBy, doc)) {\n return false;\n }\n if (this.endAt && this.endAt.sortsBeforeDocument(this.orderBy, doc)) {\n return false;\n }\n return true;\n }\n\n private assertValidBound(bound: Bound): void {\n assert(\n bound.position.length <= this.orderBy.length,\n 'Bound is longer than orderBy'\n );\n }\n}\n\nexport abstract class Filter {\n abstract matches(doc: Document): boolean;\n abstract canonicalId(): string;\n abstract isEqual(filter: Filter): boolean;\n}\n\nexport class Operator {\n static LESS_THAN = new Operator('<');\n static LESS_THAN_OR_EQUAL = new Operator('<=');\n static EQUAL = new Operator('==');\n static GREATER_THAN = new Operator('>');\n static GREATER_THAN_OR_EQUAL = new Operator('>=');\n static ARRAY_CONTAINS = new Operator('array-contains');\n static IN = new Operator('in');\n static ARRAY_CONTAINS_ANY = new Operator('array-contains-any');\n\n static fromString(op: string): Operator {\n switch (op) {\n case '<':\n return Operator.LESS_THAN;\n case '<=':\n return Operator.LESS_THAN_OR_EQUAL;\n case '==':\n return Operator.EQUAL;\n case '>=':\n return Operator.GREATER_THAN_OR_EQUAL;\n case '>':\n return Operator.GREATER_THAN;\n case 'array-contains':\n return Operator.ARRAY_CONTAINS;\n case 'in':\n return Operator.IN;\n case 'array-contains-any':\n return Operator.ARRAY_CONTAINS_ANY;\n default:\n return fail('Unknown FieldFilter operator: ' + op);\n }\n }\n\n constructor(public name: string) {}\n\n toString(): string {\n return this.name;\n }\n\n isEqual(other: Operator): boolean {\n return this.name === other.name;\n }\n}\n\nexport class FieldFilter extends Filter {\n protected constructor(\n public field: FieldPath,\n public op: Operator,\n public value: FieldValue\n ) {\n super();\n }\n\n /**\n * Creates a filter based on the provided arguments.\n */\n static create(\n field: FieldPath,\n op: Operator,\n value: FieldValue\n ): FieldFilter {\n if (field.isKeyField()) {\n if (op === Operator.IN) {\n assert(\n value instanceof ArrayValue,\n 'Comparing on key with IN, but filter value not an ArrayValue'\n );\n assert(\n value.internalValue.every(elem => {\n return elem instanceof RefValue;\n }),\n 'Comparing on key with IN, but an array value was not a RefValue'\n );\n return new KeyFieldInFilter(field, value);\n } else {\n assert(\n value instanceof RefValue,\n 'Comparing on key, but filter value not a RefValue'\n );\n assert(\n op !== Operator.ARRAY_CONTAINS && op !== Operator.ARRAY_CONTAINS_ANY,\n `'${op.toString()}' queries don't make sense on document keys.`\n );\n return new KeyFieldFilter(field, op, value);\n }\n } else if (value.isEqual(NullValue.INSTANCE)) {\n if (op !== Operator.EQUAL) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Invalid query. Null supports only equality comparisons.'\n );\n }\n return new FieldFilter(field, op, value);\n } else if (value.isEqual(DoubleValue.NAN)) {\n if (op !== Operator.EQUAL) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Invalid query. NaN supports only equality comparisons.'\n );\n }\n return new FieldFilter(field, op, value);\n } else if (op === Operator.ARRAY_CONTAINS) {\n return new ArrayContainsFilter(field, value);\n } else if (op === Operator.IN) {\n assert(\n value instanceof ArrayValue,\n 'IN filter has invalid value: ' + value.toString()\n );\n return new InFilter(field, value);\n } else if (op === Operator.ARRAY_CONTAINS_ANY) {\n assert(\n value instanceof ArrayValue,\n 'ARRAY_CONTAINS_ANY filter has invalid value: ' + value.toString()\n );\n return new ArrayContainsAnyFilter(field, value);\n } else {\n return new FieldFilter(field, op, value);\n }\n }\n\n matches(doc: Document): boolean {\n const other = doc.field(this.field);\n\n // Only compare types with matching backend order (such as double and int).\n return (\n other !== null &&\n this.value.typeOrder === other.typeOrder &&\n this.matchesComparison(other.compareTo(this.value))\n );\n }\n\n protected matchesComparison(comparison: number): boolean {\n switch (this.op) {\n case Operator.LESS_THAN:\n return comparison < 0;\n case Operator.LESS_THAN_OR_EQUAL:\n return comparison <= 0;\n case Operator.EQUAL:\n return comparison === 0;\n case Operator.GREATER_THAN:\n return comparison > 0;\n case Operator.GREATER_THAN_OR_EQUAL:\n return comparison >= 0;\n default:\n return fail('Unknown FieldFilter operator: ' + this.op);\n }\n }\n\n isInequality(): boolean {\n return (\n [\n Operator.LESS_THAN,\n Operator.LESS_THAN_OR_EQUAL,\n Operator.GREATER_THAN,\n Operator.GREATER_THAN_OR_EQUAL\n ].indexOf(this.op) >= 0\n );\n }\n\n canonicalId(): string {\n // TODO(b/29183165): Technically, this won't be unique if two values have\n // the same description, such as the int 3 and the string \"3\". So we should\n // add the types in here somehow, too.\n return (\n this.field.canonicalString() + this.op.toString() + this.value.toString()\n );\n }\n\n isEqual(other: Filter): boolean {\n if (other instanceof FieldFilter) {\n return (\n this.op.isEqual(other.op) &&\n this.field.isEqual(other.field) &&\n this.value.isEqual(other.value)\n );\n } else {\n return false;\n }\n }\n\n toString(): string {\n return `${this.field.canonicalString()} ${this.op} ${this.value.value()}`;\n }\n}\n\n/** Filter that matches on key fields (i.e. '__name__'). */\nexport class KeyFieldFilter extends FieldFilter {\n matches(doc: Document): boolean {\n const refValue = this.value as RefValue;\n const comparison = DocumentKey.comparator(doc.key, refValue.key);\n return this.matchesComparison(comparison);\n }\n}\n\n/** Filter that matches on key fields within an array. */\nexport class KeyFieldInFilter extends FieldFilter {\n constructor(field: FieldPath, public value: ArrayValue) {\n super(field, Operator.IN, value);\n }\n\n matches(doc: Document): boolean {\n const arrayValue = this.value;\n return arrayValue.internalValue.some(refValue => {\n return doc.key.isEqual((refValue as RefValue).key);\n });\n }\n}\n\n/** A Filter that implements the array-contains operator. */\nexport class ArrayContainsFilter extends FieldFilter {\n constructor(field: FieldPath, value: FieldValue) {\n super(field, Operator.ARRAY_CONTAINS, value);\n }\n\n matches(doc: Document): boolean {\n const other = doc.field(this.field);\n return other instanceof ArrayValue && other.contains(this.value);\n }\n}\n\n/** A Filter that implements the IN operator. */\nexport class InFilter extends FieldFilter {\n constructor(field: FieldPath, public value: ArrayValue) {\n super(field, Operator.IN, value);\n }\n\n matches(doc: Document): boolean {\n const arrayValue = this.value;\n const other = doc.field(this.field);\n return other !== null && arrayValue.contains(other);\n }\n}\n\n/** A Filter that implements the array-contains-any operator. */\nexport class ArrayContainsAnyFilter extends FieldFilter {\n constructor(field: FieldPath, public value: ArrayValue) {\n super(field, Operator.ARRAY_CONTAINS_ANY, value);\n }\n\n matches(doc: Document): boolean {\n const other = doc.field(this.field);\n return (\n other instanceof ArrayValue &&\n other.internalValue.some(lhsElem => {\n return this.value.contains(lhsElem);\n })\n );\n }\n}\n\n/**\n * The direction of sorting in an order by.\n */\nexport class Direction {\n static ASCENDING = new Direction('asc');\n static DESCENDING = new Direction('desc');\n\n private constructor(public name: string) {}\n\n toString(): string {\n return this.name;\n }\n}\n\n/**\n * Represents a bound of a query.\n *\n * The bound is specified with the given components representing a position and\n * whether it's just before or just after the position (relative to whatever the\n * query order is).\n *\n * The position represents a logical index position for a query. It's a prefix\n * of values for the (potentially implicit) order by clauses of a query.\n *\n * Bound provides a function to determine whether a document comes before or\n * after a bound. This is influenced by whether the position is just before or\n * just after the provided values.\n */\nexport class Bound {\n constructor(readonly position: FieldValue[], readonly before: boolean) {}\n\n canonicalId(): string {\n // TODO(b/29183165): Make this collision robust.\n let canonicalId = this.before ? 'b:' : 'a:';\n for (const component of this.position) {\n canonicalId += component.toString();\n }\n return canonicalId;\n }\n\n /**\n * Returns true if a document sorts before a bound using the provided sort\n * order.\n */\n sortsBeforeDocument(orderBy: OrderBy[], doc: Document): boolean {\n assert(\n this.position.length <= orderBy.length,\n \"Bound has more components than query's orderBy\"\n );\n let comparison = 0;\n for (let i = 0; i < this.position.length; i++) {\n const orderByComponent = orderBy[i];\n const component = this.position[i];\n if (orderByComponent.field.isKeyField()) {\n assert(\n component instanceof RefValue,\n 'Bound has a non-key value where the key path is being used.'\n );\n comparison = DocumentKey.comparator(component.key, doc.key);\n } else {\n const docValue = doc.field(orderByComponent.field);\n assert(\n docValue !== null,\n 'Field should exist since document matched the orderBy already.'\n );\n comparison = component.compareTo(docValue);\n }\n if (orderByComponent.dir === Direction.DESCENDING) {\n comparison = comparison * -1;\n }\n if (comparison !== 0) {\n break;\n }\n }\n return this.before ? comparison <= 0 : comparison < 0;\n }\n\n isEqual(other: Bound | null): boolean {\n if (other === null) {\n return false;\n }\n if (\n this.before !== other.before ||\n this.position.length !== other.position.length\n ) {\n return false;\n }\n for (let i = 0; i < this.position.length; i++) {\n const thisPosition = this.position[i];\n const otherPosition = other.position[i];\n if (!thisPosition.isEqual(otherPosition)) {\n return false;\n }\n }\n return true;\n }\n}\n\n/**\n * An ordering on a field, in some Direction. Direction defaults to ASCENDING.\n */\nexport class OrderBy {\n readonly dir: Direction;\n private readonly isKeyOrderBy: boolean;\n\n constructor(readonly field: FieldPath, dir?: Direction) {\n if (dir === undefined) {\n dir = Direction.ASCENDING;\n }\n this.dir = dir;\n this.isKeyOrderBy = field.isKeyField();\n }\n\n compare(d1: Document, d2: Document): number {\n const comparison = this.isKeyOrderBy\n ? Document.compareByKey(d1, d2)\n : Document.compareByField(this.field, d1, d2);\n switch (this.dir) {\n case Direction.ASCENDING:\n return comparison;\n case Direction.DESCENDING:\n return -1 * comparison;\n default:\n return fail('Unknown direction: ' + this.dir);\n }\n }\n\n canonicalId(): string {\n // TODO(b/29183165): Make this collision robust.\n return this.field.canonicalString() + this.dir.toString();\n }\n\n toString(): string {\n return `${this.field.canonicalString()} (${this.dir})`;\n }\n\n isEqual(other: OrderBy): boolean {\n return this.dir === other.dir && this.field.isEqual(other.field);\n }\n}\n\nconst KEY_ORDERING_ASC = new OrderBy(FieldPath.keyField(), Direction.ASCENDING);\nconst KEY_ORDERING_DESC = new OrderBy(\n FieldPath.keyField(),\n Direction.DESCENDING\n);\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { Target } from '../core/target';\nimport { ListenSequenceNumber, ProtoByteString, TargetId } from '../core/types';\nimport { emptyByteString } from '../platform/platform';\n\n/** An enumeration of the different purposes we have for targets. */\nexport enum TargetPurpose {\n /** A regular, normal query target. */\n Listen,\n\n /**\n * The query target was used to refill a query after an existence filter mismatch.\n */\n ExistenceFilterMismatch,\n\n /** The query target was used to resolve a limbo document. */\n LimboResolution\n}\n\n/**\n * An immutable set of metadata that the local store tracks for each target.\n */\nexport class TargetData {\n constructor(\n /** The target being listened to. */\n readonly target: Target,\n /**\n * The target ID to which the target corresponds; Assigned by the\n * LocalStore for user listens and by the SyncEngine for limbo watches.\n */\n readonly targetId: TargetId,\n /** The purpose of the target. */\n readonly purpose: TargetPurpose,\n /**\n * The sequence number of the last transaction during which this target data\n * was modified.\n */\n readonly sequenceNumber: ListenSequenceNumber,\n /** The latest snapshot version seen for this target. */\n readonly snapshotVersion: SnapshotVersion = SnapshotVersion.MIN,\n /**\n * The maximum snapshot version at which the associated view\n * contained no limbo documents.\n */\n readonly lastLimboFreeSnapshotVersion: SnapshotVersion = SnapshotVersion.MIN,\n /**\n * An opaque, server-assigned token that allows watching a target to be\n * resumed after disconnecting without retransmitting all the data that\n * matches the target. The resume token essentially identifies a point in\n * time from which the server should resume sending results.\n */\n readonly resumeToken: ProtoByteString = emptyByteString()\n ) {}\n\n /** Creates a new target data instance with an updated sequence number. */\n withSequenceNumber(sequenceNumber: number): TargetData {\n return new TargetData(\n this.target,\n this.targetId,\n this.purpose,\n sequenceNumber,\n this.snapshotVersion,\n this.lastLimboFreeSnapshotVersion,\n this.resumeToken\n );\n }\n\n /**\n * Creates a new target data instance with an updated resume token and\n * snapshot version.\n */\n withResumeToken(\n resumeToken: ProtoByteString,\n snapshotVersion: SnapshotVersion\n ): TargetData {\n return new TargetData(\n this.target,\n this.targetId,\n this.purpose,\n this.sequenceNumber,\n snapshotVersion,\n this.lastLimboFreeSnapshotVersion,\n resumeToken\n );\n }\n\n /**\n * Creates a new target data instance with an updated last limbo free\n * snapshot version number.\n */\n withLastLimboFreeSnapshotVersion(\n lastLimboFreeSnapshotVersion: SnapshotVersion\n ): TargetData {\n return new TargetData(\n this.target,\n this.targetId,\n this.purpose,\n this.sequenceNumber,\n this.snapshotVersion,\n lastLimboFreeSnapshotVersion,\n this.resumeToken\n );\n }\n\n isEqual(other: TargetData): boolean {\n return (\n this.targetId === other.targetId &&\n this.purpose === other.purpose &&\n this.sequenceNumber === other.sequenceNumber &&\n this.snapshotVersion.isEqual(other.snapshotVersion) &&\n this.lastLimboFreeSnapshotVersion.isEqual(\n other.lastLimboFreeSnapshotVersion\n ) &&\n this.resumeToken === other.resumeToken &&\n this.target.isEqual(other.target)\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport class ExistenceFilter {\n // TODO(b/33078163): just use simplest form of existence filter for now\n constructor(public count: number) {}\n\n isEqual(other: ExistenceFilter): boolean {\n return other && other.count === this.count;\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { fail } from '../util/assert';\nimport { Code } from '../util/error';\nimport * as log from '../util/log';\n\n/**\n * Error Codes describing the different ways GRPC can fail. These are copied\n * directly from GRPC's sources here:\n *\n * https://github.com/grpc/grpc/blob/bceec94ea4fc5f0085d81235d8e1c06798dc341a/include/grpc%2B%2B/impl/codegen/status_code_enum.h\n *\n * Important! The names of these identifiers matter because the string forms\n * are used for reverse lookups from the webchannel stream. Do NOT change the\n * names of these identifiers.\n */\nenum RpcCode {\n OK = 0,\n CANCELLED = 1,\n UNKNOWN = 2,\n INVALID_ARGUMENT = 3,\n DEADLINE_EXCEEDED = 4,\n NOT_FOUND = 5,\n ALREADY_EXISTS = 6,\n PERMISSION_DENIED = 7,\n UNAUTHENTICATED = 16,\n RESOURCE_EXHAUSTED = 8,\n FAILED_PRECONDITION = 9,\n ABORTED = 10,\n OUT_OF_RANGE = 11,\n UNIMPLEMENTED = 12,\n INTERNAL = 13,\n UNAVAILABLE = 14,\n DATA_LOSS = 15\n}\n\n/**\n * Determines whether an error code represents a permanent error when received\n * in response to a non-write operation.\n *\n * See isPermanentWriteError for classifying write errors.\n */\nexport function isPermanentError(code: Code): boolean {\n switch (code) {\n case Code.OK:\n return fail('Treated status OK as error');\n case Code.CANCELLED:\n case Code.UNKNOWN:\n case Code.DEADLINE_EXCEEDED:\n case Code.RESOURCE_EXHAUSTED:\n case Code.INTERNAL:\n case Code.UNAVAILABLE:\n // Unauthenticated means something went wrong with our token and we need\n // to retry with new credentials which will happen automatically.\n case Code.UNAUTHENTICATED:\n return false;\n case Code.INVALID_ARGUMENT:\n case Code.NOT_FOUND:\n case Code.ALREADY_EXISTS:\n case Code.PERMISSION_DENIED:\n case Code.FAILED_PRECONDITION:\n // Aborted might be retried in some scenarios, but that is dependant on\n // the context and should handled individually by the calling code.\n // See https://cloud.google.com/apis/design/errors.\n case Code.ABORTED:\n case Code.OUT_OF_RANGE:\n case Code.UNIMPLEMENTED:\n case Code.DATA_LOSS:\n return true;\n default:\n return fail('Unknown status code: ' + code);\n }\n}\n\n/**\n * Determines whether an error code represents a permanent error when received\n * in response to a write operation.\n *\n * Write operations must be handled specially because as of b/119437764, ABORTED\n * errors on the write stream should be retried too (even though ABORTED errors\n * are not generally retryable).\n *\n * Note that during the initial handshake on the write stream an ABORTED error\n * signals that we should discard our stream token (i.e. it is permanent). This\n * means a handshake error should be classified with isPermanentError, above.\n */\nexport function isPermanentWriteError(code: Code): boolean {\n return isPermanentError(code) && code !== Code.ABORTED;\n}\n\n/**\n * Maps an error Code from a GRPC status identifier like 'NOT_FOUND'.\n *\n * @returns The Code equivalent to the given status string or undefined if\n * there is no match.\n */\nexport function mapCodeFromRpcStatus(status: string): Code | undefined {\n // lookup by string\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const code: RpcCode = RpcCode[status as any] as any;\n if (code === undefined) {\n return undefined;\n }\n\n return mapCodeFromRpcCode(code);\n}\n\n/**\n * Maps an error Code from GRPC status code number, like 0, 1, or 14. These\n * are not the same as HTTP status codes.\n *\n * @returns The Code equivalent to the given GRPC status code. Fails if there\n * is no match.\n */\nexport function mapCodeFromRpcCode(code: number | undefined): Code {\n if (code === undefined) {\n // This shouldn't normally happen, but in certain error cases (like trying\n // to send invalid proto messages) we may get an error with no GRPC code.\n log.error('GRPC error has no .code');\n return Code.UNKNOWN;\n }\n\n switch (code) {\n case RpcCode.OK:\n return Code.OK;\n case RpcCode.CANCELLED:\n return Code.CANCELLED;\n case RpcCode.UNKNOWN:\n return Code.UNKNOWN;\n case RpcCode.DEADLINE_EXCEEDED:\n return Code.DEADLINE_EXCEEDED;\n case RpcCode.RESOURCE_EXHAUSTED:\n return Code.RESOURCE_EXHAUSTED;\n case RpcCode.INTERNAL:\n return Code.INTERNAL;\n case RpcCode.UNAVAILABLE:\n return Code.UNAVAILABLE;\n case RpcCode.UNAUTHENTICATED:\n return Code.UNAUTHENTICATED;\n case RpcCode.INVALID_ARGUMENT:\n return Code.INVALID_ARGUMENT;\n case RpcCode.NOT_FOUND:\n return Code.NOT_FOUND;\n case RpcCode.ALREADY_EXISTS:\n return Code.ALREADY_EXISTS;\n case RpcCode.PERMISSION_DENIED:\n return Code.PERMISSION_DENIED;\n case RpcCode.FAILED_PRECONDITION:\n return Code.FAILED_PRECONDITION;\n case RpcCode.ABORTED:\n return Code.ABORTED;\n case RpcCode.OUT_OF_RANGE:\n return Code.OUT_OF_RANGE;\n case RpcCode.UNIMPLEMENTED:\n return Code.UNIMPLEMENTED;\n case RpcCode.DATA_LOSS:\n return Code.DATA_LOSS;\n default:\n return fail('Unknown status code: ' + code);\n }\n}\n\n/**\n * Maps an RPC code from a Code. This is the reverse operation from\n * mapCodeFromRpcCode and should really only be used in tests.\n */\nexport function mapRpcCodeFromCode(code: Code | undefined): number {\n if (code === undefined) {\n return RpcCode.OK;\n }\n\n switch (code) {\n case Code.OK:\n return RpcCode.OK;\n case Code.CANCELLED:\n return RpcCode.CANCELLED;\n case Code.UNKNOWN:\n return RpcCode.UNKNOWN;\n case Code.DEADLINE_EXCEEDED:\n return RpcCode.DEADLINE_EXCEEDED;\n case Code.RESOURCE_EXHAUSTED:\n return RpcCode.RESOURCE_EXHAUSTED;\n case Code.INTERNAL:\n return RpcCode.INTERNAL;\n case Code.UNAVAILABLE:\n return RpcCode.UNAVAILABLE;\n case Code.UNAUTHENTICATED:\n return RpcCode.UNAUTHENTICATED;\n case Code.INVALID_ARGUMENT:\n return RpcCode.INVALID_ARGUMENT;\n case Code.NOT_FOUND:\n return RpcCode.NOT_FOUND;\n case Code.ALREADY_EXISTS:\n return RpcCode.ALREADY_EXISTS;\n case Code.PERMISSION_DENIED:\n return RpcCode.PERMISSION_DENIED;\n case Code.FAILED_PRECONDITION:\n return RpcCode.FAILED_PRECONDITION;\n case Code.ABORTED:\n return RpcCode.ABORTED;\n case Code.OUT_OF_RANGE:\n return RpcCode.OUT_OF_RANGE;\n case Code.UNIMPLEMENTED:\n return RpcCode.UNIMPLEMENTED;\n case Code.DATA_LOSS:\n return RpcCode.DATA_LOSS;\n default:\n return fail('Unknown status code: ' + code);\n }\n}\n\n/**\n * Converts an HTTP Status Code to the equivalent error code.\n *\n * @param status An HTTP Status Code, like 200, 404, 503, etc.\n * @returns The equivalent Code. Unknown status codes are mapped to\n * Code.UNKNOWN.\n */\nexport function mapCodeFromHttpStatus(status: number): Code {\n // The canonical error codes for Google APIs [1] specify mapping onto HTTP\n // status codes but the mapping is not bijective. In each case of ambiguity\n // this function chooses a primary error.\n //\n // [1]\n // https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto\n switch (status) {\n case 200: // OK\n return Code.OK;\n\n case 400: // Bad Request\n return Code.INVALID_ARGUMENT;\n // Other possibilities based on the forward mapping\n // return Code.FAILED_PRECONDITION;\n // return Code.OUT_OF_RANGE;\n\n case 401: // Unauthorized\n return Code.UNAUTHENTICATED;\n\n case 403: // Forbidden\n return Code.PERMISSION_DENIED;\n\n case 404: // Not Found\n return Code.NOT_FOUND;\n\n case 409: // Conflict\n return Code.ABORTED;\n // Other possibilities:\n // return Code.ALREADY_EXISTS;\n\n case 416: // Range Not Satisfiable\n return Code.OUT_OF_RANGE;\n\n case 429: // Too Many Requests\n return Code.RESOURCE_EXHAUSTED;\n\n case 499: // Client Closed Request\n return Code.CANCELLED;\n\n case 500: // Internal Server Error\n return Code.UNKNOWN;\n // Other possibilities:\n // return Code.INTERNAL;\n // return Code.DATA_LOSS;\n\n case 501: // Unimplemented\n return Code.UNIMPLEMENTED;\n\n case 503: // Service Unavailable\n return Code.UNAVAILABLE;\n\n case 504: // Gateway Timeout\n return Code.DEADLINE_EXCEEDED;\n\n default:\n if (status >= 200 && status < 300) {\n return Code.OK;\n }\n if (status >= 400 && status < 500) {\n return Code.FAILED_PRECONDITION;\n }\n if (status >= 500 && status < 600) {\n return Code.INTERNAL;\n }\n return Code.UNKNOWN;\n }\n}\n\n/**\n * Converts an HTTP response's error status to the equivalent error code.\n *\n * @param status An HTTP error response status (\"FAILED_PRECONDITION\",\n * \"UNKNOWN\", etc.)\n * @returns The equivalent Code. Non-matching responses are mapped to\n * Code.UNKNOWN.\n */\nexport function mapCodeFromHttpResponseErrorStatus(status: string): Code {\n const serverError = status.toLowerCase().replace('_', '-');\n return Object.values(Code).indexOf(serverError as Code) >= 0\n ? (serverError as Code)\n : Code.UNKNOWN;\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { SortedMap } from '../util/sorted_map';\nimport { SortedSet } from '../util/sorted_set';\n\nimport { TargetId } from '../core/types';\nimport { primitiveComparator } from '../util/misc';\nimport { Document, MaybeDocument } from './document';\nimport { DocumentKey } from './document_key';\n\n/** Miscellaneous collection types / constants. */\nexport interface DocumentSizeEntry {\n maybeDocument: MaybeDocument;\n size: number;\n}\n\nexport type MaybeDocumentMap = SortedMap<DocumentKey, MaybeDocument>;\nconst EMPTY_MAYBE_DOCUMENT_MAP = new SortedMap<DocumentKey, MaybeDocument>(\n DocumentKey.comparator\n);\nexport function maybeDocumentMap(): MaybeDocumentMap {\n return EMPTY_MAYBE_DOCUMENT_MAP;\n}\n\nexport type NullableMaybeDocumentMap = SortedMap<\n DocumentKey,\n MaybeDocument | null\n>;\n\nexport function nullableMaybeDocumentMap(): NullableMaybeDocumentMap {\n return maybeDocumentMap();\n}\n\nexport interface DocumentSizeEntries {\n maybeDocuments: NullableMaybeDocumentMap;\n sizeMap: SortedMap<DocumentKey, number>;\n}\n\nexport type DocumentMap = SortedMap<DocumentKey, Document>;\nconst EMPTY_DOCUMENT_MAP = new SortedMap<DocumentKey, Document>(\n DocumentKey.comparator\n);\nexport function documentMap(): DocumentMap {\n return EMPTY_DOCUMENT_MAP;\n}\n\nexport type DocumentVersionMap = SortedMap<DocumentKey, SnapshotVersion>;\nconst EMPTY_DOCUMENT_VERSION_MAP = new SortedMap<DocumentKey, SnapshotVersion>(\n DocumentKey.comparator\n);\nexport function documentVersionMap(): DocumentVersionMap {\n return EMPTY_DOCUMENT_VERSION_MAP;\n}\n\nexport type DocumentKeySet = SortedSet<DocumentKey>;\nconst EMPTY_DOCUMENT_KEY_SET = new SortedSet(DocumentKey.comparator);\nexport function documentKeySet(...keys: DocumentKey[]): DocumentKeySet {\n let set = EMPTY_DOCUMENT_KEY_SET;\n for (const key of keys) {\n set = set.add(key);\n }\n return set;\n}\n\nexport type TargetIdSet = SortedSet<TargetId>;\nconst EMPTY_TARGET_ID_SET = new SortedSet<TargetId>(primitiveComparator);\nexport function targetIdSet(): SortedSet<TargetId> {\n return EMPTY_TARGET_ID_SET;\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { SortedMap } from '../util/sorted_map';\n\nimport { documentMap } from './collections';\nimport { Document } from './document';\nimport { DocumentComparator } from './document_comparator';\nimport { DocumentKey } from './document_key';\n\n/**\n * DocumentSet is an immutable (copy-on-write) collection that holds documents\n * in order specified by the provided comparator. We always add a document key\n * comparator on top of what is provided to guarantee document equality based on\n * the key.\n */\n\nexport class DocumentSet {\n /**\n * Returns an empty copy of the existing DocumentSet, using the same\n * comparator.\n */\n static emptySet(oldSet: DocumentSet): DocumentSet {\n return new DocumentSet(oldSet.comparator);\n }\n\n private comparator: DocumentComparator;\n private keyedMap: SortedMap<DocumentKey, Document>;\n private sortedSet: SortedMap<Document, null>;\n\n /** The default ordering is by key if the comparator is omitted */\n constructor(comp?: DocumentComparator) {\n // We are adding document key comparator to the end as it's the only\n // guaranteed unique property of a document.\n if (comp) {\n this.comparator = (d1: Document, d2: Document) =>\n comp(d1, d2) || DocumentKey.comparator(d1.key, d2.key);\n } else {\n this.comparator = (d1: Document, d2: Document) =>\n DocumentKey.comparator(d1.key, d2.key);\n }\n\n this.keyedMap = documentMap();\n this.sortedSet = new SortedMap<Document, null>(this.comparator);\n }\n\n has(key: DocumentKey): boolean {\n return this.keyedMap.get(key) != null;\n }\n\n get(key: DocumentKey): Document | null {\n return this.keyedMap.get(key);\n }\n\n first(): Document | null {\n return this.sortedSet.minKey();\n }\n\n last(): Document | null {\n return this.sortedSet.maxKey();\n }\n\n isEmpty(): boolean {\n return this.sortedSet.isEmpty();\n }\n\n /**\n * Returns the index of the provided key in the document set, or -1 if the\n * document key is not present in the set;\n */\n indexOf(key: DocumentKey): number {\n const doc = this.keyedMap.get(key);\n return doc ? this.sortedSet.indexOf(doc) : -1;\n }\n\n get size(): number {\n return this.sortedSet.size;\n }\n\n /** Iterates documents in order defined by \"comparator\" */\n forEach(cb: (doc: Document) => void): void {\n this.sortedSet.inorderTraversal((k, v) => {\n cb(k);\n return false;\n });\n }\n\n /** Inserts or updates a document with the same key */\n add(doc: Document): DocumentSet {\n // First remove the element if we have it.\n const set = this.delete(doc.key);\n return set.copy(\n set.keyedMap.insert(doc.key, doc),\n set.sortedSet.insert(doc, null)\n );\n }\n\n /** Deletes a document with a given key */\n delete(key: DocumentKey): DocumentSet {\n const doc = this.get(key);\n if (!doc) {\n return this;\n }\n\n return this.copy(this.keyedMap.remove(key), this.sortedSet.remove(doc));\n }\n\n isEqual(other: DocumentSet | null | undefined): boolean {\n if (!(other instanceof DocumentSet)) {\n return false;\n }\n if (this.size !== other.size) {\n return false;\n }\n\n const thisIt = this.sortedSet.getIterator();\n const otherIt = other.sortedSet.getIterator();\n while (thisIt.hasNext()) {\n const thisDoc = thisIt.getNext().key;\n const otherDoc = otherIt.getNext().key;\n if (!thisDoc.isEqual(otherDoc)) {\n return false;\n }\n }\n return true;\n }\n\n toString(): string {\n const docStrings: string[] = [];\n this.forEach(doc => {\n docStrings.push(doc.toString());\n });\n if (docStrings.length === 0) {\n return 'DocumentSet ()';\n } else {\n return 'DocumentSet (\\n ' + docStrings.join(' \\n') + '\\n)';\n }\n }\n\n private copy(\n keyedMap: SortedMap<DocumentKey, Document>,\n sortedSet: SortedMap<Document, null>\n ): DocumentSet {\n const newSet = new DocumentSet();\n newSet.comparator = this.comparator;\n newSet.keyedMap = keyedMap;\n newSet.sortedSet = sortedSet;\n return newSet;\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Document } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport { DocumentSet } from '../model/document_set';\nimport { fail } from '../util/assert';\nimport { SortedMap } from '../util/sorted_map';\n\nimport { DocumentKeySet } from '../model/collections';\nimport { Query } from './query';\n\nexport enum ChangeType {\n Added,\n Removed,\n Modified,\n Metadata\n}\n\nexport interface DocumentViewChange {\n type: ChangeType;\n doc: Document;\n}\n\nexport enum SyncState {\n Local,\n Synced\n}\n\n/**\n * DocumentChangeSet keeps track of a set of changes to docs in a query, merging\n * duplicate events for the same doc.\n */\nexport class DocumentChangeSet {\n private changeMap = new SortedMap<DocumentKey, DocumentViewChange>(\n DocumentKey.comparator\n );\n\n track(change: DocumentViewChange): void {\n const key = change.doc.key;\n const oldChange = this.changeMap.get(key);\n if (!oldChange) {\n this.changeMap = this.changeMap.insert(key, change);\n return;\n }\n\n // Merge the new change with the existing change.\n if (\n change.type !== ChangeType.Added &&\n oldChange.type === ChangeType.Metadata\n ) {\n this.changeMap = this.changeMap.insert(key, change);\n } else if (\n change.type === ChangeType.Metadata &&\n oldChange.type !== ChangeType.Removed\n ) {\n this.changeMap = this.changeMap.insert(key, {\n type: oldChange.type,\n doc: change.doc\n });\n } else if (\n change.type === ChangeType.Modified &&\n oldChange.type === ChangeType.Modified\n ) {\n this.changeMap = this.changeMap.insert(key, {\n type: ChangeType.Modified,\n doc: change.doc\n });\n } else if (\n change.type === ChangeType.Modified &&\n oldChange.type === ChangeType.Added\n ) {\n this.changeMap = this.changeMap.insert(key, {\n type: ChangeType.Added,\n doc: change.doc\n });\n } else if (\n change.type === ChangeType.Removed &&\n oldChange.type === ChangeType.Added\n ) {\n this.changeMap = this.changeMap.remove(key);\n } else if (\n change.type === ChangeType.Removed &&\n oldChange.type === ChangeType.Modified\n ) {\n this.changeMap = this.changeMap.insert(key, {\n type: ChangeType.Removed,\n doc: oldChange.doc\n });\n } else if (\n change.type === ChangeType.Added &&\n oldChange.type === ChangeType.Removed\n ) {\n this.changeMap = this.changeMap.insert(key, {\n type: ChangeType.Modified,\n doc: change.doc\n });\n } else {\n // This includes these cases, which don't make sense:\n // Added->Added\n // Removed->Removed\n // Modified->Added\n // Removed->Modified\n // Metadata->Added\n // Removed->Metadata\n fail(\n 'unsupported combination of changes: ' +\n JSON.stringify(change) +\n ' after ' +\n JSON.stringify(oldChange)\n );\n }\n }\n\n getChanges(): DocumentViewChange[] {\n const changes: DocumentViewChange[] = [];\n this.changeMap.inorderTraversal(\n (key: DocumentKey, change: DocumentViewChange) => {\n changes.push(change);\n }\n );\n return changes;\n }\n}\n\nexport class ViewSnapshot {\n constructor(\n readonly query: Query,\n readonly docs: DocumentSet,\n readonly oldDocs: DocumentSet,\n readonly docChanges: DocumentViewChange[],\n readonly mutatedKeys: DocumentKeySet,\n readonly fromCache: boolean,\n readonly syncStateChanged: boolean,\n readonly excludesMetadataChanges: boolean\n ) {}\n\n /** Returns a view snapshot as if all documents in the snapshot were added. */\n static fromInitialDocuments(\n query: Query,\n documents: DocumentSet,\n mutatedKeys: DocumentKeySet,\n fromCache: boolean\n ): ViewSnapshot {\n const changes: DocumentViewChange[] = [];\n documents.forEach(doc => {\n changes.push({ type: ChangeType.Added, doc });\n });\n\n return new ViewSnapshot(\n query,\n documents,\n DocumentSet.emptySet(documents),\n changes,\n mutatedKeys,\n fromCache,\n /* syncStateChanged= */ true,\n /* excludesMetadataChanges= */ false\n );\n }\n\n get hasPendingWrites(): boolean {\n return !this.mutatedKeys.isEmpty();\n }\n\n isEqual(other: ViewSnapshot): boolean {\n if (\n this.fromCache !== other.fromCache ||\n this.syncStateChanged !== other.syncStateChanged ||\n !this.mutatedKeys.isEqual(other.mutatedKeys) ||\n !this.query.isEqual(other.query) ||\n !this.docs.isEqual(other.docs) ||\n !this.oldDocs.isEqual(other.oldDocs)\n ) {\n return false;\n }\n const changes: DocumentViewChange[] = this.docChanges;\n const otherChanges: DocumentViewChange[] = other.docChanges;\n if (changes.length !== otherChanges.length) {\n return false;\n }\n for (let i = 0; i < changes.length; i++) {\n if (\n changes[i].type !== otherChanges[i].type ||\n !changes[i].doc.isEqual(otherChanges[i].doc)\n ) {\n return false;\n }\n }\n return true;\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { ProtoByteString, TargetId } from '../core/types';\nimport {\n documentKeySet,\n DocumentKeySet,\n maybeDocumentMap,\n MaybeDocumentMap,\n targetIdSet\n} from '../model/collections';\nimport { emptyByteString } from '../platform/platform';\nimport { SortedSet } from '../util/sorted_set';\n\n/**\n * An event from the RemoteStore. It is split into targetChanges (changes to the\n * state or the set of documents in our watched targets) and documentUpdates\n * (changes to the actual documents).\n */\nexport class RemoteEvent {\n constructor(\n /**\n * The snapshot version this event brings us up to, or MIN if not set.\n */\n readonly snapshotVersion: SnapshotVersion,\n /**\n * A map from target to changes to the target. See TargetChange.\n */\n readonly targetChanges: { [targetId: number]: TargetChange },\n /**\n * A set of targets that is known to be inconsistent. Listens for these\n * targets should be re-established without resume tokens.\n */\n readonly targetMismatches: SortedSet<TargetId>,\n /**\n * A set of which documents have changed or been deleted, along with the\n * doc's new values (if not deleted).\n */\n readonly documentUpdates: MaybeDocumentMap,\n /**\n * A set of which document updates are due only to limbo resolution targets.\n */\n readonly resolvedLimboDocuments: DocumentKeySet\n ) {}\n\n /**\n * HACK: Views require RemoteEvents in order to determine whether the view is\n * CURRENT, but secondary tabs don't receive remote events. So this method is\n * used to create a synthesized RemoteEvent that can be used to apply a\n * CURRENT status change to a View, for queries executed in a different tab.\n */\n // PORTING NOTE: Multi-tab only\n static createSynthesizedRemoteEventForCurrentChange(\n targetId: TargetId,\n current: boolean\n ): RemoteEvent {\n const targetChanges = {\n [targetId]: TargetChange.createSynthesizedTargetChangeForCurrentChange(\n targetId,\n current\n )\n };\n return new RemoteEvent(\n SnapshotVersion.MIN,\n targetChanges,\n targetIdSet(),\n maybeDocumentMap(),\n documentKeySet()\n );\n }\n}\n\n/**\n * A TargetChange specifies the set of changes for a specific target as part of\n * a RemoteEvent. These changes track which documents are added, modified or\n * removed, as well as the target's resume token and whether the target is\n * marked CURRENT.\n * The actual changes *to* documents are not part of the TargetChange since\n * documents may be part of multiple targets.\n */\nexport class TargetChange {\n constructor(\n /**\n * An opaque, server-assigned token that allows watching a query to be resumed\n * after disconnecting without retransmitting all the data that matches the\n * query. The resume token essentially identifies a point in time from which\n * the server should resume sending results.\n */\n readonly resumeToken: ProtoByteString,\n /**\n * The \"current\" (synced) status of this target. Note that \"current\"\n * has special meaning in the RPC protocol that implies that a target is\n * both up-to-date and consistent with the rest of the watch stream.\n */\n readonly current: boolean,\n /**\n * The set of documents that were newly assigned to this target as part of\n * this remote event.\n */\n readonly addedDocuments: DocumentKeySet,\n /**\n * The set of documents that were already assigned to this target but received\n * an update during this remote event.\n */\n readonly modifiedDocuments: DocumentKeySet,\n /**\n * The set of documents that were removed from this target as part of this\n * remote event.\n */\n readonly removedDocuments: DocumentKeySet\n ) {}\n\n /**\n * This method is used to create a synthesized TargetChanges that can be used to\n * apply a CURRENT status change to a View (for queries executed in a different\n * tab) or for new queries (to raise snapshots with correct CURRENT status).\n */\n static createSynthesizedTargetChangeForCurrentChange(\n targetId: TargetId,\n current: boolean\n ): TargetChange {\n return new TargetChange(\n emptyByteString(),\n current,\n documentKeySet(),\n documentKeySet(),\n documentKeySet()\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { ProtoByteString, TargetId } from '../core/types';\nimport { ChangeType } from '../core/view_snapshot';\nimport { TargetData, TargetPurpose } from '../local/target_data';\nimport {\n documentKeySet,\n DocumentKeySet,\n maybeDocumentMap\n} from '../model/collections';\nimport { Document, MaybeDocument, NoDocument } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport { emptyByteString } from '../platform/platform';\nimport { assert, fail } from '../util/assert';\nimport { FirestoreError } from '../util/error';\nimport { debug } from '../util/log';\nimport { primitiveComparator } from '../util/misc';\nimport * as objUtils from '../util/obj';\nimport { SortedMap } from '../util/sorted_map';\nimport { SortedSet } from '../util/sorted_set';\nimport { ExistenceFilter } from './existence_filter';\nimport { RemoteEvent, TargetChange } from './remote_event';\n\n/**\n * Internal representation of the watcher API protocol buffers.\n */\nexport type WatchChange =\n | DocumentWatchChange\n | WatchTargetChange\n | ExistenceFilterChange;\n\n/**\n * Represents a changed document and a list of target ids to which this change\n * applies.\n *\n * If document has been deleted NoDocument will be provided.\n */\nexport class DocumentWatchChange {\n constructor(\n /** The new document applies to all of these targets. */\n public updatedTargetIds: TargetId[],\n /** The new document is removed from all of these targets. */\n public removedTargetIds: TargetId[],\n /** The key of the document for this change. */\n public key: DocumentKey,\n /**\n * The new document or NoDocument if it was deleted. Is null if the\n * document went out of view without the server sending a new document.\n */\n public newDoc: MaybeDocument | null\n ) {}\n}\n\nexport class ExistenceFilterChange {\n constructor(\n public targetId: TargetId,\n public existenceFilter: ExistenceFilter\n ) {}\n}\n\nexport enum WatchTargetChangeState {\n NoChange,\n Added,\n Removed,\n Current,\n Reset\n}\n\nexport class WatchTargetChange {\n constructor(\n /** What kind of change occurred to the watch target. */\n public state: WatchTargetChangeState,\n /** The target IDs that were added/removed/set. */\n public targetIds: TargetId[],\n /**\n * An opaque, server-assigned token that allows watching a target to be\n * resumed after disconnecting without retransmitting all the data that\n * matches the target. The resume token essentially identifies a point in\n * time from which the server should resume sending results.\n */\n public resumeToken: ProtoByteString = emptyByteString(),\n /** An RPC error indicating why the watch failed. */\n public cause: FirestoreError | null = null\n ) {}\n}\n\n/** Tracks the internal state of a Watch target. */\nclass TargetState {\n /**\n * The number of pending responses (adds or removes) that we are waiting on.\n * We only consider targets active that have no pending responses.\n */\n private pendingResponses = 0;\n\n /**\n * Keeps track of the document changes since the last raised snapshot.\n *\n * These changes are continuously updated as we receive document updates and\n * always reflect the current set of changes against the last issued snapshot.\n */\n private documentChanges: SortedMap<\n DocumentKey,\n ChangeType\n > = snapshotChangesMap();\n\n /** See public getters for explanations of these fields. */\n private _resumeToken: ProtoByteString = emptyByteString();\n private _current = false;\n\n /**\n * Whether this target state should be included in the next snapshot. We\n * initialize to true so that newly-added targets are included in the next\n * RemoteEvent.\n */\n private _hasPendingChanges = true;\n\n /**\n * Whether this target has been marked 'current'.\n *\n * 'Current' has special meaning in the RPC protocol: It implies that the\n * Watch backend has sent us all changes up to the point at which the target\n * was added and that the target is consistent with the rest of the watch\n * stream.\n */\n get current(): boolean {\n return this._current;\n }\n\n /** The last resume token sent to us for this target. */\n get resumeToken(): ProtoByteString {\n return this._resumeToken;\n }\n\n /** Whether this target has pending target adds or target removes. */\n get isPending(): boolean {\n return this.pendingResponses !== 0;\n }\n\n /** Whether we have modified any state that should trigger a snapshot. */\n get hasPendingChanges(): boolean {\n return this._hasPendingChanges;\n }\n\n /**\n * Applies the resume token to the TargetChange, but only when it has a new\n * value. Empty resumeTokens are discarded.\n */\n updateResumeToken(resumeToken: ProtoByteString): void {\n if (resumeToken.length > 0) {\n this._hasPendingChanges = true;\n this._resumeToken = resumeToken;\n }\n }\n\n /**\n * Creates a target change from the current set of changes.\n *\n * To reset the document changes after raising this snapshot, call\n * `clearPendingChanges()`.\n */\n toTargetChange(): TargetChange {\n let addedDocuments = documentKeySet();\n let modifiedDocuments = documentKeySet();\n let removedDocuments = documentKeySet();\n\n this.documentChanges.forEach((key, changeType) => {\n switch (changeType) {\n case ChangeType.Added:\n addedDocuments = addedDocuments.add(key);\n break;\n case ChangeType.Modified:\n modifiedDocuments = modifiedDocuments.add(key);\n break;\n case ChangeType.Removed:\n removedDocuments = removedDocuments.add(key);\n break;\n default:\n fail('Encountered invalid change type: ' + changeType);\n }\n });\n\n return new TargetChange(\n this._resumeToken,\n this._current,\n addedDocuments,\n modifiedDocuments,\n removedDocuments\n );\n }\n\n /**\n * Resets the document changes and sets `hasPendingChanges` to false.\n */\n clearPendingChanges(): void {\n this._hasPendingChanges = false;\n this.documentChanges = snapshotChangesMap();\n }\n\n addDocumentChange(key: DocumentKey, changeType: ChangeType): void {\n this._hasPendingChanges = true;\n this.documentChanges = this.documentChanges.insert(key, changeType);\n }\n\n removeDocumentChange(key: DocumentKey): void {\n this._hasPendingChanges = true;\n this.documentChanges = this.documentChanges.remove(key);\n }\n\n recordPendingTargetRequest(): void {\n this.pendingResponses += 1;\n }\n\n recordTargetResponse(): void {\n this.pendingResponses -= 1;\n }\n\n markCurrent(): void {\n this._hasPendingChanges = true;\n this._current = true;\n }\n}\n\n/**\n * Interface implemented by RemoteStore to expose target metadata to the\n * WatchChangeAggregator.\n */\nexport interface TargetMetadataProvider {\n /**\n * Returns the set of remote document keys for the given target ID as of the\n * last raised snapshot.\n */\n getRemoteKeysForTarget(targetId: TargetId): DocumentKeySet;\n\n /**\n * Returns the TargetData for an active target ID or 'null' if this target\n * has become inactive\n */\n getTargetDataForTarget(targetId: TargetId): TargetData | null;\n}\n\nconst LOG_TAG = 'WatchChangeAggregator';\n\n/**\n * A helper class to accumulate watch changes into a RemoteEvent.\n */\nexport class WatchChangeAggregator {\n constructor(private metadataProvider: TargetMetadataProvider) {}\n\n /** The internal state of all tracked targets. */\n private targetStates: { [targetId: number]: TargetState } = {};\n\n /** Keeps track of the documents to update since the last raised snapshot. */\n private pendingDocumentUpdates = maybeDocumentMap();\n\n /** A mapping of document keys to their set of target IDs. */\n private pendingDocumentTargetMapping = documentTargetMap();\n\n /**\n * A list of targets with existence filter mismatches. These targets are\n * known to be inconsistent and their listens needs to be re-established by\n * RemoteStore.\n */\n private pendingTargetResets = new SortedSet<TargetId>(primitiveComparator);\n\n /**\n * Processes and adds the DocumentWatchChange to the current set of changes.\n */\n handleDocumentChange(docChange: DocumentWatchChange): void {\n for (const targetId of docChange.updatedTargetIds) {\n if (docChange.newDoc instanceof Document) {\n this.addDocumentToTarget(targetId, docChange.newDoc);\n } else if (docChange.newDoc instanceof NoDocument) {\n this.removeDocumentFromTarget(\n targetId,\n docChange.key,\n docChange.newDoc\n );\n }\n }\n\n for (const targetId of docChange.removedTargetIds) {\n this.removeDocumentFromTarget(targetId, docChange.key, docChange.newDoc);\n }\n }\n\n /** Processes and adds the WatchTargetChange to the current set of changes. */\n handleTargetChange(targetChange: WatchTargetChange): void {\n this.forEachTarget(targetChange, targetId => {\n const targetState = this.ensureTargetState(targetId);\n switch (targetChange.state) {\n case WatchTargetChangeState.NoChange:\n if (this.isActiveTarget(targetId)) {\n targetState.updateResumeToken(targetChange.resumeToken);\n }\n break;\n case WatchTargetChangeState.Added:\n // We need to decrement the number of pending acks needed from watch\n // for this targetId.\n targetState.recordTargetResponse();\n if (!targetState.isPending) {\n // We have a freshly added target, so we need to reset any state\n // that we had previously. This can happen e.g. when remove and add\n // back a target for existence filter mismatches.\n targetState.clearPendingChanges();\n }\n targetState.updateResumeToken(targetChange.resumeToken);\n break;\n case WatchTargetChangeState.Removed:\n // We need to keep track of removed targets to we can post-filter and\n // remove any target changes.\n // We need to decrement the number of pending acks needed from watch\n // for this targetId.\n targetState.recordTargetResponse();\n if (!targetState.isPending) {\n this.removeTarget(targetId);\n }\n assert(\n !targetChange.cause,\n 'WatchChangeAggregator does not handle errored targets'\n );\n break;\n case WatchTargetChangeState.Current:\n if (this.isActiveTarget(targetId)) {\n targetState.markCurrent();\n targetState.updateResumeToken(targetChange.resumeToken);\n }\n break;\n case WatchTargetChangeState.Reset:\n if (this.isActiveTarget(targetId)) {\n // Reset the target and synthesizes removes for all existing\n // documents. The backend will re-add any documents that still\n // match the target before it sends the next global snapshot.\n this.resetTarget(targetId);\n targetState.updateResumeToken(targetChange.resumeToken);\n }\n break;\n default:\n fail('Unknown target watch change state: ' + targetChange.state);\n }\n });\n }\n\n /**\n * Iterates over all targetIds that the watch change applies to: either the\n * targetIds explicitly listed in the change or the targetIds of all currently\n * active targets.\n */\n forEachTarget(\n targetChange: WatchTargetChange,\n fn: (targetId: TargetId) => void\n ): void {\n if (targetChange.targetIds.length > 0) {\n targetChange.targetIds.forEach(fn);\n } else {\n objUtils.forEachNumber(this.targetStates, fn);\n }\n }\n\n /**\n * Handles existence filters and synthesizes deletes for filter mismatches.\n * Targets that are invalidated by filter mismatches are added to\n * `pendingTargetResets`.\n */\n handleExistenceFilter(watchChange: ExistenceFilterChange): void {\n const targetId = watchChange.targetId;\n const expectedCount = watchChange.existenceFilter.count;\n\n const targetData = this.targetDataForActiveTarget(targetId);\n if (targetData) {\n const target = targetData.target;\n if (target.isDocumentQuery()) {\n if (expectedCount === 0) {\n // The existence filter told us the document does not exist. We deduce\n // that this document does not exist and apply a deleted document to\n // our updates. Without applying this deleted document there might be\n // another query that will raise this document as part of a snapshot\n // until it is resolved, essentially exposing inconsistency between\n // queries.\n const key = new DocumentKey(target.path);\n this.removeDocumentFromTarget(\n targetId,\n key,\n new NoDocument(key, SnapshotVersion.forDeletedDoc())\n );\n } else {\n assert(\n expectedCount === 1,\n 'Single document existence filter with count: ' + expectedCount\n );\n }\n } else {\n const currentSize = this.getCurrentDocumentCountForTarget(targetId);\n if (currentSize !== expectedCount) {\n // Existence filter mismatch: We reset the mapping and raise a new\n // snapshot with `isFromCache:true`.\n this.resetTarget(targetId);\n this.pendingTargetResets = this.pendingTargetResets.add(targetId);\n }\n }\n }\n }\n\n /**\n * Converts the currently accumulated state into a remote event at the\n * provided snapshot version. Resets the accumulated changes before returning.\n */\n createRemoteEvent(snapshotVersion: SnapshotVersion): RemoteEvent {\n const targetChanges: { [targetId: number]: TargetChange } = {};\n\n objUtils.forEachNumber(this.targetStates, (targetId, targetState) => {\n const targetData = this.targetDataForActiveTarget(targetId);\n if (targetData) {\n if (targetState.current && targetData.target.isDocumentQuery()) {\n // Document queries for document that don't exist can produce an empty\n // result set. To update our local cache, we synthesize a document\n // delete if we have not previously received the document. This\n // resolves the limbo state of the document, removing it from\n // limboDocumentRefs.\n //\n // TODO(dimond): Ideally we would have an explicit lookup target\n // instead resulting in an explicit delete message and we could\n // remove this special logic.\n const key = new DocumentKey(targetData.target.path);\n if (\n this.pendingDocumentUpdates.get(key) === null &&\n !this.targetContainsDocument(targetId, key)\n ) {\n this.removeDocumentFromTarget(\n targetId,\n key,\n new NoDocument(key, snapshotVersion)\n );\n }\n }\n\n if (targetState.hasPendingChanges) {\n targetChanges[targetId] = targetState.toTargetChange();\n targetState.clearPendingChanges();\n }\n }\n });\n\n let resolvedLimboDocuments = documentKeySet();\n\n // We extract the set of limbo-only document updates as the GC logic\n // special-cases documents that do not appear in the target cache.\n //\n // TODO(gsoltis): Expand on this comment once GC is available in the JS\n // client.\n this.pendingDocumentTargetMapping.forEach((key, targets) => {\n let isOnlyLimboTarget = true;\n\n targets.forEachWhile(targetId => {\n const targetData = this.targetDataForActiveTarget(targetId);\n if (\n targetData &&\n targetData.purpose !== TargetPurpose.LimboResolution\n ) {\n isOnlyLimboTarget = false;\n return false;\n }\n\n return true;\n });\n\n if (isOnlyLimboTarget) {\n resolvedLimboDocuments = resolvedLimboDocuments.add(key);\n }\n });\n\n const remoteEvent = new RemoteEvent(\n snapshotVersion,\n targetChanges,\n this.pendingTargetResets,\n this.pendingDocumentUpdates,\n resolvedLimboDocuments\n );\n\n this.pendingDocumentUpdates = maybeDocumentMap();\n this.pendingDocumentTargetMapping = documentTargetMap();\n this.pendingTargetResets = new SortedSet<TargetId>(primitiveComparator);\n\n return remoteEvent;\n }\n\n /**\n * Adds the provided document to the internal list of document updates and\n * its document key to the given target's mapping.\n */\n // Visible for testing.\n addDocumentToTarget(targetId: TargetId, document: MaybeDocument): void {\n if (!this.isActiveTarget(targetId)) {\n return;\n }\n\n const changeType = this.targetContainsDocument(targetId, document.key)\n ? ChangeType.Modified\n : ChangeType.Added;\n\n const targetState = this.ensureTargetState(targetId);\n targetState.addDocumentChange(document.key, changeType);\n\n this.pendingDocumentUpdates = this.pendingDocumentUpdates.insert(\n document.key,\n document\n );\n\n this.pendingDocumentTargetMapping = this.pendingDocumentTargetMapping.insert(\n document.key,\n this.ensureDocumentTargetMapping(document.key).add(targetId)\n );\n }\n\n /**\n * Removes the provided document from the target mapping. If the\n * document no longer matches the target, but the document's state is still\n * known (e.g. we know that the document was deleted or we received the change\n * that caused the filter mismatch), the new document can be provided\n * to update the remote document cache.\n */\n // Visible for testing.\n removeDocumentFromTarget(\n targetId: TargetId,\n key: DocumentKey,\n updatedDocument: MaybeDocument | null\n ): void {\n if (!this.isActiveTarget(targetId)) {\n return;\n }\n\n const targetState = this.ensureTargetState(targetId);\n if (this.targetContainsDocument(targetId, key)) {\n targetState.addDocumentChange(key, ChangeType.Removed);\n } else {\n // The document may have entered and left the target before we raised a\n // snapshot, so we can just ignore the change.\n targetState.removeDocumentChange(key);\n }\n\n this.pendingDocumentTargetMapping = this.pendingDocumentTargetMapping.insert(\n key,\n this.ensureDocumentTargetMapping(key).delete(targetId)\n );\n\n if (updatedDocument) {\n this.pendingDocumentUpdates = this.pendingDocumentUpdates.insert(\n key,\n updatedDocument\n );\n }\n }\n\n removeTarget(targetId: TargetId): void {\n delete this.targetStates[targetId];\n }\n\n /**\n * Returns the current count of documents in the target. This includes both\n * the number of documents that the LocalStore considers to be part of the\n * target as well as any accumulated changes.\n */\n private getCurrentDocumentCountForTarget(targetId: TargetId): number {\n const targetState = this.ensureTargetState(targetId);\n const targetChange = targetState.toTargetChange();\n return (\n this.metadataProvider.getRemoteKeysForTarget(targetId).size +\n targetChange.addedDocuments.size -\n targetChange.removedDocuments.size\n );\n }\n\n /**\n * Increment the number of acks needed from watch before we can consider the\n * server to be 'in-sync' with the client's active targets.\n */\n recordPendingTargetRequest(targetId: TargetId): void {\n // For each request we get we need to record we need a response for it.\n const targetState = this.ensureTargetState(targetId);\n targetState.recordPendingTargetRequest();\n }\n\n private ensureTargetState(targetId: TargetId): TargetState {\n if (!this.targetStates[targetId]) {\n this.targetStates[targetId] = new TargetState();\n }\n\n return this.targetStates[targetId];\n }\n\n private ensureDocumentTargetMapping(key: DocumentKey): SortedSet<TargetId> {\n let targetMapping = this.pendingDocumentTargetMapping.get(key);\n\n if (!targetMapping) {\n targetMapping = new SortedSet<TargetId>(primitiveComparator);\n this.pendingDocumentTargetMapping = this.pendingDocumentTargetMapping.insert(\n key,\n targetMapping\n );\n }\n\n return targetMapping;\n }\n\n /**\n * Verifies that the user is still interested in this target (by calling\n * `getTargetDataForTarget()`) and that we are not waiting for pending ADDs\n * from watch.\n */\n protected isActiveTarget(targetId: TargetId): boolean {\n const targetActive = this.targetDataForActiveTarget(targetId) !== null;\n if (!targetActive) {\n debug(LOG_TAG, 'Detected inactive target', targetId);\n }\n return targetActive;\n }\n\n /**\n * Returns the TargetData for an active target (i.e. a target that the user\n * is still interested in that has no outstanding target change requests).\n */\n protected targetDataForActiveTarget(targetId: TargetId): TargetData | null {\n const targetState = this.targetStates[targetId];\n return targetState && targetState.isPending\n ? null\n : this.metadataProvider.getTargetDataForTarget(targetId);\n }\n\n /**\n * Resets the state of a Watch target to its initial state (e.g. sets\n * 'current' to false, clears the resume token and removes its target mapping\n * from all documents).\n */\n private resetTarget(targetId: TargetId): void {\n assert(\n !this.targetStates[targetId].isPending,\n 'Should only reset active targets'\n );\n this.targetStates[targetId] = new TargetState();\n\n // Trigger removal for any documents currently mapped to this target.\n // These removals will be part of the initial snapshot if Watch does not\n // resend these documents.\n const existingKeys = this.metadataProvider.getRemoteKeysForTarget(targetId);\n existingKeys.forEach(key => {\n this.removeDocumentFromTarget(targetId, key, /*updatedDocument=*/ null);\n });\n }\n /**\n * Returns whether the LocalStore considers the document to be part of the\n * specified target.\n */\n private targetContainsDocument(\n targetId: TargetId,\n key: DocumentKey\n ): boolean {\n const existingKeys = this.metadataProvider.getRemoteKeysForTarget(targetId);\n return existingKeys.has(key);\n }\n}\n\nfunction documentTargetMap(): SortedMap<DocumentKey, SortedSet<TargetId>> {\n return new SortedMap<DocumentKey, SortedSet<TargetId>>(\n DocumentKey.comparator\n );\n}\n\nfunction snapshotChangesMap(): SortedMap<DocumentKey, ChangeType> {\n return new SortedMap<DocumentKey, ChangeType>(DocumentKey.comparator);\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Blob } from '../api/blob';\nimport { GeoPoint } from '../api/geo_point';\nimport { Timestamp } from '../api/timestamp';\nimport { DatabaseId } from '../core/database_info';\nimport {\n Bound,\n Direction,\n FieldFilter,\n Filter,\n LimitType,\n Operator,\n OrderBy,\n Query\n} from '../core/query';\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { Target } from '../core/target';\nimport { ProtoByteString, TargetId } from '../core/types';\nimport { TargetData, TargetPurpose } from '../local/target_data';\nimport { Document, MaybeDocument, NoDocument } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport * as fieldValue from '../model/field_value';\nimport {\n DeleteMutation,\n FieldMask,\n FieldTransform,\n Mutation,\n MutationResult,\n PatchMutation,\n Precondition,\n SetMutation,\n TransformMutation,\n VerifyMutation\n} from '../model/mutation';\nimport { FieldPath, ResourcePath } from '../model/path';\nimport * as api from '../protos/firestore_proto_api';\nimport { assert, fail } from '../util/assert';\nimport { Code, FirestoreError } from '../util/error';\nimport * as obj from '../util/obj';\nimport * as typeUtils from '../util/types';\n\nimport {\n ArrayRemoveTransformOperation,\n ArrayUnionTransformOperation,\n NumericIncrementTransformOperation,\n ServerTimestampTransform,\n TransformOperation\n} from '../model/transform_operation';\nimport { ExistenceFilter } from './existence_filter';\nimport { mapCodeFromRpcCode, mapRpcCodeFromCode } from './rpc_error';\nimport {\n DocumentWatchChange,\n ExistenceFilterChange,\n WatchChange,\n WatchTargetChange,\n WatchTargetChangeState\n} from './watch_change';\n\nconst DIRECTIONS = (() => {\n const dirs: { [dir: string]: api.OrderDirection } = {};\n dirs[Direction.ASCENDING.name] = 'ASCENDING';\n dirs[Direction.DESCENDING.name] = 'DESCENDING';\n return dirs;\n})();\n\nconst OPERATORS = (() => {\n const ops: { [op: string]: api.FieldFilterOp } = {};\n ops[Operator.LESS_THAN.name] = 'LESS_THAN';\n ops[Operator.LESS_THAN_OR_EQUAL.name] = 'LESS_THAN_OR_EQUAL';\n ops[Operator.GREATER_THAN.name] = 'GREATER_THAN';\n ops[Operator.GREATER_THAN_OR_EQUAL.name] = 'GREATER_THAN_OR_EQUAL';\n ops[Operator.EQUAL.name] = 'EQUAL';\n ops[Operator.ARRAY_CONTAINS.name] = 'ARRAY_CONTAINS';\n ops[Operator.IN.name] = 'IN';\n ops[Operator.ARRAY_CONTAINS_ANY.name] = 'ARRAY_CONTAINS_ANY';\n return ops;\n})();\n\n// A RegExp matching ISO 8601 UTC timestamps with optional fraction.\nconst ISO_REG_EXP = new RegExp(/^\\d{4}-\\d\\d-\\d\\dT\\d\\d:\\d\\d:\\d\\d(?:\\.(\\d+))?Z$/);\n\nfunction assertPresent(value: unknown, description: string): asserts value {\n assert(!typeUtils.isNullOrUndefined(value), description + ' is missing');\n}\n\nfunction parseInt64(value: number | string): number {\n // TODO(bjornick): Handle int64 greater than 53 bits.\n if (typeof value === 'number') {\n return value;\n } else if (typeof value === 'string') {\n return Number(value);\n } else {\n return fail(\"can't parse \" + value);\n }\n}\n\n// This is a supplement to the generated proto interfaces, which fail to account\n// for the fact that a timestamp may be encoded as either a string OR this.\ninterface TimestampProto {\n seconds?: string;\n nanos?: number;\n}\n\nexport interface SerializerOptions {\n /**\n * The serializer supports both Protobuf.js and Proto3 JSON formats. By\n * setting this flag to true, the serializer will use the Proto3 JSON format.\n *\n * For a description of the Proto3 JSON format check\n * https://developers.google.com/protocol-buffers/docs/proto3#json\n */\n useProto3Json: boolean;\n}\n\n/**\n * Generates JsonObject values for the Datastore API suitable for sending to\n * either GRPC stub methods or via the JSON/HTTP REST API.\n * TODO(klimt): We can remove the databaseId argument if we keep the full\n * resource name in documents.\n */\nexport class JsonProtoSerializer {\n constructor(\n private databaseId: DatabaseId,\n private options: SerializerOptions\n ) {}\n\n private emptyByteString(): ProtoByteString {\n if (this.options.useProto3Json) {\n return '';\n } else {\n return new Uint8Array(0);\n }\n }\n\n private unsafeCastProtoByteString(byteString: ProtoByteString): string {\n // byteStrings can be either string or UInt8Array, but the typings say\n // it's always a string. Cast as string to avoid type check failing\n return byteString as string;\n }\n\n fromRpcStatus(status: api.Status): FirestoreError {\n const code =\n status.code === undefined\n ? Code.UNKNOWN\n : mapCodeFromRpcCode(status.code);\n return new FirestoreError(code, status.message || '');\n }\n\n /**\n * Returns a value for a number (or null) that's appropriate to put into\n * a google.protobuf.Int32Value proto.\n * DO NOT USE THIS FOR ANYTHING ELSE.\n * This method cheats. It's typed as returning \"number\" because that's what\n * our generated proto interfaces say Int32Value must be. But GRPC actually\n * expects a { value: <number> } struct.\n */\n private toInt32Value(val: number | null): number | null {\n if (this.options.useProto3Json || typeUtils.isNullOrUndefined(val)) {\n return val;\n } else {\n // ProtobufJS requires that we wrap Int32Values.\n // Use any because we need to match generated Proto types.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n return { value: val } as any;\n }\n }\n\n /**\n * Returns a number (or null) from a google.protobuf.Int32Value proto.\n * DO NOT USE THIS FOR ANYTHING ELSE.\n * This method cheats. It's typed as accepting \"number\" because that's what\n * our generated proto interfaces say Int32Value must be, but it actually\n * accepts { value: number } to match our serialization in toInt32Value().\n */\n private fromInt32Value(val: number | undefined): number | null {\n let result;\n if (typeof val === 'object') {\n // Use any because we need to match generated Proto types.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n result = (val as any).value;\n } else {\n // We accept raw numbers (without the {value: ... } wrapper) for\n // compatibility with legacy persisted data.\n result = val;\n }\n return typeUtils.isNullOrUndefined(result) ? null : result;\n }\n\n /**\n * Returns a value for a Date that's appropriate to put into a proto.\n * DO NOT USE THIS FOR ANYTHING ELSE.\n * This method cheats. It's typed as returning \"string\" because that's what\n * our generated proto interfaces say dates must be. But it's easier and safer\n * to actually return a Timestamp proto.\n */\n private toTimestamp(timestamp: Timestamp): string {\n if (this.options.useProto3Json) {\n // Serialize to ISO-8601 date format, but with full nano resolution.\n // Since JS Date has only millis, let's only use it for the seconds and\n // then manually add the fractions to the end.\n const jsDateStr = new Date(timestamp.seconds * 1000).toISOString();\n // Remove .xxx frac part and Z in the end.\n const strUntilSeconds = jsDateStr.replace(/\\.\\d*/, '').replace('Z', '');\n // Pad the fraction out to 9 digits (nanos).\n const nanoStr = ('000000000' + timestamp.nanoseconds).slice(-9);\n\n return `${strUntilSeconds}.${nanoStr}Z`;\n } else {\n return {\n seconds: '' + timestamp.seconds,\n nanos: timestamp.nanoseconds\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n } as any;\n }\n }\n\n private fromTimestamp(date: string | TimestampProto): Timestamp {\n // The json interface (for the browser) will return an iso timestamp string,\n // while the proto js library (for node) will return a\n // google.protobuf.Timestamp instance.\n if (typeof date === 'string') {\n // TODO(b/37282237): Use strings for Proto3 timestamps\n // assert(this.options.useProto3Json,\n // 'The timestamp string format requires Proto3.');\n return this.fromIso8601String(date);\n } else {\n assert(!!date, 'Cannot deserialize null or undefined timestamp.');\n // TODO(b/37282237): Use strings for Proto3 timestamps\n // assert(!this.options.useProto3Json,\n // 'The timestamp instance format requires Proto JS.');\n const seconds = parseInt64(date.seconds || '0');\n const nanos = date.nanos || 0;\n return new Timestamp(seconds, nanos);\n }\n }\n\n private fromIso8601String(utc: string): Timestamp {\n // The date string can have higher precision (nanos) than the Date class\n // (millis), so we do some custom parsing here.\n\n // Parse the nanos right out of the string.\n let nanos = 0;\n const fraction = ISO_REG_EXP.exec(utc);\n assert(!!fraction, 'invalid timestamp: ' + utc);\n if (fraction[1]) {\n // Pad the fraction out to 9 digits (nanos).\n let nanoStr = fraction[1];\n nanoStr = (nanoStr + '000000000').substr(0, 9);\n nanos = Number(nanoStr);\n }\n\n // Parse the date to get the seconds.\n const date = new Date(utc);\n const seconds = Math.floor(date.getTime() / 1000);\n\n return new Timestamp(seconds, nanos);\n }\n\n /**\n * Returns a value for bytes that's appropriate to put in a proto.\n * DO NOT USE THIS FOR ANYTHING ELSE.\n * This method cheats. It's typed as returning \"string\" because that's what\n * our generated proto interfaces say bytes must be. But it should return\n * an Uint8Array in Node.\n */\n private toBytes(bytes: Blob): string {\n if (this.options.useProto3Json) {\n return bytes.toBase64();\n } else {\n // The typings say it's a string, but it needs to be a Uint8Array in Node.\n return this.unsafeCastProtoByteString(bytes.toUint8Array());\n }\n }\n\n /**\n * Parse the blob from the protos into the internal Blob class. Note that the\n * typings assume all blobs are strings, but they are actually Uint8Arrays\n * on Node.\n */\n private fromBlob(blob: string | Uint8Array): Blob {\n if (typeof blob === 'string') {\n assert(\n this.options.useProto3Json,\n 'Expected bytes to be passed in as Uint8Array, but got a string instead.'\n );\n return Blob.fromBase64String(blob);\n } else {\n assert(\n !this.options.useProto3Json,\n 'Expected bytes to be passed in as Uint8Array, but got a string instead.'\n );\n return Blob.fromUint8Array(blob);\n }\n }\n\n toVersion(version: SnapshotVersion): string {\n return this.toTimestamp(version.toTimestamp());\n }\n\n fromVersion(version: string): SnapshotVersion {\n assert(!!version, \"Trying to deserialize version that isn't set\");\n return SnapshotVersion.fromTimestamp(this.fromTimestamp(version));\n }\n\n toResourceName(databaseId: DatabaseId, path: ResourcePath): string {\n return this.fullyQualifiedPrefixPath(databaseId)\n .child('documents')\n .child(path)\n .canonicalString();\n }\n\n fromResourceName(name: string): ResourcePath {\n const resource = ResourcePath.fromString(name);\n assert(\n this.isValidResourceName(resource),\n 'Tried to deserialize invalid key ' + resource.toString()\n );\n return resource;\n }\n\n toName(key: DocumentKey): string {\n return this.toResourceName(this.databaseId, key.path);\n }\n\n fromName(name: string): DocumentKey {\n const resource = this.fromResourceName(name);\n assert(\n resource.get(1) === this.databaseId.projectId,\n 'Tried to deserialize key from different project: ' +\n resource.get(1) +\n ' vs ' +\n this.databaseId.projectId\n );\n assert(\n (!resource.get(3) && !this.databaseId.database) ||\n resource.get(3) === this.databaseId.database,\n 'Tried to deserialize key from different database: ' +\n resource.get(3) +\n ' vs ' +\n this.databaseId.database\n );\n return new DocumentKey(this.extractLocalPathFromResourceName(resource));\n }\n\n toQueryPath(path: ResourcePath): string {\n return this.toResourceName(this.databaseId, path);\n }\n\n fromQueryPath(name: string): ResourcePath {\n const resourceName = this.fromResourceName(name);\n // In v1beta1 queries for collections at the root did not have a trailing\n // \"/documents\". In v1 all resource paths contain \"/documents\". Preserve the\n // ability to read the v1beta1 form for compatibility with queries persisted\n // in the local target cache.\n if (resourceName.length === 4) {\n return ResourcePath.EMPTY_PATH;\n }\n return this.extractLocalPathFromResourceName(resourceName);\n }\n\n get encodedDatabaseId(): string {\n const path = new ResourcePath([\n 'projects',\n this.databaseId.projectId,\n 'databases',\n this.databaseId.database\n ]);\n return path.canonicalString();\n }\n\n private fullyQualifiedPrefixPath(databaseId: DatabaseId): ResourcePath {\n return new ResourcePath([\n 'projects',\n databaseId.projectId,\n 'databases',\n databaseId.database\n ]);\n }\n\n private extractLocalPathFromResourceName(\n resourceName: ResourcePath\n ): ResourcePath {\n assert(\n resourceName.length > 4 && resourceName.get(4) === 'documents',\n 'tried to deserialize invalid key ' + resourceName.toString()\n );\n return resourceName.popFirst(5);\n }\n\n private isValidResourceName(path: ResourcePath): boolean {\n // Resource names have at least 4 components (project ID, database ID)\n return (\n path.length >= 4 &&\n path.get(0) === 'projects' &&\n path.get(2) === 'databases'\n );\n }\n\n toValue(val: fieldValue.FieldValue): api.Value {\n if (val instanceof fieldValue.NullValue) {\n return { nullValue: 'NULL_VALUE' };\n } else if (val instanceof fieldValue.BooleanValue) {\n return { booleanValue: val.value() };\n } else if (val instanceof fieldValue.IntegerValue) {\n return { integerValue: '' + val.value() };\n } else if (val instanceof fieldValue.DoubleValue) {\n const doubleValue = val.value();\n if (this.options.useProto3Json) {\n // Proto 3 let's us encode NaN and Infinity as string values as\n // expected by the backend. This is currently not checked by our unit\n // tests because they rely on protobuf.js.\n if (isNaN(doubleValue)) {\n return { doubleValue: 'NaN' } as {};\n } else if (doubleValue === Infinity) {\n return { doubleValue: 'Infinity' } as {};\n } else if (doubleValue === -Infinity) {\n return { doubleValue: '-Infinity' } as {};\n }\n }\n return { doubleValue: val.value() };\n } else if (val instanceof fieldValue.StringValue) {\n return { stringValue: val.value() };\n } else if (val instanceof fieldValue.ObjectValue) {\n return { mapValue: this.toMapValue(val) };\n } else if (val instanceof fieldValue.ArrayValue) {\n return { arrayValue: this.toArrayValue(val) };\n } else if (val instanceof fieldValue.TimestampValue) {\n return {\n timestampValue: this.toTimestamp(val.internalValue)\n };\n } else if (val instanceof fieldValue.GeoPointValue) {\n return {\n geoPointValue: {\n latitude: val.value().latitude,\n longitude: val.value().longitude\n }\n };\n } else if (val instanceof fieldValue.BlobValue) {\n return {\n bytesValue: this.toBytes(val.value())\n };\n } else if (val instanceof fieldValue.RefValue) {\n return {\n referenceValue: this.toResourceName(val.databaseId, val.key.path)\n };\n } else {\n return fail('Unknown FieldValue ' + JSON.stringify(val));\n }\n }\n\n fromValue(obj: api.Value): fieldValue.FieldValue {\n if ('nullValue' in obj) {\n return fieldValue.NullValue.INSTANCE;\n } else if ('booleanValue' in obj) {\n return fieldValue.BooleanValue.of(obj.booleanValue!);\n } else if ('integerValue' in obj) {\n return new fieldValue.IntegerValue(parseInt64(obj.integerValue!));\n } else if ('doubleValue' in obj) {\n if (this.options.useProto3Json) {\n // Proto 3 uses the string values 'NaN' and 'Infinity'.\n if ((obj.doubleValue as {}) === 'NaN') {\n return fieldValue.DoubleValue.NAN;\n } else if ((obj.doubleValue as {}) === 'Infinity') {\n return fieldValue.DoubleValue.POSITIVE_INFINITY;\n } else if ((obj.doubleValue as {}) === '-Infinity') {\n return fieldValue.DoubleValue.NEGATIVE_INFINITY;\n }\n }\n\n return new fieldValue.DoubleValue(obj.doubleValue!);\n } else if ('stringValue' in obj) {\n return new fieldValue.StringValue(obj.stringValue!);\n } else if ('mapValue' in obj) {\n return this.fromFields(obj.mapValue!.fields || {});\n } else if ('arrayValue' in obj) {\n // \"values\" is not present if the array is empty\n assertPresent(obj.arrayValue, 'arrayValue');\n const values = obj.arrayValue.values || [];\n return new fieldValue.ArrayValue(values.map(v => this.fromValue(v)));\n } else if ('timestampValue' in obj) {\n assertPresent(obj.timestampValue, 'timestampValue');\n return new fieldValue.TimestampValue(\n this.fromTimestamp(obj.timestampValue!)\n );\n } else if ('geoPointValue' in obj) {\n assertPresent(obj.geoPointValue, 'geoPointValue');\n const latitude = obj.geoPointValue.latitude || 0;\n const longitude = obj.geoPointValue.longitude || 0;\n return new fieldValue.GeoPointValue(new GeoPoint(latitude, longitude));\n } else if ('bytesValue' in obj) {\n assertPresent(obj.bytesValue, 'bytesValue');\n const blob = this.fromBlob(obj.bytesValue);\n return new fieldValue.BlobValue(blob);\n } else if ('referenceValue' in obj) {\n assertPresent(obj.referenceValue, 'referenceValue');\n const resourceName = this.fromResourceName(obj.referenceValue);\n const dbId = new DatabaseId(resourceName.get(1), resourceName.get(3));\n const key = new DocumentKey(\n this.extractLocalPathFromResourceName(resourceName)\n );\n return new fieldValue.RefValue(dbId, key);\n } else {\n return fail('Unknown Value proto ' + JSON.stringify(obj));\n }\n }\n\n /** Creates an api.Document from key and fields (but no create/update time) */\n toMutationDocument(\n key: DocumentKey,\n fields: fieldValue.ObjectValue\n ): api.Document {\n return {\n name: this.toName(key),\n fields: this.toFields(fields)\n };\n }\n\n toDocument(document: Document): api.Document {\n assert(\n !document.hasLocalMutations,\n \"Can't serialize documents with mutations.\"\n );\n return {\n name: this.toName(document.key),\n fields: this.toFields(document.data()),\n updateTime: this.toTimestamp(document.version.toTimestamp())\n };\n }\n\n fromDocument(\n document: api.Document,\n hasCommittedMutations?: boolean\n ): Document {\n const key = this.fromName(document.name!);\n const version = this.fromVersion(document.updateTime!);\n return new Document(\n key,\n version,\n { hasCommittedMutations: !!hasCommittedMutations },\n undefined,\n document,\n v => this.fromValue(v)\n );\n }\n\n toFields(fields: fieldValue.ObjectValue): { [key: string]: api.Value } {\n const result: { [key: string]: api.Value } = {};\n fields.forEach((key, value) => {\n result[key] = this.toValue(value);\n });\n return result;\n }\n\n fromFields(object: {}): fieldValue.ObjectValue {\n // Proto map<string, Value> gets mapped to Object, so cast it.\n const map = object as { [key: string]: api.Value };\n let result = fieldValue.ObjectValue.EMPTY;\n obj.forEach(map, (key, value) => {\n result = result.set(new FieldPath([key]), this.fromValue(value));\n });\n return result;\n }\n\n toMapValue(map: fieldValue.ObjectValue): api.MapValue {\n return {\n fields: this.toFields(map)\n };\n }\n\n toArrayValue(array: fieldValue.ArrayValue): api.ArrayValue {\n const result: api.Value[] = [];\n array.forEach(value => {\n result.push(this.toValue(value));\n });\n return { values: result };\n }\n\n private fromFound(doc: api.BatchGetDocumentsResponse): Document {\n assert(\n !!doc.found,\n 'Tried to deserialize a found document from a missing document.'\n );\n assertPresent(doc.found.name, 'doc.found.name');\n assertPresent(doc.found.updateTime, 'doc.found.updateTime');\n const key = this.fromName(doc.found.name);\n const version = this.fromVersion(doc.found.updateTime);\n return new Document(key, version, {}, undefined, doc.found, v =>\n this.fromValue(v)\n );\n }\n\n private fromMissing(result: api.BatchGetDocumentsResponse): NoDocument {\n assert(\n !!result.missing,\n 'Tried to deserialize a missing document from a found document.'\n );\n assert(\n !!result.readTime,\n 'Tried to deserialize a missing document without a read time.'\n );\n const key = this.fromName(result.missing);\n const version = this.fromVersion(result.readTime);\n return new NoDocument(key, version);\n }\n\n fromMaybeDocument(result: api.BatchGetDocumentsResponse): MaybeDocument {\n if ('found' in result) {\n return this.fromFound(result);\n } else if ('missing' in result) {\n return this.fromMissing(result);\n }\n return fail('invalid batch get response: ' + JSON.stringify(result));\n }\n\n private toWatchTargetChangeState(\n state: WatchTargetChangeState\n ): api.TargetChangeTargetChangeType {\n switch (state) {\n case WatchTargetChangeState.Added:\n return 'ADD';\n case WatchTargetChangeState.Current:\n return 'CURRENT';\n case WatchTargetChangeState.NoChange:\n return 'NO_CHANGE';\n case WatchTargetChangeState.Removed:\n return 'REMOVE';\n case WatchTargetChangeState.Reset:\n return 'RESET';\n default:\n return fail('Unknown WatchTargetChangeState: ' + state);\n }\n }\n\n toTestWatchChange(watchChange: WatchChange): api.ListenResponse {\n if (watchChange instanceof ExistenceFilterChange) {\n return {\n filter: {\n count: watchChange.existenceFilter.count,\n targetId: watchChange.targetId\n }\n };\n }\n if (watchChange instanceof DocumentWatchChange) {\n if (watchChange.newDoc instanceof Document) {\n const doc = watchChange.newDoc;\n return {\n documentChange: {\n document: {\n name: this.toName(doc.key),\n fields: this.toFields(doc.data()),\n updateTime: this.toVersion(doc.version)\n },\n targetIds: watchChange.updatedTargetIds,\n removedTargetIds: watchChange.removedTargetIds\n }\n };\n } else if (watchChange.newDoc instanceof NoDocument) {\n const doc = watchChange.newDoc;\n return {\n documentDelete: {\n document: this.toName(doc.key),\n readTime: this.toVersion(doc.version),\n removedTargetIds: watchChange.removedTargetIds\n }\n };\n } else if (watchChange.newDoc === null) {\n return {\n documentRemove: {\n document: this.toName(watchChange.key),\n removedTargetIds: watchChange.removedTargetIds\n }\n };\n }\n }\n if (watchChange instanceof WatchTargetChange) {\n let cause: api.Status | undefined = undefined;\n if (watchChange.cause) {\n cause = {\n code: mapRpcCodeFromCode(watchChange.cause.code),\n message: watchChange.cause.message\n };\n }\n return {\n targetChange: {\n targetChangeType: this.toWatchTargetChangeState(watchChange.state),\n targetIds: watchChange.targetIds,\n resumeToken: this.unsafeCastProtoByteString(watchChange.resumeToken),\n cause\n }\n };\n }\n return fail('Unrecognized watch change: ' + JSON.stringify(watchChange));\n }\n\n fromWatchChange(change: api.ListenResponse): WatchChange {\n let watchChange: WatchChange;\n if ('targetChange' in change) {\n assertPresent(change.targetChange, 'targetChange');\n // proto3 default value is unset in JSON (undefined), so use 'NO_CHANGE'\n // if unset\n const state = this.fromWatchTargetChangeState(\n change.targetChange.targetChangeType || 'NO_CHANGE'\n );\n const targetIds: TargetId[] = change.targetChange.targetIds || [];\n const resumeToken =\n change.targetChange.resumeToken || this.emptyByteString();\n const causeProto = change.targetChange!.cause;\n const cause = causeProto && this.fromRpcStatus(causeProto);\n watchChange = new WatchTargetChange(\n state,\n targetIds,\n resumeToken,\n cause || null\n );\n } else if ('documentChange' in change) {\n assertPresent(change.documentChange, 'documentChange');\n const entityChange = change.documentChange;\n assertPresent(entityChange.document, 'documentChange.name');\n assertPresent(entityChange.document.name, 'documentChange.document.name');\n assertPresent(\n entityChange.document.updateTime,\n 'documentChange.document.updateTime'\n );\n const key = this.fromName(entityChange.document.name);\n const version = this.fromVersion(entityChange.document.updateTime);\n const doc = new Document(\n key,\n version,\n {},\n undefined,\n entityChange.document!,\n v => this.fromValue(v)\n );\n const updatedTargetIds = entityChange.targetIds || [];\n const removedTargetIds = entityChange.removedTargetIds || [];\n watchChange = new DocumentWatchChange(\n updatedTargetIds,\n removedTargetIds,\n doc.key,\n doc\n );\n } else if ('documentDelete' in change) {\n assertPresent(change.documentDelete, 'documentDelete');\n const docDelete = change.documentDelete;\n assertPresent(docDelete.document, 'documentDelete.document');\n const key = this.fromName(docDelete.document);\n const version = docDelete.readTime\n ? this.fromVersion(docDelete.readTime)\n : SnapshotVersion.forDeletedDoc();\n const doc = new NoDocument(key, version);\n const removedTargetIds = docDelete.removedTargetIds || [];\n watchChange = new DocumentWatchChange([], removedTargetIds, doc.key, doc);\n } else if ('documentRemove' in change) {\n assertPresent(change.documentRemove, 'documentRemove');\n const docRemove = change.documentRemove;\n assertPresent(docRemove.document, 'documentRemove');\n const key = this.fromName(docRemove.document);\n const removedTargetIds = docRemove.removedTargetIds || [];\n watchChange = new DocumentWatchChange([], removedTargetIds, key, null);\n } else if ('filter' in change) {\n // TODO(dimond): implement existence filter parsing with strategy.\n assertPresent(change.filter, 'filter');\n const filter = change.filter;\n assertPresent(filter.targetId, 'filter.targetId');\n const count = filter.count || 0;\n const existenceFilter = new ExistenceFilter(count);\n const targetId = filter.targetId;\n watchChange = new ExistenceFilterChange(targetId, existenceFilter);\n } else {\n return fail('Unknown change type ' + JSON.stringify(change));\n }\n return watchChange;\n }\n\n fromWatchTargetChangeState(\n state: api.TargetChangeTargetChangeType\n ): WatchTargetChangeState {\n if (state === 'NO_CHANGE') {\n return WatchTargetChangeState.NoChange;\n } else if (state === 'ADD') {\n return WatchTargetChangeState.Added;\n } else if (state === 'REMOVE') {\n return WatchTargetChangeState.Removed;\n } else if (state === 'CURRENT') {\n return WatchTargetChangeState.Current;\n } else if (state === 'RESET') {\n return WatchTargetChangeState.Reset;\n } else {\n return fail('Got unexpected TargetChange.state: ' + state);\n }\n }\n\n versionFromListenResponse(change: api.ListenResponse): SnapshotVersion {\n // We have only reached a consistent snapshot for the entire stream if there\n // is a read_time set and it applies to all targets (i.e. the list of\n // targets is empty). The backend is guaranteed to send such responses.\n if (!('targetChange' in change)) {\n return SnapshotVersion.MIN;\n }\n const targetChange = change.targetChange!;\n if (targetChange.targetIds && targetChange.targetIds.length) {\n return SnapshotVersion.MIN;\n }\n if (!targetChange.readTime) {\n return SnapshotVersion.MIN;\n }\n return this.fromVersion(targetChange.readTime);\n }\n\n toMutation(mutation: Mutation): api.Write {\n let result: api.Write;\n if (mutation instanceof SetMutation) {\n result = {\n update: this.toMutationDocument(mutation.key, mutation.value)\n };\n } else if (mutation instanceof DeleteMutation) {\n result = { delete: this.toName(mutation.key) };\n } else if (mutation instanceof PatchMutation) {\n result = {\n update: this.toMutationDocument(mutation.key, mutation.data),\n updateMask: this.toDocumentMask(mutation.fieldMask)\n };\n } else if (mutation instanceof TransformMutation) {\n result = {\n transform: {\n document: this.toName(mutation.key),\n fieldTransforms: mutation.fieldTransforms.map(transform =>\n this.toFieldTransform(transform)\n )\n }\n };\n } else if (mutation instanceof VerifyMutation) {\n result = {\n verify: this.toName(mutation.key)\n };\n } else {\n return fail('Unknown mutation type ' + mutation.type);\n }\n\n if (!mutation.precondition.isNone) {\n result.currentDocument = this.toPrecondition(mutation.precondition);\n }\n\n return result;\n }\n\n fromMutation(proto: api.Write): Mutation {\n const precondition = proto.currentDocument\n ? this.fromPrecondition(proto.currentDocument)\n : Precondition.NONE;\n\n if (proto.update) {\n assertPresent(proto.update.name, 'name');\n const key = this.fromName(proto.update.name);\n const value = this.fromFields(proto.update.fields || {});\n if (proto.updateMask) {\n const fieldMask = this.fromDocumentMask(proto.updateMask);\n return new PatchMutation(key, value, fieldMask, precondition);\n } else {\n return new SetMutation(key, value, precondition);\n }\n } else if (proto.delete) {\n const key = this.fromName(proto.delete);\n return new DeleteMutation(key, precondition);\n } else if (proto.transform) {\n const key = this.fromName(proto.transform.document!);\n const fieldTransforms = proto.transform.fieldTransforms!.map(transform =>\n this.fromFieldTransform(transform)\n );\n assert(\n precondition.exists === true,\n 'Transforms only support precondition \"exists == true\"'\n );\n return new TransformMutation(key, fieldTransforms);\n } else if (proto.verify) {\n const key = this.fromName(proto.verify);\n return new VerifyMutation(key, precondition);\n } else {\n return fail('unknown mutation proto: ' + JSON.stringify(proto));\n }\n }\n\n private toPrecondition(precondition: Precondition): api.Precondition {\n assert(!precondition.isNone, \"Can't serialize an empty precondition\");\n if (precondition.updateTime !== undefined) {\n return {\n updateTime: this.toVersion(precondition.updateTime)\n };\n } else if (precondition.exists !== undefined) {\n return { exists: precondition.exists };\n } else {\n return fail('Unknown precondition');\n }\n }\n\n private fromPrecondition(precondition: api.Precondition): Precondition {\n if (precondition.updateTime !== undefined) {\n return Precondition.updateTime(this.fromVersion(precondition.updateTime));\n } else if (precondition.exists !== undefined) {\n return Precondition.exists(precondition.exists);\n } else {\n return Precondition.NONE;\n }\n }\n\n private fromWriteResult(\n proto: api.WriteResult,\n commitTime: string\n ): MutationResult {\n // NOTE: Deletes don't have an updateTime.\n let version = proto.updateTime\n ? this.fromVersion(proto.updateTime)\n : this.fromVersion(commitTime);\n\n if (version.isEqual(SnapshotVersion.MIN)) {\n // The Firestore Emulator currently returns an update time of 0 for\n // deletes of non-existing documents (rather than null). This breaks the\n // test \"get deleted doc while offline with source=cache\" as NoDocuments\n // with version 0 are filtered by IndexedDb's RemoteDocumentCache.\n // TODO(#2149): Remove this when Emulator is fixed\n version = this.fromVersion(commitTime);\n }\n\n let transformResults: fieldValue.FieldValue[] | null = null;\n if (proto.transformResults && proto.transformResults.length > 0) {\n transformResults = proto.transformResults.map(result =>\n this.fromValue(result)\n );\n }\n return new MutationResult(version, transformResults);\n }\n\n fromWriteResults(\n protos: api.WriteResult[] | undefined,\n commitTime?: string\n ): MutationResult[] {\n if (protos && protos.length > 0) {\n assert(\n commitTime !== undefined,\n 'Received a write result without a commit time'\n );\n return protos.map(proto => this.fromWriteResult(proto, commitTime));\n } else {\n return [];\n }\n }\n\n private toFieldTransform(fieldTransform: FieldTransform): api.FieldTransform {\n const transform = fieldTransform.transform;\n if (transform instanceof ServerTimestampTransform) {\n return {\n fieldPath: fieldTransform.field.canonicalString(),\n setToServerValue: 'REQUEST_TIME'\n };\n } else if (transform instanceof ArrayUnionTransformOperation) {\n return {\n fieldPath: fieldTransform.field.canonicalString(),\n appendMissingElements: {\n values: transform.elements.map(v => this.toValue(v))\n }\n };\n } else if (transform instanceof ArrayRemoveTransformOperation) {\n return {\n fieldPath: fieldTransform.field.canonicalString(),\n removeAllFromArray: {\n values: transform.elements.map(v => this.toValue(v))\n }\n };\n } else if (transform instanceof NumericIncrementTransformOperation) {\n return {\n fieldPath: fieldTransform.field.canonicalString(),\n increment: this.toValue(transform.operand)\n };\n } else {\n throw fail('Unknown transform: ' + fieldTransform.transform);\n }\n }\n\n private fromFieldTransform(proto: api.FieldTransform): FieldTransform {\n let transform: TransformOperation | null = null;\n if ('setToServerValue' in proto) {\n assert(\n proto.setToServerValue === 'REQUEST_TIME',\n 'Unknown server value transform proto: ' + JSON.stringify(proto)\n );\n transform = ServerTimestampTransform.instance;\n } else if ('appendMissingElements' in proto) {\n const values = proto.appendMissingElements!.values || [];\n transform = new ArrayUnionTransformOperation(\n values.map(v => this.fromValue(v))\n );\n } else if ('removeAllFromArray' in proto) {\n const values = proto.removeAllFromArray!.values || [];\n transform = new ArrayRemoveTransformOperation(\n values.map(v => this.fromValue(v))\n );\n } else if ('increment' in proto) {\n const operand = this.fromValue(proto.increment!);\n assert(\n operand instanceof fieldValue.NumberValue,\n 'NUMERIC_ADD transform requires a NumberValue'\n );\n transform = new NumericIncrementTransformOperation(\n operand as fieldValue.NumberValue\n );\n } else {\n fail('Unknown transform proto: ' + JSON.stringify(proto));\n }\n const fieldPath = FieldPath.fromServerFormat(proto.fieldPath!);\n return new FieldTransform(fieldPath, transform!);\n }\n\n toDocumentsTarget(target: Target): api.DocumentsTarget {\n return { documents: [this.toQueryPath(target.path)] };\n }\n\n fromDocumentsTarget(documentsTarget: api.DocumentsTarget): Target {\n const count = documentsTarget.documents!.length;\n assert(\n count === 1,\n 'DocumentsTarget contained other than 1 document: ' + count\n );\n const name = documentsTarget.documents![0];\n return Query.atPath(this.fromQueryPath(name)).toTarget();\n }\n\n toQueryTarget(target: Target): api.QueryTarget {\n // Dissect the path into parent, collectionId, and optional key filter.\n const result: api.QueryTarget = { structuredQuery: {} };\n const path = target.path;\n if (target.collectionGroup !== null) {\n assert(\n path.length % 2 === 0,\n 'Collection Group queries should be within a document path or root.'\n );\n result.parent = this.toQueryPath(path);\n result.structuredQuery!.from = [\n {\n collectionId: target.collectionGroup,\n allDescendants: true\n }\n ];\n } else {\n assert(\n path.length % 2 !== 0,\n 'Document queries with filters are not supported.'\n );\n result.parent = this.toQueryPath(path.popLast());\n result.structuredQuery!.from = [{ collectionId: path.lastSegment() }];\n }\n\n const where = this.toFilter(target.filters);\n if (where) {\n result.structuredQuery!.where = where;\n }\n\n const orderBy = this.toOrder(target.orderBy);\n if (orderBy) {\n result.structuredQuery!.orderBy = orderBy;\n }\n\n const limit = this.toInt32Value(target.limit);\n if (limit !== null) {\n result.structuredQuery!.limit = limit;\n }\n\n if (target.startAt) {\n result.structuredQuery!.startAt = this.toCursor(target.startAt);\n }\n if (target.endAt) {\n result.structuredQuery!.endAt = this.toCursor(target.endAt);\n }\n\n return result;\n }\n\n fromQueryTarget(target: api.QueryTarget): Target {\n let path = this.fromQueryPath(target.parent!);\n\n const query = target.structuredQuery!;\n const fromCount = query.from ? query.from.length : 0;\n let collectionGroup: string | null = null;\n if (fromCount > 0) {\n assert(\n fromCount === 1,\n 'StructuredQuery.from with more than one collection is not supported.'\n );\n const from = query.from![0];\n if (from.allDescendants) {\n collectionGroup = from.collectionId!;\n } else {\n path = path.child(from.collectionId!);\n }\n }\n\n let filterBy: Filter[] = [];\n if (query.where) {\n filterBy = this.fromFilter(query.where);\n }\n\n let orderBy: OrderBy[] = [];\n if (query.orderBy) {\n orderBy = this.fromOrder(query.orderBy);\n }\n\n let limit: number | null = null;\n if (query.limit) {\n limit = this.fromInt32Value(query.limit);\n }\n\n let startAt: Bound | null = null;\n if (query.startAt) {\n startAt = this.fromCursor(query.startAt);\n }\n\n let endAt: Bound | null = null;\n if (query.endAt) {\n endAt = this.fromCursor(query.endAt);\n }\n\n return new Query(\n path,\n collectionGroup,\n orderBy,\n filterBy,\n limit,\n LimitType.First,\n startAt,\n endAt\n ).toTarget();\n }\n\n toListenRequestLabels(\n targetData: TargetData\n ): api.ApiClientObjectMap<string> | null {\n const value = this.toLabel(targetData.purpose);\n if (value == null) {\n return null;\n } else {\n return {\n 'goog-listen-tags': value\n };\n }\n }\n\n private toLabel(purpose: TargetPurpose): string | null {\n switch (purpose) {\n case TargetPurpose.Listen:\n return null;\n case TargetPurpose.ExistenceFilterMismatch:\n return 'existence-filter-mismatch';\n case TargetPurpose.LimboResolution:\n return 'limbo-document';\n default:\n return fail('Unrecognized query purpose: ' + purpose);\n }\n }\n\n toTarget(targetData: TargetData): api.Target {\n let result: api.Target;\n const target = targetData.target;\n\n if (target.isDocumentQuery()) {\n result = { documents: this.toDocumentsTarget(target) };\n } else {\n result = { query: this.toQueryTarget(target) };\n }\n\n result.targetId = targetData.targetId;\n\n if (targetData.resumeToken.length > 0) {\n result.resumeToken = this.unsafeCastProtoByteString(\n targetData.resumeToken\n );\n }\n\n return result;\n }\n\n private toFilter(filters: Filter[]): api.Filter | undefined {\n if (filters.length === 0) {\n return;\n }\n const protos = filters.map(filter => {\n if (filter instanceof FieldFilter) {\n return this.toUnaryOrFieldFilter(filter);\n } else {\n return fail('Unrecognized filter: ' + JSON.stringify(filter));\n }\n });\n if (protos.length === 1) {\n return protos[0];\n }\n return { compositeFilter: { op: 'AND', filters: protos } };\n }\n\n private fromFilter(filter: api.Filter | undefined): Filter[] {\n if (!filter) {\n return [];\n } else if (filter.unaryFilter !== undefined) {\n return [this.fromUnaryFilter(filter)];\n } else if (filter.fieldFilter !== undefined) {\n return [this.fromFieldFilter(filter)];\n } else if (filter.compositeFilter !== undefined) {\n return filter.compositeFilter\n .filters!.map(f => this.fromFilter(f))\n .reduce((accum, current) => accum.concat(current));\n } else {\n return fail('Unknown filter: ' + JSON.stringify(filter));\n }\n }\n\n private toOrder(orderBys: OrderBy[]): api.Order[] | undefined {\n if (orderBys.length === 0) {\n return;\n }\n return orderBys.map(order => this.toPropertyOrder(order));\n }\n\n private fromOrder(orderBys: api.Order[]): OrderBy[] {\n return orderBys.map(order => this.fromPropertyOrder(order));\n }\n\n private toCursor(cursor: Bound): api.Cursor {\n return {\n before: cursor.before,\n values: cursor.position.map(component => this.toValue(component))\n };\n }\n\n private fromCursor(cursor: api.Cursor): Bound {\n const before = !!cursor.before;\n const position = cursor.values!.map(component => this.fromValue(component));\n return new Bound(position, before);\n }\n\n // visible for testing\n toDirection(dir: Direction): api.OrderDirection {\n return DIRECTIONS[dir.name];\n }\n\n // visible for testing\n fromDirection(dir: api.OrderDirection | undefined): Direction | undefined {\n switch (dir) {\n case 'ASCENDING':\n return Direction.ASCENDING;\n case 'DESCENDING':\n return Direction.DESCENDING;\n default:\n return undefined;\n }\n }\n\n // visible for testing\n toOperatorName(op: Operator): api.FieldFilterOp {\n return OPERATORS[op.name];\n }\n\n fromOperatorName(op: api.FieldFilterOp): Operator {\n switch (op) {\n case 'EQUAL':\n return Operator.EQUAL;\n case 'GREATER_THAN':\n return Operator.GREATER_THAN;\n case 'GREATER_THAN_OR_EQUAL':\n return Operator.GREATER_THAN_OR_EQUAL;\n case 'LESS_THAN':\n return Operator.LESS_THAN;\n case 'LESS_THAN_OR_EQUAL':\n return Operator.LESS_THAN_OR_EQUAL;\n case 'ARRAY_CONTAINS':\n return Operator.ARRAY_CONTAINS;\n case 'IN':\n return Operator.IN;\n case 'ARRAY_CONTAINS_ANY':\n return Operator.ARRAY_CONTAINS_ANY;\n case 'OPERATOR_UNSPECIFIED':\n return fail('Unspecified operator');\n default:\n return fail('Unknown operator');\n }\n }\n\n toFieldPathReference(path: FieldPath): api.FieldReference {\n return { fieldPath: path.canonicalString() };\n }\n\n fromFieldPathReference(fieldReference: api.FieldReference): FieldPath {\n return FieldPath.fromServerFormat(fieldReference.fieldPath!);\n }\n\n // visible for testing\n toPropertyOrder(orderBy: OrderBy): api.Order {\n return {\n field: this.toFieldPathReference(orderBy.field),\n direction: this.toDirection(orderBy.dir)\n };\n }\n\n fromPropertyOrder(orderBy: api.Order): OrderBy {\n return new OrderBy(\n this.fromFieldPathReference(orderBy.field!),\n this.fromDirection(orderBy.direction)\n );\n }\n\n fromFieldFilter(filter: api.Filter): Filter {\n return FieldFilter.create(\n this.fromFieldPathReference(filter.fieldFilter!.field!),\n this.fromOperatorName(filter.fieldFilter!.op!),\n this.fromValue(filter.fieldFilter!.value!)\n );\n }\n\n // visible for testing\n toUnaryOrFieldFilter(filter: FieldFilter): api.Filter {\n if (filter.op === Operator.EQUAL) {\n if (filter.value.isEqual(fieldValue.DoubleValue.NAN)) {\n return {\n unaryFilter: {\n field: this.toFieldPathReference(filter.field),\n op: 'IS_NAN'\n }\n };\n } else if (filter.value.isEqual(fieldValue.NullValue.INSTANCE)) {\n return {\n unaryFilter: {\n field: this.toFieldPathReference(filter.field),\n op: 'IS_NULL'\n }\n };\n }\n }\n return {\n fieldFilter: {\n field: this.toFieldPathReference(filter.field),\n op: this.toOperatorName(filter.op),\n value: this.toValue(filter.value)\n }\n };\n }\n\n fromUnaryFilter(filter: api.Filter): Filter {\n switch (filter.unaryFilter!.op!) {\n case 'IS_NAN':\n const nanField = this.fromFieldPathReference(\n filter.unaryFilter!.field!\n );\n return FieldFilter.create(\n nanField,\n Operator.EQUAL,\n fieldValue.DoubleValue.NAN\n );\n case 'IS_NULL':\n const nullField = this.fromFieldPathReference(\n filter.unaryFilter!.field!\n );\n return FieldFilter.create(\n nullField,\n Operator.EQUAL,\n fieldValue.NullValue.INSTANCE\n );\n case 'OPERATOR_UNSPECIFIED':\n return fail('Unspecified filter');\n default:\n return fail('Unknown filter');\n }\n }\n\n toDocumentMask(fieldMask: FieldMask): api.DocumentMask {\n const canonicalFields: string[] = [];\n fieldMask.fields.forEach(field =>\n canonicalFields.push(field.canonicalString())\n );\n return {\n fieldPaths: canonicalFields\n };\n }\n\n fromDocumentMask(proto: api.DocumentMask): FieldMask {\n const paths = proto.fieldPaths || [];\n const fields = paths.map(path => FieldPath.fromServerFormat(path));\n return FieldMask.fromArray(fields);\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { DatabaseId, DatabaseInfo } from '../core/database_info';\nimport { ProtoByteString } from '../core/types';\nimport { Connection } from '../remote/connection';\nimport { JsonProtoSerializer } from '../remote/serializer';\nimport { fail } from '../util/assert';\nimport { ConnectivityMonitor } from './../remote/connectivity_monitor';\n\n/**\n * Provides a common interface to load anything platform dependent, e.g.\n * the connection implementation.\n *\n * An implementation of this must be provided at compile time for the platform.\n */\n// TODO: Consider only exposing the APIs of 'document' and 'window' that we\n// use in our client.\nexport interface Platform {\n loadConnection(databaseInfo: DatabaseInfo): Promise<Connection>;\n newConnectivityMonitor(): ConnectivityMonitor;\n newSerializer(databaseId: DatabaseId): JsonProtoSerializer;\n\n /** Formats an object as a JSON string, suitable for logging. */\n formatJSON(value: unknown): string;\n\n /** Converts a Base64 encoded string to a binary string. */\n atob(encoded: string): string;\n\n /** Converts a binary string to a Base64 encoded string. */\n btoa(raw: string): string;\n\n /** The Platform's 'window' implementation or null if not available. */\n readonly window: Window | null;\n\n /** The Platform's 'document' implementation or null if not available. */\n readonly document: Document | null;\n\n /** True if and only if the Base64 conversion functions are available. */\n readonly base64Available: boolean;\n\n readonly emptyByteString: ProtoByteString;\n}\n\n/**\n * Provides singleton helpers where setup code can inject a platform at runtime.\n * setPlatform needs to be set before Firestore is used and must be set exactly\n * once.\n */\nexport class PlatformSupport {\n private static platform: Platform;\n static setPlatform(platform: Platform): void {\n if (PlatformSupport.platform) {\n fail('Platform already defined');\n }\n PlatformSupport.platform = platform;\n }\n\n static getPlatform(): Platform {\n if (!PlatformSupport.platform) {\n fail('Platform not set');\n }\n return PlatformSupport.platform;\n }\n}\n\n/**\n * Returns the representation of an empty \"proto\" byte string for the\n * platform.\n */\nexport function emptyByteString(): ProtoByteString {\n return PlatformSupport.getPlatform().emptyByteString;\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Code, FirestoreError } from './error';\n\n/**\n * Helper function to prevent instantiation through the constructor.\n *\n * This method creates a new constructor that throws when it's invoked.\n * The prototype of that constructor is then set to the prototype of the hidden\n * \"class\" to expose all the prototype methods and allow for instanceof\n * checks.\n *\n * To also make all the static methods available, all properties of the\n * original constructor are copied to the new constructor.\n */\nexport function makeConstructorPrivate<T extends Function>(\n cls: T,\n optionalMessage?: string\n): T {\n function PublicConstructor(): never {\n let error = 'This constructor is private.';\n if (optionalMessage) {\n error += ' ';\n error += optionalMessage;\n }\n throw new FirestoreError(Code.INVALID_ARGUMENT, error);\n }\n\n // Make sure instanceof checks work and all methods are exposed on the public\n // constructor\n PublicConstructor.prototype = cls.prototype;\n\n // Copy any static methods/members\n for (const staticProperty in cls) {\n if (cls.hasOwnProperty(staticProperty)) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n (PublicConstructor as any)[staticProperty] = (cls as any)[staticProperty];\n }\n }\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n return PublicConstructor as any;\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { PlatformSupport } from '../platform/platform';\nimport { makeConstructorPrivate } from '../util/api';\nimport { Code, FirestoreError } from '../util/error';\nimport {\n invalidClassError,\n validateArgType,\n validateExactNumberOfArgs\n} from '../util/input_validation';\nimport { primitiveComparator } from '../util/misc';\n\n/** Helper function to assert Uint8Array is available at runtime. */\nfunction assertUint8ArrayAvailable(): void {\n if (typeof Uint8Array === 'undefined') {\n throw new FirestoreError(\n Code.UNIMPLEMENTED,\n 'Uint8Arrays are not available in this environment.'\n );\n }\n}\n\n/** Helper function to assert Base64 functions are available at runtime. */\nfunction assertBase64Available(): void {\n if (!PlatformSupport.getPlatform().base64Available) {\n throw new FirestoreError(\n Code.UNIMPLEMENTED,\n 'Blobs are unavailable in Firestore in this environment.'\n );\n }\n}\n\n/**\n * Immutable class holding a blob (binary data).\n * This class is directly exposed in the public API.\n *\n * Note that while you can't hide the constructor in JavaScript code, we are\n * using the hack above to make sure no-one outside this module can call it.\n */\nexport class Blob {\n // Prefix with underscore to signal this is a private variable in JS and\n // prevent it showing up for autocompletion.\n // A binary string is a string with each char as Unicode code point in the\n // range of [0, 255], essentially simulating a byte array.\n private _binaryString: string;\n\n private constructor(binaryString: string) {\n assertBase64Available();\n this._binaryString = binaryString;\n }\n\n static fromBase64String(base64: string): Blob {\n validateExactNumberOfArgs('Blob.fromBase64String', arguments, 1);\n validateArgType('Blob.fromBase64String', 'string', 1, base64);\n assertBase64Available();\n try {\n const binaryString = PlatformSupport.getPlatform().atob(base64);\n return new Blob(binaryString);\n } catch (e) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Failed to construct Blob from Base64 string: ' + e\n );\n }\n }\n\n static fromUint8Array(array: Uint8Array): Blob {\n validateExactNumberOfArgs('Blob.fromUint8Array', arguments, 1);\n assertUint8ArrayAvailable();\n if (!(array instanceof Uint8Array)) {\n throw invalidClassError('Blob.fromUint8Array', 'Uint8Array', 1, array);\n }\n // We can't call array.map directly because it expects the return type to\n // be a Uint8Array, whereas we can convert it to a regular array by invoking\n // map on the Array prototype.\n const binaryString = Array.prototype.map\n .call(array, (char: number) => {\n return String.fromCharCode(char);\n })\n .join('');\n return new Blob(binaryString);\n }\n\n toBase64(): string {\n validateExactNumberOfArgs('Blob.toBase64', arguments, 0);\n assertBase64Available();\n return PlatformSupport.getPlatform().btoa(this._binaryString);\n }\n\n toUint8Array(): Uint8Array {\n validateExactNumberOfArgs('Blob.toUint8Array', arguments, 0);\n assertUint8ArrayAvailable();\n const buffer = new Uint8Array(this._binaryString.length);\n for (let i = 0; i < this._binaryString.length; i++) {\n buffer[i] = this._binaryString.charCodeAt(i);\n }\n return buffer;\n }\n\n toString(): string {\n return 'Blob(base64: ' + this.toBase64() + ')';\n }\n\n isEqual(other: Blob): boolean {\n return this._binaryString === other._binaryString;\n }\n\n _approximateByteSize(): number {\n // Assume UTF-16 encoding in memory (see StringValue.approximateByteSize())\n return this._binaryString.length * 2;\n }\n\n /**\n * Actually private to JS consumers of our API, so this function is prefixed\n * with an underscore.\n */\n _compareTo(other: Blob): number {\n return primitiveComparator(this._binaryString, other._binaryString);\n }\n}\n\n// Public instance that disallows construction at runtime. This constructor is\n// used when exporting Blob on firebase.firestore.Blob and will be called Blob\n// publicly. Internally we still use Blob which has a type checked private\n// constructor. Note that Blob and PublicBlob can be used interchangeably in\n// instanceof checks.\n// For our internal TypeScript code PublicBlob doesn't exist as a type, and so\n// we need to use Blob as type and export it too.\nexport const PublicBlob = makeConstructorPrivate(\n Blob,\n 'Use Blob.fromUint8Array() or Blob.fromBase64String() instead.'\n);\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Equatable } from './misc';\nimport * as objUtil from './obj';\n\ntype Entry<K, V> = [K, V];\n\n/**\n * A map implementation that uses objects as keys. Objects must implement the\n * Equatable interface and must be immutable. Entries in the map are stored\n * together with the key being produced from the mapKeyFn. This map\n * automatically handles collisions of keys.\n */\nexport class ObjectMap<KeyType extends Equatable<KeyType>, ValueType> {\n /**\n * The inner map for a key -> value pair. Due to the possibility of\n * collisions we keep a list of entries that we do a linear search through\n * to find an actual match. Note that collisions should be rare, so we still\n * expect near constant time lookups in practice.\n */\n private inner: {\n [canonicalId: string]: Array<Entry<KeyType, ValueType>>;\n } = {};\n\n constructor(private mapKeyFn: (key: KeyType) => string) {}\n\n /** Get a value for this key, or undefined if it does not exist. */\n get(key: KeyType): ValueType | undefined {\n const id = this.mapKeyFn(key);\n const matches = this.inner[id];\n if (matches === undefined) {\n return undefined;\n }\n for (const [otherKey, value] of matches) {\n if (otherKey.isEqual(key)) {\n return value;\n }\n }\n return undefined;\n }\n\n has(key: KeyType): boolean {\n return this.get(key) !== undefined;\n }\n\n /** Put this key and value in the map. */\n set(key: KeyType, value: ValueType): void {\n const id = this.mapKeyFn(key);\n const matches = this.inner[id];\n if (matches === undefined) {\n this.inner[id] = [[key, value]];\n return;\n }\n for (let i = 0; i < matches.length; i++) {\n if (matches[i][0].isEqual(key)) {\n matches[i] = [key, value];\n return;\n }\n }\n matches.push([key, value]);\n }\n\n /**\n * Remove this key from the map. Returns a boolean if anything was deleted.\n */\n delete(key: KeyType): boolean {\n const id = this.mapKeyFn(key);\n const matches = this.inner[id];\n if (matches === undefined) {\n return false;\n }\n for (let i = 0; i < matches.length; i++) {\n if (matches[i][0].isEqual(key)) {\n if (matches.length === 1) {\n delete this.inner[id];\n } else {\n matches.splice(i, 1);\n }\n return true;\n }\n }\n return false;\n }\n\n forEach(fn: (key: KeyType, val: ValueType) => void): void {\n objUtil.forEach(this.inner, (_, entries) => {\n for (const [k, v] of entries) {\n fn(k, v);\n }\n });\n }\n\n isEmpty(): boolean {\n return objUtil.isEmpty(this.inner);\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Timestamp } from '../api/timestamp';\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { BatchId, ProtoByteString } from '../core/types';\nimport { assert } from '../util/assert';\nimport * as misc from '../util/misc';\nimport {\n documentKeySet,\n DocumentKeySet,\n DocumentVersionMap,\n documentVersionMap,\n MaybeDocumentMap\n} from './collections';\nimport { MaybeDocument } from './document';\nimport { DocumentKey } from './document_key';\nimport { Mutation, MutationResult } from './mutation';\n\nexport const BATCHID_UNKNOWN = -1;\n\n/**\n * A batch of mutations that will be sent as one unit to the backend.\n */\nexport class MutationBatch {\n /**\n * @param batchId The unique ID of this mutation batch.\n * @param localWriteTime The original write time of this mutation.\n * @param baseMutations Mutations that are used to populate the base\n * values when this mutation is applied locally. This can be used to locally\n * overwrite values that are persisted in the remote document cache. Base\n * mutations are never sent to the backend.\n * @param mutations The user-provided mutations in this mutation batch.\n * User-provided mutations are applied both locally and remotely on the\n * backend.\n */\n constructor(\n public batchId: BatchId,\n public localWriteTime: Timestamp,\n public baseMutations: Mutation[],\n public mutations: Mutation[]\n ) {\n assert(mutations.length > 0, 'Cannot create an empty mutation batch');\n }\n\n /**\n * Applies all the mutations in this MutationBatch to the specified document\n * to create a new remote document\n *\n * @param docKey The key of the document to apply mutations to.\n * @param maybeDoc The document to apply mutations to.\n * @param batchResult The result of applying the MutationBatch to the\n * backend.\n */\n applyToRemoteDocument(\n docKey: DocumentKey,\n maybeDoc: MaybeDocument | null,\n batchResult: MutationBatchResult\n ): MaybeDocument | null {\n if (maybeDoc) {\n assert(\n maybeDoc.key.isEqual(docKey),\n `applyToRemoteDocument: key ${docKey} should match maybeDoc key\n ${maybeDoc.key}`\n );\n }\n\n const mutationResults = batchResult.mutationResults;\n assert(\n mutationResults.length === this.mutations.length,\n `Mismatch between mutations length\n (${this.mutations.length}) and mutation results length\n (${mutationResults.length}).`\n );\n\n for (let i = 0; i < this.mutations.length; i++) {\n const mutation = this.mutations[i];\n if (mutation.key.isEqual(docKey)) {\n const mutationResult = mutationResults[i];\n maybeDoc = mutation.applyToRemoteDocument(maybeDoc, mutationResult);\n }\n }\n return maybeDoc;\n }\n\n /**\n * Computes the local view of a document given all the mutations in this\n * batch.\n *\n * @param docKey The key of the document to apply mutations to.\n * @param maybeDoc The document to apply mutations to.\n */\n applyToLocalView(\n docKey: DocumentKey,\n maybeDoc: MaybeDocument | null\n ): MaybeDocument | null {\n if (maybeDoc) {\n assert(\n maybeDoc.key.isEqual(docKey),\n `applyToLocalDocument: key ${docKey} should match maybeDoc key\n ${maybeDoc.key}`\n );\n }\n\n // First, apply the base state. This allows us to apply non-idempotent\n // transform against a consistent set of values.\n for (const mutation of this.baseMutations) {\n if (mutation.key.isEqual(docKey)) {\n maybeDoc = mutation.applyToLocalView(\n maybeDoc,\n maybeDoc,\n this.localWriteTime\n );\n }\n }\n\n const baseDoc = maybeDoc;\n\n // Second, apply all user-provided mutations.\n for (const mutation of this.mutations) {\n if (mutation.key.isEqual(docKey)) {\n maybeDoc = mutation.applyToLocalView(\n maybeDoc,\n baseDoc,\n this.localWriteTime\n );\n }\n }\n return maybeDoc;\n }\n\n /**\n * Computes the local view for all provided documents given the mutations in\n * this batch.\n */\n applyToLocalDocumentSet(maybeDocs: MaybeDocumentMap): MaybeDocumentMap {\n // TODO(mrschmidt): This implementation is O(n^2). If we apply the mutations\n // directly (as done in `applyToLocalView()`), we can reduce the complexity\n // to O(n).\n let mutatedDocuments = maybeDocs;\n this.mutations.forEach(m => {\n const mutatedDocument = this.applyToLocalView(\n m.key,\n maybeDocs.get(m.key)\n );\n if (mutatedDocument) {\n mutatedDocuments = mutatedDocuments.insert(m.key, mutatedDocument);\n }\n });\n return mutatedDocuments;\n }\n\n keys(): DocumentKeySet {\n return this.mutations.reduce(\n (keys, m) => keys.add(m.key),\n documentKeySet()\n );\n }\n\n isEqual(other: MutationBatch): boolean {\n return (\n this.batchId === other.batchId &&\n misc.arrayEquals(this.mutations, other.mutations) &&\n misc.arrayEquals(this.baseMutations, other.baseMutations)\n );\n }\n}\n\n/** The result of applying a mutation batch to the backend. */\nexport class MutationBatchResult {\n private constructor(\n readonly batch: MutationBatch,\n readonly commitVersion: SnapshotVersion,\n readonly mutationResults: MutationResult[],\n readonly streamToken: ProtoByteString,\n /**\n * A pre-computed mapping from each mutated document to the resulting\n * version.\n */\n readonly docVersions: DocumentVersionMap\n ) {}\n\n /**\n * Creates a new MutationBatchResult for the given batch and results. There\n * must be one result for each mutation in the batch. This static factory\n * caches a document=>version mapping (docVersions).\n */\n static from(\n batch: MutationBatch,\n commitVersion: SnapshotVersion,\n results: MutationResult[],\n streamToken: ProtoByteString\n ): MutationBatchResult {\n assert(\n batch.mutations.length === results.length,\n 'Mutations sent ' +\n batch.mutations.length +\n ' must equal results received ' +\n results.length\n );\n\n let versionMap = documentVersionMap();\n const mutations = batch.mutations;\n for (let i = 0; i < mutations.length; i++) {\n versionMap = versionMap.insert(mutations[i].key, results[i].version);\n }\n\n return new MutationBatchResult(\n batch,\n commitVersion,\n results,\n streamToken,\n versionMap\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { BatchId, TargetId } from '../core/types';\nimport { documentKeySet, DocumentKeySet } from '../model/collections';\nimport { DocumentKey } from '../model/document_key';\nimport { primitiveComparator } from '../util/misc';\nimport { SortedSet } from '../util/sorted_set';\n\n/**\n * A collection of references to a document from some kind of numbered entity\n * (either a target ID or batch ID). As references are added to or removed from\n * the set corresponding events are emitted to a registered garbage collector.\n *\n * Each reference is represented by a DocumentReference object. Each of them\n * contains enough information to uniquely identify the reference. They are all\n * stored primarily in a set sorted by key. A document is considered garbage if\n * there's no references in that set (this can be efficiently checked thanks to\n * sorting by key).\n *\n * ReferenceSet also keeps a secondary set that contains references sorted by\n * IDs. This one is used to efficiently implement removal of all references by\n * some target ID.\n */\nexport class ReferenceSet {\n // A set of outstanding references to a document sorted by key.\n private refsByKey = new SortedSet(DocReference.compareByKey);\n\n // A set of outstanding references to a document sorted by target id.\n private refsByTarget = new SortedSet(DocReference.compareByTargetId);\n\n /** Returns true if the reference set contains no references. */\n isEmpty(): boolean {\n return this.refsByKey.isEmpty();\n }\n\n /** Adds a reference to the given document key for the given ID. */\n addReference(key: DocumentKey, id: TargetId | BatchId): void {\n const ref = new DocReference(key, id);\n this.refsByKey = this.refsByKey.add(ref);\n this.refsByTarget = this.refsByTarget.add(ref);\n }\n\n /** Add references to the given document keys for the given ID. */\n addReferences(keys: DocumentKeySet, id: TargetId | BatchId): void {\n keys.forEach(key => this.addReference(key, id));\n }\n\n /**\n * Removes a reference to the given document key for the given\n * ID.\n */\n removeReference(key: DocumentKey, id: TargetId | BatchId): void {\n this.removeRef(new DocReference(key, id));\n }\n\n removeReferences(keys: DocumentKeySet, id: TargetId | BatchId): void {\n keys.forEach(key => this.removeReference(key, id));\n }\n\n /**\n * Clears all references with a given ID. Calls removeRef() for each key\n * removed.\n */\n removeReferencesForId(id: TargetId | BatchId): DocumentKey[] {\n const emptyKey = DocumentKey.EMPTY;\n const startRef = new DocReference(emptyKey, id);\n const endRef = new DocReference(emptyKey, id + 1);\n const keys: DocumentKey[] = [];\n this.refsByTarget.forEachInRange([startRef, endRef], ref => {\n this.removeRef(ref);\n keys.push(ref.key);\n });\n return keys;\n }\n\n removeAllReferences(): void {\n this.refsByKey.forEach(ref => this.removeRef(ref));\n }\n\n private removeRef(ref: DocReference): void {\n this.refsByKey = this.refsByKey.delete(ref);\n this.refsByTarget = this.refsByTarget.delete(ref);\n }\n\n referencesForId(id: TargetId | BatchId): DocumentKeySet {\n const emptyKey = DocumentKey.EMPTY;\n const startRef = new DocReference(emptyKey, id);\n const endRef = new DocReference(emptyKey, id + 1);\n let keys = documentKeySet();\n this.refsByTarget.forEachInRange([startRef, endRef], ref => {\n keys = keys.add(ref.key);\n });\n return keys;\n }\n\n containsKey(key: DocumentKey): boolean {\n const ref = new DocReference(key, 0);\n const firstRef = this.refsByKey.firstAfterOrEqual(ref);\n return firstRef !== null && key.isEqual(firstRef.key);\n }\n}\n\nexport class DocReference {\n constructor(\n public key: DocumentKey,\n public targetOrBatchId: TargetId | BatchId\n ) {}\n\n /** Compare by key then by ID */\n static compareByKey(left: DocReference, right: DocReference): number {\n return (\n DocumentKey.comparator(left.key, right.key) ||\n primitiveComparator(left.targetOrBatchId, right.targetOrBatchId)\n );\n }\n\n /** Compare by ID then by key */\n static compareByTargetId(left: DocReference, right: DocReference): number {\n return (\n primitiveComparator(left.targetOrBatchId, right.targetOrBatchId) ||\n DocumentKey.comparator(left.key, right.key)\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { fail } from '../util/assert';\n\nexport type FulfilledHandler<T, R> =\n | ((result: T) => R | PersistencePromise<R>)\n | null;\nexport type RejectedHandler<R> =\n | ((reason: Error) => R | PersistencePromise<R>)\n | null;\nexport type Resolver<T> = (value?: T) => void;\nexport type Rejector = (error: Error) => void;\n\n/**\n * PersistencePromise<> is essentially a re-implementation of Promise<> except\n * it has a .next() method instead of .then() and .next() and .catch() callbacks\n * are executed synchronously when a PersistencePromise resolves rather than\n * asynchronously (Promise<> implementations use setImmediate() or similar).\n *\n * This is necessary to interoperate with IndexedDB which will automatically\n * commit transactions if control is returned to the event loop without\n * synchronously initiating another operation on the transaction.\n *\n * NOTE: .then() and .catch() only allow a single consumer, unlike normal\n * Promises.\n */\nexport class PersistencePromise<T> {\n // NOTE: next/catchCallback will always point to our own wrapper functions,\n // not the user's raw next() or catch() callbacks.\n private nextCallback: FulfilledHandler<T, unknown> = null;\n private catchCallback: RejectedHandler<unknown> = null;\n\n // When the operation resolves, we'll set result or error and mark isDone.\n private result: T | undefined = undefined;\n private error: Error | undefined = undefined;\n private isDone = false;\n\n // Set to true when .then() or .catch() are called and prevents additional\n // chaining.\n private callbackAttached = false;\n\n constructor(callback: (resolve: Resolver<T>, reject: Rejector) => void) {\n callback(\n value => {\n this.isDone = true;\n this.result = value;\n if (this.nextCallback) {\n // value should be defined unless T is Void, but we can't express\n // that in the type system.\n this.nextCallback(value!);\n }\n },\n error => {\n this.isDone = true;\n this.error = error;\n if (this.catchCallback) {\n this.catchCallback(error);\n }\n }\n );\n }\n\n catch<R>(\n fn: (error: Error) => R | PersistencePromise<R>\n ): PersistencePromise<R> {\n return this.next(undefined, fn);\n }\n\n next<R>(\n nextFn?: FulfilledHandler<T, R>,\n catchFn?: RejectedHandler<R>\n ): PersistencePromise<R> {\n if (this.callbackAttached) {\n fail('Called next() or catch() twice for PersistencePromise');\n }\n this.callbackAttached = true;\n if (this.isDone) {\n if (!this.error) {\n return this.wrapSuccess(nextFn, this.result!);\n } else {\n return this.wrapFailure(catchFn, this.error);\n }\n } else {\n return new PersistencePromise<R>((resolve, reject) => {\n this.nextCallback = (value: T) => {\n this.wrapSuccess(nextFn, value).next(resolve, reject);\n };\n this.catchCallback = (error: Error) => {\n this.wrapFailure(catchFn, error).next(resolve, reject);\n };\n });\n }\n }\n\n toPromise(): Promise<T> {\n return new Promise((resolve, reject) => {\n this.next(resolve, reject);\n });\n }\n\n private wrapUserFunction<R>(\n fn: () => R | PersistencePromise<R>\n ): PersistencePromise<R> {\n try {\n const result = fn();\n if (result instanceof PersistencePromise) {\n return result;\n } else {\n return PersistencePromise.resolve(result);\n }\n } catch (e) {\n return PersistencePromise.reject<R>(e);\n }\n }\n\n private wrapSuccess<R>(\n nextFn: FulfilledHandler<T, R> | undefined,\n value: T\n ): PersistencePromise<R> {\n if (nextFn) {\n return this.wrapUserFunction(() => nextFn(value));\n } else {\n // If there's no nextFn, then R must be the same as T\n return PersistencePromise.resolve<R>((value as unknown) as R);\n }\n }\n\n private wrapFailure<R>(\n catchFn: RejectedHandler<R> | undefined,\n error: Error\n ): PersistencePromise<R> {\n if (catchFn) {\n return this.wrapUserFunction(() => catchFn(error));\n } else {\n return PersistencePromise.reject<R>(error);\n }\n }\n\n static resolve(): PersistencePromise<void>;\n static resolve<R>(result: R): PersistencePromise<R>;\n static resolve<R>(result?: R): PersistencePromise<R | void> {\n return new PersistencePromise<R | void>((resolve, reject) => {\n resolve(result);\n });\n }\n\n static reject<R>(error: Error): PersistencePromise<R> {\n return new PersistencePromise<R>((resolve, reject) => {\n reject(error);\n });\n }\n\n static waitFor(\n // Accept all Promise types in waitFor().\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n all: { forEach: (cb: (el: PersistencePromise<any>) => void) => void }\n ): PersistencePromise<void> {\n return new PersistencePromise<void>((resolve, reject) => {\n let expectedCount = 0;\n let resolvedCount = 0;\n let done = false;\n\n all.forEach(element => {\n ++expectedCount;\n element.next(\n () => {\n ++resolvedCount;\n if (done && resolvedCount === expectedCount) {\n resolve();\n }\n },\n err => reject(err)\n );\n });\n\n done = true;\n if (resolvedCount === expectedCount) {\n resolve();\n }\n });\n }\n\n /**\n * Given an array of predicate functions that asynchronously evaluate to a\n * boolean, implements a short-circuiting `or` between the results. Predicates\n * will be evaluated until one of them returns `true`, then stop. The final\n * result will be whether any of them returned `true`.\n */\n static or(\n predicates: Array<() => PersistencePromise<boolean>>\n ): PersistencePromise<boolean> {\n let p: PersistencePromise<boolean> = PersistencePromise.resolve<boolean>(\n false\n );\n for (const predicate of predicates) {\n p = p.next(isTrue => {\n if (isTrue) {\n return PersistencePromise.resolve<boolean>(isTrue);\n } else {\n return predicate();\n }\n });\n }\n return p;\n }\n\n /**\n * Given an iterable, call the given function on each element in the\n * collection and wait for all of the resulting concurrent PersistencePromises\n * to resolve.\n */\n static forEach<R, S>(\n collection: { forEach: (cb: (r: R, s: S) => void) => void },\n f:\n | ((r: R, s: S) => PersistencePromise<void>)\n | ((r: R) => PersistencePromise<void>)\n ): PersistencePromise<void>;\n static forEach<R>(\n collection: { forEach: (cb: (r: R) => void) => void },\n f: (r: R) => PersistencePromise<void>\n ): PersistencePromise<void>;\n static forEach<R, S>(\n collection: { forEach: (cb: (r: R, s?: S) => void) => void },\n f: (r: R, s?: S) => PersistencePromise<void>\n ): PersistencePromise<void> {\n const promises: Array<PersistencePromise<void>> = [];\n collection.forEach((r, s) => {\n promises.push(f.call(this, r, s));\n });\n return this.waitFor(promises);\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { DocumentKeySet, NullableMaybeDocumentMap } from '../model/collections';\nimport { MaybeDocument } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport { assert } from '../util/assert';\nimport { ObjectMap } from '../util/obj_map';\n\nimport { PersistenceTransaction } from './persistence';\nimport { PersistencePromise } from './persistence_promise';\nimport { SnapshotVersion } from '../core/snapshot_version';\n\n/**\n * An in-memory buffer of entries to be written to a RemoteDocumentCache.\n * It can be used to batch up a set of changes to be written to the cache, but\n * additionally supports reading entries back with the `getEntry()` method,\n * falling back to the underlying RemoteDocumentCache if no entry is\n * buffered.\n *\n * Entries added to the cache *must* be read first. This is to facilitate\n * calculating the size delta of the pending changes.\n *\n * PORTING NOTE: This class was implemented then removed from other platforms.\n * If byte-counting ends up being needed on the other platforms, consider\n * porting this class as part of that implementation work.\n */\nexport abstract class RemoteDocumentChangeBuffer {\n // A mapping of document key to the new cache entry that should be written (or null if any\n // existing cache entry should be removed).\n protected changes: ObjectMap<\n DocumentKey,\n MaybeDocument | null\n > = new ObjectMap(key => key.toString());\n\n // The read time to use for all added documents in this change buffer.\n private _readTime: SnapshotVersion | undefined;\n\n private changesApplied = false;\n\n protected abstract getFromCache(\n transaction: PersistenceTransaction,\n documentKey: DocumentKey\n ): PersistencePromise<MaybeDocument | null>;\n\n protected abstract getAllFromCache(\n transaction: PersistenceTransaction,\n documentKeys: DocumentKeySet\n ): PersistencePromise<NullableMaybeDocumentMap>;\n\n protected abstract applyChanges(\n transaction: PersistenceTransaction\n ): PersistencePromise<void>;\n\n protected set readTime(value: SnapshotVersion) {\n // Right now (for simplicity) we just track a single readTime for all the\n // added entries since we expect them to all be the same, but we could\n // rework to store per-entry readTimes if necessary.\n assert(\n this._readTime === undefined || this._readTime.isEqual(value),\n 'All changes in a RemoteDocumentChangeBuffer must have the same read time'\n );\n this._readTime = value;\n }\n\n protected get readTime(): SnapshotVersion {\n assert(\n this._readTime !== undefined,\n 'Read time is not set. All removeEntry() calls must include a readTime if `trackRemovals` is used.'\n );\n return this._readTime;\n }\n\n /**\n * Buffers a `RemoteDocumentCache.addEntry()` call.\n *\n * You can only modify documents that have already been retrieved via\n * `getEntry()/getEntries()` (enforced via IndexedDbs `apply()`).\n */\n addEntry(maybeDocument: MaybeDocument, readTime: SnapshotVersion): void {\n this.assertNotApplied();\n this.readTime = readTime;\n this.changes.set(maybeDocument.key, maybeDocument);\n }\n\n /**\n * Buffers a `RemoteDocumentCache.removeEntry()` call.\n *\n * You can only remove documents that have already been retrieved via\n * `getEntry()/getEntries()` (enforced via IndexedDbs `apply()`).\n */\n removeEntry(key: DocumentKey, readTime?: SnapshotVersion): void {\n this.assertNotApplied();\n if (readTime) {\n this.readTime = readTime;\n }\n this.changes.set(key, null);\n }\n\n /**\n * Looks up an entry in the cache. The buffered changes will first be checked,\n * and if no buffered change applies, this will forward to\n * `RemoteDocumentCache.getEntry()`.\n *\n * @param transaction The transaction in which to perform any persistence\n * operations.\n * @param documentKey The key of the entry to look up.\n * @return The cached Document or NoDocument entry, or null if we have nothing\n * cached.\n */\n getEntry(\n transaction: PersistenceTransaction,\n documentKey: DocumentKey\n ): PersistencePromise<MaybeDocument | null> {\n this.assertNotApplied();\n const bufferedEntry = this.changes.get(documentKey);\n if (bufferedEntry !== undefined) {\n return PersistencePromise.resolve<MaybeDocument | null>(bufferedEntry);\n } else {\n return this.getFromCache(transaction, documentKey);\n }\n }\n\n /**\n * Looks up several entries in the cache, forwarding to\n * `RemoteDocumentCache.getEntry()`.\n *\n * @param transaction The transaction in which to perform any persistence\n * operations.\n * @param documentKeys The keys of the entries to look up.\n * @return A map of cached `Document`s or `NoDocument`s, indexed by key. If an\n * entry cannot be found, the corresponding key will be mapped to a null\n * value.\n */\n getEntries(\n transaction: PersistenceTransaction,\n documentKeys: DocumentKeySet\n ): PersistencePromise<NullableMaybeDocumentMap> {\n return this.getAllFromCache(transaction, documentKeys);\n }\n\n /**\n * Applies buffered changes to the underlying RemoteDocumentCache, using\n * the provided transaction.\n */\n apply(transaction: PersistenceTransaction): PersistencePromise<void> {\n this.assertNotApplied();\n this.changesApplied = true;\n return this.applyChanges(transaction);\n }\n\n /** Helper to assert this.changes is not null */\n protected assertNotApplied(): void {\n assert(!this.changesApplied, 'Changes have already been applied.');\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { User } from '../auth/user';\n\nimport { ListenSequenceNumber } from '../core/types';\nimport { DocumentKey } from '../model/document_key';\nimport { IndexManager } from './index_manager';\nimport { MutationQueue } from './mutation_queue';\nimport { PersistencePromise } from './persistence_promise';\nimport { TargetCache } from './target_cache';\nimport { ReferenceSet } from './reference_set';\nimport { RemoteDocumentCache } from './remote_document_cache';\nimport { ClientId } from './shared_client_state';\nimport { TargetData } from './target_data';\n\nexport const PRIMARY_LEASE_LOST_ERROR_MSG =\n 'The current tab is not in the required state to perform this operation. ' +\n 'It might be necessary to refresh the browser tab.';\n\n/**\n * A base class representing a persistence transaction, encapsulating both the\n * transaction's sequence numbers as well as a list of onCommitted listeners.\n *\n * When you call Persistence.runTransaction(), it will create a transaction and\n * pass it to your callback. You then pass it to any method that operates\n * on persistence.\n */\nexport abstract class PersistenceTransaction {\n private readonly onCommittedListeners: Array<() => void> = [];\n\n abstract readonly currentSequenceNumber: ListenSequenceNumber;\n\n addOnCommittedListener(listener: () => void): void {\n this.onCommittedListeners.push(listener);\n }\n\n raiseOnCommittedEvent(): void {\n this.onCommittedListeners.forEach(listener => listener());\n }\n}\n\n/** The different modes supported by `IndexedDbPersistence.runTransaction()`. */\nexport type PersistenceTransactionMode =\n | 'readonly'\n | 'readwrite'\n | 'readwrite-primary'\n | 'readonly-idempotent'\n | 'readwrite-idempotent'\n | 'readwrite-primary-idempotent';\n\n/**\n * Callback type for primary state notifications. This callback can be\n * registered with the persistence layer to get notified when we transition from\n * primary to secondary state and vice versa.\n *\n * Note: Instances can only toggle between Primary and Secondary state if\n * IndexedDB persistence is enabled and multiple clients are active. If this\n * listener is registered with MemoryPersistence, the callback will be called\n * exactly once marking the current instance as Primary.\n */\nexport type PrimaryStateListener = (isPrimary: boolean) => Promise<void>;\n\n/**\n * A ReferenceDelegate instance handles all of the hooks into the document-reference lifecycle. This\n * includes being added to a target, being removed from a target, being subject to mutation, and\n * being mutated by the user.\n *\n * Different implementations may do different things with each of these events. Not every\n * implementation needs to do something with every lifecycle hook.\n *\n * PORTING NOTE: since sequence numbers are attached to transactions in this\n * client, the ReferenceDelegate does not need to deal in transactional\n * semantics (onTransactionStarted/Committed()), nor does it need to track and\n * generate sequence numbers (getCurrentSequenceNumber()).\n */\nexport interface ReferenceDelegate {\n /**\n * Registers a ReferenceSet of documents that should be considered 'referenced' and not eligible\n * for removal during garbage collection.\n */\n setInMemoryPins(pins: ReferenceSet): void;\n\n /** Notify the delegate that the given document was added to a target. */\n addReference(\n txn: PersistenceTransaction,\n doc: DocumentKey\n ): PersistencePromise<void>;\n\n /** Notify the delegate that the given document was removed from a target. */\n removeReference(\n txn: PersistenceTransaction,\n doc: DocumentKey\n ): PersistencePromise<void>;\n\n /**\n * Notify the delegate that a target was removed. The delegate may, but is not obligated to,\n * actually delete the target and associated data.\n */\n removeTarget(\n txn: PersistenceTransaction,\n targetData: TargetData\n ): PersistencePromise<void>;\n\n /** Notify the delegate that a document is no longer being mutated by the user. */\n removeMutationReference(\n txn: PersistenceTransaction,\n doc: DocumentKey\n ): PersistencePromise<void>;\n\n /** Notify the delegate that a limbo document was updated. */\n updateLimboDocument(\n txn: PersistenceTransaction,\n doc: DocumentKey\n ): PersistencePromise<void>;\n}\n\n/**\n * Persistence is the lowest-level shared interface to persistent storage in\n * Firestore.\n *\n * Persistence is used to create MutationQueue and RemoteDocumentCache\n * instances backed by persistence (which might be in-memory or LevelDB).\n *\n * Persistence also exposes an API to create and run PersistenceTransactions\n * against persistence. All read / write operations must be wrapped in a\n * transaction. Implementations of PersistenceTransaction / Persistence only\n * need to guarantee that writes made against the transaction are not made to\n * durable storage until the transaction resolves its PersistencePromise.\n * Since memory-only storage components do not alter durable storage, they are\n * free to ignore the transaction.\n *\n * This contract is enough to allow the LocalStore be be written\n * independently of whether or not the stored state actually is durably\n * persisted. If persistent storage is enabled, writes are grouped together to\n * avoid inconsistent state that could cause crashes.\n *\n * Concretely, when persistent storage is enabled, the persistent versions of\n * MutationQueue, RemoteDocumentCache, and others (the mutators) will\n * defer their writes into a transaction. Once the local store has completed\n * one logical operation, it commits the transaction.\n *\n * When persistent storage is disabled, the non-persistent versions of the\n * mutators ignore the transaction. This short-cut is allowed because\n * memory-only storage leaves no state so it cannot be inconsistent.\n *\n * This simplifies the implementations of the mutators and allows memory-only\n * implementations to supplement the persistent ones without requiring any\n * special dual-store implementation of Persistence. The cost is that the\n * LocalStore needs to be slightly careful about the order of its reads and\n * writes in order to avoid relying on being able to read back uncommitted\n * writes.\n */\nexport interface Persistence {\n /**\n * Whether or not this persistence instance has been started.\n */\n readonly started: boolean;\n\n readonly referenceDelegate: ReferenceDelegate;\n\n /**\n * Releases any resources held during eager shutdown.\n */\n shutdown(): Promise<void>;\n\n /**\n * Registers a listener that gets called when the primary state of the\n * instance changes. Upon registering, this listener is invoked immediately\n * with the current primary state.\n *\n * PORTING NOTE: This is only used for Web multi-tab.\n */\n setPrimaryStateListener(\n primaryStateListener: PrimaryStateListener\n ): Promise<void>;\n\n /**\n * Registers a listener that gets called when the database receives a\n * version change event indicating that it has deleted.\n *\n * PORTING NOTE: This is only used for Web multi-tab.\n */\n setDatabaseDeletedListener(\n databaseDeletedListener: () => Promise<void>\n ): void;\n\n /**\n * Adjusts the current network state in the client's metadata, potentially\n * affecting the primary lease.\n *\n * PORTING NOTE: This is only used for Web multi-tab.\n */\n setNetworkEnabled(networkEnabled: boolean): void;\n\n /**\n * Returns the IDs of the clients that are currently active. If multi-tab\n * is not supported, returns an array that only contains the local client's\n * ID.\n *\n * PORTING NOTE: This is only used for Web multi-tab.\n */\n getActiveClients(): Promise<ClientId[]>;\n\n /**\n * Returns a MutationQueue representing the persisted mutations for the\n * given user.\n *\n * Note: The implementation is free to return the same instance every time\n * this is called for a given user. In particular, the memory-backed\n * implementation does this to emulate the persisted implementation to the\n * extent possible (e.g. in the case of uid switching from\n * sally=>jack=>sally, sally's mutation queue will be preserved).\n */\n getMutationQueue(user: User): MutationQueue;\n\n /**\n * Returns a TargetCache representing the persisted cache of targets.\n *\n * Note: The implementation is free to return the same instance every time\n * this is called. In particular, the memory-backed implementation does this\n * to emulate the persisted implementation to the extent possible.\n */\n getTargetCache(): TargetCache;\n\n /**\n * Returns a RemoteDocumentCache representing the persisted cache of remote\n * documents.\n *\n * Note: The implementation is free to return the same instance every time\n * this is called. In particular, the memory-backed implementation does this\n * to emulate the persisted implementation to the extent possible.\n */\n getRemoteDocumentCache(): RemoteDocumentCache;\n\n /**\n * Returns an IndexManager instance that manages our persisted query indexes.\n *\n * Note: The implementation is free to return the same instance every time\n * this is called. In particular, the memory-backed implementation does this\n * to emulate the persisted implementation to the extent possible.\n */\n getIndexManager(): IndexManager;\n\n /**\n * Performs an operation inside a persistence transaction. Any reads or writes\n * against persistence must be performed within a transaction. Writes will be\n * committed atomically once the transaction completes.\n *\n * Persistence operations are asynchronous and therefore the provided\n * transactionOperation must return a PersistencePromise. When it is resolved,\n * the transaction will be committed and the Promise returned by this method\n * will resolve.\n *\n * @param action A description of the action performed by this transaction,\n * used for logging.\n * @param mode The underlying mode of the IndexedDb transaction. Can be\n * 'readonly`, 'readwrite' or 'readwrite-primary'. Transactions marked\n * 'readwrite-primary' can only be executed by the primary client. In this\n * mode, the transactionOperation will not be run if the primary lease cannot\n * be acquired and the returned promise will be rejected with a\n * FAILED_PRECONDITION error.\n * @param transactionOperation The operation to run inside a transaction.\n * @return A promise that is resolved once the transaction completes.\n */\n runTransaction<T>(\n action: string,\n mode: PersistenceTransactionMode,\n transactionOperation: (\n transaction: PersistenceTransaction\n ) => PersistencePromise<T>\n ): Promise<T>;\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Query } from '../core/query';\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport {\n DocumentKeySet,\n documentKeySet,\n DocumentMap,\n documentMap,\n MaybeDocumentMap,\n maybeDocumentMap,\n NullableMaybeDocumentMap,\n nullableMaybeDocumentMap\n} from '../model/collections';\nimport { Document, MaybeDocument, NoDocument } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport { MutationBatch } from '../model/mutation_batch';\nimport { ResourcePath } from '../model/path';\n\nimport { assert } from '../util/assert';\nimport { IndexManager } from './index_manager';\nimport { MutationQueue } from './mutation_queue';\nimport { PatchMutation } from '../model/mutation';\nimport { PersistenceTransaction } from './persistence';\nimport { PersistencePromise } from './persistence_promise';\nimport { RemoteDocumentCache } from './remote_document_cache';\n\n/**\n * A readonly view of the local state of all documents we're tracking (i.e. we\n * have a cached version in remoteDocumentCache or local mutations for the\n * document). The view is computed by applying the mutations in the\n * MutationQueue to the RemoteDocumentCache.\n */\nexport class LocalDocumentsView {\n constructor(\n readonly remoteDocumentCache: RemoteDocumentCache,\n readonly mutationQueue: MutationQueue,\n readonly indexManager: IndexManager\n ) {}\n\n /**\n * Get the local view of the document identified by `key`.\n *\n * @return Local view of the document or null if we don't have any cached\n * state for it.\n */\n getDocument(\n transaction: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<MaybeDocument | null> {\n return this.mutationQueue\n .getAllMutationBatchesAffectingDocumentKey(transaction, key)\n .next(batches => this.getDocumentInternal(transaction, key, batches));\n }\n\n /** Internal version of `getDocument` that allows reusing batches. */\n private getDocumentInternal(\n transaction: PersistenceTransaction,\n key: DocumentKey,\n inBatches: MutationBatch[]\n ): PersistencePromise<MaybeDocument | null> {\n return this.remoteDocumentCache.getEntry(transaction, key).next(doc => {\n for (const batch of inBatches) {\n doc = batch.applyToLocalView(key, doc);\n }\n return doc;\n });\n }\n\n // Returns the view of the given `docs` as they would appear after applying\n // all mutations in the given `batches`.\n private applyLocalMutationsToDocuments(\n transaction: PersistenceTransaction,\n docs: NullableMaybeDocumentMap,\n batches: MutationBatch[]\n ): NullableMaybeDocumentMap {\n let results = nullableMaybeDocumentMap();\n docs.forEach((key, localView) => {\n for (const batch of batches) {\n localView = batch.applyToLocalView(key, localView);\n }\n results = results.insert(key, localView);\n });\n return results;\n }\n\n /**\n * Gets the local view of the documents identified by `keys`.\n *\n * If we don't have cached state for a document in `keys`, a NoDocument will\n * be stored for that key in the resulting set.\n */\n getDocuments(\n transaction: PersistenceTransaction,\n keys: DocumentKeySet\n ): PersistencePromise<MaybeDocumentMap> {\n return this.remoteDocumentCache\n .getEntries(transaction, keys)\n .next(docs => this.getLocalViewOfDocuments(transaction, docs));\n }\n\n /**\n * Similar to `getDocuments`, but creates the local view from the given\n * `baseDocs` without retrieving documents from the local store.\n */\n getLocalViewOfDocuments(\n transaction: PersistenceTransaction,\n baseDocs: NullableMaybeDocumentMap\n ): PersistencePromise<MaybeDocumentMap> {\n return this.mutationQueue\n .getAllMutationBatchesAffectingDocumentKeys(transaction, baseDocs)\n .next(batches => {\n const docs = this.applyLocalMutationsToDocuments(\n transaction,\n baseDocs,\n batches\n );\n let results = maybeDocumentMap();\n docs.forEach((key, maybeDoc) => {\n // TODO(http://b/32275378): Don't conflate missing / deleted.\n if (!maybeDoc) {\n maybeDoc = new NoDocument(key, SnapshotVersion.forDeletedDoc());\n }\n results = results.insert(key, maybeDoc);\n });\n\n return results;\n });\n }\n\n /**\n * Performs a query against the local view of all documents.\n *\n * @param transaction The persistence transaction.\n * @param query The query to match documents against.\n * @param sinceReadTime If not set to SnapshotVersion.MIN, return only\n * documents that have been read since this snapshot version (exclusive).\n */\n getDocumentsMatchingQuery(\n transaction: PersistenceTransaction,\n query: Query,\n sinceReadTime: SnapshotVersion\n ): PersistencePromise<DocumentMap> {\n if (query.isDocumentQuery()) {\n return this.getDocumentsMatchingDocumentQuery(transaction, query.path);\n } else if (query.isCollectionGroupQuery()) {\n return this.getDocumentsMatchingCollectionGroupQuery(\n transaction,\n query,\n sinceReadTime\n );\n } else {\n return this.getDocumentsMatchingCollectionQuery(\n transaction,\n query,\n sinceReadTime\n );\n }\n }\n\n private getDocumentsMatchingDocumentQuery(\n transaction: PersistenceTransaction,\n docPath: ResourcePath\n ): PersistencePromise<DocumentMap> {\n // Just do a simple document lookup.\n return this.getDocument(transaction, new DocumentKey(docPath)).next(\n maybeDoc => {\n let result = documentMap();\n if (maybeDoc instanceof Document) {\n result = result.insert(maybeDoc.key, maybeDoc);\n }\n return result;\n }\n );\n }\n\n private getDocumentsMatchingCollectionGroupQuery(\n transaction: PersistenceTransaction,\n query: Query,\n sinceReadTime: SnapshotVersion\n ): PersistencePromise<DocumentMap> {\n assert(\n query.path.isEmpty(),\n 'Currently we only support collection group queries at the root.'\n );\n const collectionId = query.collectionGroup!;\n let results = documentMap();\n return this.indexManager\n .getCollectionParents(transaction, collectionId)\n .next(parents => {\n // Perform a collection query against each parent that contains the\n // collectionId and aggregate the results.\n return PersistencePromise.forEach(parents, (parent: ResourcePath) => {\n const collectionQuery = query.asCollectionQueryAtPath(\n parent.child(collectionId)\n );\n return this.getDocumentsMatchingCollectionQuery(\n transaction,\n collectionQuery,\n sinceReadTime\n ).next(r => {\n r.forEach((key, doc) => {\n results = results.insert(key, doc);\n });\n });\n }).next(() => results);\n });\n }\n\n private getDocumentsMatchingCollectionQuery(\n transaction: PersistenceTransaction,\n query: Query,\n sinceReadTime: SnapshotVersion\n ): PersistencePromise<DocumentMap> {\n // Query the remote documents and overlay mutations.\n let results: DocumentMap;\n let mutationBatches: MutationBatch[];\n return this.remoteDocumentCache\n .getDocumentsMatchingQuery(transaction, query, sinceReadTime)\n .next(queryResults => {\n results = queryResults;\n return this.mutationQueue.getAllMutationBatchesAffectingQuery(\n transaction,\n query\n );\n })\n .next(matchingMutationBatches => {\n mutationBatches = matchingMutationBatches;\n // It is possible that a PatchMutation can make a document match a query, even if\n // the version in the RemoteDocumentCache is not a match yet (waiting for server\n // to ack). To handle this, we find all document keys affected by the PatchMutations\n // that are not in `result` yet, and back fill them via `remoteDocumentCache.getEntries`,\n // otherwise those `PatchMutations` will be ignored because no base document can be found,\n // and lead to missing result for the query.\n return this.addMissingBaseDocuments(\n transaction,\n mutationBatches,\n results\n ).next(mergedDocuments => {\n results = mergedDocuments;\n\n for (const batch of mutationBatches) {\n for (const mutation of batch.mutations) {\n const key = mutation.key;\n const baseDoc = results.get(key);\n const mutatedDoc = mutation.applyToLocalView(\n baseDoc,\n baseDoc,\n batch.localWriteTime\n );\n if (mutatedDoc instanceof Document) {\n results = results.insert(key, mutatedDoc);\n } else {\n results = results.remove(key);\n }\n }\n }\n });\n })\n .next(() => {\n // Finally, filter out any documents that don't actually match\n // the query.\n results.forEach((key, doc) => {\n if (!query.matches(doc)) {\n results = results.remove(key);\n }\n });\n\n return results;\n });\n }\n\n private addMissingBaseDocuments(\n transaction: PersistenceTransaction,\n matchingMutationBatches: MutationBatch[],\n existingDocuments: DocumentMap\n ): PersistencePromise<DocumentMap> {\n let missingBaseDocEntriesForPatching = documentKeySet();\n for (const batch of matchingMutationBatches) {\n for (const mutation of batch.mutations) {\n if (\n mutation instanceof PatchMutation &&\n existingDocuments.get(mutation.key) === null\n ) {\n missingBaseDocEntriesForPatching = missingBaseDocEntriesForPatching.add(\n mutation.key\n );\n }\n }\n }\n\n let mergedDocuments = existingDocuments;\n return this.remoteDocumentCache\n .getEntries(transaction, missingBaseDocEntriesForPatching)\n .next(missingBaseDocs => {\n missingBaseDocs.forEach((key, doc) => {\n if (doc !== null && doc instanceof Document) {\n mergedDocuments = mergedDocuments.insert(key, doc);\n }\n });\n return mergedDocuments;\n });\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { TargetId } from '../core/types';\nimport { ChangeType, ViewSnapshot } from '../core/view_snapshot';\nimport { documentKeySet, DocumentKeySet } from '../model/collections';\n\n/**\n * A set of changes to what documents are currently in view and out of view for\n * a given query. These changes are sent to the LocalStore by the View (via\n * the SyncEngine) and are used to pin / unpin documents as appropriate.\n */\nexport class LocalViewChanges {\n constructor(\n readonly targetId: TargetId,\n readonly fromCache: boolean,\n readonly addedKeys: DocumentKeySet,\n readonly removedKeys: DocumentKeySet\n ) {}\n\n static fromSnapshot(\n targetId: TargetId,\n viewSnapshot: ViewSnapshot\n ): LocalViewChanges {\n let addedKeys = documentKeySet();\n let removedKeys = documentKeySet();\n\n for (const docChange of viewSnapshot.docChanges) {\n switch (docChange.type) {\n case ChangeType.Added:\n addedKeys = addedKeys.add(docChange.doc.key);\n break;\n case ChangeType.Removed:\n removedKeys = removedKeys.add(docChange.doc.key);\n break;\n default:\n // do nothing\n }\n }\n\n return new LocalViewChanges(\n targetId,\n viewSnapshot.fromCache,\n addedKeys,\n removedKeys\n );\n }\n}\n","/**\n * @license\n * Copyright 2018 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ListenSequenceNumber } from './types';\n\n/**\n * `SequenceNumberSyncer` defines the methods required to keep multiple instances of a\n * `ListenSequence` in sync.\n */\nexport interface SequenceNumberSyncer {\n // Notify the syncer that a new sequence number has been used.\n writeSequenceNumber(sequenceNumber: ListenSequenceNumber): void;\n // Setting this property allows the syncer to notify when a sequence number has been used, and\n // and lets the ListenSequence adjust its internal previous value accordingly.\n sequenceNumberHandler:\n | ((sequenceNumber: ListenSequenceNumber) => void)\n | null;\n}\n\n/**\n * `ListenSequence` is a monotonic sequence. It is initialized with a minimum value to\n * exceed. All subsequent calls to next will return increasing values. If provided with a\n * `SequenceNumberSyncer`, it will additionally bump its next value when told of a new value, as\n * well as write out sequence numbers that it produces via `next()`.\n */\nexport class ListenSequence {\n static readonly INVALID: ListenSequenceNumber = -1;\n\n private writeNewSequenceNumber?: (\n newSequenceNumber: ListenSequenceNumber\n ) => void;\n\n constructor(\n private previousValue: ListenSequenceNumber,\n sequenceNumberSyncer?: SequenceNumberSyncer\n ) {\n if (sequenceNumberSyncer) {\n sequenceNumberSyncer.sequenceNumberHandler = sequenceNumber =>\n this.setPreviousValue(sequenceNumber);\n this.writeNewSequenceNumber = sequenceNumber =>\n sequenceNumberSyncer.writeSequenceNumber(sequenceNumber);\n }\n }\n\n private setPreviousValue(\n externalPreviousValue: ListenSequenceNumber\n ): ListenSequenceNumber {\n this.previousValue = Math.max(externalPreviousValue, this.previousValue);\n return this.previousValue;\n }\n\n next(): ListenSequenceNumber {\n const nextValue = ++this.previousValue;\n if (this.writeNewSequenceNumber) {\n this.writeNewSequenceNumber(nextValue);\n }\n return nextValue;\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport interface Resolver<R> {\n (value?: R | Promise<R>): void;\n}\n\nexport interface Rejecter {\n (reason?: Error): void;\n}\n\nexport interface CancelablePromise<T> extends Promise<T> {\n cancel(): void;\n}\n\nexport class Deferred<R> {\n promise: Promise<R>;\n // Assigned synchronously in constructor by Promise constructor callback.\n resolve!: Resolver<R>;\n reject!: Rejecter;\n\n constructor() {\n this.promise = new Promise((resolve: Resolver<R>, reject: Rejecter) => {\n this.resolve = resolve;\n this.reject = reject;\n });\n }\n}\n\n/**\n * Takes an array of values and a function from a value to a Promise. The function is run on each\n * value sequentially, waiting for the previous promise to resolve before starting the next one.\n * The returned promise resolves once the function has been run on all values.\n */\nexport function sequence<T>(\n values: T[],\n fn: (value: T) => Promise<void>\n): Promise<void> {\n let p = Promise.resolve();\n for (const value of values) {\n p = p.then(() => fn(value));\n }\n return p;\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { assert, fail } from './assert';\nimport { Code, FirestoreError } from './error';\nimport * as log from './log';\nimport { CancelablePromise, Deferred } from './promise';\n\n// Accept any return type from setTimeout().\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype TimerHandle = any;\n\n/**\n * Wellknown \"timer\" IDs used when scheduling delayed operations on the\n * AsyncQueue. These IDs can then be used from tests to check for the presence\n * of operations or to run them early.\n *\n * The string values are used when encoding these timer IDs in JSON spec tests.\n */\nexport enum TimerId {\n /** All can be used with runDelayedOperationsEarly() to run all timers. */\n All = 'all',\n\n /**\n * The following 4 timers are used in persistent_stream.ts for the listen and\n * write streams. The \"Idle\" timer is used to close the stream due to\n * inactivity. The \"ConnectionBackoff\" timer is used to restart a stream once\n * the appropriate backoff delay has elapsed.\n */\n ListenStreamIdle = 'listen_stream_idle',\n ListenStreamConnectionBackoff = 'listen_stream_connection_backoff',\n WriteStreamIdle = 'write_stream_idle',\n WriteStreamConnectionBackoff = 'write_stream_connection_backoff',\n\n /**\n * A timer used in online_state_tracker.ts to transition from\n * OnlineState.Unknown to Offline after a set timeout, rather than waiting\n * indefinitely for success or failure.\n */\n OnlineStateTimeout = 'online_state_timeout',\n\n /**\n * A timer used to update the client metadata in IndexedDb, which is used\n * to determine the primary leaseholder.\n */\n ClientMetadataRefresh = 'client_metadata_refresh',\n\n /** A timer used to periodically attempt LRU Garbage collection */\n LruGarbageCollection = 'lru_garbage_collection',\n\n /**\n * A timer used to retry transactions. Since there can be multiple concurrent\n * transactions, multiple of these may be in the queue at a given time.\n */\n RetryTransaction = 'retry_transaction'\n}\n\n/**\n * Represents an operation scheduled to be run in the future on an AsyncQueue.\n *\n * It is created via DelayedOperation.createAndSchedule().\n *\n * Supports cancellation (via cancel()) and early execution (via skipDelay()).\n */\nclass DelayedOperation<T extends unknown> implements CancelablePromise<T> {\n // handle for use with clearTimeout(), or null if the operation has been\n // executed or canceled already.\n private timerHandle: TimerHandle | null;\n\n private readonly deferred = new Deferred<T>();\n\n private constructor(\n private readonly asyncQueue: AsyncQueue,\n readonly timerId: TimerId,\n readonly targetTimeMs: number,\n private readonly op: () => Promise<T>,\n private readonly removalCallback: (op: DelayedOperation<T>) => void\n ) {\n // It's normal for the deferred promise to be canceled (due to cancellation)\n // and so we attach a dummy catch callback to avoid\n // 'UnhandledPromiseRejectionWarning' log spam.\n this.deferred.promise.catch(err => {});\n }\n\n /**\n * Creates and returns a DelayedOperation that has been scheduled to be\n * executed on the provided asyncQueue after the provided delayMs.\n *\n * @param asyncQueue The queue to schedule the operation on.\n * @param id A Timer ID identifying the type of operation this is.\n * @param delayMs The delay (ms) before the operation should be scheduled.\n * @param op The operation to run.\n * @param removalCallback A callback to be called synchronously once the\n * operation is executed or canceled, notifying the AsyncQueue to remove it\n * from its delayedOperations list.\n * PORTING NOTE: This exists to prevent making removeDelayedOperation() and\n * the DelayedOperation class public.\n */\n static createAndSchedule<R extends unknown>(\n asyncQueue: AsyncQueue,\n timerId: TimerId,\n delayMs: number,\n op: () => Promise<R>,\n removalCallback: (op: DelayedOperation<R>) => void\n ): DelayedOperation<R> {\n const targetTime = Date.now() + delayMs;\n const delayedOp = new DelayedOperation(\n asyncQueue,\n timerId,\n targetTime,\n op,\n removalCallback\n );\n delayedOp.start(delayMs);\n return delayedOp;\n }\n\n /**\n * Starts the timer. This is called immediately after construction by\n * createAndSchedule().\n */\n private start(delayMs: number): void {\n this.timerHandle = setTimeout(() => this.handleDelayElapsed(), delayMs);\n }\n\n /**\n * Queues the operation to run immediately (if it hasn't already been run or\n * canceled).\n */\n skipDelay(): void {\n return this.handleDelayElapsed();\n }\n\n /**\n * Cancels the operation if it hasn't already been executed or canceled. The\n * promise will be rejected.\n *\n * As long as the operation has not yet been run, calling cancel() provides a\n * guarantee that the operation will not be run.\n */\n cancel(reason?: string): void {\n if (this.timerHandle !== null) {\n this.clearTimeout();\n this.deferred.reject(\n new FirestoreError(\n Code.CANCELLED,\n 'Operation cancelled' + (reason ? ': ' + reason : '')\n )\n );\n }\n }\n\n // Promise implementation.\n readonly [Symbol.toStringTag]: 'Promise';\n then = this.deferred.promise.then.bind(this.deferred.promise);\n catch = this.deferred.promise.catch.bind(this.deferred.promise);\n\n private handleDelayElapsed(): void {\n this.asyncQueue.enqueueAndForget(() => {\n if (this.timerHandle !== null) {\n this.clearTimeout();\n return this.op().then(result => {\n return this.deferred.resolve(result);\n });\n } else {\n return Promise.resolve();\n }\n });\n }\n\n private clearTimeout(): void {\n if (this.timerHandle !== null) {\n this.removalCallback(this);\n clearTimeout(this.timerHandle);\n this.timerHandle = null;\n }\n }\n}\n\nexport class AsyncQueue {\n // The last promise in the queue.\n private tail: Promise<unknown> = Promise.resolve();\n\n // Is this AsyncQueue being shut down? Once it is set to true, it will not\n // be changed again.\n private _isShuttingDown: boolean = false;\n\n // Operations scheduled to be queued in the future. Operations are\n // automatically removed after they are run or canceled.\n private delayedOperations: Array<DelayedOperation<unknown>> = [];\n\n // visible for testing\n failure: Error | null = null;\n\n // Flag set while there's an outstanding AsyncQueue operation, used for\n // assertion sanity-checks.\n private operationInProgress = false;\n\n // List of TimerIds to fast-forward delays for.\n private timerIdsToSkip: TimerId[] = [];\n\n // Is this AsyncQueue being shut down? If true, this instance will not enqueue\n // any new operations, Promises from enqueue requests will not resolve.\n get isShuttingDown(): boolean {\n return this._isShuttingDown;\n }\n\n /**\n * Adds a new operation to the queue without waiting for it to complete (i.e.\n * we ignore the Promise result).\n */\n enqueueAndForget<T extends unknown>(op: () => Promise<T>): void {\n // eslint-disable-next-line @typescript-eslint/no-floating-promises\n this.enqueue(op);\n }\n\n /**\n * Regardless if the queue has initialized shutdown, adds a new operation to the\n * queue without waiting for it to complete (i.e. we ignore the Promise result).\n */\n enqueueAndForgetEvenAfterShutdown<T extends unknown>(\n op: () => Promise<T>\n ): void {\n this.verifyNotFailed();\n // eslint-disable-next-line @typescript-eslint/no-floating-promises\n this.enqueueInternal(op);\n }\n\n /**\n * Regardless if the queue has initialized shutdown, adds a new operation to the\n * queue.\n */\n private enqueueEvenAfterShutdown<T extends unknown>(\n op: () => Promise<T>\n ): Promise<T> {\n this.verifyNotFailed();\n return this.enqueueInternal(op);\n }\n\n /**\n * Adds a new operation to the queue and initialize the shut down of this queue.\n * Returns a promise that will be resolved when the promise returned by the new\n * operation is (with its value).\n * Once this method is called, the only possible way to request running an operation\n * is through `enqueueAndForgetEvenAfterShutdown`.\n */\n async enqueueAndInitiateShutdown(op: () => Promise<void>): Promise<void> {\n this.verifyNotFailed();\n if (!this._isShuttingDown) {\n this._isShuttingDown = true;\n await this.enqueueEvenAfterShutdown(op);\n }\n }\n\n /**\n * Adds a new operation to the queue. Returns a promise that will be resolved\n * when the promise returned by the new operation is (with its value).\n */\n enqueue<T extends unknown>(op: () => Promise<T>): Promise<T> {\n this.verifyNotFailed();\n if (this._isShuttingDown) {\n // Return a Promise which never resolves.\n return new Promise<T>(resolve => {});\n }\n return this.enqueueInternal(op);\n }\n\n private enqueueInternal<T extends unknown>(op: () => Promise<T>): Promise<T> {\n const newTail = this.tail.then(() => {\n this.operationInProgress = true;\n return op()\n .catch((error: FirestoreError) => {\n this.failure = error;\n this.operationInProgress = false;\n const message = error.stack || error.message || '';\n log.error('INTERNAL UNHANDLED ERROR: ', message);\n\n // Escape the promise chain and throw the error globally so that\n // e.g. any global crash reporting library detects and reports it.\n // (but not for simulated errors in our tests since this breaks mocha)\n if (message.indexOf('Firestore Test Simulated Error') < 0) {\n setTimeout(() => {\n throw error;\n }, 0);\n }\n\n // Re-throw the error so that this.tail becomes a rejected Promise and\n // all further attempts to chain (via .then) will just short-circuit\n // and return the rejected Promise.\n throw error;\n })\n .then(result => {\n this.operationInProgress = false;\n return result;\n });\n });\n this.tail = newTail;\n return newTail;\n }\n\n /**\n * Schedules an operation to be queued on the AsyncQueue once the specified\n * `delayMs` has elapsed. The returned CancelablePromise can be used to cancel\n * the operation prior to its running.\n */\n enqueueAfterDelay<T extends unknown>(\n timerId: TimerId,\n delayMs: number,\n op: () => Promise<T>\n ): CancelablePromise<T> {\n this.verifyNotFailed();\n\n assert(\n delayMs >= 0,\n `Attempted to schedule an operation with a negative delay of ${delayMs}`\n );\n\n // Fast-forward delays for timerIds that have been overriden.\n if (this.timerIdsToSkip.indexOf(timerId) > -1) {\n delayMs = 0;\n }\n\n const delayedOp = DelayedOperation.createAndSchedule<T>(\n this,\n timerId,\n delayMs,\n op,\n removedOp =>\n this.removeDelayedOperation(removedOp as DelayedOperation<unknown>)\n );\n this.delayedOperations.push(delayedOp as DelayedOperation<unknown>);\n return delayedOp;\n }\n\n private verifyNotFailed(): void {\n if (this.failure) {\n fail(\n 'AsyncQueue is already failed: ' +\n (this.failure.stack || this.failure.message)\n );\n }\n }\n\n /**\n * Verifies there's an operation currently in-progress on the AsyncQueue.\n * Unfortunately we can't verify that the running code is in the promise chain\n * of that operation, so this isn't a foolproof check, but it should be enough\n * to catch some bugs.\n */\n verifyOperationInProgress(): void {\n assert(\n this.operationInProgress,\n 'verifyOpInProgress() called when no op in progress on this queue.'\n );\n }\n\n /**\n * Waits until all currently queued tasks are finished executing. Delayed\n * operations are not run.\n */\n drain(): Promise<void> {\n // It should still be possible to drain the queue after it is shutting down.\n return this.enqueueEvenAfterShutdown(() => Promise.resolve());\n }\n\n /**\n * For Tests: Determine if a delayed operation with a particular TimerId\n * exists.\n */\n containsDelayedOperation(timerId: TimerId): boolean {\n for (const op of this.delayedOperations) {\n if (op.timerId === timerId) {\n return true;\n }\n }\n return false;\n }\n\n /**\n * For Tests: Runs some or all delayed operations early.\n *\n * @param lastTimerId Delayed operations up to and including this TimerId will\n * be drained. Throws if no such operation exists. Pass TimerId.All to run\n * all delayed operations.\n * @returns a Promise that resolves once all operations have been run.\n */\n runDelayedOperationsEarly(lastTimerId: TimerId): Promise<void> {\n // Note that draining may generate more delayed ops, so we do that first.\n return this.drain().then(() => {\n assert(\n lastTimerId === TimerId.All ||\n this.containsDelayedOperation(lastTimerId),\n `Attempted to drain to missing operation ${lastTimerId}`\n );\n\n // Run ops in the same order they'd run if they ran naturally.\n this.delayedOperations.sort((a, b) => a.targetTimeMs - b.targetTimeMs);\n\n for (const op of this.delayedOperations) {\n op.skipDelay();\n if (lastTimerId !== TimerId.All && op.timerId === lastTimerId) {\n break;\n }\n }\n\n return this.drain();\n });\n }\n\n /**\n * For Tests: Skip all subsequent delays for a timer id.\n */\n skipDelaysForTimerId(timerId: TimerId): void {\n this.timerIdsToSkip.push(timerId);\n }\n\n /** Called once a DelayedOperation is run or canceled. */\n private removeDelayedOperation(op: DelayedOperation<unknown>): void {\n // NOTE: indexOf / slice are O(n), but delayedOperations is expected to be small.\n const index = this.delayedOperations.indexOf(op);\n assert(index >= 0, 'Delayed operation not found.');\n this.delayedOperations.splice(index, 1);\n }\n}\n","/**\n * @license\n * Copyright 2018 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ListenSequence } from '../core/listen_sequence';\nimport { ListenSequenceNumber, TargetId } from '../core/types';\nimport { assert } from '../util/assert';\nimport { AsyncQueue, TimerId } from '../util/async_queue';\nimport * as log from '../util/log';\nimport { primitiveComparator } from '../util/misc';\nimport { CancelablePromise } from '../util/promise';\nimport { SortedMap } from '../util/sorted_map';\nimport { SortedSet } from '../util/sorted_set';\nimport { ignoreIfPrimaryLeaseLoss, LocalStore } from './local_store';\nimport { PersistenceTransaction } from './persistence';\nimport { PersistencePromise } from './persistence_promise';\nimport { TargetData } from './target_data';\n\n/**\n * Persistence layers intending to use LRU Garbage collection should have reference delegates that\n * implement this interface. This interface defines the operations that the LRU garbage collector\n * needs from the persistence layer.\n */\nexport interface LruDelegate {\n readonly garbageCollector: LruGarbageCollector;\n\n /** Enumerates all the targets in the TargetCache. */\n forEachTarget(\n txn: PersistenceTransaction,\n f: (target: TargetData) => void\n ): PersistencePromise<void>;\n\n getSequenceNumberCount(\n txn: PersistenceTransaction\n ): PersistencePromise<number>;\n\n /**\n * Enumerates sequence numbers for documents not associated with a target.\n * Note that this may include duplicate sequence numbers.\n */\n forEachOrphanedDocumentSequenceNumber(\n txn: PersistenceTransaction,\n f: (sequenceNumber: ListenSequenceNumber) => void\n ): PersistencePromise<void>;\n\n /**\n * Removes all targets that have a sequence number less than or equal to `upperBound`, and are not\n * present in the `activeTargetIds` set.\n *\n * @return the number of targets removed.\n */\n removeTargets(\n txn: PersistenceTransaction,\n upperBound: ListenSequenceNumber,\n activeTargetIds: ActiveTargets\n ): PersistencePromise<number>;\n\n /**\n * Removes all unreferenced documents from the cache that have a sequence number less than or\n * equal to the given `upperBound`.\n *\n * @return the number of documents removed.\n */\n removeOrphanedDocuments(\n txn: PersistenceTransaction,\n upperBound: ListenSequenceNumber\n ): PersistencePromise<number>;\n\n getCacheSize(txn: PersistenceTransaction): PersistencePromise<number>;\n}\n\n/**\n * Describes a map whose keys are active target ids. We do not care about the type of the\n * values.\n */\nexport type ActiveTargets = SortedMap<TargetId, unknown>;\n\n// The type and comparator for the items contained in the SortedSet used in\n// place of a priority queue for the RollingSequenceNumberBuffer.\ntype BufferEntry = [ListenSequenceNumber, number];\nfunction bufferEntryComparator(\n [aSequence, aIndex]: BufferEntry,\n [bSequence, bIndex]: BufferEntry\n): number {\n const seqCmp = primitiveComparator(aSequence, bSequence);\n if (seqCmp === 0) {\n // This order doesn't matter, but we can bias against churn by sorting\n // entries created earlier as less than newer entries.\n return primitiveComparator(aIndex, bIndex);\n } else {\n return seqCmp;\n }\n}\n\n/**\n * Used to calculate the nth sequence number. Keeps a rolling buffer of the\n * lowest n values passed to `addElement`, and finally reports the largest of\n * them in `maxValue`.\n */\nclass RollingSequenceNumberBuffer {\n private buffer: SortedSet<BufferEntry> = new SortedSet<BufferEntry>(\n bufferEntryComparator\n );\n\n private previousIndex = 0;\n\n constructor(private readonly maxElements: number) {}\n\n private nextIndex(): number {\n return ++this.previousIndex;\n }\n\n addElement(sequenceNumber: ListenSequenceNumber): void {\n const entry: BufferEntry = [sequenceNumber, this.nextIndex()];\n if (this.buffer.size < this.maxElements) {\n this.buffer = this.buffer.add(entry);\n } else {\n const highestValue = this.buffer.last()!;\n if (bufferEntryComparator(entry, highestValue) < 0) {\n this.buffer = this.buffer.delete(highestValue).add(entry);\n }\n }\n }\n\n get maxValue(): ListenSequenceNumber {\n // Guaranteed to be non-empty. If we decide we are not collecting any\n // sequence numbers, nthSequenceNumber below short-circuits. If we have\n // decided that we are collecting n sequence numbers, it's because n is some\n // percentage of the existing sequence numbers. That means we should never\n // be in a situation where we are collecting sequence numbers but don't\n // actually have any.\n return this.buffer.last()![0];\n }\n}\n\n/**\n * Describes the results of a garbage collection run. `didRun` will be set to\n * `false` if collection was skipped (either it is disabled or the cache size\n * has not hit the threshold). If collection ran, the other fields will be\n * filled in with the details of the results.\n */\nexport interface LruResults {\n readonly didRun: boolean;\n readonly sequenceNumbersCollected: number;\n readonly targetsRemoved: number;\n readonly documentsRemoved: number;\n}\n\nconst GC_DID_NOT_RUN: LruResults = {\n didRun: false,\n sequenceNumbersCollected: 0,\n targetsRemoved: 0,\n documentsRemoved: 0\n};\n\nexport class LruParams {\n static readonly COLLECTION_DISABLED = -1;\n static readonly MINIMUM_CACHE_SIZE_BYTES = 1 * 1024 * 1024;\n static readonly DEFAULT_CACHE_SIZE_BYTES = 40 * 1024 * 1024;\n private static readonly DEFAULT_COLLECTION_PERCENTILE = 10;\n private static readonly DEFAULT_MAX_SEQUENCE_NUMBERS_TO_COLLECT = 1000;\n\n static withCacheSize(cacheSize: number): LruParams {\n return new LruParams(\n cacheSize,\n LruParams.DEFAULT_COLLECTION_PERCENTILE,\n LruParams.DEFAULT_MAX_SEQUENCE_NUMBERS_TO_COLLECT\n );\n }\n\n static readonly DEFAULT: LruParams = new LruParams(\n LruParams.DEFAULT_CACHE_SIZE_BYTES,\n LruParams.DEFAULT_COLLECTION_PERCENTILE,\n LruParams.DEFAULT_MAX_SEQUENCE_NUMBERS_TO_COLLECT\n );\n\n static readonly DISABLED: LruParams = new LruParams(\n LruParams.COLLECTION_DISABLED,\n 0,\n 0\n );\n\n constructor(\n // When we attempt to collect, we will only do so if the cache size is greater than this\n // threshold. Passing `COLLECTION_DISABLED` here will cause collection to always be skipped.\n readonly cacheSizeCollectionThreshold: number,\n // The percentage of sequence numbers that we will attempt to collect\n readonly percentileToCollect: number,\n // A cap on the total number of sequence numbers that will be collected. This prevents\n // us from collecting a huge number of sequence numbers if the cache has grown very large.\n readonly maximumSequenceNumbersToCollect: number\n ) {}\n}\n\n/** How long we wait to try running LRU GC after SDK initialization. */\nconst INITIAL_GC_DELAY_MS = 1 * 60 * 1000;\n/** Minimum amount of time between GC checks, after the first one. */\nconst REGULAR_GC_DELAY_MS = 5 * 60 * 1000;\n\n/**\n * This class is responsible for the scheduling of LRU garbage collection. It handles checking\n * whether or not GC is enabled, as well as which delay to use before the next run.\n */\nexport class LruScheduler {\n private hasRun: boolean = false;\n private gcTask: CancelablePromise<void> | null;\n\n constructor(\n private readonly garbageCollector: LruGarbageCollector,\n private readonly asyncQueue: AsyncQueue,\n private readonly localStore: LocalStore\n ) {\n this.gcTask = null;\n }\n\n start(): void {\n assert(\n this.gcTask === null,\n 'Cannot start an already started LruScheduler'\n );\n if (\n this.garbageCollector.params.cacheSizeCollectionThreshold !==\n LruParams.COLLECTION_DISABLED\n ) {\n this.scheduleGC();\n }\n }\n\n stop(): void {\n if (this.gcTask) {\n this.gcTask.cancel();\n this.gcTask = null;\n }\n }\n\n get started(): boolean {\n return this.gcTask !== null;\n }\n\n private scheduleGC(): void {\n assert(this.gcTask === null, 'Cannot schedule GC while a task is pending');\n const delay = this.hasRun ? REGULAR_GC_DELAY_MS : INITIAL_GC_DELAY_MS;\n log.debug(\n 'LruGarbageCollector',\n `Garbage collection scheduled in ${delay}ms`\n );\n this.gcTask = this.asyncQueue.enqueueAfterDelay(\n TimerId.LruGarbageCollection,\n delay,\n () => {\n this.gcTask = null;\n this.hasRun = true;\n return this.localStore\n .collectGarbage(this.garbageCollector)\n .then(() => this.scheduleGC())\n .catch(ignoreIfPrimaryLeaseLoss);\n }\n );\n }\n}\n\n/** Implements the steps for LRU garbage collection. */\nexport class LruGarbageCollector {\n constructor(\n private readonly delegate: LruDelegate,\n readonly params: LruParams\n ) {}\n\n /** Given a percentile of target to collect, returns the number of targets to collect. */\n calculateTargetCount(\n txn: PersistenceTransaction,\n percentile: number\n ): PersistencePromise<number> {\n return this.delegate.getSequenceNumberCount(txn).next(targetCount => {\n return Math.floor((percentile / 100.0) * targetCount);\n });\n }\n\n /** Returns the nth sequence number, counting in order from the smallest. */\n nthSequenceNumber(\n txn: PersistenceTransaction,\n n: number\n ): PersistencePromise<ListenSequenceNumber> {\n if (n === 0) {\n return PersistencePromise.resolve(ListenSequence.INVALID);\n }\n\n const buffer = new RollingSequenceNumberBuffer(n);\n return this.delegate\n .forEachTarget(txn, target => buffer.addElement(target.sequenceNumber))\n .next(() => {\n return this.delegate.forEachOrphanedDocumentSequenceNumber(\n txn,\n sequenceNumber => buffer.addElement(sequenceNumber)\n );\n })\n .next(() => buffer.maxValue);\n }\n\n /**\n * Removes targets with a sequence number equal to or less than the given upper bound, and removes\n * document associations with those targets.\n */\n removeTargets(\n txn: PersistenceTransaction,\n upperBound: ListenSequenceNumber,\n activeTargetIds: ActiveTargets\n ): PersistencePromise<number> {\n return this.delegate.removeTargets(txn, upperBound, activeTargetIds);\n }\n\n /**\n * Removes documents that have a sequence number equal to or less than the upper bound and are not\n * otherwise pinned.\n */\n removeOrphanedDocuments(\n txn: PersistenceTransaction,\n upperBound: ListenSequenceNumber\n ): PersistencePromise<number> {\n return this.delegate.removeOrphanedDocuments(txn, upperBound);\n }\n\n collect(\n txn: PersistenceTransaction,\n activeTargetIds: ActiveTargets\n ): PersistencePromise<LruResults> {\n if (\n this.params.cacheSizeCollectionThreshold === LruParams.COLLECTION_DISABLED\n ) {\n log.debug('LruGarbageCollector', 'Garbage collection skipped; disabled');\n return PersistencePromise.resolve(GC_DID_NOT_RUN);\n }\n\n return this.getCacheSize(txn).next(cacheSize => {\n if (cacheSize < this.params.cacheSizeCollectionThreshold) {\n log.debug(\n 'LruGarbageCollector',\n `Garbage collection skipped; Cache size ${cacheSize} ` +\n `is lower than threshold ${this.params.cacheSizeCollectionThreshold}`\n );\n return GC_DID_NOT_RUN;\n } else {\n return this.runGarbageCollection(txn, activeTargetIds);\n }\n });\n }\n\n getCacheSize(txn: PersistenceTransaction): PersistencePromise<number> {\n return this.delegate.getCacheSize(txn);\n }\n\n private runGarbageCollection(\n txn: PersistenceTransaction,\n activeTargetIds: ActiveTargets\n ): PersistencePromise<LruResults> {\n let upperBoundSequenceNumber: number;\n let sequenceNumbersToCollect: number, targetsRemoved: number;\n // Timestamps for various pieces of the process\n let countedTargetsTs: number,\n foundUpperBoundTs: number,\n removedTargetsTs: number,\n removedDocumentsTs: number;\n const startTs = Date.now();\n return this.calculateTargetCount(txn, this.params.percentileToCollect)\n .next(sequenceNumbers => {\n // Cap at the configured max\n if (sequenceNumbers > this.params.maximumSequenceNumbersToCollect) {\n log.debug(\n 'LruGarbageCollector',\n 'Capping sequence numbers to collect down ' +\n `to the maximum of ${this.params.maximumSequenceNumbersToCollect} ` +\n `from ${sequenceNumbers}`\n );\n sequenceNumbersToCollect = this.params\n .maximumSequenceNumbersToCollect;\n } else {\n sequenceNumbersToCollect = sequenceNumbers;\n }\n countedTargetsTs = Date.now();\n\n return this.nthSequenceNumber(txn, sequenceNumbersToCollect);\n })\n .next(upperBound => {\n upperBoundSequenceNumber = upperBound;\n foundUpperBoundTs = Date.now();\n\n return this.removeTargets(\n txn,\n upperBoundSequenceNumber,\n activeTargetIds\n );\n })\n .next(numTargetsRemoved => {\n targetsRemoved = numTargetsRemoved;\n removedTargetsTs = Date.now();\n\n return this.removeOrphanedDocuments(txn, upperBoundSequenceNumber);\n })\n .next(documentsRemoved => {\n removedDocumentsTs = Date.now();\n\n if (log.getLogLevel() <= log.LogLevel.DEBUG) {\n const desc =\n 'LRU Garbage Collection\\n' +\n `\\tCounted targets in ${countedTargetsTs - startTs}ms\\n` +\n `\\tDetermined least recently used ${sequenceNumbersToCollect} in ` +\n `${foundUpperBoundTs - countedTargetsTs}ms\\n` +\n `\\tRemoved ${targetsRemoved} targets in ` +\n `${removedTargetsTs - foundUpperBoundTs}ms\\n` +\n `\\tRemoved ${documentsRemoved} documents in ` +\n `${removedDocumentsTs - removedTargetsTs}ms\\n` +\n `Total Duration: ${removedDocumentsTs - startTs}ms`;\n log.debug('LruGarbageCollector', desc);\n }\n\n return PersistencePromise.resolve<LruResults>({\n didRun: true,\n sequenceNumbersCollected: sequenceNumbersToCollect,\n targetsRemoved,\n documentsRemoved\n });\n });\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Timestamp } from '../api/timestamp';\nimport { User } from '../auth/user';\nimport { Query } from '../core/query';\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { Target } from '../core/target';\nimport { BatchId, ProtoByteString, TargetId } from '../core/types';\nimport {\n DocumentKeySet,\n documentKeySet,\n DocumentMap,\n maybeDocumentMap,\n MaybeDocumentMap\n} from '../model/collections';\nimport { MaybeDocument, NoDocument } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport { Mutation, PatchMutation, Precondition } from '../model/mutation';\nimport {\n BATCHID_UNKNOWN,\n MutationBatch,\n MutationBatchResult\n} from '../model/mutation_batch';\nimport { RemoteEvent, TargetChange } from '../remote/remote_event';\nimport { assert } from '../util/assert';\nimport { Code, FirestoreError } from '../util/error';\nimport * as log from '../util/log';\nimport { primitiveComparator } from '../util/misc';\nimport * as objUtils from '../util/obj';\nimport { ObjectMap } from '../util/obj_map';\nimport { SortedMap } from '../util/sorted_map';\n\nimport { LocalDocumentsView } from './local_documents_view';\nimport { LocalViewChanges } from './local_view_changes';\nimport { LruGarbageCollector, LruResults } from './lru_garbage_collector';\nimport { MutationQueue } from './mutation_queue';\nimport {\n Persistence,\n PersistenceTransaction,\n PRIMARY_LEASE_LOST_ERROR_MSG\n} from './persistence';\nimport { PersistencePromise } from './persistence_promise';\nimport { TargetCache } from './target_cache';\nimport { QueryEngine } from './query_engine';\nimport { ReferenceSet } from './reference_set';\nimport { RemoteDocumentCache } from './remote_document_cache';\nimport { RemoteDocumentChangeBuffer } from './remote_document_change_buffer';\nimport { ClientId } from './shared_client_state';\nimport { TargetData, TargetPurpose } from './target_data';\n\nconst LOG_TAG = 'LocalStore';\n\n/** The result of a write to the local store. */\nexport interface LocalWriteResult {\n batchId: BatchId;\n changes: MaybeDocumentMap;\n}\n\n/** The result of a user-change operation in the local store. */\nexport interface UserChangeResult {\n readonly affectedDocuments: MaybeDocumentMap;\n readonly removedBatchIds: BatchId[];\n readonly addedBatchIds: BatchId[];\n}\n\n/** The result of executing a query against the local store. */\nexport interface QueryResult {\n readonly documents: DocumentMap;\n readonly remoteKeys: DocumentKeySet;\n}\n\n/**\n * Local storage in the Firestore client. Coordinates persistence components\n * like the mutation queue and remote document cache to present a\n * latency-compensated view of stored data.\n *\n * The LocalStore is responsible for accepting mutations from the Sync Engine.\n * Writes from the client are put into a queue as provisional Mutations until\n * they are processed by the RemoteStore and confirmed as having been written\n * to the server.\n *\n * The local store provides the local version of documents that have been\n * modified locally. It maintains the constraint:\n *\n * LocalDocument = RemoteDocument + Active(LocalMutations)\n *\n * (Active mutations are those that are enqueued and have not been previously\n * acknowledged or rejected).\n *\n * The RemoteDocument (\"ground truth\") state is provided via the\n * applyChangeBatch method. It will be some version of a server-provided\n * document OR will be a server-provided document PLUS acknowledged mutations:\n *\n * RemoteDocument' = RemoteDocument + Acknowledged(LocalMutations)\n *\n * Note that this \"dirty\" version of a RemoteDocument will not be identical to a\n * server base version, since it has LocalMutations added to it pending getting\n * an authoritative copy from the server.\n *\n * Since LocalMutations can be rejected by the server, we have to be able to\n * revert a LocalMutation that has already been applied to the LocalDocument\n * (typically done by replaying all remaining LocalMutations to the\n * RemoteDocument to re-apply).\n *\n * The LocalStore is responsible for the garbage collection of the documents it\n * contains. For now, it every doc referenced by a view, the mutation queue, or\n * the RemoteStore.\n *\n * It also maintains the persistence of mapping queries to resume tokens and\n * target ids. It needs to know this data about queries to properly know what\n * docs it would be allowed to garbage collect.\n *\n * The LocalStore must be able to efficiently execute queries against its local\n * cache of the documents, to provide the initial set of results before any\n * remote changes have been received.\n *\n * Note: In TypeScript, most methods return Promises since the implementation\n * may rely on fetching data from IndexedDB which is async.\n * These Promises will only be rejected on an I/O error or other internal\n * (unexpected) failure (e.g. failed assert) and always represent an\n * unrecoverable error (should be caught / reported by the async_queue).\n */\nexport class LocalStore {\n /**\n * The maximum time to leave a resume token buffered without writing it out.\n * This value is arbitrary: it's long enough to avoid several writes\n * (possibly indefinitely if updates come more frequently than this) but\n * short enough that restarting after crashing will still have a pretty\n * recent resume token.\n */\n private static readonly RESUME_TOKEN_MAX_AGE_MICROS = 5 * 60 * 1e6;\n\n /**\n * The set of all mutations that have been sent but not yet been applied to\n * the backend.\n */\n private mutationQueue: MutationQueue;\n\n /** The set of all cached remote documents. */\n private remoteDocuments: RemoteDocumentCache;\n\n /**\n * The \"local\" view of all documents (layering mutationQueue on top of\n * remoteDocumentCache).\n */\n private localDocuments: LocalDocumentsView;\n\n /**\n * The set of document references maintained by any local views.\n */\n private localViewReferences = new ReferenceSet();\n\n /** Maps a target to its `TargetData`. */\n private targetCache: TargetCache;\n\n /**\n * Maps a targetID to data about its target.\n *\n * PORTING NOTE: We are using an immutable data structure on Web to make re-runs\n * of `applyRemoteEvent()` idempotent.\n */\n private targetDataByTarget = new SortedMap<TargetId, TargetData>(\n primitiveComparator\n );\n\n /** Maps a target to its targetID. */\n // TODO(wuandy): Evaluate if TargetId can be part of Target.\n private targetIdByTarget = new ObjectMap<Target, TargetId>(t =>\n t.canonicalId()\n );\n\n /**\n * The read time of the last entry processed by `getNewDocumentChanges()`.\n *\n * PORTING NOTE: This is only used for multi-tab synchronization.\n */\n private lastDocumentChangeReadTime = SnapshotVersion.MIN;\n\n constructor(\n /** Manages our in-memory or durable persistence. */\n private persistence: Persistence,\n private queryEngine: QueryEngine,\n initialUser: User\n ) {\n assert(\n persistence.started,\n 'LocalStore was passed an unstarted persistence implementation'\n );\n this.persistence.referenceDelegate.setInMemoryPins(\n this.localViewReferences\n );\n this.mutationQueue = persistence.getMutationQueue(initialUser);\n this.remoteDocuments = persistence.getRemoteDocumentCache();\n this.targetCache = persistence.getTargetCache();\n this.localDocuments = new LocalDocumentsView(\n this.remoteDocuments,\n this.mutationQueue,\n this.persistence.getIndexManager()\n );\n this.queryEngine.setLocalDocumentsView(this.localDocuments);\n }\n\n /** Starts the LocalStore. */\n start(): Promise<void> {\n return this.synchronizeLastDocumentChangeReadTime();\n }\n\n /**\n * Tells the LocalStore that the currently authenticated user has changed.\n *\n * In response the local store switches the mutation queue to the new user and\n * returns any resulting document changes.\n */\n // PORTING NOTE: Android and iOS only return the documents affected by the\n // change.\n async handleUserChange(user: User): Promise<UserChangeResult> {\n let newMutationQueue = this.mutationQueue;\n let newLocalDocuments = this.localDocuments;\n\n const result = await this.persistence.runTransaction(\n 'Handle user change',\n 'readonly-idempotent',\n txn => {\n // Swap out the mutation queue, grabbing the pending mutation batches\n // before and after.\n let oldBatches: MutationBatch[];\n return this.mutationQueue\n .getAllMutationBatches(txn)\n .next(promisedOldBatches => {\n oldBatches = promisedOldBatches;\n\n newMutationQueue = this.persistence.getMutationQueue(user);\n\n // Recreate our LocalDocumentsView using the new\n // MutationQueue.\n newLocalDocuments = new LocalDocumentsView(\n this.remoteDocuments,\n newMutationQueue,\n this.persistence.getIndexManager()\n );\n return newMutationQueue.getAllMutationBatches(txn);\n })\n .next(newBatches => {\n const removedBatchIds: BatchId[] = [];\n const addedBatchIds: BatchId[] = [];\n\n // Union the old/new changed keys.\n let changedKeys = documentKeySet();\n\n for (const batch of oldBatches) {\n removedBatchIds.push(batch.batchId);\n for (const mutation of batch.mutations) {\n changedKeys = changedKeys.add(mutation.key);\n }\n }\n\n for (const batch of newBatches) {\n addedBatchIds.push(batch.batchId);\n for (const mutation of batch.mutations) {\n changedKeys = changedKeys.add(mutation.key);\n }\n }\n\n // Return the set of all (potentially) changed documents and the list\n // of mutation batch IDs that were affected by change.\n return newLocalDocuments\n .getDocuments(txn, changedKeys)\n .next(affectedDocuments => {\n return {\n affectedDocuments,\n removedBatchIds,\n addedBatchIds\n };\n });\n });\n }\n );\n\n this.mutationQueue = newMutationQueue;\n this.localDocuments = newLocalDocuments;\n this.queryEngine.setLocalDocumentsView(this.localDocuments);\n\n return result;\n }\n\n /* Accept locally generated Mutations and commit them to storage. */\n localWrite(mutations: Mutation[]): Promise<LocalWriteResult> {\n const localWriteTime = Timestamp.now();\n const keys = mutations.reduce(\n (keys, m) => keys.add(m.key),\n documentKeySet()\n );\n\n let existingDocs: MaybeDocumentMap;\n\n return this.persistence\n .runTransaction(\n 'Locally write mutations',\n 'readwrite-idempotent',\n txn => {\n // Load and apply all existing mutations. This lets us compute the\n // current base state for all non-idempotent transforms before applying\n // any additional user-provided writes.\n return this.localDocuments.getDocuments(txn, keys).next(docs => {\n existingDocs = docs;\n\n // For non-idempotent mutations (such as `FieldValue.increment()`),\n // we record the base state in a separate patch mutation. This is\n // later used to guarantee consistent values and prevents flicker\n // even if the backend sends us an update that already includes our\n // transform.\n const baseMutations: Mutation[] = [];\n\n for (const mutation of mutations) {\n const baseValue = mutation.extractBaseValue(\n existingDocs.get(mutation.key)\n );\n if (baseValue != null) {\n // NOTE: The base state should only be applied if there's some\n // existing document to override, so use a Precondition of\n // exists=true\n baseMutations.push(\n new PatchMutation(\n mutation.key,\n baseValue,\n baseValue.fieldMask(),\n Precondition.exists(true)\n )\n );\n }\n }\n\n return this.mutationQueue.addMutationBatch(\n txn,\n localWriteTime,\n baseMutations,\n mutations\n );\n });\n }\n )\n .then(batch => {\n const changes = batch.applyToLocalDocumentSet(existingDocs);\n return { batchId: batch.batchId, changes };\n });\n }\n\n /** Returns the local view of the documents affected by a mutation batch. */\n // PORTING NOTE: Multi-tab only.\n lookupMutationDocuments(batchId: BatchId): Promise<MaybeDocumentMap | null> {\n return this.persistence.runTransaction(\n 'Lookup mutation documents',\n 'readonly-idempotent',\n txn => {\n return this.mutationQueue\n .lookupMutationKeys(txn, batchId)\n .next(keys => {\n if (keys) {\n return this.localDocuments.getDocuments(\n txn,\n keys\n ) as PersistencePromise<MaybeDocumentMap | null>;\n } else {\n return PersistencePromise.resolve<MaybeDocumentMap | null>(null);\n }\n });\n }\n );\n }\n\n /**\n * Acknowledge the given batch.\n *\n * On the happy path when a batch is acknowledged, the local store will\n *\n * + remove the batch from the mutation queue;\n * + apply the changes to the remote document cache;\n * + recalculate the latency compensated view implied by those changes (there\n * may be mutations in the queue that affect the documents but haven't been\n * acknowledged yet); and\n * + give the changed documents back the sync engine\n *\n * @returns The resulting (modified) documents.\n */\n acknowledgeBatch(\n batchResult: MutationBatchResult\n ): Promise<MaybeDocumentMap> {\n return this.persistence.runTransaction(\n 'Acknowledge batch',\n 'readwrite-primary-idempotent',\n txn => {\n const affected = batchResult.batch.keys();\n const documentBuffer = this.remoteDocuments.newChangeBuffer({\n trackRemovals: true // Make sure document removals show up in `getNewDocumentChanges()`\n });\n return this.mutationQueue\n .acknowledgeBatch(txn, batchResult.batch, batchResult.streamToken)\n .next(() =>\n this.applyWriteToRemoteDocuments(txn, batchResult, documentBuffer)\n )\n .next(() => documentBuffer.apply(txn))\n .next(() => this.mutationQueue.performConsistencyCheck(txn))\n .next(() => this.localDocuments.getDocuments(txn, affected));\n }\n );\n }\n\n /**\n * Remove mutations from the MutationQueue for the specified batch;\n * LocalDocuments will be recalculated.\n *\n * @returns The resulting modified documents.\n */\n rejectBatch(batchId: BatchId): Promise<MaybeDocumentMap> {\n return this.persistence.runTransaction(\n 'Reject batch',\n 'readwrite-primary-idempotent',\n txn => {\n let affectedKeys: DocumentKeySet;\n return this.mutationQueue\n .lookupMutationBatch(txn, batchId)\n .next((batch: MutationBatch | null) => {\n assert(batch !== null, 'Attempt to reject nonexistent batch!');\n affectedKeys = batch.keys();\n return this.mutationQueue.removeMutationBatch(txn, batch);\n })\n .next(() => {\n return this.mutationQueue.performConsistencyCheck(txn);\n })\n .next(() => {\n return this.localDocuments.getDocuments(txn, affectedKeys);\n });\n }\n );\n }\n\n /**\n * Returns the largest (latest) batch id in mutation queue that is pending server response.\n * Returns `BATCHID_UNKNOWN` if the queue is empty.\n */\n getHighestUnacknowledgedBatchId(): Promise<BatchId> {\n return this.persistence.runTransaction(\n 'Get highest unacknowledged batch id',\n 'readonly-idempotent',\n txn => {\n return this.mutationQueue.getHighestUnacknowledgedBatchId(txn);\n }\n );\n }\n\n /** Returns the last recorded stream token for the current user. */\n getLastStreamToken(): Promise<ProtoByteString> {\n return this.persistence.runTransaction(\n 'Get last stream token',\n 'readonly-idempotent',\n txn => {\n return this.mutationQueue.getLastStreamToken(txn);\n }\n );\n }\n\n /**\n * Sets the stream token for the current user without acknowledging any\n * mutation batch. This is usually only useful after a stream handshake or in\n * response to an error that requires clearing the stream token.\n */\n setLastStreamToken(streamToken: ProtoByteString): Promise<void> {\n return this.persistence.runTransaction(\n 'Set last stream token',\n 'readwrite-primary-idempotent',\n txn => {\n return this.mutationQueue.setLastStreamToken(txn, streamToken);\n }\n );\n }\n\n /**\n * Returns the last consistent snapshot processed (used by the RemoteStore to\n * determine whether to buffer incoming snapshots from the backend).\n */\n getLastRemoteSnapshotVersion(): Promise<SnapshotVersion> {\n return this.persistence.runTransaction(\n 'Get last remote snapshot version',\n 'readonly-idempotent',\n txn => this.targetCache.getLastRemoteSnapshotVersion(txn)\n );\n }\n\n /**\n * Update the \"ground-state\" (remote) documents. We assume that the remote\n * event reflects any write batches that have been acknowledged or rejected\n * (i.e. we do not re-apply local mutations to updates from this event).\n *\n * LocalDocuments are re-calculated if there are remaining mutations in the\n * queue.\n */\n applyRemoteEvent(remoteEvent: RemoteEvent): Promise<MaybeDocumentMap> {\n const remoteVersion = remoteEvent.snapshotVersion;\n let newTargetDataByTargetMap = this.targetDataByTarget;\n\n return this.persistence\n .runTransaction(\n 'Apply remote event',\n 'readwrite-primary-idempotent',\n txn => {\n const documentBuffer = this.remoteDocuments.newChangeBuffer({\n trackRemovals: true // Make sure document removals show up in `getNewDocumentChanges()`\n });\n\n // Reset newTargetDataByTargetMap in case this transaction gets re-run.\n newTargetDataByTargetMap = this.targetDataByTarget;\n\n const promises = [] as Array<PersistencePromise<void>>;\n objUtils.forEachNumber(\n remoteEvent.targetChanges,\n (targetId: TargetId, change: TargetChange) => {\n const oldTargetData = newTargetDataByTargetMap.get(targetId);\n if (!oldTargetData) {\n return;\n }\n\n // Only update the remote keys if the target is still active. This\n // ensures that we can persist the updated target data along with\n // the updated assignment.\n promises.push(\n this.targetCache\n .removeMatchingKeys(txn, change.removedDocuments, targetId)\n .next(() => {\n return this.targetCache.addMatchingKeys(\n txn,\n change.addedDocuments,\n targetId\n );\n })\n );\n\n const resumeToken = change.resumeToken;\n // Update the resume token if the change includes one.\n if (resumeToken.length > 0) {\n const newTargetData = oldTargetData\n .withResumeToken(resumeToken, remoteVersion)\n .withSequenceNumber(txn.currentSequenceNumber);\n newTargetDataByTargetMap = newTargetDataByTargetMap.insert(\n targetId,\n newTargetData\n );\n\n // Update the target data if there are target changes (or if\n // sufficient time has passed since the last update).\n if (\n LocalStore.shouldPersistTargetData(\n oldTargetData,\n newTargetData,\n change\n )\n ) {\n promises.push(\n this.targetCache.updateTargetData(txn, newTargetData)\n );\n }\n }\n }\n );\n\n let changedDocs = maybeDocumentMap();\n let updatedKeys = documentKeySet();\n remoteEvent.documentUpdates.forEach((key, doc) => {\n updatedKeys = updatedKeys.add(key);\n });\n\n // Each loop iteration only affects its \"own\" doc, so it's safe to get all the remote\n // documents in advance in a single call.\n promises.push(\n documentBuffer.getEntries(txn, updatedKeys).next(existingDocs => {\n remoteEvent.documentUpdates.forEach((key, doc) => {\n const existingDoc = existingDocs.get(key);\n\n // Note: The order of the steps below is important, since we want\n // to ensure that rejected limbo resolutions (which fabricate\n // NoDocuments with SnapshotVersion.MIN) never add documents to\n // cache.\n if (\n doc instanceof NoDocument &&\n doc.version.isEqual(SnapshotVersion.MIN)\n ) {\n // NoDocuments with SnapshotVersion.MIN are used in manufactured\n // events. We remove these documents from cache since we lost\n // access.\n documentBuffer.removeEntry(key, remoteVersion);\n changedDocs = changedDocs.insert(key, doc);\n } else if (\n existingDoc == null ||\n doc.version.compareTo(existingDoc.version) > 0 ||\n (doc.version.compareTo(existingDoc.version) === 0 &&\n existingDoc.hasPendingWrites)\n ) {\n assert(\n !SnapshotVersion.MIN.isEqual(remoteVersion),\n 'Cannot add a document when the remote version is zero'\n );\n documentBuffer.addEntry(doc, remoteVersion);\n changedDocs = changedDocs.insert(key, doc);\n } else {\n log.debug(\n LOG_TAG,\n 'Ignoring outdated watch update for ',\n key,\n '. Current version:',\n existingDoc.version,\n ' Watch version:',\n doc.version\n );\n }\n\n if (remoteEvent.resolvedLimboDocuments.has(key)) {\n promises.push(\n this.persistence.referenceDelegate.updateLimboDocument(\n txn,\n key\n )\n );\n }\n });\n })\n );\n\n // HACK: The only reason we allow a null snapshot version is so that we\n // can synthesize remote events when we get permission denied errors while\n // trying to resolve the state of a locally cached document that is in\n // limbo.\n if (!remoteVersion.isEqual(SnapshotVersion.MIN)) {\n const updateRemoteVersion = this.targetCache\n .getLastRemoteSnapshotVersion(txn)\n .next(lastRemoteSnapshotVersion => {\n assert(\n remoteVersion.compareTo(lastRemoteSnapshotVersion) >= 0,\n 'Watch stream reverted to previous snapshot?? ' +\n remoteVersion +\n ' < ' +\n lastRemoteSnapshotVersion\n );\n return this.targetCache.setTargetsMetadata(\n txn,\n txn.currentSequenceNumber,\n remoteVersion\n );\n });\n promises.push(updateRemoteVersion);\n }\n\n return PersistencePromise.waitFor(promises)\n .next(() => documentBuffer.apply(txn))\n .next(() => {\n return this.localDocuments.getLocalViewOfDocuments(\n txn,\n changedDocs\n );\n });\n }\n )\n .then(changedDocs => {\n this.targetDataByTarget = newTargetDataByTargetMap;\n return changedDocs;\n });\n }\n\n /**\n * Returns true if the newTargetData should be persisted during an update of\n * an active target. TargetData should always be persisted when a target is\n * being released and should not call this function.\n *\n * While the target is active, TargetData updates can be omitted when nothing\n * about the target has changed except metadata like the resume token or\n * snapshot version. Occasionally it's worth the extra write to prevent these\n * values from getting too stale after a crash, but this doesn't have to be\n * too frequent.\n */\n private static shouldPersistTargetData(\n oldTargetData: TargetData,\n newTargetData: TargetData,\n change: TargetChange\n ): boolean {\n assert(\n newTargetData.resumeToken.length > 0,\n 'Attempted to persist target data with no resume token'\n );\n\n // Always persist target data if we don't already have a resume token.\n if (oldTargetData.resumeToken.length === 0) {\n return true;\n }\n\n // Don't allow resume token changes to be buffered indefinitely. This\n // allows us to be reasonably up-to-date after a crash and avoids needing\n // to loop over all active queries on shutdown. Especially in the browser\n // we may not get time to do anything interesting while the current tab is\n // closing.\n const timeDelta =\n newTargetData.snapshotVersion.toMicroseconds() -\n oldTargetData.snapshotVersion.toMicroseconds();\n if (timeDelta >= this.RESUME_TOKEN_MAX_AGE_MICROS) {\n return true;\n }\n\n // Otherwise if the only thing that has changed about a target is its resume\n // token it's not worth persisting. Note that the RemoteStore keeps an\n // in-memory view of the currently active targets which includes the current\n // resume token, so stream failure or user changes will still use an\n // up-to-date resume token regardless of what we do here.\n const changes =\n change.addedDocuments.size +\n change.modifiedDocuments.size +\n change.removedDocuments.size;\n return changes > 0;\n }\n\n /**\n * Notify local store of the changed views to locally pin documents.\n */\n notifyLocalViewChanges(viewChanges: LocalViewChanges[]): Promise<void> {\n for (const viewChange of viewChanges) {\n const targetId = viewChange.targetId;\n\n this.localViewReferences.addReferences(viewChange.addedKeys, targetId);\n this.localViewReferences.removeReferences(\n viewChange.removedKeys,\n targetId\n );\n\n if (!viewChange.fromCache) {\n const targetData = this.targetDataByTarget.get(targetId);\n assert(\n targetData !== null,\n `Can't set limbo-free snapshot version for unknown target: ${targetId}`\n );\n\n // Advance the last limbo free snapshot version\n const lastLimboFreeSnapshotVersion = targetData.snapshotVersion;\n const updatedTargetData = targetData.withLastLimboFreeSnapshotVersion(\n lastLimboFreeSnapshotVersion\n );\n this.targetDataByTarget = this.targetDataByTarget.insert(\n targetId,\n updatedTargetData\n );\n }\n }\n return this.persistence.runTransaction(\n 'notifyLocalViewChanges',\n 'readwrite-idempotent',\n txn => {\n return PersistencePromise.forEach(\n viewChanges,\n (viewChange: LocalViewChanges) => {\n return PersistencePromise.forEach(\n viewChange.removedKeys,\n (key: DocumentKey) =>\n this.persistence.referenceDelegate.removeReference(txn, key)\n );\n }\n );\n }\n );\n }\n\n /**\n * Gets the mutation batch after the passed in batchId in the mutation queue\n * or null if empty.\n * @param afterBatchId If provided, the batch to search after.\n * @returns The next mutation or null if there wasn't one.\n */\n nextMutationBatch(afterBatchId?: BatchId): Promise<MutationBatch | null> {\n return this.persistence.runTransaction(\n 'Get next mutation batch',\n 'readonly-idempotent',\n txn => {\n if (afterBatchId === undefined) {\n afterBatchId = BATCHID_UNKNOWN;\n }\n return this.mutationQueue.getNextMutationBatchAfterBatchId(\n txn,\n afterBatchId\n );\n }\n );\n }\n\n /**\n * Read the current value of a Document with a given key or null if not\n * found - used for testing.\n */\n readDocument(key: DocumentKey): Promise<MaybeDocument | null> {\n return this.persistence.runTransaction(\n 'read document',\n 'readonly-idempotent',\n txn => {\n return this.localDocuments.getDocument(txn, key);\n }\n );\n }\n\n /**\n * Assigns the given target an internal ID so that its results can be pinned so\n * they don't get GC'd. A target must be allocated in the local store before\n * the store can be used to manage its view.\n *\n * Allocating an already allocated `Target` will return the existing `TargetData`\n * for that `Target`.\n */\n allocateTarget(target: Target): Promise<TargetData> {\n return this.persistence\n .runTransaction('Allocate target', 'readwrite-idempotent', txn => {\n let targetData: TargetData;\n return this.targetCache\n .getTargetData(txn, target)\n .next((cached: TargetData | null) => {\n if (cached) {\n // This target has been listened to previously, so reuse the\n // previous targetID.\n // TODO(mcg): freshen last accessed date?\n targetData = cached;\n return PersistencePromise.resolve(targetData);\n } else {\n return this.targetCache.allocateTargetId(txn).next(targetId => {\n targetData = new TargetData(\n target,\n targetId,\n TargetPurpose.Listen,\n txn.currentSequenceNumber\n );\n return this.targetCache\n .addTargetData(txn, targetData)\n .next(() => targetData);\n });\n }\n });\n })\n .then(targetData => {\n if (this.targetDataByTarget.get(targetData.targetId) === null) {\n this.targetDataByTarget = this.targetDataByTarget.insert(\n targetData.targetId,\n targetData\n );\n this.targetIdByTarget.set(target, targetData.targetId);\n }\n return targetData;\n });\n }\n\n /**\n * Returns the TargetData as seen by the LocalStore, including updates that may\n * have not yet been persisted to the TargetCache.\n */\n // Visible for testing.\n getTargetData(\n transaction: PersistenceTransaction,\n target: Target\n ): PersistencePromise<TargetData | null> {\n const targetId = this.targetIdByTarget.get(target);\n if (targetId !== undefined) {\n return PersistencePromise.resolve<TargetData | null>(\n this.targetDataByTarget.get(targetId)\n );\n } else {\n return this.targetCache.getTargetData(transaction, target);\n }\n }\n\n /**\n * Unpin all the documents associated with the given target. If\n * `keepPersistedTargetData` is set to false and Eager GC enabled, the method\n * directly removes the associated target data from the target cache.\n *\n * Releasing a non-existing `Target` is a no-op.\n */\n // PORTING NOTE: `keepPersistedTargetData` is multi-tab only.\n releaseTarget(\n targetId: number,\n keepPersistedTargetData: boolean\n ): Promise<void> {\n const targetData = this.targetDataByTarget.get(targetId);\n assert(\n targetData !== null,\n `Tried to release nonexistent target: ${targetId}`\n );\n\n const mode = keepPersistedTargetData\n ? 'readwrite-idempotent'\n : 'readwrite-primary-idempotent';\n return this.persistence\n .runTransaction('Release target', mode, txn => {\n // References for documents sent via Watch are automatically removed\n // when we delete a target's data from the reference delegate.\n // Since this does not remove references for locally mutated documents,\n // we have to remove the target associations for these documents\n // manually.\n // This operation needs to be run inside the transaction since EagerGC\n // uses the local view references during the transaction's commit.\n // Fortunately, the operation is safe to be re-run in case the\n // transaction fails since there are no side effects if the target has\n // already been removed.\n const removed = this.localViewReferences.removeReferencesForId(\n targetId\n );\n\n if (!keepPersistedTargetData) {\n return PersistencePromise.forEach(removed, (key: DocumentKey) =>\n this.persistence.referenceDelegate.removeReference(txn, key)\n ).next(() => {\n this.persistence.referenceDelegate.removeTarget(txn, targetData!);\n });\n } else {\n return PersistencePromise.resolve();\n }\n })\n .then(() => {\n this.targetDataByTarget = this.targetDataByTarget.remove(targetId);\n this.targetIdByTarget.delete(targetData!.target);\n });\n }\n\n /**\n * Runs the specified query against the local store and returns the results,\n * potentially taking advantage of query data from previous executions (such\n * as the set of remote keys).\n *\n * @param usePreviousResults Whether results from previous executions can\n * be used to optimize this query execution.\n */\n executeQuery(\n query: Query,\n usePreviousResults: boolean\n ): Promise<QueryResult> {\n let lastLimboFreeSnapshotVersion = SnapshotVersion.MIN;\n let remoteKeys = documentKeySet();\n\n return this.persistence.runTransaction(\n 'Execute query',\n 'readonly-idempotent',\n txn => {\n return this.getTargetData(txn, query.toTarget())\n .next(targetData => {\n if (targetData) {\n lastLimboFreeSnapshotVersion =\n targetData.lastLimboFreeSnapshotVersion;\n return this.targetCache\n .getMatchingKeysForTargetId(txn, targetData.targetId)\n .next(result => {\n remoteKeys = result;\n });\n }\n })\n .next(() =>\n this.queryEngine.getDocumentsMatchingQuery(\n txn,\n query,\n usePreviousResults\n ? lastLimboFreeSnapshotVersion\n : SnapshotVersion.MIN,\n usePreviousResults ? remoteKeys : documentKeySet()\n )\n )\n .next(documents => {\n return { documents, remoteKeys };\n });\n }\n );\n }\n\n /**\n * Returns the keys of the documents that are associated with the given\n * target id in the remote table.\n */\n remoteDocumentKeys(targetId: TargetId): Promise<DocumentKeySet> {\n return this.persistence.runTransaction(\n 'Remote document keys',\n 'readonly-idempotent',\n txn => {\n return this.targetCache.getMatchingKeysForTargetId(txn, targetId);\n }\n );\n }\n\n // PORTING NOTE: Multi-tab only.\n getActiveClients(): Promise<ClientId[]> {\n return this.persistence.getActiveClients();\n }\n\n // PORTING NOTE: Multi-tab only.\n removeCachedMutationBatchMetadata(batchId: BatchId): void {\n this.mutationQueue.removeCachedMutationKeys(batchId);\n }\n\n // PORTING NOTE: Multi-tab only.\n setNetworkEnabled(networkEnabled: boolean): void {\n this.persistence.setNetworkEnabled(networkEnabled);\n }\n\n private applyWriteToRemoteDocuments(\n txn: PersistenceTransaction,\n batchResult: MutationBatchResult,\n documentBuffer: RemoteDocumentChangeBuffer\n ): PersistencePromise<void> {\n const batch = batchResult.batch;\n const docKeys = batch.keys();\n let promiseChain = PersistencePromise.resolve();\n docKeys.forEach(docKey => {\n promiseChain = promiseChain\n .next(() => {\n return documentBuffer.getEntry(txn, docKey);\n })\n .next((remoteDoc: MaybeDocument | null) => {\n let doc = remoteDoc;\n const ackVersion = batchResult.docVersions.get(docKey);\n assert(\n ackVersion !== null,\n 'ackVersions should contain every doc in the write.'\n );\n if (!doc || doc.version.compareTo(ackVersion!) < 0) {\n doc = batch.applyToRemoteDocument(docKey, doc, batchResult);\n if (!doc) {\n assert(\n !remoteDoc,\n 'Mutation batch ' +\n batch +\n ' applied to document ' +\n remoteDoc +\n ' resulted in null'\n );\n } else {\n // We use the commitVersion as the readTime rather than the\n // document's updateTime since the updateTime is not advanced\n // for updates that do not modify the underlying document.\n documentBuffer.addEntry(doc, batchResult.commitVersion);\n }\n }\n });\n });\n return promiseChain.next(() =>\n this.mutationQueue.removeMutationBatch(txn, batch)\n );\n }\n\n collectGarbage(garbageCollector: LruGarbageCollector): Promise<LruResults> {\n return this.persistence.runTransaction(\n 'Collect garbage',\n 'readwrite-primary-idempotent',\n txn => garbageCollector.collect(txn, this.targetDataByTarget)\n );\n }\n\n // PORTING NOTE: Multi-tab only.\n getTarget(targetId: TargetId): Promise<Target | null> {\n const cachedTargetData = this.targetDataByTarget.get(targetId);\n\n if (cachedTargetData) {\n return Promise.resolve(cachedTargetData.target);\n } else {\n return this.persistence.runTransaction(\n 'Get target data',\n 'readonly-idempotent',\n txn => {\n return this.targetCache\n .getTargetDataForTarget(txn, targetId)\n .next(targetData => (targetData ? targetData.target : null));\n }\n );\n }\n }\n\n /**\n * Returns the set of documents that have been updated since the last call.\n * If this is the first call, returns the set of changes since client\n * initialization. Further invocations will return document changes since\n * the point of rejection.\n */\n // PORTING NOTE: Multi-tab only.\n getNewDocumentChanges(): Promise<MaybeDocumentMap> {\n return this.persistence\n .runTransaction('Get new document changes', 'readonly-idempotent', txn =>\n this.remoteDocuments.getNewDocumentChanges(\n txn,\n this.lastDocumentChangeReadTime\n )\n )\n .then(({ changedDocs, readTime }) => {\n this.lastDocumentChangeReadTime = readTime;\n return changedDocs;\n });\n }\n\n /**\n * Reads the newest document change from persistence and forwards the internal\n * synchronization marker so that calls to `getNewDocumentChanges()`\n * only return changes that happened after client initialization.\n */\n // PORTING NOTE: Multi-tab only.\n async synchronizeLastDocumentChangeReadTime(): Promise<void> {\n this.lastDocumentChangeReadTime = await this.persistence.runTransaction(\n 'Synchronize last document change read time',\n 'readonly-idempotent',\n txn => this.remoteDocuments.getLastReadTime(txn)\n );\n }\n}\n\n/**\n * Verifies the error thrown by a LocalStore operation. If a LocalStore\n * operation fails because the primary lease has been taken by another client,\n * we ignore the error (the persistence layer will immediately call\n * `applyPrimaryLease` to propagate the primary state change). All other errors\n * are re-thrown.\n *\n * @param err An error returned by a LocalStore operation.\n * @return A Promise that resolves after we recovered, or the original error.\n */\nexport async function ignoreIfPrimaryLeaseLoss(\n err: FirestoreError\n): Promise<void> {\n if (\n err.code === Code.FAILED_PRECONDITION &&\n err.message === PRIMARY_LEASE_LOST_ERROR_MSG\n ) {\n log.debug(LOG_TAG, 'Unexpectedly lost primary lease');\n } else {\n throw err;\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport * as firestore from '@firebase/firestore-types';\n\nimport { FieldPath as InternalFieldPath } from '../model/path';\nimport { Code, FirestoreError } from '../util/error';\nimport {\n invalidClassError,\n validateArgType,\n validateNamedArrayAtLeastNumberOfElements\n} from '../util/input_validation';\n\n// The objects that are a part of this API are exposed to third-parties as\n// compiled javascript so we want to flag our private members with a leading\n// underscore to discourage their use.\n\n/**\n * A FieldPath refers to a field in a document. The path may consist of a single\n * field name (referring to a top-level field in the document), or a list of\n * field names (referring to a nested field in the document).\n */\nexport class FieldPath implements firestore.FieldPath {\n /** Internal representation of a Firestore field path. */\n _internalPath: InternalFieldPath;\n\n /**\n * Creates a FieldPath from the provided field names. If more than one field\n * name is provided, the path will point to a nested field in a document.\n *\n * @param fieldNames A list of field names.\n */\n constructor(...fieldNames: string[]) {\n validateNamedArrayAtLeastNumberOfElements(\n 'FieldPath',\n fieldNames,\n 'fieldNames',\n 1\n );\n\n for (let i = 0; i < fieldNames.length; ++i) {\n validateArgType('FieldPath', 'string', i, fieldNames[i]);\n if (fieldNames[i].length === 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid field name at argument $(i + 1). ` +\n 'Field names must not be empty.'\n );\n }\n }\n\n this._internalPath = new InternalFieldPath(fieldNames);\n }\n\n /**\n * Internal Note: The backend doesn't technically support querying by\n * document ID. Instead it queries by the entire document name (full path\n * included), but in the cases we currently support documentId(), the net\n * effect is the same.\n */\n private static readonly _DOCUMENT_ID = new FieldPath(\n InternalFieldPath.keyField().canonicalString()\n );\n\n static documentId(): FieldPath {\n return FieldPath._DOCUMENT_ID;\n }\n\n isEqual(other: firestore.FieldPath): boolean {\n if (!(other instanceof FieldPath)) {\n throw invalidClassError('isEqual', 'FieldPath', 1, other);\n }\n return this._internalPath.isEqual(other._internalPath);\n }\n}\n\n/**\n * Matches any characters in a field path string that are reserved.\n */\nconst RESERVED = new RegExp('[~\\\\*/\\\\[\\\\]]');\n\n/**\n * Parses a field path string into a FieldPath, treating dots as separators.\n */\nexport function fromDotSeparatedString(path: string): FieldPath {\n const found = path.search(RESERVED);\n if (found >= 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid field path (${path}). Paths must not contain ` +\n `'~', '*', '/', '[', or ']'`\n );\n }\n try {\n return new FieldPath(...path.split('.'));\n } catch (e) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid field path (${path}). Paths must not be empty, ` +\n `begin with '.', end with '.', or contain '..'`\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport * as firestore from '@firebase/firestore-types';\n\nimport { makeConstructorPrivate } from '../util/api';\nimport {\n validateArgType,\n validateAtLeastNumberOfArgs,\n validateExactNumberOfArgs,\n validateNoArgs\n} from '../util/input_validation';\n\n/**\n * An opaque base class for FieldValue sentinel objects in our public API,\n * with public static methods for creating said sentinel objects.\n */\nexport abstract class FieldValueImpl implements firestore.FieldValue {\n protected constructor(readonly _methodName: string) {}\n\n static delete(): FieldValueImpl {\n validateNoArgs('FieldValue.delete', arguments);\n return DeleteFieldValueImpl.instance;\n }\n\n static serverTimestamp(): FieldValueImpl {\n validateNoArgs('FieldValue.serverTimestamp', arguments);\n return ServerTimestampFieldValueImpl.instance;\n }\n\n static arrayUnion(...elements: unknown[]): FieldValueImpl {\n validateAtLeastNumberOfArgs('FieldValue.arrayUnion', arguments, 1);\n // NOTE: We don't actually parse the data until it's used in set() or\n // update() since we need access to the Firestore instance.\n return new ArrayUnionFieldValueImpl(elements);\n }\n\n static arrayRemove(...elements: unknown[]): FieldValueImpl {\n validateAtLeastNumberOfArgs('FieldValue.arrayRemove', arguments, 1);\n // NOTE: We don't actually parse the data until it's used in set() or\n // update() since we need access to the Firestore instance.\n return new ArrayRemoveFieldValueImpl(elements);\n }\n\n static increment(n: number): FieldValueImpl {\n validateArgType('FieldValue.increment', 'number', 1, n);\n validateExactNumberOfArgs('FieldValue.increment', arguments, 1);\n return new NumericIncrementFieldValueImpl(n);\n }\n\n isEqual(other: FieldValueImpl): boolean {\n return this === other;\n }\n}\n\nexport class DeleteFieldValueImpl extends FieldValueImpl {\n private constructor() {\n super('FieldValue.delete');\n }\n /** Singleton instance. */\n static instance = new DeleteFieldValueImpl();\n}\n\nexport class ServerTimestampFieldValueImpl extends FieldValueImpl {\n private constructor() {\n super('FieldValue.serverTimestamp');\n }\n /** Singleton instance. */\n static instance = new ServerTimestampFieldValueImpl();\n}\n\nexport class ArrayUnionFieldValueImpl extends FieldValueImpl {\n constructor(readonly _elements: unknown[]) {\n super('FieldValue.arrayUnion');\n }\n}\n\nexport class ArrayRemoveFieldValueImpl extends FieldValueImpl {\n constructor(readonly _elements: unknown[]) {\n super('FieldValue.arrayRemove');\n }\n}\n\nexport class NumericIncrementFieldValueImpl extends FieldValueImpl {\n constructor(readonly _operand: number) {\n super('FieldValue.increment');\n }\n}\n\n// Public instance that disallows construction at runtime. This constructor is\n// used when exporting FieldValueImpl on firebase.firestore.FieldValue and will\n// be called FieldValue publicly. Internally we still use FieldValueImpl which\n// has a type-checked private constructor. Note that FieldValueImpl and\n// PublicFieldValue can be used interchangeably in instanceof checks.\n// For our internal TypeScript code PublicFieldValue doesn't exist as a type,\n// and so we need to use FieldValueImpl as type and export it too.\nexport const PublicFieldValue = makeConstructorPrivate(\n FieldValueImpl,\n 'Use FieldValue.<field>() instead.'\n);\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport * as firestore from '@firebase/firestore-types';\n\nimport { Timestamp } from '../api/timestamp';\nimport { DatabaseId } from '../core/database_info';\nimport { DocumentKey } from '../model/document_key';\nimport {\n FieldValue,\n NumberValue,\n ObjectValue,\n ArrayValue,\n BlobValue,\n BooleanValue,\n DoubleValue,\n GeoPointValue,\n IntegerValue,\n NullValue,\n RefValue,\n StringValue,\n TimestampValue\n} from '../model/field_value';\n\nimport {\n FieldMask,\n FieldTransform,\n Mutation,\n PatchMutation,\n Precondition,\n SetMutation,\n TransformMutation\n} from '../model/mutation';\nimport { FieldPath } from '../model/path';\nimport { assert, fail } from '../util/assert';\nimport { Code, FirestoreError } from '../util/error';\nimport { isPlainObject, valueDescription } from '../util/input_validation';\nimport { primitiveComparator } from '../util/misc';\nimport { Dict, forEach, isEmpty } from '../util/obj';\nimport { SortedMap } from '../util/sorted_map';\nimport * as typeUtils from '../util/types';\n\nimport {\n ArrayRemoveTransformOperation,\n ArrayUnionTransformOperation,\n NumericIncrementTransformOperation,\n ServerTimestampTransform\n} from '../model/transform_operation';\nimport { SortedSet } from '../util/sorted_set';\nimport { Blob } from './blob';\nimport {\n FieldPath as ExternalFieldPath,\n fromDotSeparatedString\n} from './field_path';\nimport {\n ArrayRemoveFieldValueImpl,\n ArrayUnionFieldValueImpl,\n DeleteFieldValueImpl,\n FieldValueImpl,\n NumericIncrementFieldValueImpl,\n ServerTimestampFieldValueImpl\n} from './field_value';\nimport { GeoPoint } from './geo_point';\n\nconst RESERVED_FIELD_REGEX = /^__.*__$/;\n\n/** The result of parsing document data (e.g. for a setData call). */\nexport class ParsedSetData {\n constructor(\n readonly data: ObjectValue,\n readonly fieldMask: FieldMask | null,\n readonly fieldTransforms: FieldTransform[]\n ) {}\n\n toMutations(key: DocumentKey, precondition: Precondition): Mutation[] {\n const mutations = [] as Mutation[];\n if (this.fieldMask !== null) {\n mutations.push(\n new PatchMutation(key, this.data, this.fieldMask, precondition)\n );\n } else {\n mutations.push(new SetMutation(key, this.data, precondition));\n }\n if (this.fieldTransforms.length > 0) {\n mutations.push(new TransformMutation(key, this.fieldTransforms));\n }\n return mutations;\n }\n}\n\n/** The result of parsing \"update\" data (i.e. for an updateData call). */\nexport class ParsedUpdateData {\n constructor(\n readonly data: ObjectValue,\n readonly fieldMask: FieldMask,\n readonly fieldTransforms: FieldTransform[]\n ) {}\n\n toMutations(key: DocumentKey, precondition: Precondition): Mutation[] {\n const mutations = [\n new PatchMutation(key, this.data, this.fieldMask, precondition)\n ] as Mutation[];\n if (this.fieldTransforms.length > 0) {\n mutations.push(new TransformMutation(key, this.fieldTransforms));\n }\n return mutations;\n }\n}\n\n/*\n * Represents what type of API method provided the data being parsed; useful\n * for determining which error conditions apply during parsing and providing\n * better error messages.\n */\nenum UserDataSource {\n Set,\n Update,\n MergeSet,\n /**\n * Indicates the source is a where clause, cursor bound, arrayUnion()\n * element, etc. Of note, isWrite(source) will return false.\n */\n Argument,\n /**\n * Indicates that the source is an Argument that may directly contain nested\n * arrays (e.g. the operand of an `in` query).\n */\n ArrayArgument\n}\n\nfunction isWrite(dataSource: UserDataSource): boolean {\n switch (dataSource) {\n case UserDataSource.Set: // fall through\n case UserDataSource.MergeSet: // fall through\n case UserDataSource.Update:\n return true;\n case UserDataSource.Argument:\n case UserDataSource.ArrayArgument:\n return false;\n default:\n throw fail(`Unexpected case for UserDataSource: ${dataSource}`);\n }\n}\n\n/** A \"context\" object passed around while parsing user data. */\nclass ParseContext {\n readonly fieldTransforms: FieldTransform[];\n readonly fieldMask: FieldPath[];\n /**\n * Initializes a ParseContext with the given source and path.\n *\n * @param dataSource Indicates what kind of API method this data came from.\n * @param methodName The name of the method the user called to create this\n * ParseContext.\n * @param path A path within the object being parsed. This could be an empty\n * path (in which case the context represents the root of the data being\n * parsed), or a nonempty path (indicating the context represents a nested\n * location within the data).\n * @param arrayElement Whether or not this context corresponds to an element\n * of an array.\n * @param fieldTransforms A mutable list of field transforms encountered while\n * parsing the data.\n * @param fieldMask A mutable list of field paths encountered while parsing\n * the data.\n *\n * TODO(b/34871131): We don't support array paths right now, so path can be\n * null to indicate the context represents any location within an array (in\n * which case certain features will not work and errors will be somewhat\n * compromised).\n */\n constructor(\n readonly dataSource: UserDataSource,\n readonly methodName: string,\n readonly path: FieldPath | null,\n readonly arrayElement?: boolean,\n fieldTransforms?: FieldTransform[],\n fieldMask?: FieldPath[]\n ) {\n // Minor hack: If fieldTransforms is undefined, we assume this is an\n // external call and we need to validate the entire path.\n if (fieldTransforms === undefined) {\n this.validatePath();\n }\n this.arrayElement = arrayElement !== undefined ? arrayElement : false;\n this.fieldTransforms = fieldTransforms || [];\n this.fieldMask = fieldMask || [];\n }\n\n childContextForField(field: string): ParseContext {\n const childPath = this.path == null ? null : this.path.child(field);\n const context = new ParseContext(\n this.dataSource,\n this.methodName,\n childPath,\n /*arrayElement=*/ false,\n this.fieldTransforms,\n this.fieldMask\n );\n context.validatePathSegment(field);\n return context;\n }\n\n childContextForFieldPath(field: FieldPath): ParseContext {\n const childPath = this.path == null ? null : this.path.child(field);\n const context = new ParseContext(\n this.dataSource,\n this.methodName,\n childPath,\n /*arrayElement=*/ false,\n this.fieldTransforms,\n this.fieldMask\n );\n context.validatePath();\n return context;\n }\n\n childContextForArray(index: number): ParseContext {\n // TODO(b/34871131): We don't support array paths right now; so make path\n // null.\n return new ParseContext(\n this.dataSource,\n this.methodName,\n /*path=*/ null,\n /*arrayElement=*/ true,\n this.fieldTransforms,\n this.fieldMask\n );\n }\n\n createError(reason: string): Error {\n const fieldDescription =\n this.path === null || this.path.isEmpty()\n ? ''\n : ` (found in field ${this.path.toString()})`;\n return new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function ${this.methodName}() called with invalid data. ` +\n reason +\n fieldDescription\n );\n }\n\n /** Returns 'true' if 'fieldPath' was traversed when creating this context. */\n contains(fieldPath: FieldPath): boolean {\n return (\n this.fieldMask.find(field => fieldPath.isPrefixOf(field)) !== undefined ||\n this.fieldTransforms.find(transform =>\n fieldPath.isPrefixOf(transform.field)\n ) !== undefined\n );\n }\n\n private validatePath(): void {\n // TODO(b/34871131): Remove null check once we have proper paths for fields\n // within arrays.\n if (this.path === null) {\n return;\n }\n for (let i = 0; i < this.path.length; i++) {\n this.validatePathSegment(this.path.get(i));\n }\n }\n\n private validatePathSegment(segment: string): void {\n if (segment.length === 0) {\n throw this.createError('Document fields must not be empty');\n }\n if (isWrite(this.dataSource) && RESERVED_FIELD_REGEX.test(segment)) {\n throw this.createError('Document fields cannot begin and end with \"__\"');\n }\n }\n}\n/**\n * An interface that allows arbitrary pre-converting of user data. This\n * abstraction allows for, e.g.:\n * * The public API to convert DocumentReference objects to DocRef objects,\n * avoiding a circular dependency between user_data_converter.ts and\n * database.ts\n * * Tests to convert test-only sentinels (e.g. '<DELETE>') into types\n * compatible with UserDataConverter.\n *\n * Returns the converted value (can return back the input to act as a no-op).\n *\n * It can also throw an Error which will be wrapped into a friendly message.\n */\nexport type DataPreConverter = (input: unknown) => unknown;\n\n/**\n * A placeholder object for DocumentReferences in this file, in order to\n * avoid a circular dependency. See the comments for `DataPreConverter` for\n * the full context.\n */\nexport class DocumentKeyReference {\n constructor(public databaseId: DatabaseId, public key: DocumentKey) {}\n}\n\n/**\n * Helper for parsing raw user input (provided via the API) into internal model\n * classes.\n */\nexport class UserDataConverter {\n constructor(private preConverter: DataPreConverter) {}\n\n /** Parse document data from a non-merge set() call. */\n parseSetData(methodName: string, input: unknown): ParsedSetData {\n const context = new ParseContext(\n UserDataSource.Set,\n methodName,\n FieldPath.EMPTY_PATH\n );\n validatePlainObject('Data must be an object, but it was:', context, input);\n\n const updateData = this.parseData(input, context);\n\n return new ParsedSetData(\n updateData as ObjectValue,\n /* fieldMask= */ null,\n context.fieldTransforms\n );\n }\n\n /** Parse document data from a set() call with '{merge:true}'. */\n parseMergeData(\n methodName: string,\n input: unknown,\n fieldPaths?: Array<string | firestore.FieldPath>\n ): ParsedSetData {\n const context = new ParseContext(\n UserDataSource.MergeSet,\n methodName,\n FieldPath.EMPTY_PATH\n );\n validatePlainObject('Data must be an object, but it was:', context, input);\n\n const updateData = this.parseData(input, context) as ObjectValue;\n let fieldMask: FieldMask;\n let fieldTransforms: FieldTransform[];\n\n if (!fieldPaths) {\n fieldMask = FieldMask.fromArray(context.fieldMask);\n fieldTransforms = context.fieldTransforms;\n } else {\n let validatedFieldPaths = new SortedSet<FieldPath>(FieldPath.comparator);\n\n for (const stringOrFieldPath of fieldPaths) {\n let fieldPath: FieldPath;\n\n if (stringOrFieldPath instanceof ExternalFieldPath) {\n fieldPath = stringOrFieldPath._internalPath;\n } else if (typeof stringOrFieldPath === 'string') {\n fieldPath = fieldPathFromDotSeparatedString(\n methodName,\n stringOrFieldPath\n );\n } else {\n throw fail(\n 'Expected stringOrFieldPath to be a string or a FieldPath'\n );\n }\n\n if (!context.contains(fieldPath)) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Field '${fieldPath}' is specified in your field mask but missing from your input data.`\n );\n }\n\n validatedFieldPaths = validatedFieldPaths.add(fieldPath);\n }\n\n fieldMask = FieldMask.fromSet(validatedFieldPaths);\n fieldTransforms = context.fieldTransforms.filter(transform =>\n fieldMask.covers(transform.field)\n );\n }\n return new ParsedSetData(\n updateData as ObjectValue,\n fieldMask,\n fieldTransforms\n );\n }\n\n /** Parse update data from an update() call. */\n parseUpdateData(methodName: string, input: unknown): ParsedUpdateData {\n const context = new ParseContext(\n UserDataSource.Update,\n methodName,\n FieldPath.EMPTY_PATH\n );\n validatePlainObject('Data must be an object, but it was:', context, input);\n\n let fieldMaskPaths = new SortedSet<FieldPath>(FieldPath.comparator);\n let updateData = ObjectValue.EMPTY;\n forEach(input as Dict<unknown>, (key, value) => {\n const path = fieldPathFromDotSeparatedString(methodName, key);\n\n const childContext = context.childContextForFieldPath(path);\n value = this.runPreConverter(value, childContext);\n if (value instanceof DeleteFieldValueImpl) {\n // Add it to the field mask, but don't add anything to updateData.\n fieldMaskPaths = fieldMaskPaths.add(path);\n } else {\n const parsedValue = this.parseData(value, childContext);\n if (parsedValue != null) {\n fieldMaskPaths = fieldMaskPaths.add(path);\n updateData = updateData.set(path, parsedValue);\n }\n }\n });\n\n const mask = FieldMask.fromSet(fieldMaskPaths);\n return new ParsedUpdateData(updateData, mask, context.fieldTransforms);\n }\n\n /** Parse update data from a list of field/value arguments. */\n parseUpdateVarargs(\n methodName: string,\n field: string | ExternalFieldPath,\n value: unknown,\n moreFieldsAndValues: unknown[]\n ): ParsedUpdateData {\n const context = new ParseContext(\n UserDataSource.Update,\n methodName,\n FieldPath.EMPTY_PATH\n );\n const keys = [fieldPathFromArgument(methodName, field)];\n const values = [value];\n\n if (moreFieldsAndValues.length % 2 !== 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function ${methodName}() needs to be called with an even number ` +\n 'of arguments that alternate between field names and values.'\n );\n }\n\n for (let i = 0; i < moreFieldsAndValues.length; i += 2) {\n keys.push(\n fieldPathFromArgument(\n methodName,\n moreFieldsAndValues[i] as string | ExternalFieldPath\n )\n );\n values.push(moreFieldsAndValues[i + 1]);\n }\n\n let fieldMaskPaths = new SortedSet<FieldPath>(FieldPath.comparator);\n let updateData = ObjectValue.EMPTY;\n\n for (let i = 0; i < keys.length; ++i) {\n const path = keys[i];\n const childContext = context.childContextForFieldPath(path);\n const value = this.runPreConverter(values[i], childContext);\n if (value instanceof DeleteFieldValueImpl) {\n // Add it to the field mask, but don't add anything to updateData.\n fieldMaskPaths = fieldMaskPaths.add(path);\n } else {\n const parsedValue = this.parseData(value, childContext);\n if (parsedValue != null) {\n fieldMaskPaths = fieldMaskPaths.add(path);\n updateData = updateData.set(path, parsedValue);\n }\n }\n }\n\n const mask = FieldMask.fromSet(fieldMaskPaths);\n return new ParsedUpdateData(updateData, mask, context.fieldTransforms);\n }\n\n /**\n * Parse a \"query value\" (e.g. value in a where filter or a value in a cursor\n * bound).\n *\n * @param allowArrays Whether the query value is an array that may directly\n * contain additional arrays (e.g. the operand of an `in` query).\n */\n parseQueryValue(\n methodName: string,\n input: unknown,\n allowArrays = false\n ): FieldValue {\n const context = new ParseContext(\n allowArrays ? UserDataSource.ArrayArgument : UserDataSource.Argument,\n methodName,\n FieldPath.EMPTY_PATH\n );\n const parsed = this.parseData(input, context);\n assert(parsed != null, 'Parsed data should not be null.');\n assert(\n context.fieldTransforms.length === 0,\n 'Field transforms should have been disallowed.'\n );\n return parsed;\n }\n\n /** Sends data through this.preConverter, handling any thrown errors. */\n private runPreConverter(input: unknown, context: ParseContext): unknown {\n try {\n return this.preConverter(input);\n } catch (e) {\n const message = errorMessage(e);\n throw context.createError(message);\n }\n }\n\n /**\n * Internal helper for parsing user data.\n *\n * @param input Data to be parsed.\n * @param context A context object representing the current path being parsed,\n * the source of the data being parsed, etc.\n * @return The parsed value, or null if the value was a FieldValue sentinel\n * that should not be included in the resulting parsed data.\n */\n private parseData(input: unknown, context: ParseContext): FieldValue | null {\n input = this.runPreConverter(input, context);\n if (looksLikeJsonObject(input)) {\n validatePlainObject('Unsupported field value:', context, input);\n return this.parseObject(input as Dict<unknown>, context);\n } else if (input instanceof FieldValueImpl) {\n // FieldValues usually parse into transforms (except FieldValue.delete())\n // in which case we do not want to include this field in our parsed data\n // (as doing so will overwrite the field directly prior to the transform\n // trying to transform it). So we don't add this location to\n // context.fieldMask and we return null as our parsing result.\n this.parseSentinelFieldValue(input, context);\n return null;\n } else {\n // If context.path is null we are inside an array and we don't support\n // field mask paths more granular than the top-level array.\n if (context.path) {\n context.fieldMask.push(context.path);\n }\n\n if (input instanceof Array) {\n // TODO(b/34871131): Include the path containing the array in the error\n // message.\n // In the case of IN queries, the parsed data is an array (representing\n // the set of values to be included for the IN query) that may directly\n // contain additional arrays (each representing an individual field\n // value), so we disable this validation.\n if (\n context.arrayElement &&\n context.dataSource !== UserDataSource.ArrayArgument\n ) {\n throw context.createError('Nested arrays are not supported');\n }\n return this.parseArray(input as unknown[], context);\n } else {\n return this.parseScalarValue(input, context);\n }\n }\n }\n\n private parseObject(obj: Dict<unknown>, context: ParseContext): FieldValue {\n let result = new SortedMap<string, FieldValue>(primitiveComparator);\n\n if (isEmpty(obj)) {\n // If we encounter an empty object, we explicitly add it to the update\n // mask to ensure that the server creates a map entry.\n if (context.path && context.path.length > 0) {\n context.fieldMask.push(context.path);\n }\n } else {\n forEach(obj, (key: string, val: unknown) => {\n const parsedValue = this.parseData(\n val,\n context.childContextForField(key)\n );\n if (parsedValue != null) {\n result = result.insert(key, parsedValue);\n }\n });\n }\n\n return new ObjectValue(result);\n }\n\n private parseArray(array: unknown[], context: ParseContext): FieldValue {\n const result = [] as FieldValue[];\n let entryIndex = 0;\n for (const entry of array) {\n let parsedEntry = this.parseData(\n entry,\n context.childContextForArray(entryIndex)\n );\n if (parsedEntry == null) {\n // Just include nulls in the array for fields being replaced with a\n // sentinel.\n parsedEntry = NullValue.INSTANCE;\n }\n result.push(parsedEntry);\n entryIndex++;\n }\n return new ArrayValue(result);\n }\n\n /**\n * \"Parses\" the provided FieldValueImpl, adding any necessary transforms to\n * context.fieldTransforms.\n */\n private parseSentinelFieldValue(\n value: FieldValueImpl,\n context: ParseContext\n ): void {\n // Sentinels are only supported with writes, and not within arrays.\n if (!isWrite(context.dataSource)) {\n throw context.createError(\n `${value._methodName}() can only be used with update() and set()`\n );\n }\n if (context.path === null) {\n throw context.createError(\n `${value._methodName}() is not currently supported inside arrays`\n );\n }\n\n if (value instanceof DeleteFieldValueImpl) {\n if (context.dataSource === UserDataSource.MergeSet) {\n // No transform to add for a delete, but we need to add it to our\n // fieldMask so it gets deleted.\n context.fieldMask.push(context.path);\n } else if (context.dataSource === UserDataSource.Update) {\n assert(\n context.path.length > 0,\n 'FieldValue.delete() at the top level should have already' +\n ' been handled.'\n );\n throw context.createError(\n 'FieldValue.delete() can only appear at the top level ' +\n 'of your update data'\n );\n } else {\n // We shouldn't encounter delete sentinels for queries or non-merge set() calls.\n throw context.createError(\n 'FieldValue.delete() cannot be used with set() unless you pass ' +\n '{merge:true}'\n );\n }\n } else if (value instanceof ServerTimestampFieldValueImpl) {\n context.fieldTransforms.push(\n new FieldTransform(context.path, ServerTimestampTransform.instance)\n );\n } else if (value instanceof ArrayUnionFieldValueImpl) {\n const parsedElements = this.parseArrayTransformElements(\n value._methodName,\n value._elements\n );\n const arrayUnion = new ArrayUnionTransformOperation(parsedElements);\n context.fieldTransforms.push(\n new FieldTransform(context.path, arrayUnion)\n );\n } else if (value instanceof ArrayRemoveFieldValueImpl) {\n const parsedElements = this.parseArrayTransformElements(\n value._methodName,\n value._elements\n );\n const arrayRemove = new ArrayRemoveTransformOperation(parsedElements);\n context.fieldTransforms.push(\n new FieldTransform(context.path, arrayRemove)\n );\n } else if (value instanceof NumericIncrementFieldValueImpl) {\n const operand = this.parseQueryValue(\n 'FieldValue.increment',\n value._operand\n ) as NumberValue;\n const numericIncrement = new NumericIncrementTransformOperation(operand);\n context.fieldTransforms.push(\n new FieldTransform(context.path, numericIncrement)\n );\n } else {\n fail('Unknown FieldValue type: ' + value);\n }\n }\n\n /**\n * Helper to parse a scalar value (i.e. not an Object, Array, or FieldValue)\n *\n * @return The parsed value\n */\n private parseScalarValue(value: unknown, context: ParseContext): FieldValue {\n if (value === null) {\n return NullValue.INSTANCE;\n } else if (typeof value === 'number') {\n if (typeUtils.isSafeInteger(value)) {\n return new IntegerValue(value);\n } else {\n return new DoubleValue(value);\n }\n } else if (typeof value === 'boolean') {\n return BooleanValue.of(value);\n } else if (typeof value === 'string') {\n return new StringValue(value);\n } else if (value instanceof Date) {\n return new TimestampValue(Timestamp.fromDate(value));\n } else if (value instanceof Timestamp) {\n // Firestore backend truncates precision down to microseconds. To ensure\n // offline mode works the same with regards to truncation, perform the\n // truncation immediately without waiting for the backend to do that.\n return new TimestampValue(\n new Timestamp(\n value.seconds,\n Math.floor(value.nanoseconds / 1000) * 1000\n )\n );\n } else if (value instanceof GeoPoint) {\n return new GeoPointValue(value);\n } else if (value instanceof Blob) {\n return new BlobValue(value);\n } else if (value instanceof DocumentKeyReference) {\n return new RefValue(value.databaseId, value.key);\n } else {\n throw context.createError(\n `Unsupported field value: ${valueDescription(value)}`\n );\n }\n }\n\n private parseArrayTransformElements(\n methodName: string,\n elements: unknown[]\n ): FieldValue[] {\n return elements.map((element, i) => {\n // Although array transforms are used with writes, the actual elements\n // being unioned or removed are not considered writes since they cannot\n // contain any FieldValue sentinels, etc.\n const context = new ParseContext(\n UserDataSource.Argument,\n methodName,\n FieldPath.EMPTY_PATH\n );\n return this.parseData(element, context.childContextForArray(i))!;\n });\n }\n}\n\n/**\n * Checks whether an object looks like a JSON object that should be converted\n * into a struct. Normal class/prototype instances are considered to look like\n * JSON objects since they should be converted to a struct value. Arrays, Dates,\n * GeoPoints, etc. are not considered to look like JSON objects since they map\n * to specific FieldValue types other than ObjectValue.\n */\nfunction looksLikeJsonObject(input: unknown): boolean {\n return (\n typeof input === 'object' &&\n input !== null &&\n !(input instanceof Array) &&\n !(input instanceof Date) &&\n !(input instanceof Timestamp) &&\n !(input instanceof GeoPoint) &&\n !(input instanceof Blob) &&\n !(input instanceof DocumentKeyReference) &&\n !(input instanceof FieldValueImpl)\n );\n}\n\nfunction validatePlainObject(\n message: string,\n context: ParseContext,\n input: unknown\n): void {\n if (!looksLikeJsonObject(input) || !isPlainObject(input)) {\n const description = valueDescription(input);\n if (description === 'an object') {\n // Massage the error if it was an object.\n throw context.createError(message + ' a custom object');\n } else {\n throw context.createError(message + ' ' + description);\n }\n }\n}\n\n/**\n * Helper that calls fromDotSeparatedString() but wraps any error thrown.\n */\nexport function fieldPathFromArgument(\n methodName: string,\n path: string | ExternalFieldPath\n): FieldPath {\n if (path instanceof ExternalFieldPath) {\n return path._internalPath;\n } else if (typeof path === 'string') {\n return fieldPathFromDotSeparatedString(methodName, path);\n } else {\n const message = 'Field path arguments must be of type string or FieldPath.';\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function ${methodName}() called with invalid data. ${message}`\n );\n }\n}\n\n/**\n * Wraps fromDotSeparatedString with an error message about the method that\n * was thrown.\n * @param methodName The publicly visible method name\n * @param path The dot-separated string form of a field path which will be split\n * on dots.\n */\nfunction fieldPathFromDotSeparatedString(\n methodName: string,\n path: string\n): FieldPath {\n try {\n return fromDotSeparatedString(path)._internalPath;\n } catch (e) {\n const message = errorMessage(e);\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function ${methodName}() called with invalid data. ${message}`\n );\n }\n}\n\n/**\n * Extracts the message from a caught exception, which should be an Error object\n * though JS doesn't guarantee that.\n */\nfunction errorMessage(error: Error | object): string {\n return error instanceof Error ? error.message : error.toString();\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AsyncQueue, TimerId } from '../util/async_queue';\nimport * as log from '../util/log';\nimport { CancelablePromise } from '../util/promise';\nconst LOG_TAG = 'ExponentialBackoff';\n\n/**\n * Initial backoff time in milliseconds after an error.\n * Set to 1s according to https://cloud.google.com/apis/design/errors.\n */\nconst DEFAULT_BACKOFF_INITIAL_DELAY_MS = 1000;\n\nconst DEFAULT_BACKOFF_FACTOR = 1.5;\n\n/** Maximum backoff time in milliseconds */\nconst DEFAULT_BACKOFF_MAX_DELAY_MS = 60 * 1000;\n\n/**\n * A helper for running delayed tasks following an exponential backoff curve\n * between attempts.\n *\n * Each delay is made up of a \"base\" delay which follows the exponential\n * backoff curve, and a +/- 50% \"jitter\" that is calculated and added to the\n * base delay. This prevents clients from accidentally synchronizing their\n * delays causing spikes of load to the backend.\n */\nexport class ExponentialBackoff {\n private currentBaseMs: number = 0;\n private timerPromise: CancelablePromise<void> | null = null;\n /** The last backoff attempt, as epoch milliseconds. */\n private lastAttemptTime = Date.now();\n\n constructor(\n /**\n * The AsyncQueue to run backoff operations on.\n */\n private readonly queue: AsyncQueue,\n /**\n * The ID to use when scheduling backoff operations on the AsyncQueue.\n */\n private readonly timerId: TimerId,\n /**\n * The initial delay (used as the base delay on the first retry attempt).\n * Note that jitter will still be applied, so the actual delay could be as\n * little as 0.5*initialDelayMs.\n */\n private readonly initialDelayMs: number = DEFAULT_BACKOFF_INITIAL_DELAY_MS,\n /**\n * The multiplier to use to determine the extended base delay after each\n * attempt.\n */\n private readonly backoffFactor: number = DEFAULT_BACKOFF_FACTOR,\n /**\n * The maximum base delay after which no further backoff is performed.\n * Note that jitter will still be applied, so the actual delay could be as\n * much as 1.5*maxDelayMs.\n */\n private readonly maxDelayMs: number = DEFAULT_BACKOFF_MAX_DELAY_MS\n ) {\n this.reset();\n }\n\n /**\n * Resets the backoff delay.\n *\n * The very next backoffAndWait() will have no delay. If it is called again\n * (i.e. due to an error), initialDelayMs (plus jitter) will be used, and\n * subsequent ones will increase according to the backoffFactor.\n */\n reset(): void {\n this.currentBaseMs = 0;\n }\n\n /**\n * Resets the backoff delay to the maximum delay (e.g. for use after a\n * RESOURCE_EXHAUSTED error).\n */\n resetToMax(): void {\n this.currentBaseMs = this.maxDelayMs;\n }\n\n /**\n * Returns a promise that resolves after currentDelayMs, and increases the\n * delay for any subsequent attempts. If there was a pending backoff operation\n * already, it will be canceled.\n */\n backoffAndRun(op: () => Promise<void>): void {\n // Cancel any pending backoff operation.\n this.cancel();\n\n // First schedule using the current base (which may be 0 and should be\n // honored as such).\n const desiredDelayWithJitterMs = Math.floor(\n this.currentBaseMs + this.jitterDelayMs()\n );\n\n // Guard against lastAttemptTime being in the future due to a clock change.\n const delaySoFarMs = Math.max(0, Date.now() - this.lastAttemptTime);\n\n // Guard against the backoff delay already being past.\n const remainingDelayMs = Math.max(\n 0,\n desiredDelayWithJitterMs - delaySoFarMs\n );\n\n if (this.currentBaseMs > 0) {\n log.debug(\n LOG_TAG,\n `Backing off for ${remainingDelayMs} ms ` +\n `(base delay: ${this.currentBaseMs} ms, ` +\n `delay with jitter: ${desiredDelayWithJitterMs} ms, ` +\n `last attempt: ${delaySoFarMs} ms ago)`\n );\n }\n\n this.timerPromise = this.queue.enqueueAfterDelay(\n this.timerId,\n remainingDelayMs,\n () => {\n this.lastAttemptTime = Date.now();\n return op();\n }\n );\n\n // Apply backoff factor to determine next delay and ensure it is within\n // bounds.\n this.currentBaseMs *= this.backoffFactor;\n if (this.currentBaseMs < this.initialDelayMs) {\n this.currentBaseMs = this.initialDelayMs;\n }\n if (this.currentBaseMs > this.maxDelayMs) {\n this.currentBaseMs = this.maxDelayMs;\n }\n }\n\n cancel(): void {\n if (this.timerPromise !== null) {\n this.timerPromise.cancel();\n this.timerPromise = null;\n }\n }\n\n /** Returns a random value in the range [-currentBaseMs/2, currentBaseMs/2] */\n private jitterDelayMs(): number {\n return (Math.random() - 0.5) * this.currentBaseMs;\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { CredentialsProvider, Token } from '../api/credentials';\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { ProtoByteString, TargetId } from '../core/types';\nimport { TargetData } from '../local/target_data';\nimport { Mutation, MutationResult } from '../model/mutation';\nimport * as api from '../protos/firestore_proto_api';\nimport { assert } from '../util/assert';\nimport { AsyncQueue, TimerId } from '../util/async_queue';\nimport { Code, FirestoreError } from '../util/error';\nimport * as log from '../util/log';\n\nimport { CancelablePromise } from '../util/promise';\nimport { isNullOrUndefined } from '../util/types';\nimport { ExponentialBackoff } from './backoff';\nimport { Connection, Stream } from './connection';\nimport { JsonProtoSerializer } from './serializer';\nimport { WatchChange } from './watch_change';\nimport { emptyByteString } from '../platform/platform';\n\nconst LOG_TAG = 'PersistentStream';\n\n// The generated proto interfaces for these class are missing the database\n// field. So we add it here.\n// TODO(b/36015800): Remove this once the api generator is fixed.\ninterface ListenRequest extends api.ListenRequest {\n database?: string;\n}\nexport interface WriteRequest extends api.WriteRequest {\n database?: string;\n}\n/**\n * PersistentStream can be in one of 5 states (each described in detail below)\n * based on the following state transition diagram:\n *\n * start() called auth & connection succeeded\n * INITIAL ----------------> STARTING -----------------------------> OPEN\n * ^ | |\n * | | error occurred |\n * | \\-----------------------------v-----/\n * | |\n * backoff | |\n * elapsed | start() called |\n * \\--- BACKOFF <---------------- ERROR\n *\n * [any state] --------------------------> INITIAL\n * stop() called or\n * idle timer expired\n */\nenum PersistentStreamState {\n /**\n * The streaming RPC is not yet running and there's no error condition.\n * Calling start() will start the stream immediately without backoff.\n * While in this state isStarted() will return false.\n */\n Initial,\n\n /**\n * The stream is starting, either waiting for an auth token or for the stream\n * to successfully open. While in this state, isStarted() will return true but\n * isOpen() will return false.\n */\n Starting,\n\n /**\n * The streaming RPC is up and running. Requests and responses can flow\n * freely. Both isStarted() and isOpen() will return true.\n */\n Open,\n\n /**\n * The stream encountered an error. The next start attempt will back off.\n * While in this state isStarted() will return false.\n */\n Error,\n\n /**\n * An in-between state after an error where the stream is waiting before\n * re-starting. After waiting is complete, the stream will try to open.\n * While in this state isStarted() will return true but isOpen() will return\n * false.\n */\n Backoff\n}\n\n/**\n * Provides a common interface that is shared by the listeners for stream\n * events by the concrete implementation classes.\n */\nexport interface PersistentStreamListener {\n /**\n * Called after the stream was established and can accept outgoing\n * messages\n */\n onOpen: () => Promise<void>;\n /**\n * Called after the stream has closed. If there was an error, the\n * FirestoreError will be set.\n */\n onClose: (err?: FirestoreError) => Promise<void>;\n}\n\n/** The time a stream stays open after it is marked idle. */\nconst IDLE_TIMEOUT_MS = 60 * 1000;\n\n/**\n * A PersistentStream is an abstract base class that represents a streaming RPC\n * to the Firestore backend. It's built on top of the connections own support\n * for streaming RPCs, and adds several critical features for our clients:\n *\n * - Exponential backoff on failure\n * - Authentication via CredentialsProvider\n * - Dispatching all callbacks into the shared worker queue\n * - Closing idle streams after 60 seconds of inactivity\n *\n * Subclasses of PersistentStream implement serialization of models to and\n * from the JSON representation of the protocol buffers for a specific\n * streaming RPC.\n *\n * ## Starting and Stopping\n *\n * Streaming RPCs are stateful and need to be start()ed before messages can\n * be sent and received. The PersistentStream will call the onOpen() function\n * of the listener once the stream is ready to accept requests.\n *\n * Should a start() fail, PersistentStream will call the registered onClose()\n * listener with a FirestoreError indicating what went wrong.\n *\n * A PersistentStream can be started and stopped repeatedly.\n *\n * Generic types:\n * SendType: The type of the outgoing message of the underlying\n * connection stream\n * ReceiveType: The type of the incoming message of the underlying\n * connection stream\n * ListenerType: The type of the listener that will be used for callbacks\n */\nexport abstract class PersistentStream<\n SendType,\n ReceiveType,\n ListenerType extends PersistentStreamListener\n> {\n private state = PersistentStreamState.Initial;\n /**\n * A close count that's incremented every time the stream is closed; used by\n * getCloseGuardedDispatcher() to invalidate callbacks that happen after\n * close.\n */\n private closeCount = 0;\n\n private idleTimer: CancelablePromise<void> | null = null;\n private stream: Stream<SendType, ReceiveType> | null = null;\n\n protected backoff: ExponentialBackoff;\n\n constructor(\n private queue: AsyncQueue,\n connectionTimerId: TimerId,\n private idleTimerId: TimerId,\n protected connection: Connection,\n private credentialsProvider: CredentialsProvider,\n protected listener: ListenerType\n ) {\n this.backoff = new ExponentialBackoff(queue, connectionTimerId);\n }\n\n /**\n * Returns true if start() has been called and no error has occurred. True\n * indicates the stream is open or in the process of opening (which\n * encompasses respecting backoff, getting auth tokens, and starting the\n * actual RPC). Use isOpen() to determine if the stream is open and ready for\n * outbound requests.\n */\n isStarted(): boolean {\n return (\n this.state === PersistentStreamState.Starting ||\n this.state === PersistentStreamState.Open ||\n this.state === PersistentStreamState.Backoff\n );\n }\n\n /**\n * Returns true if the underlying RPC is open (the onOpen() listener has been\n * called) and the stream is ready for outbound requests.\n */\n isOpen(): boolean {\n return this.state === PersistentStreamState.Open;\n }\n\n /**\n * Starts the RPC. Only allowed if isStarted() returns false. The stream is\n * not immediately ready for use: onOpen() will be invoked when the RPC is\n * ready for outbound requests, at which point isOpen() will return true.\n *\n * When start returns, isStarted() will return true.\n */\n start(): void {\n if (this.state === PersistentStreamState.Error) {\n this.performBackoff();\n return;\n }\n\n assert(this.state === PersistentStreamState.Initial, 'Already started');\n this.auth();\n }\n\n /**\n * Stops the RPC. This call is idempotent and allowed regardless of the\n * current isStarted() state.\n *\n * When stop returns, isStarted() and isOpen() will both return false.\n */\n async stop(): Promise<void> {\n if (this.isStarted()) {\n await this.close(PersistentStreamState.Initial);\n }\n }\n\n /**\n * After an error the stream will usually back off on the next attempt to\n * start it. If the error warrants an immediate restart of the stream, the\n * sender can use this to indicate that the receiver should not back off.\n *\n * Each error will call the onClose() listener. That function can decide to\n * inhibit backoff if required.\n */\n inhibitBackoff(): void {\n assert(!this.isStarted(), 'Can only inhibit backoff in a stopped state');\n\n this.state = PersistentStreamState.Initial;\n this.backoff.reset();\n }\n\n /**\n * Marks this stream as idle. If no further actions are performed on the\n * stream for one minute, the stream will automatically close itself and\n * notify the stream's onClose() handler with Status.OK. The stream will then\n * be in a !isStarted() state, requiring the caller to start the stream again\n * before further use.\n *\n * Only streams that are in state 'Open' can be marked idle, as all other\n * states imply pending network operations.\n */\n markIdle(): void {\n // Starts the idle time if we are in state 'Open' and are not yet already\n // running a timer (in which case the previous idle timeout still applies).\n if (this.isOpen() && this.idleTimer === null) {\n this.idleTimer = this.queue.enqueueAfterDelay(\n this.idleTimerId,\n IDLE_TIMEOUT_MS,\n () => this.handleIdleCloseTimer()\n );\n }\n }\n\n /** Sends a message to the underlying stream. */\n protected sendRequest(msg: SendType): void {\n this.cancelIdleCheck();\n this.stream!.send(msg);\n }\n\n /** Called by the idle timer when the stream should close due to inactivity. */\n private async handleIdleCloseTimer(): Promise<void> {\n if (this.isOpen()) {\n // When timing out an idle stream there's no reason to force the stream into backoff when\n // it restarts so set the stream state to Initial instead of Error.\n return this.close(PersistentStreamState.Initial);\n }\n }\n\n /** Marks the stream as active again. */\n private cancelIdleCheck(): void {\n if (this.idleTimer) {\n this.idleTimer.cancel();\n this.idleTimer = null;\n }\n }\n\n /**\n * Closes the stream and cleans up as necessary:\n *\n * * closes the underlying GRPC stream;\n * * calls the onClose handler with the given 'error';\n * * sets internal stream state to 'finalState';\n * * adjusts the backoff timer based on the error\n *\n * A new stream can be opened by calling start().\n *\n * @param finalState the intended state of the stream after closing.\n * @param error the error the connection was closed with.\n */\n private async close(\n finalState: PersistentStreamState,\n error?: FirestoreError\n ): Promise<void> {\n assert(this.isStarted(), 'Only started streams should be closed.');\n assert(\n finalState === PersistentStreamState.Error || isNullOrUndefined(error),\n \"Can't provide an error when not in an error state.\"\n );\n\n // Cancel any outstanding timers (they're guaranteed not to execute).\n this.cancelIdleCheck();\n this.backoff.cancel();\n\n // Invalidates any stream-related callbacks (e.g. from auth or the\n // underlying stream), guaranteeing they won't execute.\n this.closeCount++;\n\n if (finalState !== PersistentStreamState.Error) {\n // If this is an intentional close ensure we don't delay our next connection attempt.\n this.backoff.reset();\n } else if (error && error.code === Code.RESOURCE_EXHAUSTED) {\n // Log the error. (Probably either 'quota exceeded' or 'max queue length reached'.)\n log.error(error.toString());\n log.error(\n 'Using maximum backoff delay to prevent overloading the backend.'\n );\n this.backoff.resetToMax();\n } else if (error && error.code === Code.UNAUTHENTICATED) {\n // \"unauthenticated\" error means the token was rejected. Try force refreshing it in case it\n // just expired.\n this.credentialsProvider.invalidateToken();\n }\n\n // Clean up the underlying stream because we are no longer interested in events.\n if (this.stream !== null) {\n this.tearDown();\n this.stream.close();\n this.stream = null;\n }\n\n // This state must be assigned before calling onClose() to allow the callback to\n // inhibit backoff or otherwise manipulate the state in its non-started state.\n this.state = finalState;\n\n // Notify the listener that the stream closed.\n await this.listener.onClose(error);\n }\n\n /**\n * Can be overridden to perform additional cleanup before the stream is closed.\n * Calling super.tearDown() is not required.\n */\n protected tearDown(): void {}\n\n /**\n * Used by subclasses to start the concrete RPC and return the underlying\n * connection stream.\n */\n protected abstract startRpc(\n token: Token | null\n ): Stream<SendType, ReceiveType>;\n\n /**\n * Called after the stream has received a message. The function will be\n * called on the right queue and must return a Promise.\n * @param message The message received from the stream.\n */\n protected abstract onMessage(message: ReceiveType): Promise<void>;\n\n private auth(): void {\n assert(\n this.state === PersistentStreamState.Initial,\n 'Must be in initial state to auth'\n );\n\n this.state = PersistentStreamState.Starting;\n\n const dispatchIfNotClosed = this.getCloseGuardedDispatcher(this.closeCount);\n\n // TODO(mikelehen): Just use dispatchIfNotClosed, but see TODO below.\n const closeCount = this.closeCount;\n\n this.credentialsProvider.getToken().then(\n token => {\n // Stream can be stopped while waiting for authentication.\n // TODO(mikelehen): We really should just use dispatchIfNotClosed\n // and let this dispatch onto the queue, but that opened a spec test can\n // of worms that I don't want to deal with in this PR.\n if (this.closeCount === closeCount) {\n // Normally we'd have to schedule the callback on the AsyncQueue.\n // However, the following calls are safe to be called outside the\n // AsyncQueue since they don't chain asynchronous calls\n this.startStream(token);\n }\n },\n (error: Error) => {\n dispatchIfNotClosed(() => {\n const rpcError = new FirestoreError(\n Code.UNKNOWN,\n 'Fetching auth token failed: ' + error.message\n );\n return this.handleStreamClose(rpcError);\n });\n }\n );\n }\n\n private startStream(token: Token | null): void {\n assert(\n this.state === PersistentStreamState.Starting,\n 'Trying to start stream in a non-starting state'\n );\n\n const dispatchIfNotClosed = this.getCloseGuardedDispatcher(this.closeCount);\n\n this.stream = this.startRpc(token);\n this.stream.onOpen(() => {\n dispatchIfNotClosed(() => {\n assert(\n this.state === PersistentStreamState.Starting,\n 'Expected stream to be in state Starting, but was ' + this.state\n );\n this.state = PersistentStreamState.Open;\n return this.listener!.onOpen();\n });\n });\n this.stream.onClose((error?: FirestoreError) => {\n dispatchIfNotClosed(() => {\n return this.handleStreamClose(error);\n });\n });\n this.stream.onMessage((msg: ReceiveType) => {\n dispatchIfNotClosed(() => {\n return this.onMessage(msg);\n });\n });\n }\n\n private performBackoff(): void {\n assert(\n this.state === PersistentStreamState.Error,\n 'Should only perform backoff when in Error state'\n );\n this.state = PersistentStreamState.Backoff;\n\n this.backoff.backoffAndRun(async () => {\n assert(\n this.state === PersistentStreamState.Backoff,\n 'Backoff elapsed but state is now: ' + this.state\n );\n\n this.state = PersistentStreamState.Initial;\n this.start();\n assert(this.isStarted(), 'PersistentStream should have started');\n });\n }\n\n // Visible for tests\n handleStreamClose(error?: FirestoreError): Promise<void> {\n assert(this.isStarted(), \"Can't handle server close on non-started stream\");\n log.debug(LOG_TAG, `close with error: ${error}`);\n\n this.stream = null;\n\n // In theory the stream could close cleanly, however, in our current model\n // we never expect this to happen because if we stop a stream ourselves,\n // this callback will never be called. To prevent cases where we retry\n // without a backoff accidentally, we set the stream to error in all cases.\n return this.close(PersistentStreamState.Error, error);\n }\n\n /**\n * Returns a \"dispatcher\" function that dispatches operations onto the\n * AsyncQueue but only runs them if closeCount remains unchanged. This allows\n * us to turn auth / stream callbacks into no-ops if the stream is closed /\n * re-opened, etc.\n */\n private getCloseGuardedDispatcher(\n startCloseCount: number\n ): (fn: () => Promise<void>) => void {\n return (fn: () => Promise<void>): void => {\n this.queue.enqueueAndForget(() => {\n if (this.closeCount === startCloseCount) {\n return fn();\n } else {\n log.debug(\n LOG_TAG,\n 'stream callback skipped by getCloseGuardedDispatcher.'\n );\n return Promise.resolve();\n }\n });\n };\n }\n}\n\n/** Listener for the PersistentWatchStream */\nexport interface WatchStreamListener extends PersistentStreamListener {\n /**\n * Called on a watchChange. The snapshot parameter will be MIN if the watch\n * change did not have a snapshot associated with it.\n */\n onWatchChange: (\n watchChange: WatchChange,\n snapshot: SnapshotVersion\n ) => Promise<void>;\n}\n\n/**\n * A PersistentStream that implements the Listen RPC.\n *\n * Once the Listen stream has called the onOpen() listener, any number of\n * listen() and unlisten() calls can be made to control what changes will be\n * sent from the server for ListenResponses.\n */\nexport class PersistentListenStream extends PersistentStream<\n api.ListenRequest,\n api.ListenResponse,\n WatchStreamListener\n> {\n constructor(\n queue: AsyncQueue,\n connection: Connection,\n credentials: CredentialsProvider,\n private serializer: JsonProtoSerializer,\n listener: WatchStreamListener\n ) {\n super(\n queue,\n TimerId.ListenStreamConnectionBackoff,\n TimerId.ListenStreamIdle,\n connection,\n credentials,\n listener\n );\n }\n\n protected startRpc(\n token: Token | null\n ): Stream<api.ListenRequest, api.ListenResponse> {\n return this.connection.openStream<api.ListenRequest, api.ListenResponse>(\n 'Listen',\n token\n );\n }\n\n protected onMessage(watchChangeProto: api.ListenResponse): Promise<void> {\n // A successful response means the stream is healthy\n this.backoff.reset();\n\n const watchChange = this.serializer.fromWatchChange(watchChangeProto);\n const snapshot = this.serializer.versionFromListenResponse(\n watchChangeProto\n );\n return this.listener!.onWatchChange(watchChange, snapshot);\n }\n\n /**\n * Registers interest in the results of the given target. If the target\n * includes a resumeToken it will be included in the request. Results that\n * affect the target will be streamed back as WatchChange messages that\n * reference the targetId.\n */\n watch(targetData: TargetData): void {\n const request: ListenRequest = {};\n request.database = this.serializer.encodedDatabaseId;\n request.addTarget = this.serializer.toTarget(targetData);\n\n const labels = this.serializer.toListenRequestLabels(targetData);\n if (labels) {\n request.labels = labels;\n }\n\n this.sendRequest(request);\n }\n\n /**\n * Unregisters interest in the results of the target associated with the\n * given targetId.\n */\n unwatch(targetId: TargetId): void {\n const request: ListenRequest = {};\n request.database = this.serializer.encodedDatabaseId;\n request.removeTarget = targetId;\n this.sendRequest(request);\n }\n}\n\n/** Listener for the PersistentWriteStream */\nexport interface WriteStreamListener extends PersistentStreamListener {\n /**\n * Called by the PersistentWriteStream upon a successful handshake response\n * from the server, which is the receiver's cue to send any pending writes.\n */\n onHandshakeComplete: () => Promise<void>;\n\n /**\n * Called by the PersistentWriteStream upon receiving a StreamingWriteResponse\n * from the server that contains a mutation result.\n */\n onMutationResult: (\n commitVersion: SnapshotVersion,\n results: MutationResult[]\n ) => Promise<void>;\n}\n\n/**\n * A Stream that implements the Write RPC.\n *\n * The Write RPC requires the caller to maintain special streamToken\n * state in between calls, to help the server understand which responses the\n * client has processed by the time the next request is made. Every response\n * will contain a streamToken; this value must be passed to the next\n * request.\n *\n * After calling start() on this stream, the next request must be a handshake,\n * containing whatever streamToken is on hand. Once a response to this\n * request is received, all pending mutations may be submitted. When\n * submitting multiple batches of mutations at the same time, it's\n * okay to use the same streamToken for the calls to writeMutations.\n *\n * TODO(b/33271235): Use proto types\n */\nexport class PersistentWriteStream extends PersistentStream<\n api.WriteRequest,\n api.WriteResponse,\n WriteStreamListener\n> {\n private handshakeComplete_ = false;\n\n constructor(\n queue: AsyncQueue,\n connection: Connection,\n credentials: CredentialsProvider,\n private serializer: JsonProtoSerializer,\n listener: WriteStreamListener\n ) {\n super(\n queue,\n TimerId.WriteStreamConnectionBackoff,\n TimerId.WriteStreamIdle,\n connection,\n credentials,\n listener\n );\n }\n\n /**\n * The last received stream token from the server, used to acknowledge which\n * responses the client has processed. Stream tokens are opaque checkpoint\n * markers whose only real value is their inclusion in the next request.\n *\n * PersistentWriteStream manages propagating this value from responses to the\n * next request.\n */\n lastStreamToken: ProtoByteString = emptyByteString();\n\n /**\n * Tracks whether or not a handshake has been successfully exchanged and\n * the stream is ready to accept mutations.\n */\n get handshakeComplete(): boolean {\n return this.handshakeComplete_;\n }\n\n // Override of PersistentStream.start\n start(): void {\n this.handshakeComplete_ = false;\n super.start();\n }\n\n protected tearDown(): void {\n if (this.handshakeComplete_) {\n this.writeMutations([]);\n }\n }\n\n protected startRpc(\n token: Token | null\n ): Stream<api.WriteRequest, api.WriteResponse> {\n return this.connection.openStream<api.WriteRequest, api.WriteResponse>(\n 'Write',\n token\n );\n }\n\n protected onMessage(responseProto: api.WriteResponse): Promise<void> {\n // Always capture the last stream token.\n assert(\n !!responseProto.streamToken,\n 'Got a write response without a stream token'\n );\n this.lastStreamToken = responseProto.streamToken;\n\n if (!this.handshakeComplete_) {\n // The first response is always the handshake response\n assert(\n !responseProto.writeResults || responseProto.writeResults.length === 0,\n 'Got mutation results for handshake'\n );\n this.handshakeComplete_ = true;\n return this.listener!.onHandshakeComplete();\n } else {\n // A successful first write response means the stream is healthy,\n // Note, that we could consider a successful handshake healthy, however,\n // the write itself might be causing an error we want to back off from.\n this.backoff.reset();\n\n const results = this.serializer.fromWriteResults(\n responseProto.writeResults,\n responseProto.commitTime\n );\n const commitVersion = this.serializer.fromVersion(\n responseProto.commitTime!\n );\n return this.listener!.onMutationResult(commitVersion, results);\n }\n }\n\n /**\n * Sends an initial streamToken to the server, performing the handshake\n * required to make the StreamingWrite RPC work. Subsequent\n * calls should wait until onHandshakeComplete was called.\n */\n writeHandshake(): void {\n assert(this.isOpen(), 'Writing handshake requires an opened stream');\n assert(!this.handshakeComplete_, 'Handshake already completed');\n // TODO(dimond): Support stream resumption. We intentionally do not set the\n // stream token on the handshake, ignoring any stream token we might have.\n const request: WriteRequest = {};\n request.database = this.serializer.encodedDatabaseId;\n this.sendRequest(request);\n }\n\n /** Sends a group of mutations to the Firestore backend to apply. */\n writeMutations(mutations: Mutation[]): void {\n assert(this.isOpen(), 'Writing mutations requires an opened stream');\n assert(\n this.handshakeComplete_,\n 'Handshake must be complete before writing mutations'\n );\n assert(\n this.lastStreamToken.length > 0,\n 'Trying to write mutation without a token'\n );\n\n const request: WriteRequest = {\n // Protos are typed with string, but we support UInt8Array on Node\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n streamToken: this.lastStreamToken as any,\n writes: mutations.map(mutation => this.serializer.toMutation(mutation))\n };\n\n this.sendRequest(request);\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { CredentialsProvider } from '../api/credentials';\nimport { maybeDocumentMap } from '../model/collections';\nimport { MaybeDocument } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport { Mutation, MutationResult } from '../model/mutation';\nimport * as api from '../protos/firestore_proto_api';\nimport { assert } from '../util/assert';\nimport { AsyncQueue } from '../util/async_queue';\nimport { Code, FirestoreError } from '../util/error';\nimport { Connection } from './connection';\nimport {\n WatchStreamListener,\n WriteStreamListener,\n PersistentListenStream,\n PersistentWriteStream\n} from './persistent_stream';\n\nimport { JsonProtoSerializer } from './serializer';\n\n// The generated proto interfaces for these class are missing the database\n// field. So we add it here.\n// TODO(b/36015800): Remove this once the api generator is fixed.\ninterface BatchGetDocumentsRequest extends api.BatchGetDocumentsRequest {\n database?: string;\n}\ninterface CommitRequest extends api.CommitRequest {\n database?: string;\n}\n\n/**\n * Datastore is a wrapper around the external Google Cloud Datastore grpc API,\n * which provides an interface that is more convenient for the rest of the\n * client SDK architecture to consume.\n */\nexport class Datastore {\n constructor(\n private queue: AsyncQueue,\n private connection: Connection,\n private credentials: CredentialsProvider,\n private serializer: JsonProtoSerializer\n ) {}\n\n newPersistentWriteStream(\n listener: WriteStreamListener\n ): PersistentWriteStream {\n return new PersistentWriteStream(\n this.queue,\n this.connection,\n this.credentials,\n this.serializer,\n listener\n );\n }\n\n newPersistentWatchStream(\n listener: WatchStreamListener\n ): PersistentListenStream {\n return new PersistentListenStream(\n this.queue,\n this.connection,\n this.credentials,\n this.serializer,\n listener\n );\n }\n\n commit(mutations: Mutation[]): Promise<MutationResult[]> {\n const params: CommitRequest = {\n database: this.serializer.encodedDatabaseId,\n writes: mutations.map(m => this.serializer.toMutation(m))\n };\n return this.invokeRPC<CommitRequest, api.CommitResponse>(\n 'Commit',\n params\n ).then(response => {\n return this.serializer.fromWriteResults(\n response.writeResults,\n response.commitTime\n );\n });\n }\n\n lookup(keys: DocumentKey[]): Promise<MaybeDocument[]> {\n const params: BatchGetDocumentsRequest = {\n database: this.serializer.encodedDatabaseId,\n documents: keys.map(k => this.serializer.toName(k))\n };\n return this.invokeStreamingRPC<\n BatchGetDocumentsRequest,\n api.BatchGetDocumentsResponse\n >('BatchGetDocuments', params).then(response => {\n let docs = maybeDocumentMap();\n response.forEach(proto => {\n const doc = this.serializer.fromMaybeDocument(proto);\n docs = docs.insert(doc.key, doc);\n });\n const result: MaybeDocument[] = [];\n keys.forEach(key => {\n const doc = docs.get(key);\n assert(!!doc, 'Missing entity in write response for ' + key);\n result.push(doc);\n });\n return result;\n });\n }\n\n /** Gets an auth token and invokes the provided RPC. */\n private invokeRPC<Req, Resp>(rpcName: string, request: Req): Promise<Resp> {\n return this.credentials\n .getToken()\n .then(token => {\n return this.connection.invokeRPC<Req, Resp>(rpcName, request, token);\n })\n .catch((error: FirestoreError) => {\n if (error.code === Code.UNAUTHENTICATED) {\n this.credentials.invalidateToken();\n }\n throw error;\n });\n }\n\n /** Gets an auth token and invokes the provided RPC with streamed results. */\n private invokeStreamingRPC<Req, Resp>(\n rpcName: string,\n request: Req\n ): Promise<Resp[]> {\n return this.credentials\n .getToken()\n .then(token => {\n return this.connection.invokeStreamingRPC<Req, Resp>(\n rpcName,\n request,\n token\n );\n })\n .catch((error: FirestoreError) => {\n if (error.code === Code.UNAUTHENTICATED) {\n this.credentials.invalidateToken();\n }\n throw error;\n });\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ParsedSetData, ParsedUpdateData } from '../api/user_data_converter';\nimport { documentVersionMap } from '../model/collections';\nimport { Document, NoDocument, MaybeDocument } from '../model/document';\n\nimport { DocumentKey } from '../model/document_key';\nimport {\n DeleteMutation,\n Mutation,\n Precondition,\n VerifyMutation\n} from '../model/mutation';\nimport { Datastore } from '../remote/datastore';\nimport { fail, assert } from '../util/assert';\nimport { Code, FirestoreError } from '../util/error';\nimport { SnapshotVersion } from './snapshot_version';\n\n/**\n * Internal transaction object responsible for accumulating the mutations to\n * perform and the base versions for any documents read.\n */\nexport class Transaction {\n // The version of each document that was read during this transaction.\n private readVersions = documentVersionMap();\n private mutations: Mutation[] = [];\n private committed = false;\n\n /**\n * A deferred usage error that occurred previously in this transaction that\n * will cause the transaction to fail once it actually commits.\n */\n private lastWriteError: FirestoreError | null = null;\n\n /**\n * Set of documents that have been written in the transaction.\n *\n * When there's more than one write to the same key in a transaction, any\n * writes after the first are handled differently.\n */\n private writtenDocs: Set<DocumentKey> = new Set();\n\n constructor(private datastore: Datastore) {}\n\n async lookup(keys: DocumentKey[]): Promise<MaybeDocument[]> {\n this.ensureCommitNotCalled();\n\n if (this.mutations.length > 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Firestore transactions require all reads to be executed before all writes.'\n );\n }\n const docs = await this.datastore.lookup(keys);\n docs.forEach(doc => {\n if (doc instanceof NoDocument || doc instanceof Document) {\n this.recordVersion(doc);\n } else {\n fail('Document in a transaction was a ' + doc.constructor.name);\n }\n });\n return docs;\n }\n\n set(key: DocumentKey, data: ParsedSetData): void {\n this.write(data.toMutations(key, this.precondition(key)));\n this.writtenDocs.add(key);\n }\n\n update(key: DocumentKey, data: ParsedUpdateData): void {\n try {\n this.write(data.toMutations(key, this.preconditionForUpdate(key)));\n } catch (e) {\n this.lastWriteError = e;\n }\n this.writtenDocs.add(key);\n }\n\n delete(key: DocumentKey): void {\n this.write([new DeleteMutation(key, this.precondition(key))]);\n this.writtenDocs.add(key);\n }\n\n async commit(): Promise<void> {\n this.ensureCommitNotCalled();\n\n if (this.lastWriteError) {\n throw this.lastWriteError;\n }\n let unwritten = this.readVersions;\n // For each mutation, note that the doc was written.\n this.mutations.forEach(mutation => {\n unwritten = unwritten.remove(mutation.key);\n });\n // For each document that was read but not written to, we want to perform\n // a `verify` operation.\n unwritten.forEach((key, _version) => {\n this.mutations.push(new VerifyMutation(key, this.precondition(key)));\n });\n await this.datastore.commit(this.mutations);\n this.committed = true;\n }\n\n private recordVersion(doc: MaybeDocument): void {\n let docVersion: SnapshotVersion;\n\n if (doc instanceof Document) {\n docVersion = doc.version;\n } else if (doc instanceof NoDocument) {\n // For deleted docs, we must use baseVersion 0 when we overwrite them.\n docVersion = SnapshotVersion.forDeletedDoc();\n } else {\n throw fail('Document in a transaction was a ' + doc.constructor.name);\n }\n\n const existingVersion = this.readVersions.get(doc.key);\n if (existingVersion !== null) {\n if (!docVersion.isEqual(existingVersion)) {\n // This transaction will fail no matter what.\n throw new FirestoreError(\n Code.ABORTED,\n 'Document version changed between two reads.'\n );\n }\n } else {\n this.readVersions = this.readVersions.insert(doc.key, docVersion);\n }\n }\n\n /**\n * Returns the version of this document when it was read in this transaction,\n * as a precondition, or no precondition if it was not read.\n */\n private precondition(key: DocumentKey): Precondition {\n const version = this.readVersions.get(key);\n if (!this.writtenDocs.has(key) && version) {\n return Precondition.updateTime(version);\n } else {\n return Precondition.NONE;\n }\n }\n\n /**\n * Returns the precondition for a document if the operation is an update.\n */\n private preconditionForUpdate(key: DocumentKey): Precondition {\n const version = this.readVersions.get(key);\n // The first time a document is written, we want to take into account the\n // read time and existence\n if (!this.writtenDocs.has(key) && version) {\n if (version.isEqual(SnapshotVersion.forDeletedDoc())) {\n // The document doesn't exist, so fail the transaction.\n\n // This has to be validated locally because you can't send a\n // precondition that a document does not exist without changing the\n // semantics of the backend write to be an insert. This is the reverse\n // of what we want, since we want to assert that the document doesn't\n // exist but then send the update and have it fail. Since we can't\n // express that to the backend, we have to validate locally.\n\n // Note: this can change once we can send separate verify writes in the\n // transaction.\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n \"Can't update a document that doesn't exist.\"\n );\n }\n // Document exists, base precondition on document update time.\n return Precondition.updateTime(version);\n } else {\n // Document was not read, so we just use the preconditions for a blind\n // update.\n return Precondition.exists(true);\n }\n }\n\n private write(mutations: Mutation[]): void {\n this.ensureCommitNotCalled();\n this.mutations = this.mutations.concat(mutations);\n }\n\n private ensureCommitNotCalled(): void {\n assert(\n !this.committed,\n 'A transaction object cannot be used after its update callback has been invoked.'\n );\n }\n}\n","/**\n * @license\n * Copyright 2018 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { OnlineState } from '../core/types';\nimport { assert } from '../util/assert';\nimport { AsyncQueue, TimerId } from '../util/async_queue';\nimport { FirestoreError } from '../util/error';\nimport * as log from '../util/log';\nimport { CancelablePromise } from '../util/promise';\n\nconst LOG_TAG = 'OnlineStateTracker';\n\n// To deal with transient failures, we allow multiple stream attempts before\n// giving up and transitioning from OnlineState.Unknown to Offline.\n// TODO(mikelehen): This used to be set to 2 as a mitigation for b/66228394.\n// @jdimond thinks that bug is sufficiently fixed so that we can set this back\n// to 1. If that works okay, we could potentially remove this logic entirely.\nconst MAX_WATCH_STREAM_FAILURES = 1;\n\n// To deal with stream attempts that don't succeed or fail in a timely manner,\n// we have a timeout for OnlineState to reach Online or Offline.\n// If the timeout is reached, we transition to Offline rather than waiting\n// indefinitely.\nconst ONLINE_STATE_TIMEOUT_MS = 10 * 1000;\n\n/**\n * A component used by the RemoteStore to track the OnlineState (that is,\n * whether or not the client as a whole should be considered to be online or\n * offline), implementing the appropriate heuristics.\n *\n * In particular, when the client is trying to connect to the backend, we\n * allow up to MAX_WATCH_STREAM_FAILURES within ONLINE_STATE_TIMEOUT_MS for\n * a connection to succeed. If we have too many failures or the timeout elapses,\n * then we set the OnlineState to Offline, and the client will behave as if\n * it is offline (get()s will return cached data, etc.).\n */\nexport class OnlineStateTracker {\n /** The current OnlineState. */\n private state = OnlineState.Unknown;\n\n /**\n * A count of consecutive failures to open the stream. If it reaches the\n * maximum defined by MAX_WATCH_STREAM_FAILURES, we'll set the OnlineState to\n * Offline.\n */\n private watchStreamFailures = 0;\n\n /**\n * A timer that elapses after ONLINE_STATE_TIMEOUT_MS, at which point we\n * transition from OnlineState.Unknown to OnlineState.Offline without waiting\n * for the stream to actually fail (MAX_WATCH_STREAM_FAILURES times).\n */\n private onlineStateTimer: CancelablePromise<void> | null = null;\n\n /**\n * Whether the client should log a warning message if it fails to connect to\n * the backend (initially true, cleared after a successful stream, or if we've\n * logged the message already).\n */\n private shouldWarnClientIsOffline = true;\n\n constructor(\n private asyncQueue: AsyncQueue,\n private onlineStateHandler: (onlineState: OnlineState) => void\n ) {}\n\n /**\n * Called by RemoteStore when a watch stream is started (including on each\n * backoff attempt).\n *\n * If this is the first attempt, it sets the OnlineState to Unknown and starts\n * the onlineStateTimer.\n */\n handleWatchStreamStart(): void {\n if (this.watchStreamFailures === 0) {\n this.setAndBroadcast(OnlineState.Unknown);\n\n assert(\n this.onlineStateTimer === null,\n `onlineStateTimer shouldn't be started yet`\n );\n this.onlineStateTimer = this.asyncQueue.enqueueAfterDelay(\n TimerId.OnlineStateTimeout,\n ONLINE_STATE_TIMEOUT_MS,\n () => {\n this.onlineStateTimer = null;\n assert(\n this.state === OnlineState.Unknown,\n 'Timer should be canceled if we transitioned to a different state.'\n );\n this.logClientOfflineWarningIfNecessary(\n `Backend didn't respond within ${ONLINE_STATE_TIMEOUT_MS / 1000} ` +\n `seconds.`\n );\n this.setAndBroadcast(OnlineState.Offline);\n\n // NOTE: handleWatchStreamFailure() will continue to increment\n // watchStreamFailures even though we are already marked Offline,\n // but this is non-harmful.\n\n return Promise.resolve();\n }\n );\n }\n }\n\n /**\n * Updates our OnlineState as appropriate after the watch stream reports a\n * failure. The first failure moves us to the 'Unknown' state. We then may\n * allow multiple failures (based on MAX_WATCH_STREAM_FAILURES) before we\n * actually transition to the 'Offline' state.\n */\n handleWatchStreamFailure(error: FirestoreError): void {\n if (this.state === OnlineState.Online) {\n this.setAndBroadcast(OnlineState.Unknown);\n\n // To get to OnlineState.Online, set() must have been called which would\n // have reset our heuristics.\n assert(this.watchStreamFailures === 0, 'watchStreamFailures must be 0');\n assert(this.onlineStateTimer === null, 'onlineStateTimer must be null');\n } else {\n this.watchStreamFailures++;\n if (this.watchStreamFailures >= MAX_WATCH_STREAM_FAILURES) {\n this.clearOnlineStateTimer();\n\n this.logClientOfflineWarningIfNecessary(\n `Connection failed ${MAX_WATCH_STREAM_FAILURES} ` +\n `times. Most recent error: ${error.toString()}`\n );\n\n this.setAndBroadcast(OnlineState.Offline);\n }\n }\n }\n\n /**\n * Explicitly sets the OnlineState to the specified state.\n *\n * Note that this resets our timers / failure counters, etc. used by our\n * Offline heuristics, so must not be used in place of\n * handleWatchStreamStart() and handleWatchStreamFailure().\n */\n set(newState: OnlineState): void {\n this.clearOnlineStateTimer();\n this.watchStreamFailures = 0;\n\n if (newState === OnlineState.Online) {\n // We've connected to watch at least once. Don't warn the developer\n // about being offline going forward.\n this.shouldWarnClientIsOffline = false;\n }\n\n this.setAndBroadcast(newState);\n }\n\n private setAndBroadcast(newState: OnlineState): void {\n if (newState !== this.state) {\n this.state = newState;\n this.onlineStateHandler(newState);\n }\n }\n\n private logClientOfflineWarningIfNecessary(details: string): void {\n const message =\n `Could not reach Cloud Firestore backend. ${details}\\n` +\n `This typically indicates that your device does not have a healthy ` +\n `Internet connection at the moment. The client will operate in offline ` +\n `mode until it is able to successfully connect to the backend.`;\n if (this.shouldWarnClientIsOffline) {\n log.error(message);\n this.shouldWarnClientIsOffline = false;\n } else {\n log.debug(LOG_TAG, message);\n }\n }\n\n private clearOnlineStateTimer(): void {\n if (this.onlineStateTimer !== null) {\n this.onlineStateTimer.cancel();\n this.onlineStateTimer = null;\n }\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { Transaction } from '../core/transaction';\nimport { OnlineState, TargetId } from '../core/types';\nimport { ignoreIfPrimaryLeaseLoss, LocalStore } from '../local/local_store';\nimport { TargetData, TargetPurpose } from '../local/target_data';\nimport { MutationResult } from '../model/mutation';\nimport {\n BATCHID_UNKNOWN,\n MutationBatch,\n MutationBatchResult\n} from '../model/mutation_batch';\nimport { emptyByteString } from '../platform/platform';\nimport { assert } from '../util/assert';\nimport { FirestoreError } from '../util/error';\nimport * as log from '../util/log';\nimport * as objUtils from '../util/obj';\n\nimport { DocumentKeySet } from '../model/collections';\nimport { AsyncQueue } from '../util/async_queue';\nimport { ConnectivityMonitor, NetworkStatus } from './connectivity_monitor';\nimport { Datastore } from './datastore';\nimport { OnlineStateTracker } from './online_state_tracker';\nimport {\n PersistentListenStream,\n PersistentWriteStream\n} from './persistent_stream';\nimport { RemoteSyncer } from './remote_syncer';\nimport { isPermanentError, isPermanentWriteError } from './rpc_error';\nimport {\n DocumentWatchChange,\n ExistenceFilterChange,\n TargetMetadataProvider,\n WatchChange,\n WatchChangeAggregator,\n WatchTargetChange,\n WatchTargetChangeState\n} from './watch_change';\n\nconst LOG_TAG = 'RemoteStore';\n\n// TODO(b/35853402): Negotiate this with the stream.\nconst MAX_PENDING_WRITES = 10;\n\n/**\n * RemoteStore - An interface to remotely stored data, basically providing a\n * wrapper around the Datastore that is more reliable for the rest of the\n * system.\n *\n * RemoteStore is responsible for maintaining the connection to the server.\n * - maintaining a list of active listens.\n * - reconnecting when the connection is dropped.\n * - resuming all the active listens on reconnect.\n *\n * RemoteStore handles all incoming events from the Datastore.\n * - listening to the watch stream and repackaging the events as RemoteEvents\n * - notifying SyncEngine of any changes to the active listens.\n *\n * RemoteStore takes writes from other components and handles them reliably.\n * - pulling pending mutations from LocalStore and sending them to Datastore.\n * - retrying mutations that failed because of network problems.\n * - acking mutations to the SyncEngine once they are accepted or rejected.\n */\nexport class RemoteStore implements TargetMetadataProvider {\n /**\n * A list of up to MAX_PENDING_WRITES writes that we have fetched from the\n * LocalStore via fillWritePipeline() and have or will send to the write\n * stream.\n *\n * Whenever writePipeline.length > 0 the RemoteStore will attempt to start or\n * restart the write stream. When the stream is established the writes in the\n * pipeline will be sent in order.\n *\n * Writes remain in writePipeline until they are acknowledged by the backend\n * and thus will automatically be re-sent if the stream is interrupted /\n * restarted before they're acknowledged.\n *\n * Write responses from the backend are linked to their originating request\n * purely based on order, and so we can just shift() writes from the front of\n * the writePipeline as we receive responses.\n */\n private writePipeline: MutationBatch[] = [];\n\n /**\n * A mapping of watched targets that the client cares about tracking and the\n * user has explicitly called a 'listen' for this target.\n *\n * These targets may or may not have been sent to or acknowledged by the\n * server. On re-establishing the listen stream, these targets should be sent\n * to the server. The targets removed with unlistens are removed eagerly\n * without waiting for confirmation from the listen stream.\n */\n private listenTargets: { [targetId: number]: TargetData } = {};\n\n private connectivityMonitor: ConnectivityMonitor;\n private watchStream: PersistentListenStream;\n private writeStream: PersistentWriteStream;\n private watchChangeAggregator: WatchChangeAggregator | null = null;\n\n /**\n * Set to true by enableNetwork() and false by disableNetwork() and indicates\n * the user-preferred network state.\n */\n private networkEnabled = false;\n\n private isPrimary = false;\n\n private onlineStateTracker: OnlineStateTracker;\n\n constructor(\n /**\n * The local store, used to fill the write pipeline with outbound mutations.\n */\n private localStore: LocalStore,\n /** The client-side proxy for interacting with the backend. */\n private datastore: Datastore,\n asyncQueue: AsyncQueue,\n onlineStateHandler: (onlineState: OnlineState) => void,\n connectivityMonitor: ConnectivityMonitor\n ) {\n this.connectivityMonitor = connectivityMonitor;\n this.connectivityMonitor.addCallback((status: NetworkStatus) => {\n asyncQueue.enqueueAndForget(async () => {\n if (this.canUseNetwork()) {\n log.debug(\n LOG_TAG,\n 'Restarting streams for network reachability change.'\n );\n await this.restartNetwork();\n }\n });\n });\n\n this.onlineStateTracker = new OnlineStateTracker(\n asyncQueue,\n onlineStateHandler\n );\n\n // Create streams (but note they're not started yet).\n this.watchStream = this.datastore.newPersistentWatchStream({\n onOpen: this.onWatchStreamOpen.bind(this),\n onClose: this.onWatchStreamClose.bind(this),\n onWatchChange: this.onWatchStreamChange.bind(this)\n });\n\n this.writeStream = this.datastore.newPersistentWriteStream({\n onOpen: this.onWriteStreamOpen.bind(this),\n onClose: this.onWriteStreamClose.bind(this),\n onHandshakeComplete: this.onWriteHandshakeComplete.bind(this),\n onMutationResult: this.onMutationResult.bind(this)\n });\n }\n\n /**\n * SyncEngine to notify of watch and write events. This must be set\n * immediately after construction.\n */\n syncEngine!: RemoteSyncer;\n\n /**\n * Starts up the remote store, creating streams, restoring state from\n * LocalStore, etc.\n */\n start(): Promise<void> {\n return this.enableNetwork();\n }\n\n /** Re-enables the network. Idempotent. */\n async enableNetwork(): Promise<void> {\n this.networkEnabled = true;\n\n if (this.canUseNetwork()) {\n this.writeStream.lastStreamToken = await this.localStore.getLastStreamToken();\n\n if (this.shouldStartWatchStream()) {\n this.startWatchStream();\n } else {\n this.onlineStateTracker.set(OnlineState.Unknown);\n }\n\n // This will start the write stream if necessary.\n await this.fillWritePipeline();\n }\n }\n\n /**\n * Temporarily disables the network. The network can be re-enabled using\n * enableNetwork().\n */\n async disableNetwork(): Promise<void> {\n this.networkEnabled = false;\n await this.disableNetworkInternal();\n\n // Set the OnlineState to Offline so get()s return from cache, etc.\n this.onlineStateTracker.set(OnlineState.Offline);\n }\n\n private async disableNetworkInternal(): Promise<void> {\n await this.writeStream.stop();\n await this.watchStream.stop();\n\n if (this.writePipeline.length > 0) {\n log.debug(\n LOG_TAG,\n `Stopping write stream with ${this.writePipeline.length} pending writes`\n );\n this.writePipeline = [];\n }\n\n this.cleanUpWatchStreamState();\n }\n\n async shutdown(): Promise<void> {\n log.debug(LOG_TAG, 'RemoteStore shutting down.');\n this.networkEnabled = false;\n await this.disableNetworkInternal();\n this.connectivityMonitor.shutdown();\n\n // Set the OnlineState to Unknown (rather than Offline) to avoid potentially\n // triggering spurious listener events with cached data, etc.\n this.onlineStateTracker.set(OnlineState.Unknown);\n }\n\n /**\n * Starts new listen for the given target. Uses resume token if provided. It\n * is a no-op if the target of given `TargetData` is already being listened to.\n */\n listen(targetData: TargetData): void {\n if (objUtils.contains(this.listenTargets, targetData.targetId)) {\n return;\n }\n\n // Mark this as something the client is currently listening for.\n this.listenTargets[targetData.targetId] = targetData;\n\n if (this.shouldStartWatchStream()) {\n // The listen will be sent in onWatchStreamOpen\n this.startWatchStream();\n } else if (this.watchStream.isOpen()) {\n this.sendWatchRequest(targetData);\n }\n }\n\n /**\n * Removes the listen from server. It is a no-op if the given target id is\n * not being listened to.\n */\n unlisten(targetId: TargetId): void {\n assert(\n objUtils.contains(this.listenTargets, targetId),\n `unlisten called on target no currently watched: ${targetId}`\n );\n\n delete this.listenTargets[targetId];\n if (this.watchStream.isOpen()) {\n this.sendUnwatchRequest(targetId);\n }\n\n if (objUtils.isEmpty(this.listenTargets)) {\n if (this.watchStream.isOpen()) {\n this.watchStream.markIdle();\n } else if (this.canUseNetwork()) {\n // Revert to OnlineState.Unknown if the watch stream is not open and we\n // have no listeners, since without any listens to send we cannot\n // confirm if the stream is healthy and upgrade to OnlineState.Online.\n this.onlineStateTracker.set(OnlineState.Unknown);\n }\n }\n }\n\n /** {@link TargetMetadataProvider.getTargetDataForTarget} */\n getTargetDataForTarget(targetId: TargetId): TargetData | null {\n return this.listenTargets[targetId] || null;\n }\n\n /** {@link TargetMetadataProvider.getRemoteKeysForTarget} */\n getRemoteKeysForTarget(targetId: TargetId): DocumentKeySet {\n return this.syncEngine.getRemoteKeysForTarget(targetId);\n }\n\n /**\n * We need to increment the the expected number of pending responses we're due\n * from watch so we wait for the ack to process any messages from this target.\n */\n private sendWatchRequest(targetData: TargetData): void {\n this.watchChangeAggregator!.recordPendingTargetRequest(targetData.targetId);\n this.watchStream.watch(targetData);\n }\n\n /**\n * We need to increment the expected number of pending responses we're due\n * from watch so we wait for the removal on the server before we process any\n * messages from this target.\n */\n private sendUnwatchRequest(targetId: TargetId): void {\n this.watchChangeAggregator!.recordPendingTargetRequest(targetId);\n this.watchStream.unwatch(targetId);\n }\n\n private startWatchStream(): void {\n assert(\n this.shouldStartWatchStream(),\n 'startWatchStream() called when shouldStartWatchStream() is false.'\n );\n\n this.watchChangeAggregator = new WatchChangeAggregator(this);\n this.watchStream.start();\n this.onlineStateTracker.handleWatchStreamStart();\n }\n\n /**\n * Returns whether the watch stream should be started because it's necessary\n * and has not yet been started.\n */\n private shouldStartWatchStream(): boolean {\n return (\n this.canUseNetwork() &&\n !this.watchStream.isStarted() &&\n !objUtils.isEmpty(this.listenTargets)\n );\n }\n\n canUseNetwork(): boolean {\n return this.isPrimary && this.networkEnabled;\n }\n\n private cleanUpWatchStreamState(): void {\n this.watchChangeAggregator = null;\n }\n\n private async onWatchStreamOpen(): Promise<void> {\n objUtils.forEachNumber(this.listenTargets, (targetId, targetData) => {\n this.sendWatchRequest(targetData);\n });\n }\n\n private async onWatchStreamClose(error?: FirestoreError): Promise<void> {\n if (error === undefined) {\n // Graceful stop (due to stop() or idle timeout). Make sure that's\n // desirable.\n assert(\n !this.shouldStartWatchStream(),\n 'Watch stream was stopped gracefully while still needed.'\n );\n }\n\n this.cleanUpWatchStreamState();\n\n // If we still need the watch stream, retry the connection.\n if (this.shouldStartWatchStream()) {\n this.onlineStateTracker.handleWatchStreamFailure(error!);\n\n this.startWatchStream();\n } else {\n // No need to restart watch stream because there are no active targets.\n // The online state is set to unknown because there is no active attempt\n // at establishing a connection\n this.onlineStateTracker.set(OnlineState.Unknown);\n }\n }\n\n private async onWatchStreamChange(\n watchChange: WatchChange,\n snapshotVersion: SnapshotVersion\n ): Promise<void> {\n // Mark the client as online since we got a message from the server\n this.onlineStateTracker.set(OnlineState.Online);\n\n if (\n watchChange instanceof WatchTargetChange &&\n watchChange.state === WatchTargetChangeState.Removed &&\n watchChange.cause\n ) {\n // There was an error on a target, don't wait for a consistent snapshot\n // to raise events\n return this.handleTargetError(watchChange);\n }\n\n if (watchChange instanceof DocumentWatchChange) {\n this.watchChangeAggregator!.handleDocumentChange(watchChange);\n } else if (watchChange instanceof ExistenceFilterChange) {\n this.watchChangeAggregator!.handleExistenceFilter(watchChange);\n } else {\n assert(\n watchChange instanceof WatchTargetChange,\n 'Expected watchChange to be an instance of WatchTargetChange'\n );\n this.watchChangeAggregator!.handleTargetChange(watchChange);\n }\n\n if (!snapshotVersion.isEqual(SnapshotVersion.MIN)) {\n const lastRemoteSnapshotVersion = await this.localStore.getLastRemoteSnapshotVersion();\n if (snapshotVersion.compareTo(lastRemoteSnapshotVersion) >= 0) {\n // We have received a target change with a global snapshot if the snapshot\n // version is not equal to SnapshotVersion.MIN.\n await this.raiseWatchSnapshot(snapshotVersion);\n }\n }\n }\n\n /**\n * Takes a batch of changes from the Datastore, repackages them as a\n * RemoteEvent, and passes that on to the listener, which is typically the\n * SyncEngine.\n */\n private raiseWatchSnapshot(snapshotVersion: SnapshotVersion): Promise<void> {\n assert(\n !snapshotVersion.isEqual(SnapshotVersion.MIN),\n \"Can't raise event for unknown SnapshotVersion\"\n );\n const remoteEvent = this.watchChangeAggregator!.createRemoteEvent(\n snapshotVersion\n );\n\n // Update in-memory resume tokens. LocalStore will update the\n // persistent view of these when applying the completed RemoteEvent.\n objUtils.forEachNumber(remoteEvent.targetChanges, (targetId, change) => {\n if (change.resumeToken.length > 0) {\n const targetData = this.listenTargets[targetId];\n // A watched target might have been removed already.\n if (targetData) {\n this.listenTargets[targetId] = targetData.withResumeToken(\n change.resumeToken,\n snapshotVersion\n );\n }\n }\n });\n\n // Re-establish listens for the targets that have been invalidated by\n // existence filter mismatches.\n remoteEvent.targetMismatches.forEach(targetId => {\n const targetData = this.listenTargets[targetId];\n if (!targetData) {\n // A watched target might have been removed already.\n return;\n }\n\n // Clear the resume token for the target, since we're in a known mismatch\n // state.\n this.listenTargets[targetId] = targetData.withResumeToken(\n emptyByteString(),\n targetData.snapshotVersion\n );\n\n // Cause a hard reset by unwatching and rewatching immediately, but\n // deliberately don't send a resume token so that we get a full update.\n this.sendUnwatchRequest(targetId);\n\n // Mark the target we send as being on behalf of an existence filter\n // mismatch, but don't actually retain that in listenTargets. This ensures\n // that we flag the first re-listen this way without impacting future\n // listens of this target (that might happen e.g. on reconnect).\n const requestTargetData = new TargetData(\n targetData.target,\n targetId,\n TargetPurpose.ExistenceFilterMismatch,\n targetData.sequenceNumber\n );\n this.sendWatchRequest(requestTargetData);\n });\n\n // Finally raise remote event\n return this.syncEngine.applyRemoteEvent(remoteEvent);\n }\n\n /** Handles an error on a target */\n private handleTargetError(watchChange: WatchTargetChange): Promise<void> {\n assert(!!watchChange.cause, 'Handling target error without a cause');\n const error = watchChange.cause!;\n let promiseChain = Promise.resolve();\n watchChange.targetIds.forEach(targetId => {\n promiseChain = promiseChain.then(async () => {\n // A watched target might have been removed already.\n if (objUtils.contains(this.listenTargets, targetId)) {\n delete this.listenTargets[targetId];\n this.watchChangeAggregator!.removeTarget(targetId);\n return this.syncEngine.rejectListen(targetId, error);\n }\n });\n });\n return promiseChain;\n }\n\n /**\n * Attempts to fill our write pipeline with writes from the LocalStore.\n *\n * Called internally to bootstrap or refill the write pipeline and by\n * SyncEngine whenever there are new mutations to process.\n *\n * Starts the write stream if necessary.\n */\n async fillWritePipeline(): Promise<void> {\n if (this.canAddToWritePipeline()) {\n const lastBatchIdRetrieved =\n this.writePipeline.length > 0\n ? this.writePipeline[this.writePipeline.length - 1].batchId\n : BATCHID_UNKNOWN;\n const batch = await this.localStore.nextMutationBatch(\n lastBatchIdRetrieved\n );\n\n if (batch === null) {\n if (this.writePipeline.length === 0) {\n this.writeStream.markIdle();\n }\n } else {\n this.addToWritePipeline(batch);\n await this.fillWritePipeline();\n }\n }\n\n if (this.shouldStartWriteStream()) {\n this.startWriteStream();\n }\n }\n\n /**\n * Returns true if we can add to the write pipeline (i.e. the network is\n * enabled and the write pipeline is not full).\n */\n private canAddToWritePipeline(): boolean {\n return (\n this.canUseNetwork() && this.writePipeline.length < MAX_PENDING_WRITES\n );\n }\n\n // For testing\n outstandingWrites(): number {\n return this.writePipeline.length;\n }\n\n /**\n * Queues additional writes to be sent to the write stream, sending them\n * immediately if the write stream is established.\n */\n private addToWritePipeline(batch: MutationBatch): void {\n assert(\n this.canAddToWritePipeline(),\n 'addToWritePipeline called when pipeline is full'\n );\n this.writePipeline.push(batch);\n\n if (this.writeStream.isOpen() && this.writeStream.handshakeComplete) {\n this.writeStream.writeMutations(batch.mutations);\n }\n }\n\n private shouldStartWriteStream(): boolean {\n return (\n this.canUseNetwork() &&\n !this.writeStream.isStarted() &&\n this.writePipeline.length > 0\n );\n }\n\n private startWriteStream(): void {\n assert(\n this.shouldStartWriteStream(),\n 'startWriteStream() called when shouldStartWriteStream() is false.'\n );\n this.writeStream.start();\n }\n\n private async onWriteStreamOpen(): Promise<void> {\n this.writeStream.writeHandshake();\n }\n\n private onWriteHandshakeComplete(): Promise<void> {\n // Record the stream token.\n return this.localStore\n .setLastStreamToken(this.writeStream.lastStreamToken)\n .then(() => {\n // Send the write pipeline now that the stream is established.\n for (const batch of this.writePipeline) {\n this.writeStream.writeMutations(batch.mutations);\n }\n })\n .catch(ignoreIfPrimaryLeaseLoss);\n }\n\n private onMutationResult(\n commitVersion: SnapshotVersion,\n results: MutationResult[]\n ): Promise<void> {\n // This is a response to a write containing mutations and should be\n // correlated to the first write in our write pipeline.\n assert(\n this.writePipeline.length > 0,\n 'Got result for empty write pipeline'\n );\n const batch = this.writePipeline.shift()!;\n const success = MutationBatchResult.from(\n batch,\n commitVersion,\n results,\n this.writeStream.lastStreamToken\n );\n return this.syncEngine.applySuccessfulWrite(success).then(() => {\n // It's possible that with the completion of this mutation another\n // slot has freed up.\n return this.fillWritePipeline();\n });\n }\n\n private async onWriteStreamClose(error?: FirestoreError): Promise<void> {\n if (error === undefined) {\n // Graceful stop (due to stop() or idle timeout). Make sure that's\n // desirable.\n assert(\n !this.shouldStartWriteStream(),\n 'Write stream was stopped gracefully while still needed.'\n );\n }\n\n // If the write stream closed due to an error, invoke the error callbacks if\n // there are pending writes.\n if (error && this.writePipeline.length > 0) {\n // A promise that is resolved after we processed the error\n let errorHandling: Promise<void>;\n if (this.writeStream.handshakeComplete) {\n // This error affects the actual write.\n errorHandling = this.handleWriteError(error!);\n } else {\n // If there was an error before the handshake has finished, it's\n // possible that the server is unable to process the stream token\n // we're sending. (Perhaps it's too old?)\n errorHandling = this.handleHandshakeError(error!);\n }\n\n return errorHandling.then(() => {\n // The write stream might have been started by refilling the write\n // pipeline for failed writes\n if (this.shouldStartWriteStream()) {\n this.startWriteStream();\n }\n });\n }\n // No pending writes, nothing to do\n }\n\n private async handleHandshakeError(error: FirestoreError): Promise<void> {\n // Reset the token if it's a permanent error, signaling the write stream is\n // no longer valid. Note that the handshake does not count as a write: see\n // comments on isPermanentWriteError for details.\n if (isPermanentError(error.code)) {\n log.debug(\n LOG_TAG,\n 'RemoteStore error before completed handshake; resetting stream token: ',\n this.writeStream.lastStreamToken\n );\n this.writeStream.lastStreamToken = emptyByteString();\n\n return this.localStore\n .setLastStreamToken(emptyByteString())\n .catch(ignoreIfPrimaryLeaseLoss);\n } else {\n // Some other error, don't reset stream token. Our stream logic will\n // just retry with exponential backoff.\n }\n }\n\n private async handleWriteError(error: FirestoreError): Promise<void> {\n // Only handle permanent errors here. If it's transient, just let the retry\n // logic kick in.\n if (isPermanentWriteError(error.code)) {\n // This was a permanent error, the request itself was the problem\n // so it's not going to succeed if we resend it.\n const batch = this.writePipeline.shift()!;\n\n // In this case it's also unlikely that the server itself is melting\n // down -- this was just a bad request so inhibit backoff on the next\n // restart.\n this.writeStream.inhibitBackoff();\n\n return this.syncEngine\n .rejectFailedWrite(batch.batchId, error)\n .then(() => {\n // It's possible that with the completion of this mutation\n // another slot has freed up.\n return this.fillWritePipeline();\n });\n } else {\n // Transient error, just let the retry logic kick in.\n }\n }\n\n createTransaction(): Transaction {\n return new Transaction(this.datastore);\n }\n\n private async restartNetwork(): Promise<void> {\n this.networkEnabled = false;\n await this.disableNetworkInternal();\n this.onlineStateTracker.set(OnlineState.Unknown);\n await this.enableNetwork();\n }\n\n async handleCredentialChange(): Promise<void> {\n if (this.canUseNetwork()) {\n // Tear down and re-create our network streams. This will ensure we get a fresh auth token\n // for the new user and re-fill the write pipeline with new mutations from the LocalStore\n // (since mutations are per-user).\n log.debug(LOG_TAG, 'RemoteStore restarting streams for new credential');\n await this.restartNetwork();\n }\n }\n\n /**\n * Toggles the network state when the client gains or loses its primary lease.\n */\n async applyPrimaryState(isPrimary: boolean): Promise<void> {\n this.isPrimary = isPrimary;\n\n if (isPrimary && this.networkEnabled) {\n await this.enableNetwork();\n } else if (!isPrimary) {\n await this.disableNetworkInternal();\n this.onlineStateTracker.set(OnlineState.Unknown);\n }\n }\n}\n","/**\n * @license\n * Copyright 2019 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { BatchId, MutationBatchState, TargetId } from '../core/types';\nimport { QueryTargetState } from './shared_client_state_syncer';\nimport { assert } from '../util/assert';\nimport { ClientId } from './shared_client_state';\nimport { User } from '../auth/user';\n\n// The format of the LocalStorage key that stores the client state is:\n// firestore_clients_<persistence_prefix>_<instance_key>\nexport const CLIENT_STATE_KEY_PREFIX = 'firestore_clients';\n\n/** Assembles the key for a client state in WebStorage */\nexport function createWebStorageClientStateKey(\n persistenceKey: string,\n clientId: ClientId\n): string {\n assert(\n clientId.indexOf('_') === -1,\n `Client key cannot contain '_', but was '${clientId}'`\n );\n\n return `${CLIENT_STATE_KEY_PREFIX}_${persistenceKey}_${clientId}`;\n}\n\n/**\n * The JSON representation of a clients's metadata as used during WebStorage\n * serialization. The ClientId is omitted here as it is encoded as part of the\n * key.\n */\nexport interface ClientStateSchema {\n activeTargetIds: number[];\n updateTimeMs: number;\n}\n\n// The format of the WebStorage key that stores the mutation state is:\n// firestore_mutations_<persistence_prefix>_<batch_id>\n// (for unauthenticated users)\n// or: firestore_mutations_<persistence_prefix>_<batch_id>_<user_uid>\n//\n// 'user_uid' is last to avoid needing to escape '_' characters that it might\n// contain.\nexport const MUTATION_BATCH_KEY_PREFIX = 'firestore_mutations';\n\n/** Assembles the key for a mutation batch in WebStorage */\nexport function createWebStorageMutationBatchKey(\n persistenceKey: string,\n user: User,\n batchId: BatchId\n): string {\n let mutationKey = `${MUTATION_BATCH_KEY_PREFIX}_${persistenceKey}_${batchId}`;\n\n if (user.isAuthenticated()) {\n mutationKey += `_${user.uid}`;\n }\n\n return mutationKey;\n}\n\n/**\n * The JSON representation of a mutation batch's metadata as used during\n * WebStorage serialization. The UserId and BatchId is omitted as it is\n * encoded as part of the key.\n */\nexport interface MutationMetadataSchema {\n state: MutationBatchState;\n error?: { code: string; message: string }; // Only set when state === 'rejected'\n updateTimeMs: number;\n}\n\n// The format of the WebStorage key that stores a query target's metadata is:\n// firestore_targets_<persistence_prefix>_<target_id>\nexport const QUERY_TARGET_KEY_PREFIX = 'firestore_targets';\n\n/** Assembles the key for a query state in WebStorage */\nexport function createWebStorageQueryTargetMetadataKey(\n persistenceKey: string,\n targetId: TargetId\n): string {\n return `${QUERY_TARGET_KEY_PREFIX}_${persistenceKey}_${targetId}`;\n}\n\n/**\n * The JSON representation of a query target's state as used during WebStorage\n * serialization. The TargetId is omitted as it is encoded as part of the key.\n */\nexport interface QueryTargetStateSchema {\n state: QueryTargetState;\n error?: { code: string; message: string }; // Only set when state === 'rejected'\n updateTimeMs: number;\n}\n\n// The WebStorage prefix that stores the primary tab's online state. The\n// format of the key is:\n// firestore_online_state_<persistence_prefix>\nexport const ONLINE_STATE_KEY_PREFIX = 'firestore_online_state';\n\n/** Assembles the key for the online state of the primary tab. */\nexport function createWebStorageOnlineStateKey(persistenceKey: string): string {\n return `${ONLINE_STATE_KEY_PREFIX}_${persistenceKey}`;\n}\n\n/**\n * The JSON representation of the system's online state, as written by the\n * primary client.\n */\nexport interface SharedOnlineStateSchema {\n /**\n * The clientId of the client that wrote this onlineState value. Tracked so\n * that on startup, clients can check if this client is still active when\n * determining whether to apply this value or not.\n */\n readonly clientId: string;\n readonly onlineState: string;\n}\n\n// The WebStorage key prefix for the key that stores the last sequence number allocated. The key\n// looks like 'firestore_sequence_number_<persistence_prefix>'.\nexport const SEQUENCE_NUMBER_KEY_PREFIX = 'firestore_sequence_number';\n\n/** Assembles the key for the current sequence number. */\nexport function createWebStorageSequenceNumberKey(\n persistenceKey: string\n): string {\n return `${SEQUENCE_NUMBER_KEY_PREFIX}_${persistenceKey}`;\n}\n","/**\n * @license\n * Copyright 2018 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { User } from '../auth/user';\nimport { ListenSequence } from '../core/listen_sequence';\nimport {\n BatchId,\n ListenSequenceNumber,\n MutationBatchState,\n OnlineState,\n TargetId\n} from '../core/types';\nimport { TargetIdSet, targetIdSet } from '../model/collections';\nimport { Platform } from '../platform/platform';\nimport { assert } from '../util/assert';\nimport { AsyncQueue } from '../util/async_queue';\nimport { Code, FirestoreError } from '../util/error';\nimport { debug, error } from '../util/log';\nimport * as objUtils from '../util/obj';\nimport { SortedSet } from '../util/sorted_set';\nimport { isSafeInteger } from '../util/types';\nimport {\n QueryTargetState,\n SharedClientStateSyncer\n} from './shared_client_state_syncer';\nimport {\n CLIENT_STATE_KEY_PREFIX,\n ClientStateSchema,\n createWebStorageClientStateKey,\n createWebStorageMutationBatchKey,\n createWebStorageOnlineStateKey,\n createWebStorageQueryTargetMetadataKey,\n createWebStorageSequenceNumberKey,\n MUTATION_BATCH_KEY_PREFIX,\n MutationMetadataSchema,\n QUERY_TARGET_KEY_PREFIX,\n QueryTargetStateSchema,\n SharedOnlineStateSchema\n} from './shared_client_state_schema';\n\nconst LOG_TAG = 'SharedClientState';\n\n/**\n * A randomly-generated key assigned to each Firestore instance at startup.\n */\nexport type ClientId = string;\n\n/**\n * A `SharedClientState` keeps track of the global state of the mutations\n * and query targets for all active clients with the same persistence key (i.e.\n * project ID and FirebaseApp name). It relays local changes to other clients\n * and updates its local state as new state is observed.\n *\n * `SharedClientState` is primarily used for synchronization in Multi-Tab\n * environments. Each tab is responsible for registering its active query\n * targets and mutations. `SharedClientState` will then notify the listener\n * assigned to `.syncEngine` for updates to mutations and queries that\n * originated in other clients.\n *\n * To receive notifications, `.syncEngine` and `.onlineStateHandler` has to be\n * assigned before calling `start()`.\n */\nexport interface SharedClientState {\n syncEngine: SharedClientStateSyncer | null;\n onlineStateHandler: ((onlineState: OnlineState) => void) | null;\n sequenceNumberHandler:\n | ((sequenceNumber: ListenSequenceNumber) => void)\n | null;\n\n /** Registers the Mutation Batch ID of a newly pending mutation. */\n addPendingMutation(batchId: BatchId): void;\n\n /**\n * Records that a pending mutation has been acknowledged or rejected.\n * Called by the primary client to notify secondary clients of mutation\n * results as they come back from the backend.\n */\n updateMutationState(\n batchId: BatchId,\n state: 'acknowledged' | 'rejected',\n error?: FirestoreError\n ): void;\n\n /**\n * Associates a new Query Target ID with the local Firestore client. Returns\n * the new query state for the query (which can be 'current' if the query is\n * already associated with another tab).\n *\n * If the target id is already associated with local client, the method simply\n * returns its `QueryTargetState`.\n */\n addLocalQueryTarget(targetId: TargetId): QueryTargetState;\n\n /** Removes the Query Target ID association from the local client. */\n removeLocalQueryTarget(targetId: TargetId): void;\n\n /** Checks whether the target is associated with the local client. */\n isLocalQueryTarget(targetId: TargetId): boolean;\n\n /**\n * Processes an update to a query target.\n *\n * Called by the primary client to notify secondary clients of document\n * changes or state transitions that affect the provided query target.\n */\n updateQueryState(\n targetId: TargetId,\n state: QueryTargetState,\n error?: FirestoreError\n ): void;\n\n /**\n * Removes the target's metadata entry.\n *\n * Called by the primary client when all clients stopped listening to a query\n * target.\n */\n clearQueryState(targetId: TargetId): void;\n\n /**\n * Gets the active Query Targets IDs for all active clients.\n *\n * The implementation for this may require O(n) runtime, where 'n' is the size\n * of the result set.\n */\n // Visible for testing\n getAllActiveQueryTargets(): SortedSet<TargetId>;\n\n /**\n * Checks whether the provided target ID is currently being listened to by\n * any of the active clients.\n *\n * The implementation may require O(n*log m) runtime, where 'n' is the number\n * of clients and 'm' the number of targets.\n */\n isActiveQueryTarget(targetId: TargetId): boolean;\n\n /**\n * Starts the SharedClientState, reads existing client data and registers\n * listeners for updates to new and existing clients.\n */\n start(): Promise<void>;\n\n /** Shuts down the `SharedClientState` and its listeners. */\n shutdown(): void;\n\n /**\n * Changes the active user and removes all existing user-specific data. The\n * user change does not call back into SyncEngine (for example, no mutations\n * will be marked as removed).\n */\n handleUserChange(\n user: User,\n removedBatchIds: BatchId[],\n addedBatchIds: BatchId[]\n ): void;\n\n /** Changes the shared online state of all clients. */\n setOnlineState(onlineState: OnlineState): void;\n\n writeSequenceNumber(sequenceNumber: ListenSequenceNumber): void;\n}\n\n/**\n * Holds the state of a mutation batch, including its user ID, batch ID and\n * whether the batch is 'pending', 'acknowledged' or 'rejected'.\n */\n// Visible for testing\nexport class MutationMetadata {\n constructor(\n readonly user: User,\n readonly batchId: BatchId,\n readonly state: MutationBatchState,\n readonly error?: FirestoreError\n ) {\n assert(\n (error !== undefined) === (state === 'rejected'),\n `MutationMetadata must contain an error iff state is 'rejected'`\n );\n }\n\n /**\n * Parses a MutationMetadata from its JSON representation in WebStorage.\n * Logs a warning and returns null if the format of the data is not valid.\n */\n static fromWebStorageEntry(\n user: User,\n batchId: BatchId,\n value: string\n ): MutationMetadata | null {\n const mutationBatch = JSON.parse(value) as MutationMetadataSchema;\n\n let validData =\n typeof mutationBatch === 'object' &&\n ['pending', 'acknowledged', 'rejected'].indexOf(mutationBatch.state) !==\n -1 &&\n (mutationBatch.error === undefined ||\n typeof mutationBatch.error === 'object');\n\n let firestoreError: FirestoreError | undefined = undefined;\n\n if (validData && mutationBatch.error) {\n validData =\n typeof mutationBatch.error.message === 'string' &&\n typeof mutationBatch.error.code === 'string';\n if (validData) {\n firestoreError = new FirestoreError(\n mutationBatch.error.code as Code,\n mutationBatch.error.message\n );\n }\n }\n\n if (validData) {\n return new MutationMetadata(\n user,\n batchId,\n mutationBatch.state,\n firestoreError\n );\n } else {\n error(\n LOG_TAG,\n `Failed to parse mutation state for ID '${batchId}': ${value}`\n );\n return null;\n }\n }\n\n toWebStorageJSON(): string {\n const batchMetadata: MutationMetadataSchema = {\n state: this.state,\n updateTimeMs: Date.now() // Modify the existing value to trigger update.\n };\n\n if (this.error) {\n batchMetadata.error = {\n code: this.error.code,\n message: this.error.message\n };\n }\n\n return JSON.stringify(batchMetadata);\n }\n}\n\n/**\n * Holds the state of a query target, including its target ID and whether the\n * target is 'not-current', 'current' or 'rejected'.\n */\n// Visible for testing\nexport class QueryTargetMetadata {\n constructor(\n readonly targetId: TargetId,\n readonly state: QueryTargetState,\n readonly error?: FirestoreError\n ) {\n assert(\n (error !== undefined) === (state === 'rejected'),\n `QueryTargetMetadata must contain an error iff state is 'rejected'`\n );\n }\n\n /**\n * Parses a QueryTargetMetadata from its JSON representation in WebStorage.\n * Logs a warning and returns null if the format of the data is not valid.\n */\n static fromWebStorageEntry(\n targetId: TargetId,\n value: string\n ): QueryTargetMetadata | null {\n const targetState = JSON.parse(value) as QueryTargetStateSchema;\n\n let validData =\n typeof targetState === 'object' &&\n ['not-current', 'current', 'rejected'].indexOf(targetState.state) !==\n -1 &&\n (targetState.error === undefined ||\n typeof targetState.error === 'object');\n\n let firestoreError: FirestoreError | undefined = undefined;\n\n if (validData && targetState.error) {\n validData =\n typeof targetState.error.message === 'string' &&\n typeof targetState.error.code === 'string';\n if (validData) {\n firestoreError = new FirestoreError(\n targetState.error.code as Code,\n targetState.error.message\n );\n }\n }\n\n if (validData) {\n return new QueryTargetMetadata(\n targetId,\n targetState.state,\n firestoreError\n );\n } else {\n error(\n LOG_TAG,\n `Failed to parse target state for ID '${targetId}': ${value}`\n );\n return null;\n }\n }\n\n toWebStorageJSON(): string {\n const targetState: QueryTargetStateSchema = {\n state: this.state,\n updateTimeMs: Date.now() // Modify the existing value to trigger update.\n };\n\n if (this.error) {\n targetState.error = {\n code: this.error.code,\n message: this.error.message\n };\n }\n\n return JSON.stringify(targetState);\n }\n}\n\n/**\n * Metadata state of a single client denoting the query targets it is actively\n * listening to.\n */\n// Visible for testing.\nexport interface ClientState {\n readonly activeTargetIds: TargetIdSet;\n}\n\n/**\n * This class represents the immutable ClientState for a client read from\n * WebStorage, containing the list of active query targets.\n */\nclass RemoteClientState implements ClientState {\n private constructor(\n readonly clientId: ClientId,\n readonly activeTargetIds: TargetIdSet\n ) {}\n\n /**\n * Parses a RemoteClientState from the JSON representation in WebStorage.\n * Logs a warning and returns null if the format of the data is not valid.\n */\n static fromWebStorageEntry(\n clientId: ClientId,\n value: string\n ): RemoteClientState | null {\n const clientState = JSON.parse(value) as ClientStateSchema;\n\n let validData =\n typeof clientState === 'object' &&\n clientState.activeTargetIds instanceof Array;\n\n let activeTargetIdsSet = targetIdSet();\n\n for (let i = 0; validData && i < clientState.activeTargetIds.length; ++i) {\n validData = isSafeInteger(clientState.activeTargetIds[i]);\n activeTargetIdsSet = activeTargetIdsSet.add(\n clientState.activeTargetIds[i]\n );\n }\n\n if (validData) {\n return new RemoteClientState(clientId, activeTargetIdsSet);\n } else {\n error(\n LOG_TAG,\n `Failed to parse client data for instance '${clientId}': ${value}`\n );\n return null;\n }\n }\n}\n\n/**\n * This class represents the online state for all clients participating in\n * multi-tab. The online state is only written to by the primary client, and\n * used in secondary clients to update their query views.\n */\nexport class SharedOnlineState {\n constructor(readonly clientId: string, readonly onlineState: OnlineState) {}\n\n /**\n * Parses a SharedOnlineState from its JSON representation in WebStorage.\n * Logs a warning and returns null if the format of the data is not valid.\n */\n static fromWebStorageEntry(value: string): SharedOnlineState | null {\n const onlineState = JSON.parse(value) as SharedOnlineStateSchema;\n\n const validData =\n typeof onlineState === 'object' &&\n onlineState.onlineState in OnlineState &&\n typeof onlineState.clientId === 'string';\n\n if (validData) {\n return new SharedOnlineState(\n onlineState.clientId,\n OnlineState[onlineState.onlineState as keyof typeof OnlineState]\n );\n } else {\n error(LOG_TAG, `Failed to parse online state: ${value}`);\n return null;\n }\n }\n}\n\n/**\n * Metadata state of the local client. Unlike `RemoteClientState`, this class is\n * mutable and keeps track of all pending mutations, which allows us to\n * update the range of pending mutation batch IDs as new mutations are added or\n * removed.\n *\n * The data in `LocalClientState` is not read from WebStorage and instead\n * updated via its instance methods. The updated state can be serialized via\n * `toWebStorageJSON()`.\n */\n// Visible for testing.\nexport class LocalClientState implements ClientState {\n activeTargetIds = targetIdSet();\n\n addQueryTarget(targetId: TargetId): void {\n this.activeTargetIds = this.activeTargetIds.add(targetId);\n }\n\n removeQueryTarget(targetId: TargetId): void {\n this.activeTargetIds = this.activeTargetIds.delete(targetId);\n }\n\n /**\n * Converts this entry into a JSON-encoded format we can use for WebStorage.\n * Does not encode `clientId` as it is part of the key in WebStorage.\n */\n toWebStorageJSON(): string {\n const data: ClientStateSchema = {\n activeTargetIds: this.activeTargetIds.toArray(),\n updateTimeMs: Date.now() // Modify the existing value to trigger update.\n };\n return JSON.stringify(data);\n }\n}\n\n/**\n * `WebStorageSharedClientState` uses WebStorage (window.localStorage) as the\n * backing store for the SharedClientState. It keeps track of all active\n * clients and supports modifications of the local client's data.\n */\nexport class WebStorageSharedClientState implements SharedClientState {\n syncEngine: SharedClientStateSyncer | null = null;\n onlineStateHandler: ((onlineState: OnlineState) => void) | null = null;\n sequenceNumberHandler:\n | ((sequenceNumber: ListenSequenceNumber) => void)\n | null = null;\n\n private readonly storage: Storage;\n private readonly localClientStorageKey: string;\n private readonly sequenceNumberKey: string;\n private readonly activeClients: { [key: string]: ClientState } = {};\n private readonly storageListener = this.handleWebStorageEvent.bind(this);\n private readonly onlineStateKey: string;\n private readonly clientStateKeyRe: RegExp;\n private readonly mutationBatchKeyRe: RegExp;\n private readonly queryTargetKeyRe: RegExp;\n private started = false;\n private currentUser: User;\n\n /**\n * Captures WebStorage events that occur before `start()` is called. These\n * events are replayed once `WebStorageSharedClientState` is started.\n */\n private earlyEvents: StorageEvent[] = [];\n\n constructor(\n private readonly queue: AsyncQueue,\n private readonly platform: Platform,\n private readonly persistenceKey: string,\n private readonly localClientId: ClientId,\n initialUser: User\n ) {\n if (!WebStorageSharedClientState.isAvailable(this.platform)) {\n throw new FirestoreError(\n Code.UNIMPLEMENTED,\n 'LocalStorage is not available on this platform.'\n );\n }\n // Escape the special characters mentioned here:\n // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions\n const escapedPersistenceKey = persistenceKey.replace(\n /[.*+?^${}()|[\\]\\\\]/g,\n '\\\\$&'\n );\n\n this.storage = this.platform.window!.localStorage;\n this.currentUser = initialUser;\n this.localClientStorageKey = createWebStorageClientStateKey(\n this.persistenceKey,\n this.localClientId\n );\n this.sequenceNumberKey = createWebStorageSequenceNumberKey(\n this.persistenceKey\n );\n this.activeClients[this.localClientId] = new LocalClientState();\n\n this.clientStateKeyRe = new RegExp(\n `^${CLIENT_STATE_KEY_PREFIX}_${escapedPersistenceKey}_([^_]*)$`\n );\n this.mutationBatchKeyRe = new RegExp(\n `^${MUTATION_BATCH_KEY_PREFIX}_${escapedPersistenceKey}_(\\\\d+)(?:_(.*))?$`\n );\n this.queryTargetKeyRe = new RegExp(\n `^${QUERY_TARGET_KEY_PREFIX}_${escapedPersistenceKey}_(\\\\d+)$`\n );\n\n this.onlineStateKey = createWebStorageOnlineStateKey(this.persistenceKey);\n\n // Rather than adding the storage observer during start(), we add the\n // storage observer during initialization. This ensures that we collect\n // events before other components populate their initial state (during their\n // respective start() calls). Otherwise, we might for example miss a\n // mutation that is added after LocalStore's start() processed the existing\n // mutations but before we observe WebStorage events.\n this.platform.window!.addEventListener('storage', this.storageListener);\n }\n\n /** Returns 'true' if WebStorage is available in the current environment. */\n static isAvailable(platform: Platform): boolean {\n return !!(platform.window && platform.window.localStorage != null);\n }\n\n async start(): Promise<void> {\n assert(!this.started, 'WebStorageSharedClientState already started');\n assert(\n this.syncEngine !== null,\n 'syncEngine property must be set before calling start()'\n );\n assert(\n this.onlineStateHandler !== null,\n 'onlineStateHandler property must be set before calling start()'\n );\n\n // Retrieve the list of existing clients to backfill the data in\n // SharedClientState.\n const existingClients = await this.syncEngine!.getActiveClients();\n\n for (const clientId of existingClients) {\n if (clientId === this.localClientId) {\n continue;\n }\n\n const storageItem = this.getItem(\n createWebStorageClientStateKey(this.persistenceKey, clientId)\n );\n if (storageItem) {\n const clientState = RemoteClientState.fromWebStorageEntry(\n clientId,\n storageItem\n );\n if (clientState) {\n this.activeClients[clientState.clientId] = clientState;\n }\n }\n }\n\n this.persistClientState();\n\n // Check if there is an existing online state and call the callback handler\n // if applicable.\n const onlineStateJSON = this.storage.getItem(this.onlineStateKey);\n if (onlineStateJSON) {\n const onlineState = this.fromWebStorageOnlineState(onlineStateJSON);\n if (onlineState) {\n this.handleOnlineStateEvent(onlineState);\n }\n }\n\n for (const event of this.earlyEvents) {\n this.handleWebStorageEvent(event);\n }\n\n this.earlyEvents = [];\n\n // Register a window unload hook to remove the client metadata entry from\n // WebStorage even if `shutdown()` was not called.\n this.platform.window!.addEventListener('unload', () => this.shutdown());\n\n this.started = true;\n }\n\n writeSequenceNumber(sequenceNumber: ListenSequenceNumber): void {\n this.setItem(this.sequenceNumberKey, JSON.stringify(sequenceNumber));\n }\n\n getAllActiveQueryTargets(): TargetIdSet {\n let activeTargets = targetIdSet();\n objUtils.forEach(this.activeClients, (key, value) => {\n activeTargets = activeTargets.unionWith(value.activeTargetIds);\n });\n return activeTargets;\n }\n\n isActiveQueryTarget(targetId: TargetId): boolean {\n // This is not using `obj.forEach` since `forEach` doesn't support early\n // return.\n for (const clientId in this.activeClients) {\n if (this.activeClients.hasOwnProperty(clientId)) {\n if (this.activeClients[clientId].activeTargetIds.has(targetId)) {\n return true;\n }\n }\n }\n return false;\n }\n\n addPendingMutation(batchId: BatchId): void {\n this.persistMutationState(batchId, 'pending');\n }\n\n updateMutationState(\n batchId: BatchId,\n state: 'acknowledged' | 'rejected',\n error?: FirestoreError\n ): void {\n this.persistMutationState(batchId, state, error);\n\n // Once a final mutation result is observed by other clients, they no longer\n // access the mutation's metadata entry. Since WebStorage replays events\n // in order, it is safe to delete the entry right after updating it.\n this.removeMutationState(batchId);\n }\n\n addLocalQueryTarget(targetId: TargetId): QueryTargetState {\n let queryState: QueryTargetState = 'not-current';\n\n // Lookup an existing query state if the target ID was already registered\n // by another tab\n if (this.isActiveQueryTarget(targetId)) {\n const storageItem = this.storage.getItem(\n createWebStorageQueryTargetMetadataKey(this.persistenceKey, targetId)\n );\n\n if (storageItem) {\n const metadata = QueryTargetMetadata.fromWebStorageEntry(\n targetId,\n storageItem\n );\n if (metadata) {\n queryState = metadata.state;\n }\n }\n }\n\n this.localClientState.addQueryTarget(targetId);\n this.persistClientState();\n\n return queryState;\n }\n\n removeLocalQueryTarget(targetId: TargetId): void {\n this.localClientState.removeQueryTarget(targetId);\n this.persistClientState();\n }\n\n isLocalQueryTarget(targetId: TargetId): boolean {\n return this.localClientState.activeTargetIds.has(targetId);\n }\n\n clearQueryState(targetId: TargetId): void {\n this.removeItem(\n createWebStorageQueryTargetMetadataKey(this.persistenceKey, targetId)\n );\n }\n\n updateQueryState(\n targetId: TargetId,\n state: QueryTargetState,\n error?: FirestoreError\n ): void {\n this.persistQueryTargetState(targetId, state, error);\n }\n\n handleUserChange(\n user: User,\n removedBatchIds: BatchId[],\n addedBatchIds: BatchId[]\n ): void {\n removedBatchIds.forEach(batchId => {\n this.removeMutationState(batchId);\n });\n this.currentUser = user;\n addedBatchIds.forEach(batchId => {\n this.addPendingMutation(batchId);\n });\n }\n\n setOnlineState(onlineState: OnlineState): void {\n this.persistOnlineState(onlineState);\n }\n\n shutdown(): void {\n if (this.started) {\n this.platform.window!.removeEventListener(\n 'storage',\n this.storageListener\n );\n this.removeItem(this.localClientStorageKey);\n this.started = false;\n }\n }\n\n private getItem(key: string): string | null {\n const value = this.storage.getItem(key);\n debug(LOG_TAG, 'READ', key, value);\n return value;\n }\n\n private setItem(key: string, value: string): void {\n debug(LOG_TAG, 'SET', key, value);\n this.storage.setItem(key, value);\n }\n\n private removeItem(key: string): void {\n debug(LOG_TAG, 'REMOVE', key);\n this.storage.removeItem(key);\n }\n\n private handleWebStorageEvent(event: StorageEvent): void {\n if (event.storageArea === this.storage) {\n debug(LOG_TAG, 'EVENT', event.key, event.newValue);\n\n if (event.key === this.localClientStorageKey) {\n error(\n 'Received WebStorage notification for local change. Another client might have ' +\n 'garbage-collected our state'\n );\n return;\n }\n\n this.queue.enqueueAndForget(async () => {\n if (!this.started) {\n this.earlyEvents.push(event);\n return;\n }\n\n if (event.key === null) {\n return;\n }\n\n if (this.clientStateKeyRe.test(event.key)) {\n if (event.newValue != null) {\n const clientState = this.fromWebStorageClientState(\n event.key,\n event.newValue\n );\n if (clientState) {\n return this.handleClientStateEvent(\n clientState.clientId,\n clientState\n );\n }\n } else {\n const clientId = this.fromWebStorageClientStateKey(event.key)!;\n return this.handleClientStateEvent(clientId, null);\n }\n } else if (this.mutationBatchKeyRe.test(event.key)) {\n if (event.newValue !== null) {\n const mutationMetadata = this.fromWebStorageMutationMetadata(\n event.key,\n event.newValue\n );\n if (mutationMetadata) {\n return this.handleMutationBatchEvent(mutationMetadata);\n }\n }\n } else if (this.queryTargetKeyRe.test(event.key)) {\n if (event.newValue !== null) {\n const queryTargetMetadata = this.fromWebStorageQueryTargetMetadata(\n event.key,\n event.newValue\n );\n if (queryTargetMetadata) {\n return this.handleQueryTargetEvent(queryTargetMetadata);\n }\n }\n } else if (event.key === this.onlineStateKey) {\n if (event.newValue !== null) {\n const onlineState = this.fromWebStorageOnlineState(event.newValue);\n if (onlineState) {\n return this.handleOnlineStateEvent(onlineState);\n }\n }\n } else if (event.key === this.sequenceNumberKey) {\n assert(!!this.sequenceNumberHandler, 'Missing sequenceNumberHandler');\n const sequenceNumber = fromWebStorageSequenceNumber(event.newValue);\n if (sequenceNumber !== ListenSequence.INVALID) {\n this.sequenceNumberHandler!(sequenceNumber);\n }\n }\n });\n }\n }\n\n private get localClientState(): LocalClientState {\n return this.activeClients[this.localClientId] as LocalClientState;\n }\n\n private persistClientState(): void {\n this.setItem(\n this.localClientStorageKey,\n this.localClientState.toWebStorageJSON()\n );\n }\n\n private persistMutationState(\n batchId: BatchId,\n state: MutationBatchState,\n error?: FirestoreError\n ): void {\n const mutationState = new MutationMetadata(\n this.currentUser,\n batchId,\n state,\n error\n );\n const mutationKey = createWebStorageMutationBatchKey(\n this.persistenceKey,\n this.currentUser,\n batchId\n );\n this.setItem(mutationKey, mutationState.toWebStorageJSON());\n }\n\n private removeMutationState(batchId: BatchId): void {\n const mutationKey = createWebStorageMutationBatchKey(\n this.persistenceKey,\n this.currentUser,\n batchId\n );\n this.removeItem(mutationKey);\n }\n\n private persistOnlineState(onlineState: OnlineState): void {\n const entry: SharedOnlineStateSchema = {\n clientId: this.localClientId,\n onlineState: OnlineState[onlineState]\n };\n this.storage.setItem(this.onlineStateKey, JSON.stringify(entry));\n }\n\n private persistQueryTargetState(\n targetId: TargetId,\n state: QueryTargetState,\n error?: FirestoreError\n ): void {\n const targetKey = createWebStorageQueryTargetMetadataKey(\n this.persistenceKey,\n targetId\n );\n const targetMetadata = new QueryTargetMetadata(targetId, state, error);\n this.setItem(targetKey, targetMetadata.toWebStorageJSON());\n }\n\n /**\n * Parses a client state key in WebStorage. Returns null if the key does not\n * match the expected key format.\n */\n private fromWebStorageClientStateKey(key: string): ClientId | null {\n const match = this.clientStateKeyRe.exec(key);\n return match ? match[1] : null;\n }\n\n /**\n * Parses a client state in WebStorage. Returns 'null' if the value could not\n * be parsed.\n */\n private fromWebStorageClientState(\n key: string,\n value: string\n ): RemoteClientState | null {\n const clientId = this.fromWebStorageClientStateKey(key);\n assert(clientId !== null, `Cannot parse client state key '${key}'`);\n return RemoteClientState.fromWebStorageEntry(clientId, value);\n }\n\n /**\n * Parses a mutation batch state in WebStorage. Returns 'null' if the value\n * could not be parsed.\n */\n private fromWebStorageMutationMetadata(\n key: string,\n value: string\n ): MutationMetadata | null {\n const match = this.mutationBatchKeyRe.exec(key);\n assert(match !== null, `Cannot parse mutation batch key '${key}'`);\n\n const batchId = Number(match[1]);\n const userId = match[2] !== undefined ? match[2] : null;\n return MutationMetadata.fromWebStorageEntry(\n new User(userId),\n batchId,\n value\n );\n }\n\n /**\n * Parses a query target state from WebStorage. Returns 'null' if the value\n * could not be parsed.\n */\n private fromWebStorageQueryTargetMetadata(\n key: string,\n value: string\n ): QueryTargetMetadata | null {\n const match = this.queryTargetKeyRe.exec(key);\n assert(match !== null, `Cannot parse query target key '${key}'`);\n\n const targetId = Number(match[1]);\n return QueryTargetMetadata.fromWebStorageEntry(targetId, value);\n }\n\n /**\n * Parses an online state from WebStorage. Returns 'null' if the value\n * could not be parsed.\n */\n private fromWebStorageOnlineState(value: string): SharedOnlineState | null {\n return SharedOnlineState.fromWebStorageEntry(value);\n }\n\n private async handleMutationBatchEvent(\n mutationBatch: MutationMetadata\n ): Promise<void> {\n if (mutationBatch.user.uid !== this.currentUser.uid) {\n debug(\n LOG_TAG,\n `Ignoring mutation for non-active user ${mutationBatch.user.uid}`\n );\n return;\n }\n\n return this.syncEngine!.applyBatchState(\n mutationBatch.batchId,\n mutationBatch.state,\n mutationBatch.error\n );\n }\n\n private handleQueryTargetEvent(\n targetMetadata: QueryTargetMetadata\n ): Promise<void> {\n return this.syncEngine!.applyTargetState(\n targetMetadata.targetId,\n targetMetadata.state,\n targetMetadata.error\n );\n }\n\n private handleClientStateEvent(\n clientId: ClientId,\n clientState: RemoteClientState | null\n ): Promise<void> {\n const existingTargets = this.getAllActiveQueryTargets();\n\n if (clientState) {\n this.activeClients[clientId] = clientState;\n } else {\n delete this.activeClients[clientId];\n }\n\n const newTargets = this.getAllActiveQueryTargets();\n\n const addedTargets: TargetId[] = [];\n const removedTargets: TargetId[] = [];\n\n newTargets.forEach(async targetId => {\n if (!existingTargets.has(targetId)) {\n addedTargets.push(targetId);\n }\n });\n\n existingTargets.forEach(async targetId => {\n if (!newTargets.has(targetId)) {\n removedTargets.push(targetId);\n }\n });\n\n return this.syncEngine!.applyActiveTargetsChange(\n addedTargets,\n removedTargets\n );\n }\n\n private handleOnlineStateEvent(onlineState: SharedOnlineState): void {\n // We check whether the client that wrote this online state is still active\n // by comparing its client ID to the list of clients kept active in\n // IndexedDb. If a client does not update their IndexedDb client state\n // within 5 seconds, it is considered inactive and we don't emit an online\n // state event.\n if (this.activeClients[onlineState.clientId]) {\n this.onlineStateHandler!(onlineState.onlineState);\n }\n }\n}\n\nfunction fromWebStorageSequenceNumber(\n seqString: string | null\n): ListenSequenceNumber {\n let sequenceNumber = ListenSequence.INVALID;\n if (seqString != null) {\n try {\n const parsed = JSON.parse(seqString);\n assert(typeof parsed === 'number', 'Found non-numeric sequence number');\n sequenceNumber = parsed;\n } catch (e) {\n error(LOG_TAG, 'Failed to read sequence number from WebStorage', e);\n }\n }\n return sequenceNumber;\n}\n\n/**\n * `MemorySharedClientState` is a simple implementation of SharedClientState for\n * clients using memory persistence. The state in this class remains fully\n * isolated and no synchronization is performed.\n */\nexport class MemorySharedClientState implements SharedClientState {\n private localState = new LocalClientState();\n private queryState: { [targetId: number]: QueryTargetState } = {};\n\n syncEngine: SharedClientStateSyncer | null = null;\n onlineStateHandler: ((onlineState: OnlineState) => void) | null = null;\n sequenceNumberHandler:\n | ((sequenceNumber: ListenSequenceNumber) => void)\n | null = null;\n\n addPendingMutation(batchId: BatchId): void {\n // No op.\n }\n\n updateMutationState(\n batchId: BatchId,\n state: 'acknowledged' | 'rejected',\n error?: FirestoreError\n ): void {\n // No op.\n }\n\n addLocalQueryTarget(targetId: TargetId): QueryTargetState {\n this.localState.addQueryTarget(targetId);\n return this.queryState[targetId] || 'not-current';\n }\n\n updateQueryState(\n targetId: TargetId,\n state: QueryTargetState,\n error?: FirestoreError\n ): void {\n this.queryState[targetId] = state;\n }\n\n removeLocalQueryTarget(targetId: TargetId): void {\n this.localState.removeQueryTarget(targetId);\n }\n\n isLocalQueryTarget(targetId: TargetId): boolean {\n return this.localState.activeTargetIds.has(targetId);\n }\n\n clearQueryState(targetId: TargetId): void {\n delete this.queryState[targetId];\n }\n\n getAllActiveQueryTargets(): TargetIdSet {\n return this.localState.activeTargetIds;\n }\n\n isActiveQueryTarget(targetId: TargetId): boolean {\n return this.localState.activeTargetIds.has(targetId);\n }\n\n start(): Promise<void> {\n this.localState = new LocalClientState();\n return Promise.resolve();\n }\n\n handleUserChange(\n user: User,\n removedBatchIds: BatchId[],\n addedBatchIds: BatchId[]\n ): void {\n // No op.\n }\n\n setOnlineState(onlineState: OnlineState): void {\n // No op.\n }\n\n shutdown(): void {}\n\n writeSequenceNumber(sequenceNumber: ListenSequenceNumber): void {}\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { assert } from '../util/assert';\nimport { TargetId } from './types';\n\nconst RESERVED_BITS = 1;\n\nenum GeneratorIds {\n QueryCache = 0, // The target IDs for user-issued queries are even (end in 0).\n SyncEngine = 1 // The target IDs for limbo detection are odd (end in 1).\n}\n\n/**\n * Generates monotonically increasing target IDs for sending targets to the\n * watch stream.\n *\n * The client constructs two generators, one for the query cache (via\n * forQueryCache()), and one for limbo documents (via forSyncEngine()). These\n * two generators produce non-overlapping IDs (by using even and odd IDs\n * respectively).\n *\n * By separating the target ID space, the query cache can generate target IDs\n * that persist across client restarts, while sync engine can independently\n * generate in-memory target IDs that are transient and can be reused after a\n * restart.\n */\n// TODO(mrschmidt): Explore removing this class in favor of generating these IDs\n// directly in SyncEngine and LocalStore.\nexport class TargetIdGenerator {\n // Initialized in the constructor via call to seek().\n private nextId!: TargetId;\n\n /**\n * Instantiates a new TargetIdGenerator. If a seed is provided, the generator\n * will use the seed value as the next target ID.\n */\n constructor(private generatorId: number, seed?: number) {\n assert(\n (generatorId & RESERVED_BITS) === generatorId,\n `Generator ID ${generatorId} contains more than ${RESERVED_BITS} reserved bits`\n );\n this.seek(seed !== undefined ? seed : this.generatorId);\n }\n\n next(): TargetId {\n const nextId = this.nextId;\n this.nextId += 1 << RESERVED_BITS;\n return nextId;\n }\n\n /**\n * Returns the ID that follows the given ID. Subsequent calls to `next()`\n * use the newly returned target ID as their base.\n */\n // PORTING NOTE: Multi-tab only.\n after(targetId: TargetId): TargetId {\n this.seek(targetId + (1 << RESERVED_BITS));\n return this.next();\n }\n\n private seek(targetId: TargetId): void {\n assert(\n (targetId & RESERVED_BITS) === this.generatorId,\n 'Cannot supply target ID from different generator ID'\n );\n this.nextId = targetId;\n }\n\n static forTargetCache(): TargetIdGenerator {\n // We seed the query cache generator to return '2' as its first ID, as there\n // is no differentiation in the protocol layer between an unset number and\n // the number '0'. If we were to sent a target with target ID '0', the\n // backend would consider it unset and replace it with its own ID.\n const targetIdGenerator = new TargetIdGenerator(GeneratorIds.QueryCache, 2);\n return targetIdGenerator;\n }\n\n static forSyncEngine(): TargetIdGenerator {\n // Sync engine assigns target IDs for limbo document detection.\n return new TargetIdGenerator(GeneratorIds.SyncEngine);\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { QueryResult } from '../local/local_store';\nimport {\n documentKeySet,\n DocumentKeySet,\n MaybeDocumentMap\n} from '../model/collections';\nimport { Document, MaybeDocument } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport { DocumentSet } from '../model/document_set';\nimport { TargetChange } from '../remote/remote_event';\nimport { assert, fail } from '../util/assert';\n\nimport { Query } from './query';\nimport { OnlineState } from './types';\nimport {\n ChangeType,\n DocumentChangeSet,\n SyncState,\n ViewSnapshot\n} from './view_snapshot';\n\nexport type LimboDocumentChange = AddedLimboDocument | RemovedLimboDocument;\nexport class AddedLimboDocument {\n constructor(public key: DocumentKey) {}\n}\nexport class RemovedLimboDocument {\n constructor(public key: DocumentKey) {}\n}\n\n/** The result of applying a set of doc changes to a view. */\nexport interface ViewDocumentChanges {\n /** The new set of docs that should be in the view. */\n documentSet: DocumentSet;\n /** The diff of these docs with the previous set of docs. */\n changeSet: DocumentChangeSet;\n /**\n * Whether the set of documents passed in was not sufficient to calculate the\n * new state of the view and there needs to be another pass based on the\n * local cache.\n */\n needsRefill: boolean;\n\n mutatedKeys: DocumentKeySet;\n}\n\nexport interface ViewChange {\n snapshot?: ViewSnapshot;\n limboChanges: LimboDocumentChange[];\n}\n\n/**\n * View is responsible for computing the final merged truth of what docs are in\n * a query. It gets notified of local and remote changes to docs, and applies\n * the query filters and limits to determine the most correct possible results.\n */\nexport class View {\n private syncState: SyncState | null = null;\n /**\n * A flag whether the view is current with the backend. A view is considered\n * current after it has seen the current flag from the backend and did not\n * lose consistency within the watch stream (e.g. because of an existence\n * filter mismatch).\n */\n private current = false;\n private documentSet: DocumentSet;\n /** Documents in the view but not in the remote target */\n private limboDocuments = documentKeySet();\n /** Document Keys that have local changes */\n private mutatedKeys = documentKeySet();\n\n constructor(\n private query: Query,\n /** Documents included in the remote target */\n private _syncedDocuments: DocumentKeySet\n ) {\n this.documentSet = new DocumentSet(query.docComparator.bind(query));\n }\n\n /**\n * The set of remote documents that the server has told us belongs to the target associated with\n * this view.\n */\n get syncedDocuments(): DocumentKeySet {\n return this._syncedDocuments;\n }\n\n /**\n * Iterates over a set of doc changes, applies the query limit, and computes\n * what the new results should be, what the changes were, and whether we may\n * need to go back to the local cache for more results. Does not make any\n * changes to the view.\n * @param docChanges The doc changes to apply to this view.\n * @param previousChanges If this is being called with a refill, then start\n * with this set of docs and changes instead of the current view.\n * @return a new set of docs, changes, and refill flag.\n */\n computeDocChanges(\n docChanges: MaybeDocumentMap,\n previousChanges?: ViewDocumentChanges\n ): ViewDocumentChanges {\n const changeSet = previousChanges\n ? previousChanges.changeSet\n : new DocumentChangeSet();\n const oldDocumentSet = previousChanges\n ? previousChanges.documentSet\n : this.documentSet;\n let newMutatedKeys = previousChanges\n ? previousChanges.mutatedKeys\n : this.mutatedKeys;\n let newDocumentSet = oldDocumentSet;\n let needsRefill = false;\n\n // Track the last doc in a (full) limit. This is necessary, because some\n // update (a delete, or an update moving a doc past the old limit) might\n // mean there is some other document in the local cache that either should\n // come (1) between the old last limit doc and the new last document, in the\n // case of updates, or (2) after the new last document, in the case of\n // deletes. So we keep this doc at the old limit to compare the updates to.\n //\n // Note that this should never get used in a refill (when previousChanges is\n // set), because there will only be adds -- no deletes or updates.\n const lastDocInLimit =\n this.query.hasLimitToFirst() && oldDocumentSet.size === this.query.limit\n ? oldDocumentSet.last()\n : null;\n const firstDocInLimit =\n this.query.hasLimitToLast() && oldDocumentSet.size === this.query.limit\n ? oldDocumentSet.first()\n : null;\n\n docChanges.inorderTraversal(\n (key: DocumentKey, newMaybeDoc: MaybeDocument) => {\n const oldDoc = oldDocumentSet.get(key);\n let newDoc = newMaybeDoc instanceof Document ? newMaybeDoc : null;\n if (newDoc) {\n assert(\n key.isEqual(newDoc.key),\n 'Mismatching keys found in document changes: ' +\n key +\n ' != ' +\n newDoc.key\n );\n newDoc = this.query.matches(newDoc) ? newDoc : null;\n }\n\n const oldDocHadPendingMutations = oldDoc\n ? this.mutatedKeys.has(oldDoc.key)\n : false;\n const newDocHasPendingMutations = newDoc\n ? newDoc.hasLocalMutations ||\n // We only consider committed mutations for documents that were\n // mutated during the lifetime of the view.\n (this.mutatedKeys.has(newDoc.key) && newDoc.hasCommittedMutations)\n : false;\n\n let changeApplied = false;\n\n // Calculate change\n if (oldDoc && newDoc) {\n const docsEqual = oldDoc.data().isEqual(newDoc.data());\n if (!docsEqual) {\n if (!this.shouldWaitForSyncedDocument(oldDoc, newDoc)) {\n changeSet.track({\n type: ChangeType.Modified,\n doc: newDoc\n });\n changeApplied = true;\n\n if (\n (lastDocInLimit &&\n this.query.docComparator(newDoc, lastDocInLimit) > 0) ||\n (firstDocInLimit &&\n this.query.docComparator(newDoc, firstDocInLimit) < 0)\n ) {\n // This doc moved from inside the limit to outside the limit.\n // That means there may be some other doc in the local cache\n // that should be included instead.\n needsRefill = true;\n }\n }\n } else if (oldDocHadPendingMutations !== newDocHasPendingMutations) {\n changeSet.track({ type: ChangeType.Metadata, doc: newDoc });\n changeApplied = true;\n }\n } else if (!oldDoc && newDoc) {\n changeSet.track({ type: ChangeType.Added, doc: newDoc });\n changeApplied = true;\n } else if (oldDoc && !newDoc) {\n changeSet.track({ type: ChangeType.Removed, doc: oldDoc });\n changeApplied = true;\n\n if (lastDocInLimit || firstDocInLimit) {\n // A doc was removed from a full limit query. We'll need to\n // requery from the local cache to see if we know about some other\n // doc that should be in the results.\n needsRefill = true;\n }\n }\n\n if (changeApplied) {\n if (newDoc) {\n newDocumentSet = newDocumentSet.add(newDoc);\n if (newDocHasPendingMutations) {\n newMutatedKeys = newMutatedKeys.add(key);\n } else {\n newMutatedKeys = newMutatedKeys.delete(key);\n }\n } else {\n newDocumentSet = newDocumentSet.delete(key);\n newMutatedKeys = newMutatedKeys.delete(key);\n }\n }\n }\n );\n\n // Drop documents out to meet limit/limitToLast requirement.\n if (this.query.hasLimitToFirst() || this.query.hasLimitToLast()) {\n while (newDocumentSet.size > this.query.limit!) {\n const oldDoc = this.query.hasLimitToFirst()\n ? newDocumentSet.last()\n : newDocumentSet.first();\n newDocumentSet = newDocumentSet.delete(oldDoc!.key);\n newMutatedKeys = newMutatedKeys.delete(oldDoc!.key);\n changeSet.track({ type: ChangeType.Removed, doc: oldDoc! });\n }\n }\n\n assert(\n !needsRefill || !previousChanges,\n 'View was refilled using docs that themselves needed refilling.'\n );\n return {\n documentSet: newDocumentSet,\n changeSet,\n needsRefill,\n mutatedKeys: newMutatedKeys\n };\n }\n\n private shouldWaitForSyncedDocument(\n oldDoc: Document,\n newDoc: Document\n ): boolean {\n // We suppress the initial change event for documents that were modified as\n // part of a write acknowledgment (e.g. when the value of a server transform\n // is applied) as Watch will send us the same document again.\n // By suppressing the event, we only raise two user visible events (one with\n // `hasPendingWrites` and the final state of the document) instead of three\n // (one with `hasPendingWrites`, the modified document with\n // `hasPendingWrites` and the final state of the document).\n return (\n oldDoc.hasLocalMutations &&\n newDoc.hasCommittedMutations &&\n !newDoc.hasLocalMutations\n );\n }\n\n /**\n * Updates the view with the given ViewDocumentChanges and optionally updates\n * limbo docs and sync state from the provided target change.\n * @param docChanges The set of changes to make to the view's docs.\n * @param updateLimboDocuments Whether to update limbo documents based on this\n * change.\n * @param targetChange A target change to apply for computing limbo docs and\n * sync state.\n * @return A new ViewChange with the given docs, changes, and sync state.\n */\n // PORTING NOTE: The iOS/Android clients always compute limbo document changes.\n applyChanges(\n docChanges: ViewDocumentChanges,\n updateLimboDocuments: boolean,\n targetChange?: TargetChange\n ): ViewChange {\n assert(!docChanges.needsRefill, 'Cannot apply changes that need a refill');\n const oldDocs = this.documentSet;\n this.documentSet = docChanges.documentSet;\n this.mutatedKeys = docChanges.mutatedKeys;\n // Sort changes based on type and query comparator\n const changes = docChanges.changeSet.getChanges();\n changes.sort((c1, c2) => {\n return (\n compareChangeType(c1.type, c2.type) ||\n this.query.docComparator(c1.doc, c2.doc)\n );\n });\n\n this.applyTargetChange(targetChange);\n const limboChanges = updateLimboDocuments\n ? this.updateLimboDocuments()\n : [];\n const synced = this.limboDocuments.size === 0 && this.current;\n const newSyncState = synced ? SyncState.Synced : SyncState.Local;\n const syncStateChanged = newSyncState !== this.syncState;\n this.syncState = newSyncState;\n\n if (changes.length === 0 && !syncStateChanged) {\n // no changes\n return { limboChanges };\n } else {\n const snap: ViewSnapshot = new ViewSnapshot(\n this.query,\n docChanges.documentSet,\n oldDocs,\n changes,\n docChanges.mutatedKeys,\n newSyncState === SyncState.Local,\n syncStateChanged,\n /* excludesMetadataChanges= */ false\n );\n return {\n snapshot: snap,\n limboChanges\n };\n }\n }\n\n /**\n * Applies an OnlineState change to the view, potentially generating a\n * ViewChange if the view's syncState changes as a result.\n */\n applyOnlineStateChange(onlineState: OnlineState): ViewChange {\n if (this.current && onlineState === OnlineState.Offline) {\n // If we're offline, set `current` to false and then call applyChanges()\n // to refresh our syncState and generate a ViewChange as appropriate. We\n // are guaranteed to get a new TargetChange that sets `current` back to\n // true once the client is back online.\n this.current = false;\n return this.applyChanges(\n {\n documentSet: this.documentSet,\n changeSet: new DocumentChangeSet(),\n mutatedKeys: this.mutatedKeys,\n needsRefill: false\n },\n /* updateLimboDocuments= */ false\n );\n } else {\n // No effect, just return a no-op ViewChange.\n return { limboChanges: [] };\n }\n }\n\n /**\n * Returns whether the doc for the given key should be in limbo.\n */\n private shouldBeInLimbo(key: DocumentKey): boolean {\n // If the remote end says it's part of this query, it's not in limbo.\n if (this._syncedDocuments.has(key)) {\n return false;\n }\n // The local store doesn't think it's a result, so it shouldn't be in limbo.\n if (!this.documentSet.has(key)) {\n return false;\n }\n // If there are local changes to the doc, they might explain why the server\n // doesn't know that it's part of the query. So don't put it in limbo.\n // TODO(klimt): Ideally, we would only consider changes that might actually\n // affect this specific query.\n if (this.documentSet.get(key)!.hasLocalMutations) {\n return false;\n }\n // Everything else is in limbo.\n return true;\n }\n\n /**\n * Updates syncedDocuments, current, and limbo docs based on the given change.\n * Returns the list of changes to which docs are in limbo.\n */\n private applyTargetChange(targetChange?: TargetChange): void {\n if (targetChange) {\n targetChange.addedDocuments.forEach(\n key => (this._syncedDocuments = this._syncedDocuments.add(key))\n );\n targetChange.modifiedDocuments.forEach(key =>\n assert(\n this._syncedDocuments.has(key),\n `Modified document ${key} not found in view.`\n )\n );\n targetChange.removedDocuments.forEach(\n key => (this._syncedDocuments = this._syncedDocuments.delete(key))\n );\n this.current = targetChange.current;\n }\n }\n\n private updateLimboDocuments(): LimboDocumentChange[] {\n // We can only determine limbo documents when we're in-sync with the server.\n if (!this.current) {\n return [];\n }\n\n // TODO(klimt): Do this incrementally so that it's not quadratic when\n // updating many documents.\n const oldLimboDocuments = this.limboDocuments;\n this.limboDocuments = documentKeySet();\n this.documentSet.forEach(doc => {\n if (this.shouldBeInLimbo(doc.key)) {\n this.limboDocuments = this.limboDocuments.add(doc.key);\n }\n });\n\n // Diff the new limbo docs with the old limbo docs.\n const changes: LimboDocumentChange[] = [];\n oldLimboDocuments.forEach(key => {\n if (!this.limboDocuments.has(key)) {\n changes.push(new RemovedLimboDocument(key));\n }\n });\n this.limboDocuments.forEach(key => {\n if (!oldLimboDocuments.has(key)) {\n changes.push(new AddedLimboDocument(key));\n }\n });\n return changes;\n }\n\n /**\n * Update the in-memory state of the current view with the state read from\n * persistence.\n *\n * We update the query view whenever a client's primary status changes:\n * - When a client transitions from primary to secondary, it can miss\n * LocalStorage updates and its query views may temporarily not be\n * synchronized with the state on disk.\n * - For secondary to primary transitions, the client needs to update the list\n * of `syncedDocuments` since secondary clients update their query views\n * based purely on synthesized RemoteEvents.\n *\n * @param queryResult.documents - The documents that match the query according\n * to the LocalStore.\n * @param queryResult.remoteKeys - The keys of the documents that match the\n * query according to the backend.\n *\n * @return The ViewChange that resulted from this synchronization.\n */\n // PORTING NOTE: Multi-tab only.\n synchronizeWithPersistedState(queryResult: QueryResult): ViewChange {\n this._syncedDocuments = queryResult.remoteKeys;\n this.limboDocuments = documentKeySet();\n const docChanges = this.computeDocChanges(queryResult.documents);\n return this.applyChanges(docChanges, /*updateLimboDocuments=*/ true);\n }\n\n /**\n * Returns a view snapshot as if this query was just listened to. Contains\n * a document add for every existing document and the `fromCache` and\n * `hasPendingWrites` status of the already established view.\n */\n // PORTING NOTE: Multi-tab only.\n computeInitialSnapshot(): ViewSnapshot {\n return ViewSnapshot.fromInitialDocuments(\n this.query,\n this.documentSet,\n this.mutatedKeys,\n this.syncState === SyncState.Local\n );\n }\n}\n\nfunction compareChangeType(c1: ChangeType, c2: ChangeType): number {\n const order = (change: ChangeType): 0 | 1 | 2 => {\n switch (change) {\n case ChangeType.Added:\n return 1;\n case ChangeType.Modified:\n return 2;\n case ChangeType.Metadata:\n // A metadata change is converted to a modified change at the public\n // api layer. Since we sort by document key and then change type,\n // metadata and modified changes must be sorted equivalently.\n return 2;\n case ChangeType.Removed:\n return 0;\n default:\n return fail('Unknown ChangeType: ' + change);\n }\n };\n\n return order(c1) - order(c2);\n}\n","/**\n * @license\n * Copyright 2019 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Deferred } from '../util/promise';\nimport { TimerId, AsyncQueue } from '../util/async_queue';\nimport { ExponentialBackoff } from '../remote/backoff';\nimport { Transaction } from './transaction';\nimport { RemoteStore } from '../remote/remote_store';\nimport { isNullOrUndefined } from '../util/types';\nimport { isPermanentError } from '../remote/rpc_error';\nimport { FirestoreError } from '../util/error';\n\nconst RETRY_COUNT = 5;\n\n/**\n * TransactionRunner encapsulates the logic needed to run and retry transactions\n * with backoff.\n */\nexport class TransactionRunner<T> {\n private retries = RETRY_COUNT;\n private backoff: ExponentialBackoff;\n\n constructor(\n private readonly asyncQueue: AsyncQueue,\n private readonly remoteStore: RemoteStore,\n private readonly updateFunction: (transaction: Transaction) => Promise<T>,\n private readonly deferred: Deferred<T>\n ) {\n this.backoff = new ExponentialBackoff(\n this.asyncQueue,\n TimerId.RetryTransaction\n );\n }\n\n /** Runs the transaction and sets the result on deferred. */\n run(): void {\n this.runWithBackOff();\n }\n\n private runWithBackOff(): void {\n this.backoff.backoffAndRun(async () => {\n const transaction = this.remoteStore.createTransaction();\n const userPromise = this.tryRunUpdateFunction(transaction);\n if (userPromise) {\n userPromise\n .then(result => {\n this.asyncQueue.enqueueAndForget(() => {\n return transaction\n .commit()\n .then(() => {\n this.deferred.resolve(result);\n })\n .catch(commitError => {\n this.handleTransactionError(commitError);\n });\n });\n })\n .catch(userPromiseError => {\n this.handleTransactionError(userPromiseError);\n });\n }\n });\n }\n\n private tryRunUpdateFunction(transaction: Transaction): Promise<T> | null {\n try {\n const userPromise = this.updateFunction(transaction);\n if (\n isNullOrUndefined(userPromise) ||\n !userPromise.catch ||\n !userPromise.then\n ) {\n this.deferred.reject(\n Error('Transaction callback must return a Promise')\n );\n return null;\n }\n return userPromise;\n } catch (error) {\n // Do not retry errors thrown by user provided updateFunction.\n this.deferred.reject(error);\n return null;\n }\n }\n\n private handleTransactionError(error: Error): void {\n if (this.retries > 0 && this.isRetryableTransactionError(error)) {\n this.retries -= 1;\n this.asyncQueue.enqueueAndForget(() => {\n this.runWithBackOff();\n return Promise.resolve();\n });\n } else {\n this.deferred.reject(error);\n }\n }\n\n private isRetryableTransactionError(error: Error): boolean {\n if (error.name === 'FirebaseError') {\n // In transactions, the backend will fail outdated reads with FAILED_PRECONDITION and\n // non-matching document versions with ABORTED. These errors should be retried.\n const code = (error as FirestoreError).code;\n return (\n code === 'aborted' ||\n code === 'failed-precondition' ||\n !isPermanentError(code)\n );\n }\n return false;\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { User } from '../auth/user';\nimport { ignoreIfPrimaryLeaseLoss, LocalStore } from '../local/local_store';\nimport { LocalViewChanges } from '../local/local_view_changes';\nimport { ReferenceSet } from '../local/reference_set';\nimport { TargetData, TargetPurpose } from '../local/target_data';\nimport {\n documentKeySet,\n DocumentKeySet,\n MaybeDocumentMap\n} from '../model/collections';\nimport { MaybeDocument, NoDocument } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport { Mutation } from '../model/mutation';\nimport { MutationBatchResult, BATCHID_UNKNOWN } from '../model/mutation_batch';\nimport { RemoteEvent, TargetChange } from '../remote/remote_event';\nimport { RemoteStore } from '../remote/remote_store';\nimport { RemoteSyncer } from '../remote/remote_syncer';\nimport { assert, fail } from '../util/assert';\nimport { Code, FirestoreError } from '../util/error';\nimport * as log from '../util/log';\nimport { primitiveComparator } from '../util/misc';\nimport { ObjectMap } from '../util/obj_map';\nimport { Deferred } from '../util/promise';\nimport { SortedMap } from '../util/sorted_map';\n\nimport { ClientId, SharedClientState } from '../local/shared_client_state';\nimport {\n QueryTargetState,\n SharedClientStateSyncer\n} from '../local/shared_client_state_syncer';\nimport * as objUtils from '../util/obj';\nimport { SortedSet } from '../util/sorted_set';\nimport { ListenSequence } from './listen_sequence';\nimport { Query, LimitType } from './query';\nimport { SnapshotVersion } from './snapshot_version';\nimport { Target } from './target';\nimport { TargetIdGenerator } from './target_id_generator';\nimport { Transaction } from './transaction';\nimport {\n BatchId,\n MutationBatchState,\n OnlineState,\n OnlineStateSource,\n TargetId\n} from './types';\nimport {\n AddedLimboDocument,\n LimboDocumentChange,\n RemovedLimboDocument,\n View,\n ViewChange,\n ViewDocumentChanges\n} from './view';\nimport { ViewSnapshot } from './view_snapshot';\nimport { AsyncQueue } from '../util/async_queue';\nimport { TransactionRunner } from './transaction_runner';\n\nconst LOG_TAG = 'SyncEngine';\n\n/**\n * QueryView contains all of the data that SyncEngine needs to keep track of for\n * a particular query.\n */\nclass QueryView {\n constructor(\n /**\n * The query itself.\n */\n public query: Query,\n /**\n * The target number created by the client that is used in the watch\n * stream to identify this query.\n */\n public targetId: TargetId,\n /**\n * The view is responsible for computing the final merged truth of what\n * docs are in the query. It gets notified of local and remote changes,\n * and applies the query filters and limits to determine the most correct\n * possible results.\n */\n public view: View\n ) {}\n}\n\n/** Tracks a limbo resolution. */\nclass LimboResolution {\n constructor(public key: DocumentKey) {}\n\n /**\n * Set to true once we've received a document. This is used in\n * getRemoteKeysForTarget() and ultimately used by WatchChangeAggregator to\n * decide whether it needs to manufacture a delete event for the target once\n * the target is CURRENT.\n */\n receivedDocument: boolean = false;\n}\n\n/**\n * Interface implemented by EventManager to handle notifications from\n * SyncEngine.\n */\nexport interface SyncEngineListener {\n /** Handles new view snapshots. */\n onWatchChange(snapshots: ViewSnapshot[]): void;\n\n /** Handles the failure of a query. */\n onWatchError(query: Query, error: Error): void;\n\n /** Handles a change in online state. */\n onOnlineStateChange(onlineState: OnlineState): void;\n}\n\n/**\n * SyncEngine is the central controller in the client SDK architecture. It is\n * the glue code between the EventManager, LocalStore, and RemoteStore. Some of\n * SyncEngine's responsibilities include:\n * 1. Coordinating client requests and remote events between the EventManager\n * and the local and remote data stores.\n * 2. Managing a View object for each query, providing the unified view between\n * the local and remote data stores.\n * 3. Notifying the RemoteStore when the LocalStore has new mutations in its\n * queue that need sending to the backend.\n *\n * The SyncEngine’s methods should only ever be called by methods running in the\n * global async queue.\n */\nexport class SyncEngine implements RemoteSyncer, SharedClientStateSyncer {\n private syncEngineListener: SyncEngineListener | null = null;\n\n private queryViewsByQuery = new ObjectMap<Query, QueryView>(q =>\n q.canonicalId()\n );\n private queriesByTarget: { [targetId: number]: Query[] } = {};\n private limboTargetsByKey = new SortedMap<DocumentKey, TargetId>(\n DocumentKey.comparator\n );\n private limboResolutionsByTarget: {\n [targetId: number]: LimboResolution;\n } = {};\n private limboDocumentRefs = new ReferenceSet();\n /** Stores user completion handlers, indexed by User and BatchId. */\n private mutationUserCallbacks = {} as {\n [uidKey: string]: SortedMap<BatchId, Deferred<void>>;\n };\n /** Stores user callbacks waiting for all pending writes to be acknowledged. */\n private pendingWritesCallbacks = new Map<BatchId, Array<Deferred<void>>>();\n private limboTargetIdGenerator = TargetIdGenerator.forSyncEngine();\n\n // The primary state is set to `true` or `false` immediately after Firestore\n // startup. In the interim, a client should only be considered primary if\n // `isPrimary` is true.\n private isPrimary: undefined | boolean = undefined;\n private onlineState: OnlineState = OnlineState.Unknown;\n\n constructor(\n private localStore: LocalStore,\n private remoteStore: RemoteStore,\n // PORTING NOTE: Manages state synchronization in multi-tab environments.\n private sharedClientState: SharedClientState,\n private currentUser: User\n ) {}\n\n // Only used for testing.\n get isPrimaryClient(): boolean {\n return this.isPrimary === true;\n }\n\n /** Subscribes to SyncEngine notifications. Has to be called exactly once. */\n subscribe(syncEngineListener: SyncEngineListener): void {\n assert(syncEngineListener !== null, 'SyncEngine listener cannot be null');\n assert(\n this.syncEngineListener === null,\n 'SyncEngine already has a subscriber.'\n );\n\n this.syncEngineListener = syncEngineListener;\n }\n\n /**\n * Initiates the new listen, resolves promise when listen enqueued to the\n * server. All the subsequent view snapshots or errors are sent to the\n * subscribed handlers. Returns the targetId of the query.\n */\n async listen(query: Query): Promise<TargetId> {\n this.assertSubscribed('listen()');\n\n let targetId;\n let viewSnapshot;\n\n const queryView = this.queryViewsByQuery.get(query);\n if (queryView) {\n // PORTING NOTE: With Multi-Tab Web, it is possible that a query view\n // already exists when EventManager calls us for the first time. This\n // happens when the primary tab is already listening to this query on\n // behalf of another tab and the user of the primary also starts listening\n // to the query. EventManager will not have an assigned target ID in this\n // case and calls `listen` to obtain this ID.\n targetId = queryView.targetId;\n this.sharedClientState.addLocalQueryTarget(targetId);\n viewSnapshot = queryView.view.computeInitialSnapshot();\n } else {\n const targetData = await this.localStore.allocateTarget(query.toTarget());\n\n const status = this.sharedClientState.addLocalQueryTarget(\n targetData.targetId\n );\n targetId = targetData.targetId;\n viewSnapshot = await this.initializeViewAndComputeSnapshot(\n query,\n targetId,\n status === 'current'\n );\n if (this.isPrimary) {\n this.remoteStore.listen(targetData);\n }\n }\n\n this.syncEngineListener!.onWatchChange([viewSnapshot]);\n return targetId;\n }\n\n /**\n * Registers a view for a previously unknown query and computes its initial\n * snapshot.\n */\n private async initializeViewAndComputeSnapshot(\n query: Query,\n targetId: TargetId,\n current: boolean\n ): Promise<ViewSnapshot> {\n const queryResult = await this.localStore.executeQuery(\n query,\n /* usePreviousResults= */ true\n );\n const view = new View(query, queryResult.remoteKeys);\n const viewDocChanges = view.computeDocChanges(queryResult.documents);\n const synthesizedTargetChange = TargetChange.createSynthesizedTargetChangeForCurrentChange(\n targetId,\n current && this.onlineState !== OnlineState.Offline\n );\n const viewChange = view.applyChanges(\n viewDocChanges,\n /* updateLimboDocuments= */ this.isPrimary === true,\n synthesizedTargetChange\n );\n assert(\n viewChange.limboChanges.length === 0,\n 'View returned limbo docs before target ack from the server.'\n );\n assert(\n !!viewChange.snapshot,\n 'applyChanges for new view should always return a snapshot'\n );\n\n const data = new QueryView(query, targetId, view);\n this.queryViewsByQuery.set(query, data);\n if (!this.queriesByTarget[targetId]) {\n this.queriesByTarget[targetId] = [];\n }\n this.queriesByTarget[targetId].push(query);\n return viewChange.snapshot!;\n }\n\n /**\n * Reconcile the list of synced documents in an existing view with those\n * from persistence.\n */\n // PORTING NOTE: Multi-tab only.\n private async synchronizeViewAndComputeSnapshot(\n queryView: QueryView\n ): Promise<ViewChange> {\n const queryResult = await this.localStore.executeQuery(\n queryView.query,\n /* usePreviousResults= */ true\n );\n const viewSnapshot = queryView.view.synchronizeWithPersistedState(\n queryResult\n );\n if (this.isPrimary) {\n this.updateTrackedLimbos(queryView.targetId, viewSnapshot.limboChanges);\n }\n return viewSnapshot;\n }\n\n /** Stops listening to the query. */\n async unlisten(query: Query): Promise<void> {\n this.assertSubscribed('unlisten()');\n\n const queryView = this.queryViewsByQuery.get(query)!;\n assert(!!queryView, 'Trying to unlisten on query not found:' + query);\n\n // Only clean up the query view and target if this is the only query mapped\n // to the target.\n const queries = this.queriesByTarget[queryView.targetId];\n if (queries.length > 1) {\n this.queriesByTarget[queryView.targetId] = queries.filter(\n q => !q.isEqual(query)\n );\n this.queryViewsByQuery.delete(query);\n return;\n }\n\n // No other queries are mapped to the target, clean up the query and the target.\n if (this.isPrimary) {\n // We need to remove the local query target first to allow us to verify\n // whether any other client is still interested in this target.\n this.sharedClientState.removeLocalQueryTarget(queryView.targetId);\n const targetRemainsActive = this.sharedClientState.isActiveQueryTarget(\n queryView.targetId\n );\n\n if (!targetRemainsActive) {\n await this.localStore\n .releaseTarget(queryView.targetId, /*keepPersistedTargetData=*/ false)\n .then(() => {\n this.sharedClientState.clearQueryState(queryView.targetId);\n this.remoteStore.unlisten(queryView.targetId);\n this.removeAndCleanupTarget(queryView.targetId);\n })\n .catch(ignoreIfPrimaryLeaseLoss);\n }\n } else {\n this.removeAndCleanupTarget(queryView.targetId);\n await this.localStore.releaseTarget(\n queryView.targetId,\n /*keepPersistedTargetData=*/ true\n );\n }\n }\n\n /**\n * Initiates the write of local mutation batch which involves adding the\n * writes to the mutation queue, notifying the remote store about new\n * mutations and raising events for any changes this write caused.\n *\n * The promise returned by this call is resolved when the above steps\n * have completed, *not* when the write was acked by the backend. The\n * userCallback is resolved once the write was acked/rejected by the\n * backend (or failed locally for any other reason).\n */\n async write(batch: Mutation[], userCallback: Deferred<void>): Promise<void> {\n this.assertSubscribed('write()');\n const result = await this.localStore.localWrite(batch);\n this.sharedClientState.addPendingMutation(result.batchId);\n this.addMutationCallback(result.batchId, userCallback);\n await this.emitNewSnapsAndNotifyLocalStore(result.changes);\n await this.remoteStore.fillWritePipeline();\n }\n\n /**\n * Takes an updateFunction in which a set of reads and writes can be performed\n * atomically. In the updateFunction, the client can read and write values\n * using the supplied transaction object. After the updateFunction, all\n * changes will be committed. If a retryable error occurs (ex: some other\n * client has changed any of the data referenced), then the updateFunction\n * will be called again after a backoff. If the updateFunction still fails\n * after all retries, then the transaction will be rejected.\n *\n * The transaction object passed to the updateFunction contains methods for\n * accessing documents and collections. Unlike other datastore access, data\n * accessed with the transaction will not reflect local changes that have not\n * been committed. For this reason, it is required that all reads are\n * performed before any writes. Transactions must be performed while online.\n *\n * The Deferred input is resolved when the transaction is fully committed.\n */\n runTransaction<T>(\n asyncQueue: AsyncQueue,\n updateFunction: (transaction: Transaction) => Promise<T>,\n deferred: Deferred<T>\n ): void {\n new TransactionRunner<T>(\n asyncQueue,\n this.remoteStore,\n updateFunction,\n deferred\n ).run();\n }\n\n async applyRemoteEvent(remoteEvent: RemoteEvent): Promise<void> {\n this.assertSubscribed('applyRemoteEvent()');\n try {\n const changes = await this.localStore.applyRemoteEvent(remoteEvent);\n // Update `receivedDocument` as appropriate for any limbo targets.\n objUtils.forEach(remoteEvent.targetChanges, (targetId, targetChange) => {\n const limboResolution = this.limboResolutionsByTarget[Number(targetId)];\n if (limboResolution) {\n // Since this is a limbo resolution lookup, it's for a single document\n // and it could be added, modified, or removed, but not a combination.\n assert(\n targetChange.addedDocuments.size +\n targetChange.modifiedDocuments.size +\n targetChange.removedDocuments.size <=\n 1,\n 'Limbo resolution for single document contains multiple changes.'\n );\n if (targetChange.addedDocuments.size > 0) {\n limboResolution.receivedDocument = true;\n } else if (targetChange.modifiedDocuments.size > 0) {\n assert(\n limboResolution.receivedDocument,\n 'Received change for limbo target document without add.'\n );\n } else if (targetChange.removedDocuments.size > 0) {\n assert(\n limboResolution.receivedDocument,\n 'Received remove for limbo target document without add.'\n );\n limboResolution.receivedDocument = false;\n } else {\n // This was probably just a CURRENT targetChange or similar.\n }\n }\n });\n await this.emitNewSnapsAndNotifyLocalStore(changes, remoteEvent);\n } catch (error) {\n await ignoreIfPrimaryLeaseLoss(error);\n }\n }\n\n /**\n * Applies an OnlineState change to the sync engine and notifies any views of\n * the change.\n */\n applyOnlineStateChange(\n onlineState: OnlineState,\n source: OnlineStateSource\n ): void {\n // If we are the secondary client, we explicitly ignore the remote store's\n // online state (the local client may go offline, even though the primary\n // tab remains online) and only apply the primary tab's online state from\n // SharedClientState.\n if (\n (this.isPrimary && source === OnlineStateSource.RemoteStore) ||\n (!this.isPrimary && source === OnlineStateSource.SharedClientState)\n ) {\n this.assertSubscribed('applyOnlineStateChange()');\n const newViewSnapshots = [] as ViewSnapshot[];\n this.queryViewsByQuery.forEach((query, queryView) => {\n const viewChange = queryView.view.applyOnlineStateChange(onlineState);\n assert(\n viewChange.limboChanges.length === 0,\n 'OnlineState should not affect limbo documents.'\n );\n if (viewChange.snapshot) {\n newViewSnapshots.push(viewChange.snapshot);\n }\n });\n this.syncEngineListener!.onOnlineStateChange(onlineState);\n this.syncEngineListener!.onWatchChange(newViewSnapshots);\n\n this.onlineState = onlineState;\n if (this.isPrimary) {\n this.sharedClientState.setOnlineState(onlineState);\n }\n }\n }\n\n async rejectListen(targetId: TargetId, err: FirestoreError): Promise<void> {\n this.assertSubscribed('rejectListens()');\n\n // PORTING NOTE: Multi-tab only.\n this.sharedClientState.updateQueryState(targetId, 'rejected', err);\n\n const limboResolution = this.limboResolutionsByTarget[targetId];\n const limboKey = limboResolution && limboResolution.key;\n if (limboKey) {\n // Since this query failed, we won't want to manually unlisten to it.\n // So go ahead and remove it from bookkeeping.\n this.limboTargetsByKey = this.limboTargetsByKey.remove(limboKey);\n delete this.limboResolutionsByTarget[targetId];\n\n // TODO(klimt): We really only should do the following on permission\n // denied errors, but we don't have the cause code here.\n\n // It's a limbo doc. Create a synthetic event saying it was deleted.\n // This is kind of a hack. Ideally, we would have a method in the local\n // store to purge a document. However, it would be tricky to keep all of\n // the local store's invariants with another method.\n let documentUpdates = new SortedMap<DocumentKey, MaybeDocument>(\n DocumentKey.comparator\n );\n documentUpdates = documentUpdates.insert(\n limboKey,\n new NoDocument(limboKey, SnapshotVersion.forDeletedDoc())\n );\n const resolvedLimboDocuments = documentKeySet().add(limboKey);\n const event = new RemoteEvent(\n SnapshotVersion.MIN,\n /* targetChanges= */ {},\n /* targetMismatches= */ new SortedSet<TargetId>(primitiveComparator),\n documentUpdates,\n resolvedLimboDocuments\n );\n return this.applyRemoteEvent(event);\n } else {\n await this.localStore\n .releaseTarget(targetId, /* keepPersistedTargetData */ false)\n .then(() => this.removeAndCleanupTarget(targetId, err))\n .catch(ignoreIfPrimaryLeaseLoss);\n }\n }\n\n // PORTING NOTE: Multi-tab only\n async applyBatchState(\n batchId: BatchId,\n batchState: MutationBatchState,\n error?: FirestoreError\n ): Promise<void> {\n this.assertSubscribed('applyBatchState()');\n const documents = await this.localStore.lookupMutationDocuments(batchId);\n\n if (documents === null) {\n // A throttled tab may not have seen the mutation before it was completed\n // and removed from the mutation queue, in which case we won't have cached\n // the affected documents. In this case we can safely ignore the update\n // since that means we didn't apply the mutation locally at all (if we\n // had, we would have cached the affected documents), and so we will just\n // see any resulting document changes via normal remote document updates\n // as applicable.\n log.debug(LOG_TAG, 'Cannot apply mutation batch with id: ' + batchId);\n return;\n }\n\n if (batchState === 'pending') {\n // If we are the primary client, we need to send this write to the\n // backend. Secondary clients will ignore these writes since their remote\n // connection is disabled.\n await this.remoteStore.fillWritePipeline();\n } else if (batchState === 'acknowledged' || batchState === 'rejected') {\n // NOTE: Both these methods are no-ops for batches that originated from\n // other clients.\n this.processUserCallback(batchId, error ? error : null);\n this.localStore.removeCachedMutationBatchMetadata(batchId);\n } else {\n fail(`Unknown batchState: ${batchState}`);\n }\n\n await this.emitNewSnapsAndNotifyLocalStore(documents);\n }\n\n async applySuccessfulWrite(\n mutationBatchResult: MutationBatchResult\n ): Promise<void> {\n this.assertSubscribed('applySuccessfulWrite()');\n\n const batchId = mutationBatchResult.batch.batchId;\n\n // The local store may or may not be able to apply the write result and\n // raise events immediately (depending on whether the watcher is caught\n // up), so we raise user callbacks first so that they consistently happen\n // before listen events.\n this.processUserCallback(batchId, /*error=*/ null);\n\n this.triggerPendingWritesCallbacks(batchId);\n\n try {\n const changes = await this.localStore.acknowledgeBatch(\n mutationBatchResult\n );\n this.sharedClientState.updateMutationState(batchId, 'acknowledged');\n await this.emitNewSnapsAndNotifyLocalStore(changes);\n } catch (error) {\n await ignoreIfPrimaryLeaseLoss(error);\n }\n }\n\n async rejectFailedWrite(\n batchId: BatchId,\n error: FirestoreError\n ): Promise<void> {\n this.assertSubscribed('rejectFailedWrite()');\n\n // The local store may or may not be able to apply the write result and\n // raise events immediately (depending on whether the watcher is caught up),\n // so we raise user callbacks first so that they consistently happen before\n // listen events.\n this.processUserCallback(batchId, error);\n\n this.triggerPendingWritesCallbacks(batchId);\n\n try {\n const changes = await this.localStore.rejectBatch(batchId);\n this.sharedClientState.updateMutationState(batchId, 'rejected', error);\n await this.emitNewSnapsAndNotifyLocalStore(changes);\n } catch (error) {\n await ignoreIfPrimaryLeaseLoss(error);\n }\n }\n\n /**\n * Registers a user callback that resolves when all pending mutations at the moment of calling\n * are acknowledged .\n */\n async registerPendingWritesCallback(callback: Deferred<void>): Promise<void> {\n if (!this.remoteStore.canUseNetwork()) {\n log.debug(\n LOG_TAG,\n 'The network is disabled. The task returned by ' +\n \"'awaitPendingWrites()' will not complete until the network is enabled.\"\n );\n }\n\n const highestBatchId = await this.localStore.getHighestUnacknowledgedBatchId();\n if (highestBatchId === BATCHID_UNKNOWN) {\n // Trigger the callback right away if there is no pending writes at the moment.\n callback.resolve();\n return;\n }\n\n const callbacks = this.pendingWritesCallbacks.get(highestBatchId) || [];\n callbacks.push(callback);\n this.pendingWritesCallbacks.set(highestBatchId, callbacks);\n }\n\n /**\n * Triggers the callbacks that are waiting for this batch id to get acknowledged by server,\n * if there are any.\n */\n private triggerPendingWritesCallbacks(batchId: BatchId): void {\n (this.pendingWritesCallbacks.get(batchId) || []).forEach(callback => {\n callback.resolve();\n });\n\n this.pendingWritesCallbacks.delete(batchId);\n }\n\n /** Reject all outstanding callbacks waiting for pending writes to complete. */\n private rejectOutstandingPendingWritesCallbacks(errorMessage: string): void {\n this.pendingWritesCallbacks.forEach(callbacks => {\n callbacks.forEach(callback => {\n callback.reject(new FirestoreError(Code.CANCELLED, errorMessage));\n });\n });\n\n this.pendingWritesCallbacks.clear();\n }\n\n private addMutationCallback(\n batchId: BatchId,\n callback: Deferred<void>\n ): void {\n let newCallbacks = this.mutationUserCallbacks[this.currentUser.toKey()];\n if (!newCallbacks) {\n newCallbacks = new SortedMap<BatchId, Deferred<void>>(\n primitiveComparator\n );\n }\n newCallbacks = newCallbacks.insert(batchId, callback);\n this.mutationUserCallbacks[this.currentUser.toKey()] = newCallbacks;\n }\n\n /**\n * Resolves or rejects the user callback for the given batch and then discards\n * it.\n */\n private processUserCallback(batchId: BatchId, error: Error | null): void {\n let newCallbacks = this.mutationUserCallbacks[this.currentUser.toKey()];\n\n // NOTE: Mutations restored from persistence won't have callbacks, so it's\n // okay for there to be no callback for this ID.\n if (newCallbacks) {\n const callback = newCallbacks.get(batchId);\n if (callback) {\n assert(\n batchId === newCallbacks.minKey(),\n 'Mutation callbacks processed out-of-order?'\n );\n if (error) {\n callback.reject(error);\n } else {\n callback.resolve();\n }\n newCallbacks = newCallbacks.remove(batchId);\n }\n this.mutationUserCallbacks[this.currentUser.toKey()] = newCallbacks;\n }\n }\n\n private removeAndCleanupTarget(\n targetId: number,\n error: Error | null = null\n ): void {\n this.sharedClientState.removeLocalQueryTarget(targetId);\n\n assert(\n this.queriesByTarget[targetId] &&\n this.queriesByTarget[targetId].length !== 0,\n `There are no queries mapped to target id ${targetId}`\n );\n\n for (const query of this.queriesByTarget[targetId]) {\n this.queryViewsByQuery.delete(query);\n if (error) {\n this.syncEngineListener!.onWatchError(query, error);\n }\n }\n\n delete this.queriesByTarget[targetId];\n\n if (this.isPrimary) {\n const limboKeys = this.limboDocumentRefs.referencesForId(targetId);\n this.limboDocumentRefs.removeReferencesForId(targetId);\n limboKeys.forEach(limboKey => {\n const isReferenced = this.limboDocumentRefs.containsKey(limboKey);\n if (!isReferenced) {\n // We removed the last reference for this key\n this.removeLimboTarget(limboKey);\n }\n });\n }\n }\n\n private removeLimboTarget(key: DocumentKey): void {\n // It's possible that the target already got removed because the query failed. In that case,\n // the key won't exist in `limboTargetsByKey`. Only do the cleanup if we still have the target.\n const limboTargetId = this.limboTargetsByKey.get(key);\n if (limboTargetId === null) {\n // This target already got removed, because the query failed.\n return;\n }\n\n this.remoteStore.unlisten(limboTargetId);\n this.limboTargetsByKey = this.limboTargetsByKey.remove(key);\n delete this.limboResolutionsByTarget[limboTargetId];\n }\n\n private updateTrackedLimbos(\n targetId: TargetId,\n limboChanges: LimboDocumentChange[]\n ): void {\n for (const limboChange of limboChanges) {\n if (limboChange instanceof AddedLimboDocument) {\n this.limboDocumentRefs.addReference(limboChange.key, targetId);\n this.trackLimboChange(limboChange);\n } else if (limboChange instanceof RemovedLimboDocument) {\n log.debug(LOG_TAG, 'Document no longer in limbo: ' + limboChange.key);\n this.limboDocumentRefs.removeReference(limboChange.key, targetId);\n const isReferenced = this.limboDocumentRefs.containsKey(\n limboChange.key\n );\n if (!isReferenced) {\n // We removed the last reference for this key\n this.removeLimboTarget(limboChange.key);\n }\n } else {\n fail('Unknown limbo change: ' + JSON.stringify(limboChange));\n }\n }\n }\n\n private trackLimboChange(limboChange: AddedLimboDocument): void {\n const key = limboChange.key;\n if (!this.limboTargetsByKey.get(key)) {\n log.debug(LOG_TAG, 'New document in limbo: ' + key);\n const limboTargetId = this.limboTargetIdGenerator.next();\n const query = Query.atPath(key.path);\n this.limboResolutionsByTarget[limboTargetId] = new LimboResolution(key);\n this.remoteStore.listen(\n new TargetData(\n query.toTarget(),\n limboTargetId,\n TargetPurpose.LimboResolution,\n ListenSequence.INVALID\n )\n );\n this.limboTargetsByKey = this.limboTargetsByKey.insert(\n key,\n limboTargetId\n );\n }\n }\n\n // Visible for testing\n currentLimboDocs(): SortedMap<DocumentKey, TargetId> {\n return this.limboTargetsByKey;\n }\n\n private async emitNewSnapsAndNotifyLocalStore(\n changes: MaybeDocumentMap,\n remoteEvent?: RemoteEvent\n ): Promise<void> {\n const newSnaps: ViewSnapshot[] = [];\n const docChangesInAllViews: LocalViewChanges[] = [];\n const queriesProcessed: Array<Promise<void>> = [];\n\n this.queryViewsByQuery.forEach((_, queryView) => {\n queriesProcessed.push(\n Promise.resolve()\n .then(() => {\n const viewDocChanges = queryView.view.computeDocChanges(changes);\n if (!viewDocChanges.needsRefill) {\n return viewDocChanges;\n }\n // The query has a limit and some docs were removed, so we need\n // to re-run the query against the local store to make sure we\n // didn't lose any good docs that had been past the limit.\n return this.localStore\n .executeQuery(queryView.query, /* usePreviousResults= */ false)\n .then(({ documents }) => {\n return queryView.view.computeDocChanges(\n documents,\n viewDocChanges\n );\n });\n })\n .then((viewDocChanges: ViewDocumentChanges) => {\n const targetChange =\n remoteEvent && remoteEvent.targetChanges[queryView.targetId];\n const viewChange = queryView.view.applyChanges(\n viewDocChanges,\n /* updateLimboDocuments= */ this.isPrimary === true,\n targetChange\n );\n this.updateTrackedLimbos(\n queryView.targetId,\n viewChange.limboChanges\n );\n if (viewChange.snapshot) {\n if (this.isPrimary) {\n this.sharedClientState.updateQueryState(\n queryView.targetId,\n viewChange.snapshot.fromCache ? 'not-current' : 'current'\n );\n }\n\n newSnaps.push(viewChange.snapshot);\n const docChanges = LocalViewChanges.fromSnapshot(\n queryView.targetId,\n viewChange.snapshot\n );\n docChangesInAllViews.push(docChanges);\n }\n })\n );\n });\n\n await Promise.all(queriesProcessed);\n this.syncEngineListener!.onWatchChange(newSnaps);\n await this.localStore.notifyLocalViewChanges(docChangesInAllViews);\n }\n\n private assertSubscribed(fnName: string): void {\n assert(\n this.syncEngineListener !== null,\n 'Trying to call ' + fnName + ' before calling subscribe().'\n );\n }\n\n async handleCredentialChange(user: User): Promise<void> {\n const userChanged = !this.currentUser.isEqual(user);\n this.currentUser = user;\n\n if (userChanged) {\n // Fails tasks waiting for pending writes requested by previous user.\n this.rejectOutstandingPendingWritesCallbacks(\n \"'waitForPendingWrites' promise is rejected due to a user change.\"\n );\n\n const result = await this.localStore.handleUserChange(user);\n // TODO(b/114226417): Consider calling this only in the primary tab.\n this.sharedClientState.handleUserChange(\n user,\n result.removedBatchIds,\n result.addedBatchIds\n );\n await this.emitNewSnapsAndNotifyLocalStore(result.affectedDocuments);\n }\n\n await this.remoteStore.handleCredentialChange();\n }\n\n // PORTING NOTE: Multi-tab only\n async applyPrimaryState(isPrimary: boolean): Promise<void> {\n if (isPrimary === true && this.isPrimary !== true) {\n this.isPrimary = true;\n await this.remoteStore.applyPrimaryState(true);\n\n // Secondary tabs only maintain Views for their local listeners and the\n // Views internal state may not be 100% populated (in particular\n // secondary tabs don't track syncedDocuments, the set of documents the\n // server considers to be in the target). So when a secondary becomes\n // primary, we need to need to make sure that all views for all targets\n // match the state on disk.\n const activeTargets = this.sharedClientState.getAllActiveQueryTargets();\n const activeQueries = await this.synchronizeQueryViewsAndRaiseSnapshots(\n activeTargets.toArray()\n );\n for (const targetData of activeQueries) {\n this.remoteStore.listen(targetData);\n }\n } else if (isPrimary === false && this.isPrimary !== false) {\n this.isPrimary = false;\n\n const activeTargets: TargetId[] = [];\n\n let p = Promise.resolve();\n objUtils.forEachNumber(this.queriesByTarget, (targetId, _) => {\n if (this.sharedClientState.isLocalQueryTarget(targetId)) {\n activeTargets.push(targetId);\n } else {\n p = p.then(() => {\n this.removeAndCleanupTarget(targetId);\n return this.localStore.releaseTarget(\n targetId,\n /*keepPersistedTargetData=*/ true\n );\n });\n }\n this.remoteStore.unlisten(targetId);\n });\n await p;\n\n await this.synchronizeQueryViewsAndRaiseSnapshots(activeTargets);\n this.resetLimboDocuments();\n await this.remoteStore.applyPrimaryState(false);\n }\n }\n\n // PORTING NOTE: Multi-tab only.\n private resetLimboDocuments(): void {\n objUtils.forEachNumber(this.limboResolutionsByTarget, targetId => {\n this.remoteStore.unlisten(targetId);\n });\n this.limboDocumentRefs.removeAllReferences();\n this.limboResolutionsByTarget = [];\n this.limboTargetsByKey = new SortedMap<DocumentKey, TargetId>(\n DocumentKey.comparator\n );\n }\n\n /**\n * Reconcile the query views of the provided query targets with the state from\n * persistence. Raises snapshots for any changes that affect the local\n * client and returns the updated state of all target's query data.\n */\n // PORTING NOTE: Multi-tab only.\n private async synchronizeQueryViewsAndRaiseSnapshots(\n targets: TargetId[]\n ): Promise<TargetData[]> {\n const activeQueries: TargetData[] = [];\n const newViewSnapshots: ViewSnapshot[] = [];\n for (const targetId of targets) {\n let targetData: TargetData;\n const queries = this.queriesByTarget[targetId];\n\n if (queries && queries.length !== 0) {\n // For queries that have a local View, we need to update their state\n // in LocalStore (as the resume token and the snapshot version\n // might have changed) and reconcile their views with the persisted\n // state (the list of syncedDocuments may have gotten out of sync).\n await this.localStore.releaseTarget(\n targetId,\n /*keepPersistedTargetData=*/ true\n );\n targetData = await this.localStore.allocateTarget(\n queries[0].toTarget()\n );\n\n for (const query of queries) {\n const queryView = this.queryViewsByQuery.get(query);\n assert(!!queryView, `No query view found for ${query}`);\n\n const viewChange = await this.synchronizeViewAndComputeSnapshot(\n queryView\n );\n if (viewChange.snapshot) {\n newViewSnapshots.push(viewChange.snapshot);\n }\n }\n } else {\n assert(\n this.isPrimary === true,\n 'A secondary tab should never have an active target without an active query.'\n );\n // For queries that never executed on this client, we need to\n // allocate the target in LocalStore and initialize a new View.\n const target = await this.localStore.getTarget(targetId);\n assert(!!target, `Target for id ${targetId} not found`);\n targetData = await this.localStore.allocateTarget(target);\n await this.initializeViewAndComputeSnapshot(\n this.synthesizeTargetToQuery(target!),\n targetId,\n /*current=*/ false\n );\n }\n\n activeQueries.push(targetData!);\n }\n\n this.syncEngineListener!.onWatchChange(newViewSnapshots);\n return activeQueries;\n }\n\n /**\n * Creates a `Query` object from the specified `Target`. There is no way to\n * obtain the original `Query`, so we synthesize a `Query` from the `Target`\n * object.\n *\n * The synthesized result might be different from the original `Query`, but\n * since the synthesized `Query` should return the same results as the\n * original one (only the presentation of results might differ), the potential\n * difference will not cause issues.\n */\n // PORTING NOTE: Multi-tab only\n private synthesizeTargetToQuery(target: Target): Query {\n return new Query(\n target.path,\n target.collectionGroup,\n target.orderBy,\n target.filters,\n target.limit,\n LimitType.First,\n target.startAt,\n target.endAt\n );\n }\n\n // PORTING NOTE: Multi-tab only\n getActiveClients(): Promise<ClientId[]> {\n return this.localStore.getActiveClients();\n }\n\n // PORTING NOTE: Multi-tab only\n async applyTargetState(\n targetId: TargetId,\n state: QueryTargetState,\n error?: FirestoreError\n ): Promise<void> {\n if (this.isPrimary) {\n // If we receive a target state notification via WebStorage, we are\n // either already secondary or another tab has taken the primary lease.\n log.debug(LOG_TAG, 'Ignoring unexpected query state notification.');\n return;\n }\n\n if (this.queriesByTarget[targetId]) {\n switch (state) {\n case 'current':\n case 'not-current': {\n const changes = await this.localStore.getNewDocumentChanges();\n const synthesizedRemoteEvent = RemoteEvent.createSynthesizedRemoteEventForCurrentChange(\n targetId,\n state === 'current'\n );\n await this.emitNewSnapsAndNotifyLocalStore(\n changes,\n synthesizedRemoteEvent\n );\n break;\n }\n case 'rejected': {\n await this.localStore.releaseTarget(\n targetId,\n /* keepPersistedTargetData */ true\n );\n this.removeAndCleanupTarget(targetId, error);\n break;\n }\n default:\n fail('Unexpected target state: ' + state);\n }\n }\n }\n\n // PORTING NOTE: Multi-tab only\n async applyActiveTargetsChange(\n added: TargetId[],\n removed: TargetId[]\n ): Promise<void> {\n if (!this.isPrimary) {\n return;\n }\n\n for (const targetId of added) {\n assert(\n !this.queriesByTarget[targetId],\n 'Trying to add an already active target'\n );\n const target = await this.localStore.getTarget(targetId);\n assert(!!target, `Query data for active target ${targetId} not found`);\n const targetData = await this.localStore.allocateTarget(target);\n await this.initializeViewAndComputeSnapshot(\n this.synthesizeTargetToQuery(target),\n targetData.targetId,\n /*current=*/ false\n );\n this.remoteStore.listen(targetData);\n }\n\n for (const targetId of removed) {\n // Check that the target is still active since the target might have been\n // removed if it has been rejected by the backend.\n if (!this.queriesByTarget[targetId]) {\n continue;\n }\n\n // Release queries that are still active.\n await this.localStore\n .releaseTarget(targetId, /* keepPersistedTargetData */ false)\n .then(() => {\n this.remoteStore.unlisten(targetId);\n this.removeAndCleanupTarget(targetId);\n })\n .catch(ignoreIfPrimaryLeaseLoss);\n }\n }\n\n // PORTING NOTE: Multi-tab only. In other clients, LocalStore is unaware of\n // the online state.\n enableNetwork(): Promise<void> {\n this.localStore.setNetworkEnabled(true);\n return this.remoteStore.enableNetwork();\n }\n\n // PORTING NOTE: Multi-tab only. In other clients, LocalStore is unaware of\n // the online state.\n disableNetwork(): Promise<void> {\n this.localStore.setNetworkEnabled(false);\n return this.remoteStore.disableNetwork();\n }\n\n getRemoteKeysForTarget(targetId: TargetId): DocumentKeySet {\n const limboResolution = this.limboResolutionsByTarget[targetId];\n if (limboResolution && limboResolution.receivedDocument) {\n return documentKeySet().add(limboResolution.key);\n } else {\n let keySet = documentKeySet();\n const queries = this.queriesByTarget[targetId];\n if (!queries) {\n return keySet;\n }\n for (const query of queries) {\n const queryView = this.queryViewsByQuery.get(query);\n assert(!!queryView, `No query view found for ${query}`);\n keySet = keySet.unionWith(queryView.view.syncedDocuments);\n }\n return keySet;\n }\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { assert } from '../util/assert';\nimport { EventHandler } from '../util/misc';\nimport { ObjectMap } from '../util/obj_map';\nimport { Query } from './query';\nimport { SyncEngine, SyncEngineListener } from './sync_engine';\nimport { OnlineState, TargetId } from './types';\nimport { DocumentViewChange, ChangeType, ViewSnapshot } from './view_snapshot';\n\n/**\n * Holds the listeners and the last received ViewSnapshot for a query being\n * tracked by EventManager.\n */\nclass QueryListenersInfo {\n viewSnap: ViewSnapshot | null = null;\n targetId: TargetId = 0;\n listeners: QueryListener[] = [];\n}\n\n/**\n * Interface for handling events from the EventManager.\n */\nexport interface Observer<T> {\n next: EventHandler<T>;\n error: EventHandler<Error>;\n}\n\n/**\n * EventManager is responsible for mapping queries to query event emitters.\n * It handles \"fan-out\". -- Identical queries will re-use the same watch on the\n * backend.\n */\nexport class EventManager implements SyncEngineListener {\n private queries = new ObjectMap<Query, QueryListenersInfo>(q =>\n q.canonicalId()\n );\n\n private onlineState: OnlineState = OnlineState.Unknown;\n\n private snapshotsInSyncListeners: Set<Observer<void>> = new Set();\n\n constructor(private syncEngine: SyncEngine) {\n this.syncEngine.subscribe(this);\n }\n\n listen(listener: QueryListener): Promise<TargetId> {\n const query = listener.query;\n let firstListen = false;\n\n let queryInfo = this.queries.get(query);\n if (!queryInfo) {\n firstListen = true;\n queryInfo = new QueryListenersInfo();\n this.queries.set(query, queryInfo);\n }\n queryInfo.listeners.push(listener);\n\n // Run global snapshot listeners if a consistent snapshot has been emitted.\n const raisedEvent = listener.applyOnlineStateChange(this.onlineState);\n assert(\n !raisedEvent,\n \"applyOnlineStateChange() shouldn't raise an event for brand-new listeners.\"\n );\n\n if (queryInfo.viewSnap) {\n const raisedEvent = listener.onViewSnapshot(queryInfo.viewSnap);\n if (raisedEvent) {\n this.raiseSnapshotsInSyncEvent();\n }\n }\n\n if (firstListen) {\n return this.syncEngine.listen(query).then(targetId => {\n queryInfo!.targetId = targetId;\n return targetId;\n });\n } else {\n return Promise.resolve(queryInfo.targetId);\n }\n }\n\n async unlisten(listener: QueryListener): Promise<void> {\n const query = listener.query;\n let lastListen = false;\n\n const queryInfo = this.queries.get(query);\n if (queryInfo) {\n const i = queryInfo.listeners.indexOf(listener);\n if (i >= 0) {\n queryInfo.listeners.splice(i, 1);\n lastListen = queryInfo.listeners.length === 0;\n }\n }\n\n if (lastListen) {\n this.queries.delete(query);\n return this.syncEngine.unlisten(query);\n }\n }\n\n onWatchChange(viewSnaps: ViewSnapshot[]): void {\n let raisedEvent = false;\n for (const viewSnap of viewSnaps) {\n const query = viewSnap.query;\n const queryInfo = this.queries.get(query);\n if (queryInfo) {\n for (const listener of queryInfo.listeners) {\n if (listener.onViewSnapshot(viewSnap)) {\n raisedEvent = true;\n }\n }\n queryInfo.viewSnap = viewSnap;\n }\n }\n if (raisedEvent) {\n this.raiseSnapshotsInSyncEvent();\n }\n }\n\n onWatchError(query: Query, error: Error): void {\n const queryInfo = this.queries.get(query);\n if (queryInfo) {\n for (const listener of queryInfo.listeners) {\n listener.onError(error);\n }\n }\n\n // Remove all listeners. NOTE: We don't need to call syncEngine.unlisten()\n // after an error.\n this.queries.delete(query);\n }\n\n onOnlineStateChange(onlineState: OnlineState): void {\n this.onlineState = onlineState;\n let raisedEvent = false;\n this.queries.forEach((_, queryInfo) => {\n for (const listener of queryInfo.listeners) {\n // Run global snapshot listeners if a consistent snapshot has been emitted.\n if (listener.applyOnlineStateChange(onlineState)) {\n raisedEvent = true;\n }\n }\n });\n if (raisedEvent) {\n this.raiseSnapshotsInSyncEvent();\n }\n }\n\n addSnapshotsInSyncListener(observer: Observer<void>): void {\n this.snapshotsInSyncListeners.add(observer);\n // Immediately fire an initial event, indicating all existing listeners\n // are in-sync.\n observer.next();\n }\n\n removeSnapshotsInSyncListener(observer: Observer<void>): void {\n this.snapshotsInSyncListeners.delete(observer);\n }\n\n // Call all global snapshot listeners that have been set.\n private raiseSnapshotsInSyncEvent(): void {\n this.snapshotsInSyncListeners.forEach(observer => {\n observer.next();\n });\n }\n}\n\nexport interface ListenOptions {\n /** Raise events even when only the metadata changes */\n readonly includeMetadataChanges?: boolean;\n\n /**\n * Wait for a sync with the server when online, but still raise events while\n * offline.\n */\n readonly waitForSyncWhenOnline?: boolean;\n}\n\n/**\n * QueryListener takes a series of internal view snapshots and determines\n * when to raise the event.\n *\n * It uses an Observer to dispatch events.\n */\nexport class QueryListener {\n /**\n * Initial snapshots (e.g. from cache) may not be propagated to the wrapped\n * observer. This flag is set to true once we've actually raised an event.\n */\n private raisedInitialEvent = false;\n\n private options: ListenOptions;\n\n private snap: ViewSnapshot | null = null;\n\n private onlineState: OnlineState = OnlineState.Unknown;\n\n constructor(\n readonly query: Query,\n private queryObserver: Observer<ViewSnapshot>,\n options?: ListenOptions\n ) {\n this.options = options || {};\n }\n\n /**\n * Applies the new ViewSnapshot to this listener, raising a user-facing event\n * if applicable (depending on what changed, whether the user has opted into\n * metadata-only changes, etc.). Returns true if a user-facing event was\n * indeed raised.\n */\n onViewSnapshot(snap: ViewSnapshot): boolean {\n assert(\n snap.docChanges.length > 0 || snap.syncStateChanged,\n 'We got a new snapshot with no changes?'\n );\n\n if (!this.options.includeMetadataChanges) {\n // Remove the metadata only changes.\n const docChanges: DocumentViewChange[] = [];\n for (const docChange of snap.docChanges) {\n if (docChange.type !== ChangeType.Metadata) {\n docChanges.push(docChange);\n }\n }\n snap = new ViewSnapshot(\n snap.query,\n snap.docs,\n snap.oldDocs,\n docChanges,\n snap.mutatedKeys,\n snap.fromCache,\n snap.syncStateChanged,\n /* excludesMetadataChanges= */ true\n );\n }\n let raisedEvent = false;\n if (!this.raisedInitialEvent) {\n if (this.shouldRaiseInitialEvent(snap, this.onlineState)) {\n this.raiseInitialEvent(snap);\n raisedEvent = true;\n }\n } else if (this.shouldRaiseEvent(snap)) {\n this.queryObserver.next(snap);\n raisedEvent = true;\n }\n\n this.snap = snap;\n return raisedEvent;\n }\n\n onError(error: Error): void {\n this.queryObserver.error(error);\n }\n\n /** Returns whether a snapshot was raised. */\n applyOnlineStateChange(onlineState: OnlineState): boolean {\n this.onlineState = onlineState;\n let raisedEvent = false;\n if (\n this.snap &&\n !this.raisedInitialEvent &&\n this.shouldRaiseInitialEvent(this.snap, onlineState)\n ) {\n this.raiseInitialEvent(this.snap);\n raisedEvent = true;\n }\n return raisedEvent;\n }\n\n private shouldRaiseInitialEvent(\n snap: ViewSnapshot,\n onlineState: OnlineState\n ): boolean {\n assert(\n !this.raisedInitialEvent,\n 'Determining whether to raise first event but already had first event'\n );\n\n // Always raise the first event when we're synced\n if (!snap.fromCache) {\n return true;\n }\n\n // NOTE: We consider OnlineState.Unknown as online (it should become Offline\n // or Online if we wait long enough).\n const maybeOnline = onlineState !== OnlineState.Offline;\n // Don't raise the event if we're online, aren't synced yet (checked\n // above) and are waiting for a sync.\n if (this.options.waitForSyncWhenOnline && maybeOnline) {\n assert(\n snap.fromCache,\n 'Waiting for sync, but snapshot is not from cache'\n );\n return false;\n }\n\n // Raise data from cache if we have any documents or we are offline\n return !snap.docs.isEmpty() || onlineState === OnlineState.Offline;\n }\n\n private shouldRaiseEvent(snap: ViewSnapshot): boolean {\n // We don't need to handle includeDocumentMetadataChanges here because\n // the Metadata only changes have already been stripped out if needed.\n // At this point the only changes we will see are the ones we should\n // propagate.\n if (snap.docChanges.length > 0) {\n return true;\n }\n\n const hasPendingWritesChanged =\n this.snap && this.snap.hasPendingWrites !== snap.hasPendingWrites;\n if (snap.syncStateChanged || hasPendingWritesChanged) {\n return this.options.includeMetadataChanges === true;\n }\n\n // Generally we should have hit one of the cases above, but it's possible\n // to get here if there were only metadata docChanges and they got\n // stripped out.\n return false;\n }\n\n private raiseInitialEvent(snap: ViewSnapshot): void {\n assert(\n !this.raisedInitialEvent,\n 'Trying to raise initial events for second time'\n );\n snap = ViewSnapshot.fromInitialDocuments(\n snap.query,\n snap.docs,\n snap.mutatedKeys,\n snap.fromCache\n );\n this.raisedInitialEvent = true;\n this.queryObserver.next(snap);\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ResourcePath } from '../model/path';\nimport { assert, fail } from '../util/assert';\n\n/**\n * Helpers for dealing with resource paths stored in IndexedDB.\n *\n * Resource paths in their canonical string form do not sort as the server\n * sorts them. Specifically the server splits paths into segments first and then\n * sorts, putting end-of-segment before any character. In a UTF-8 string\n * encoding the slash ('/') that denotes the end-of-segment naturally comes\n * after other characters so the intent here is to encode the path delimiters in\n * such a way that the resulting strings sort naturally.\n *\n * Resource paths are also used for prefix scans so it's important to\n * distinguish whole segments from any longer segments of which they might be a\n * prefix. For example, it's important to make it possible to scan documents in\n * a collection \"foo\" without encountering documents in a collection \"foobar\".\n *\n * Separate from the concerns about resource path ordering and separation,\n * On Android, SQLite imposes additional restrictions since it does not handle\n * keys with embedded NUL bytes particularly well. Rather than change the\n * implementation we keep the encoding identical to keep the ports similar.\n *\n * Taken together this means resource paths when encoded for storage in\n * IndexedDB have the following characteristics:\n *\n * * Segment separators (\"/\") sort before everything else.\n * * All paths have a trailing separator.\n * * NUL bytes do not exist in the output, since IndexedDB doesn't treat them\n * well.\n *\n * Therefore resource paths are encoded into string form using the following\n * rules:\n *\n * * '\\x01' is used as an escape character.\n * * Path separators are encoded as \"\\x01\\x01\"\n * * NUL bytes are encoded as \"\\x01\\x10\"\n * * '\\x01' is encoded as \"\\x01\\x11\"\n *\n * This encoding leaves some room between path separators and the NUL byte\n * just in case we decide to support integer document ids after all.\n *\n * Note that characters treated specially by the backend ('.', '/', and '~')\n * are not treated specially here. This class assumes that any unescaping of\n * resource path strings into actual ResourcePath objects will handle these\n * characters there.\n */\nexport type EncodedResourcePath = string;\n\nconst escapeChar = '\\u0001';\nconst encodedSeparatorChar = '\\u0001';\nconst encodedNul = '\\u0010';\nconst encodedEscape = '\\u0011';\n\n/**\n * Encodes a resource path into a IndexedDb-compatible string form.\n */\nexport function encode(path: ResourcePath): EncodedResourcePath {\n let result = '';\n for (let i = 0; i < path.length; i++) {\n if (result.length > 0) {\n result = encodeSeparator(result);\n }\n result = encodeSegment(path.get(i), result);\n }\n return encodeSeparator(result);\n}\n\n/** Encodes a single segment of a resource path into the given result */\nfunction encodeSegment(segment: string, resultBuf: string): string {\n let result = resultBuf;\n const length = segment.length;\n for (let i = 0; i < length; i++) {\n const c = segment.charAt(i);\n switch (c) {\n case '\\0':\n result += escapeChar + encodedNul;\n break;\n case escapeChar:\n result += escapeChar + encodedEscape;\n break;\n default:\n result += c;\n }\n }\n return result;\n}\n\n/** Encodes a path separator into the given result */\nfunction encodeSeparator(result: string): string {\n return result + escapeChar + encodedSeparatorChar;\n}\n\n/**\n * Decodes the given IndexedDb-compatible string form of a resource path into\n * a ResourcePath instance. Note that this method is not suitable for use with\n * decoding resource names from the server; those are One Platform format\n * strings.\n */\nexport function decode(path: EncodedResourcePath): ResourcePath {\n // Event the empty path must encode as a path of at least length 2. A path\n // with exactly 2 must be the empty path.\n const length = path.length;\n assert(length >= 2, 'Invalid path ' + path);\n if (length === 2) {\n assert(\n path.charAt(0) === escapeChar && path.charAt(1) === encodedSeparatorChar,\n 'Non-empty path ' + path + ' had length 2'\n );\n return ResourcePath.EMPTY_PATH;\n }\n\n // Escape characters cannot exist past the second-to-last position in the\n // source value.\n const lastReasonableEscapeIndex = length - 2;\n\n const segments: string[] = [];\n let segmentBuilder = '';\n\n for (let start = 0; start < length; ) {\n // The last two characters of a valid encoded path must be a separator, so\n // there must be an end to this segment.\n const end = path.indexOf(escapeChar, start);\n if (end < 0 || end > lastReasonableEscapeIndex) {\n fail('Invalid encoded resource path: \"' + path + '\"');\n }\n\n const next = path.charAt(end + 1);\n switch (next) {\n case encodedSeparatorChar:\n const currentPiece = path.substring(start, end);\n let segment;\n if (segmentBuilder.length === 0) {\n // Avoid copying for the common case of a segment that excludes \\0\n // and \\001\n segment = currentPiece;\n } else {\n segmentBuilder += currentPiece;\n segment = segmentBuilder;\n segmentBuilder = '';\n }\n segments.push(segment);\n break;\n case encodedNul:\n segmentBuilder += path.substring(start, end);\n segmentBuilder += '\\0';\n break;\n case encodedEscape:\n // The escape character can be used in the output to encode itself.\n segmentBuilder += path.substring(start, end + 1);\n break;\n default:\n fail('Invalid encoded resource path: \"' + path + '\"');\n }\n\n start = end + 2;\n }\n\n return new ResourcePath(segments);\n}\n\n/**\n * Computes the prefix successor of the given path, computed by encode above.\n * A prefix successor is the first key that cannot be prefixed by the given\n * path. It's useful for defining the end of a prefix scan such that all keys\n * in the scan have the same prefix.\n *\n * Note that this is not a general prefix successor implementation, which is\n * tricky to get right with Strings, given that they encode down to UTF-8.\n * Instead this relies on the fact that all paths encoded by this class are\n * always terminated with a separator, and so a successor can always be\n * cheaply computed by incrementing the last character of the path.\n */\nexport function prefixSuccessor(\n path: EncodedResourcePath\n): EncodedResourcePath {\n const c = path.charCodeAt(path.length - 1);\n // TODO(mcg): this really should be a general thing, but not worth it right\n // now\n assert(c === 1, 'successor may only operate on paths generated by encode');\n return path.substring(0, path.length - 1) + String.fromCharCode(c + 1);\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { getUA } from '@firebase/util';\nimport { assert } from '../util/assert';\nimport { Code, FirestoreError } from '../util/error';\nimport { debug, error } from '../util/log';\nimport { Deferred } from '../util/promise';\nimport { SCHEMA_VERSION } from './indexeddb_schema';\nimport { PersistencePromise } from './persistence_promise';\n\nconst LOG_TAG = 'SimpleDb';\n\n/**\n * The maximum number of retry attempts for an IndexedDb transaction that fails\n * with a DOMException.\n */\nconst TRANSACTION_RETRY_COUNT = 3;\n\n// The different modes supported by `SimpleDb.runTransaction()`\ntype SimpleDbTransactionMode =\n | 'readonly'\n | 'readwrite'\n | 'readonly-idempotent'\n | 'readwrite-idempotent';\n\nexport interface SimpleDbSchemaConverter {\n createOrUpgrade(\n db: IDBDatabase,\n txn: IDBTransaction,\n fromVersion: number,\n toVersion: number\n ): PersistencePromise<void>;\n}\n\n/**\n * Provides a wrapper around IndexedDb with a simplified interface that uses\n * Promise-like return values to chain operations. Real promises cannot be used\n * since .then() continuations are executed asynchronously (e.g. via\n * .setImmediate), which would cause IndexedDB to end the transaction.\n * See PersistencePromise for more details.\n */\nexport class SimpleDb {\n /**\n * Opens the specified database, creating or upgrading it if necessary.\n *\n * Note that `version` must not be a downgrade. IndexedDB does not support downgrading the schema\n * version. We currently do not support any way to do versioning outside of IndexedDB's versioning\n * mechanism, as only version-upgrade transactions are allowed to do things like create\n * objectstores.\n */\n static openOrCreate(\n name: string,\n version: number,\n schemaConverter: SimpleDbSchemaConverter\n ): Promise<SimpleDb> {\n assert(\n SimpleDb.isAvailable(),\n 'IndexedDB not supported in current environment.'\n );\n debug(LOG_TAG, 'Opening database:', name);\n return new PersistencePromise<SimpleDb>((resolve, reject) => {\n // TODO(mikelehen): Investigate browser compatibility.\n // https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API/Using_IndexedDB\n // suggests IE9 and older WebKit browsers handle upgrade\n // differently. They expect setVersion, as described here:\n // https://developer.mozilla.org/en-US/docs/Web/API/IDBVersionChangeRequest/setVersion\n const request = window.indexedDB.open(name, version);\n\n request.onsuccess = (event: Event) => {\n const db = (event.target as IDBOpenDBRequest).result;\n resolve(new SimpleDb(db));\n };\n\n request.onblocked = () => {\n reject(\n new FirestoreError(\n Code.FAILED_PRECONDITION,\n 'Cannot upgrade IndexedDB schema while another tab is open. ' +\n 'Close all tabs that access Firestore and reload this page to proceed.'\n )\n );\n };\n\n request.onerror = (event: Event) => {\n const error: DOMException = (event.target as IDBOpenDBRequest).error!;\n if (error.name === 'VersionError') {\n reject(\n new FirestoreError(\n Code.FAILED_PRECONDITION,\n 'A newer version of the Firestore SDK was previously used and so the persisted ' +\n 'data is not compatible with the version of the SDK you are now using. The SDK ' +\n 'will operate with persistence disabled. If you need persistence, please ' +\n 're-upgrade to a newer version of the SDK or else clear the persisted IndexedDB ' +\n 'data for your app to start fresh.'\n )\n );\n } else {\n reject(error);\n }\n };\n\n request.onupgradeneeded = (event: IDBVersionChangeEvent) => {\n debug(\n LOG_TAG,\n 'Database \"' + name + '\" requires upgrade from version:',\n event.oldVersion\n );\n const db = (event.target as IDBOpenDBRequest).result;\n schemaConverter\n .createOrUpgrade(\n db,\n request.transaction!,\n event.oldVersion,\n SCHEMA_VERSION\n )\n .next(() => {\n debug(\n LOG_TAG,\n 'Database upgrade to version ' + SCHEMA_VERSION + ' complete'\n );\n });\n };\n }).toPromise();\n }\n\n /** Deletes the specified database. */\n static delete(name: string): Promise<void> {\n debug(LOG_TAG, 'Removing database:', name);\n return wrapRequest<void>(window.indexedDB.deleteDatabase(name)).toPromise();\n }\n\n /** Returns true if IndexedDB is available in the current environment. */\n static isAvailable(): boolean {\n if (typeof window === 'undefined' || window.indexedDB == null) {\n return false;\n }\n\n if (SimpleDb.isMockPersistence()) {\n return true;\n }\n\n // In some Node environments, `window` is defined, but `window.navigator` is\n // not. We don't support IndexedDB persistence in Node if the\n // isMockPersistence() check above returns false.\n if (window.navigator === undefined) {\n return false;\n }\n\n // We extensively use indexed array values and compound keys,\n // which IE and Edge do not support. However, they still have indexedDB\n // defined on the window, so we need to check for them here and make sure\n // to return that persistence is not enabled for those browsers.\n // For tracking support of this feature, see here:\n // https://developer.microsoft.com/en-us/microsoft-edge/platform/status/indexeddbarraysandmultientrysupport/\n\n // Check the UA string to find out the browser.\n const ua = getUA();\n\n // IE 10\n // ua = 'Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.2; Trident/6.0)';\n\n // IE 11\n // ua = 'Mozilla/5.0 (Windows NT 6.3; Trident/7.0; rv:11.0) like Gecko';\n\n // Edge\n // ua = 'Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML,\n // like Gecko) Chrome/39.0.2171.71 Safari/537.36 Edge/12.0';\n\n // iOS Safari: Disable for users running iOS version < 10.\n const iOSVersion = SimpleDb.getIOSVersion(ua);\n const isUnsupportedIOS = 0 < iOSVersion && iOSVersion < 10;\n\n // Android browser: Disable for userse running version < 4.5.\n const androidVersion = SimpleDb.getAndroidVersion(ua);\n const isUnsupportedAndroid = 0 < androidVersion && androidVersion < 4.5;\n\n if (\n ua.indexOf('MSIE ') > 0 ||\n ua.indexOf('Trident/') > 0 ||\n ua.indexOf('Edge/') > 0 ||\n isUnsupportedIOS ||\n isUnsupportedAndroid\n ) {\n return false;\n } else {\n return true;\n }\n }\n\n /**\n * Returns true if the backing IndexedDB store is the Node IndexedDBShim\n * (see https://github.com/axemclion/IndexedDBShim).\n */\n static isMockPersistence(): boolean {\n return (\n typeof process !== 'undefined' &&\n process.env?.USE_MOCK_PERSISTENCE === 'YES'\n );\n }\n\n /** Helper to get a typed SimpleDbStore from a transaction. */\n static getStore<KeyType extends IDBValidKey, ValueType extends unknown>(\n txn: SimpleDbTransaction,\n store: string\n ): SimpleDbStore<KeyType, ValueType> {\n return txn.store<KeyType, ValueType>(store);\n }\n\n // visible for testing\n /** Parse User Agent to determine iOS version. Returns -1 if not found. */\n static getIOSVersion(ua: string): number {\n const iOSVersionRegex = ua.match(/i(?:phone|pad|pod) os ([\\d_]+)/i);\n const version = iOSVersionRegex\n ? iOSVersionRegex[1]\n .split('_')\n .slice(0, 2)\n .join('.')\n : '-1';\n return Number(version);\n }\n\n // visible for testing\n /** Parse User Agent to determine Android version. Returns -1 if not found. */\n static getAndroidVersion(ua: string): number {\n const androidVersionRegex = ua.match(/Android ([\\d.]+)/i);\n const version = androidVersionRegex\n ? androidVersionRegex[1]\n .split('.')\n .slice(0, 2)\n .join('.')\n : '-1';\n return Number(version);\n }\n\n constructor(private db: IDBDatabase) {\n const iOSVersion = SimpleDb.getIOSVersion(getUA());\n // NOTE: According to https://bugs.webkit.org/show_bug.cgi?id=197050, the\n // bug we're checking for should exist in iOS >= 12.2 and < 13, but for\n // whatever reason it's much harder to hit after 12.2 so we only proactively\n // log on 12.2.\n if (iOSVersion === 12.2) {\n error(\n 'Firestore persistence suffers from a bug in iOS 12.2 ' +\n 'Safari that may cause your app to stop working. See ' +\n 'https://stackoverflow.com/q/56496296/110915 for details ' +\n 'and a potential workaround.'\n );\n }\n }\n\n setVersionChangeListener(\n versionChangeListener: (event: IDBVersionChangeEvent) => void\n ): void {\n this.db.onversionchange = (event: IDBVersionChangeEvent) => {\n return versionChangeListener(event);\n };\n }\n\n async runTransaction<T>(\n mode: SimpleDbTransactionMode,\n objectStores: string[],\n transactionFn: (transaction: SimpleDbTransaction) => PersistencePromise<T>\n ): Promise<T> {\n const readonly = mode.startsWith('readonly');\n const idempotent = mode.endsWith('idempotent');\n let attemptNumber = 0;\n\n while (true) {\n ++attemptNumber;\n\n const transaction = SimpleDbTransaction.open(\n this.db,\n readonly ? 'readonly' : 'readwrite',\n objectStores\n );\n try {\n const transactionFnResult = transactionFn(transaction)\n .catch(error => {\n // Abort the transaction if there was an error.\n transaction.abort(error);\n // We cannot actually recover, and calling `abort()` will cause the transaction's\n // completion promise to be rejected. This in turn means that we won't use\n // `transactionFnResult` below. We return a rejection here so that we don't add the\n // possibility of returning `void` to the type of `transactionFnResult`.\n return PersistencePromise.reject<T>(error);\n })\n .toPromise();\n\n // As noted above, errors are propagated by aborting the transaction. So\n // we swallow any error here to avoid the browser logging it as unhandled.\n transactionFnResult.catch(() => {});\n\n // Wait for the transaction to complete (i.e. IndexedDb's onsuccess event to\n // fire), but still return the original transactionFnResult back to the\n // caller.\n await transaction.completionPromise;\n return transactionFnResult;\n } catch (error) {\n // TODO(schmidt-sebastian): We could probably be smarter about this and\n // not retry exceptions that are likely unrecoverable (such as quota\n // exceeded errors).\n\n // Note: We cannot use an instanceof check for FirestoreException, since the\n // exception is wrapped in a generic error by our async/await handling.\n const retryable =\n idempotent &&\n error.name !== 'FirebaseError' &&\n attemptNumber < TRANSACTION_RETRY_COUNT;\n debug(\n LOG_TAG,\n 'Transaction failed with error: %s. Retrying: %s.',\n error.message,\n retryable\n );\n\n if (!retryable) {\n return Promise.reject(error);\n }\n }\n }\n }\n\n close(): void {\n this.db.close();\n }\n}\n\n/**\n * A controller for iterating over a key range or index. It allows an iterate\n * callback to delete the currently-referenced object, or jump to a new key\n * within the key range or index.\n */\nexport class IterationController {\n private shouldStop = false;\n private nextKey: IDBValidKey | null = null;\n\n constructor(private dbCursor: IDBCursorWithValue) {}\n\n get isDone(): boolean {\n return this.shouldStop;\n }\n\n get skipToKey(): IDBValidKey | null {\n return this.nextKey;\n }\n\n set cursor(value: IDBCursorWithValue) {\n this.dbCursor = value;\n }\n\n /**\n * This function can be called to stop iteration at any point.\n */\n done(): void {\n this.shouldStop = true;\n }\n\n /**\n * This function can be called to skip to that next key, which could be\n * an index or a primary key.\n */\n skip(key: IDBValidKey): void {\n this.nextKey = key;\n }\n\n /**\n * Delete the current cursor value from the object store.\n *\n * NOTE: You CANNOT do this with a keysOnly query.\n */\n delete(): PersistencePromise<void> {\n return wrapRequest<void>(this.dbCursor.delete());\n }\n}\n\n/**\n * Callback used with iterate() method.\n */\nexport type IterateCallback<KeyType, ValueType> = (\n key: KeyType,\n value: ValueType,\n control: IterationController\n) => void | PersistencePromise<void>;\n\n/** Options available to the iterate() method. */\nexport interface IterateOptions {\n /** Index to iterate over (else primary keys will be iterated) */\n index?: string;\n\n /** IndxedDB Range to iterate over (else entire store will be iterated) */\n range?: IDBKeyRange;\n\n /** If true, values aren't read while iterating. */\n keysOnly?: boolean;\n\n /** If true, iterate over the store in reverse. */\n reverse?: boolean;\n}\n\n/**\n * Wraps an IDBTransaction and exposes a store() method to get a handle to a\n * specific object store.\n */\nexport class SimpleDbTransaction {\n private aborted = false;\n\n /**\n * A promise that resolves with the result of the IndexedDb transaction.\n */\n private readonly completionDeferred = new Deferred<void>();\n\n static open(\n db: IDBDatabase,\n mode: IDBTransactionMode,\n objectStoreNames: string[]\n ): SimpleDbTransaction {\n return new SimpleDbTransaction(db.transaction(objectStoreNames, mode));\n }\n\n constructor(private readonly transaction: IDBTransaction) {\n this.transaction.oncomplete = () => {\n this.completionDeferred.resolve();\n };\n this.transaction.onabort = () => {\n if (transaction.error) {\n this.completionDeferred.reject(transaction.error);\n } else {\n this.completionDeferred.resolve();\n }\n };\n this.transaction.onerror = (event: Event) => {\n const error = checkForAndReportiOSError(\n (event.target as IDBRequest).error!\n );\n this.completionDeferred.reject(error);\n };\n }\n\n get completionPromise(): Promise<void> {\n return this.completionDeferred.promise;\n }\n\n abort(error?: Error): void {\n if (error) {\n this.completionDeferred.reject(error);\n }\n\n if (!this.aborted) {\n debug(\n LOG_TAG,\n 'Aborting transaction:',\n error ? error.message : 'Client-initiated abort'\n );\n this.aborted = true;\n this.transaction.abort();\n }\n }\n\n /**\n * Returns a SimpleDbStore<KeyType, ValueType> for the specified store. All\n * operations performed on the SimpleDbStore happen within the context of this\n * transaction and it cannot be used anymore once the transaction is\n * completed.\n *\n * Note that we can't actually enforce that the KeyType and ValueType are\n * correct, but they allow type safety through the rest of the consuming code.\n */\n store<KeyType extends IDBValidKey, ValueType extends unknown>(\n storeName: string\n ): SimpleDbStore<KeyType, ValueType> {\n const store = this.transaction.objectStore(storeName);\n assert(!!store, 'Object store not part of transaction: ' + storeName);\n return new SimpleDbStore<KeyType, ValueType>(store);\n }\n}\n\n/**\n * A wrapper around an IDBObjectStore providing an API that:\n *\n * 1) Has generic KeyType / ValueType parameters to provide strongly-typed\n * methods for acting against the object store.\n * 2) Deals with IndexedDB's onsuccess / onerror event callbacks, making every\n * method return a PersistencePromise instead.\n * 3) Provides a higher-level API to avoid needing to do excessive wrapping of\n * intermediate IndexedDB types (IDBCursorWithValue, etc.)\n */\nexport class SimpleDbStore<\n KeyType extends IDBValidKey,\n ValueType extends unknown\n> {\n constructor(private store: IDBObjectStore) {}\n\n /**\n * Writes a value into the Object Store.\n *\n * @param key Optional explicit key to use when writing the object, else the\n * key will be auto-assigned (e.g. via the defined keyPath for the store).\n * @param value The object to write.\n */\n put(value: ValueType): PersistencePromise<void>;\n put(key: KeyType, value: ValueType): PersistencePromise<void>;\n put(\n keyOrValue: KeyType | ValueType,\n value?: ValueType\n ): PersistencePromise<void> {\n let request;\n if (value !== undefined) {\n debug(LOG_TAG, 'PUT', this.store.name, keyOrValue, value);\n request = this.store.put(value, keyOrValue as KeyType);\n } else {\n debug(LOG_TAG, 'PUT', this.store.name, '<auto-key>', keyOrValue);\n request = this.store.put(keyOrValue as ValueType);\n }\n return wrapRequest<void>(request);\n }\n\n /**\n * Adds a new value into an Object Store and returns the new key. Similar to\n * IndexedDb's `add()`, this method will fail on primary key collisions.\n *\n * @param value The object to write.\n * @return The key of the value to add.\n */\n add(value: ValueType): PersistencePromise<KeyType> {\n debug(LOG_TAG, 'ADD', this.store.name, value, value);\n const request = this.store.add(value as ValueType);\n return wrapRequest<KeyType>(request);\n }\n\n /**\n * Gets the object with the specified key from the specified store, or null\n * if no object exists with the specified key.\n *\n * @key The key of the object to get.\n * @return The object with the specified key or null if no object exists.\n */\n get(key: KeyType): PersistencePromise<ValueType | null> {\n const request = this.store.get(key);\n // We're doing an unsafe cast to ValueType.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n return wrapRequest<any>(request).next(result => {\n // Normalize nonexistence to null.\n if (result === undefined) {\n result = null;\n }\n debug(LOG_TAG, 'GET', this.store.name, key, result);\n return result;\n });\n }\n\n delete(key: KeyType | IDBKeyRange): PersistencePromise<void> {\n debug(LOG_TAG, 'DELETE', this.store.name, key);\n const request = this.store.delete(key);\n return wrapRequest<void>(request);\n }\n\n /**\n * If we ever need more of the count variants, we can add overloads. For now,\n * all we need is to count everything in a store.\n *\n * Returns the number of rows in the store.\n */\n count(): PersistencePromise<number> {\n debug(LOG_TAG, 'COUNT', this.store.name);\n const request = this.store.count();\n return wrapRequest<number>(request);\n }\n\n loadAll(): PersistencePromise<ValueType[]>;\n loadAll(range: IDBKeyRange): PersistencePromise<ValueType[]>;\n loadAll(index: string, range: IDBKeyRange): PersistencePromise<ValueType[]>;\n loadAll(\n indexOrRange?: string | IDBKeyRange,\n range?: IDBKeyRange\n ): PersistencePromise<ValueType[]> {\n const cursor = this.cursor(this.options(indexOrRange, range));\n const results: ValueType[] = [];\n return this.iterateCursor(cursor, (key, value) => {\n results.push(value);\n }).next(() => {\n return results;\n });\n }\n\n deleteAll(): PersistencePromise<void>;\n deleteAll(range: IDBKeyRange): PersistencePromise<void>;\n deleteAll(index: string, range: IDBKeyRange): PersistencePromise<void>;\n deleteAll(\n indexOrRange?: string | IDBKeyRange,\n range?: IDBKeyRange\n ): PersistencePromise<void> {\n debug(LOG_TAG, 'DELETE ALL', this.store.name);\n const options = this.options(indexOrRange, range);\n options.keysOnly = false;\n const cursor = this.cursor(options);\n return this.iterateCursor(cursor, (key, value, control) => {\n // NOTE: Calling delete() on a cursor is documented as more efficient than\n // calling delete() on an object store with a single key\n // (https://developer.mozilla.org/en-US/docs/Web/API/IDBObjectStore/delete),\n // however, this requires us *not* to use a keysOnly cursor\n // (https://developer.mozilla.org/en-US/docs/Web/API/IDBCursor/delete). We\n // may want to compare the performance of each method.\n return control.delete();\n });\n }\n\n /**\n * Iterates over keys and values in an object store.\n *\n * @param options Options specifying how to iterate the objects in the store.\n * @param callback will be called for each iterated object. Iteration can be\n * canceled at any point by calling the doneFn passed to the callback.\n * The callback can return a PersistencePromise if it performs async\n * operations but note that iteration will continue without waiting for them\n * to complete.\n * @returns A PersistencePromise that resolves once all PersistencePromises\n * returned by callbacks resolve.\n */\n iterate(\n callback: IterateCallback<KeyType, ValueType>\n ): PersistencePromise<void>;\n iterate(\n options: IterateOptions,\n callback: IterateCallback<KeyType, ValueType>\n ): PersistencePromise<void>;\n iterate(\n optionsOrCallback: IterateOptions | IterateCallback<KeyType, ValueType>,\n callback?: IterateCallback<KeyType, ValueType>\n ): PersistencePromise<void> {\n let options;\n if (!callback) {\n options = {};\n callback = optionsOrCallback as IterateCallback<KeyType, ValueType>;\n } else {\n options = optionsOrCallback as IterateOptions;\n }\n const cursor = this.cursor(options);\n return this.iterateCursor(cursor, callback);\n }\n\n /**\n * Iterates over a store, but waits for the given callback to complete for\n * each entry before iterating the next entry. This allows the callback to do\n * asynchronous work to determine if this iteration should continue.\n *\n * The provided callback should return `true` to continue iteration, and\n * `false` otherwise.\n */\n iterateSerial(\n callback: (k: KeyType, v: ValueType) => PersistencePromise<boolean>\n ): PersistencePromise<void> {\n const cursorRequest = this.cursor({});\n return new PersistencePromise((resolve, reject) => {\n cursorRequest.onerror = (event: Event) => {\n const error = checkForAndReportiOSError(\n (event.target as IDBRequest).error!\n );\n reject(error);\n };\n cursorRequest.onsuccess = (event: Event) => {\n const cursor: IDBCursorWithValue = (event.target as IDBRequest).result;\n if (!cursor) {\n resolve();\n return;\n }\n\n callback(cursor.primaryKey as KeyType, cursor.value).next(\n shouldContinue => {\n if (shouldContinue) {\n cursor.continue();\n } else {\n resolve();\n }\n }\n );\n };\n });\n }\n\n private iterateCursor(\n cursorRequest: IDBRequest,\n fn: IterateCallback<KeyType, ValueType>\n ): PersistencePromise<void> {\n const results: Array<PersistencePromise<void>> = [];\n return new PersistencePromise((resolve, reject) => {\n cursorRequest.onerror = (event: Event) => {\n reject((event.target as IDBRequest).error!);\n };\n cursorRequest.onsuccess = (event: Event) => {\n const cursor: IDBCursorWithValue = (event.target as IDBRequest).result;\n if (!cursor) {\n resolve();\n return;\n }\n const controller = new IterationController(cursor);\n const userResult = fn(\n cursor.primaryKey as KeyType,\n cursor.value,\n controller\n );\n if (userResult instanceof PersistencePromise) {\n const userPromise: PersistencePromise<void> = userResult.catch(\n err => {\n controller.done();\n return PersistencePromise.reject(err);\n }\n );\n results.push(userPromise);\n }\n if (controller.isDone) {\n resolve();\n } else if (controller.skipToKey === null) {\n cursor.continue();\n } else {\n cursor.continue(controller.skipToKey);\n }\n };\n }).next(() => {\n return PersistencePromise.waitFor(results);\n });\n }\n\n private options(\n indexOrRange?: string | IDBKeyRange,\n range?: IDBKeyRange\n ): IterateOptions {\n let indexName: string | undefined = undefined;\n if (indexOrRange !== undefined) {\n if (typeof indexOrRange === 'string') {\n indexName = indexOrRange;\n } else {\n assert(\n range === undefined,\n '3rd argument must not be defined if 2nd is a range.'\n );\n range = indexOrRange;\n }\n }\n return { index: indexName, range };\n }\n\n private cursor(options: IterateOptions): IDBRequest {\n let direction: IDBCursorDirection = 'next';\n if (options.reverse) {\n direction = 'prev';\n }\n if (options.index) {\n const index = this.store.index(options.index);\n if (options.keysOnly) {\n return index.openKeyCursor(options.range, direction);\n } else {\n return index.openCursor(options.range, direction);\n }\n } else {\n return this.store.openCursor(options.range, direction);\n }\n }\n}\n\n/**\n * Wraps an IDBRequest in a PersistencePromise, using the onsuccess / onerror\n * handlers to resolve / reject the PersistencePromise as appropriate.\n */\nfunction wrapRequest<R>(request: IDBRequest): PersistencePromise<R> {\n return new PersistencePromise<R>((resolve, reject) => {\n request.onsuccess = (event: Event) => {\n const result = (event.target as IDBRequest).result;\n resolve(result);\n };\n\n request.onerror = (event: Event) => {\n const error = checkForAndReportiOSError(\n (event.target as IDBRequest).error!\n );\n reject(error);\n };\n });\n}\n\n// Guard so we only report the error once.\nlet reportedIOSError = false;\nfunction checkForAndReportiOSError(error: DOMException): Error {\n const iOSVersion = SimpleDb.getIOSVersion(getUA());\n if (iOSVersion >= 12.2 && iOSVersion < 13) {\n const IOS_ERROR =\n 'An internal error was encountered in the Indexed Database server';\n if (error.message.indexOf(IOS_ERROR) >= 0) {\n // Wrap error in a more descriptive one.\n const newError = new FirestoreError(\n 'internal',\n `IOS_INDEXEDDB_BUG1: IndexedDb has thrown '${IOS_ERROR}'. This is likely ` +\n `due to an unavoidable bug in iOS. See https://stackoverflow.com/q/56496296/110915 ` +\n `for details and a potential workaround.`\n );\n if (!reportedIOSError) {\n reportedIOSError = true;\n // Throw a global exception outside of this promise chain, for the user to\n // potentially catch.\n setTimeout(() => {\n throw newError;\n }, 0);\n }\n return newError;\n }\n }\n return error;\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Timestamp } from '../api/timestamp';\nimport { User } from '../auth/user';\nimport { Query } from '../core/query';\nimport { BatchId, ProtoByteString } from '../core/types';\nimport { DocumentKeySet } from '../model/collections';\nimport { DocumentKey } from '../model/document_key';\nimport { Mutation } from '../model/mutation';\nimport { BATCHID_UNKNOWN, MutationBatch } from '../model/mutation_batch';\nimport { ResourcePath } from '../model/path';\nimport { assert, fail } from '../util/assert';\nimport { primitiveComparator } from '../util/misc';\nimport { SortedMap } from '../util/sorted_map';\nimport { SortedSet } from '../util/sorted_set';\n\nimport * as EncodedResourcePath from './encoded_resource_path';\nimport { IndexManager } from './index_manager';\nimport {\n IndexedDbPersistence,\n IndexedDbTransaction\n} from './indexeddb_persistence';\nimport {\n DbDocumentMutation,\n DbDocumentMutationKey,\n DbMutationBatch,\n DbMutationBatchKey,\n DbMutationQueue,\n DbMutationQueueKey\n} from './indexeddb_schema';\nimport { LocalSerializer } from './local_serializer';\nimport { MutationQueue } from './mutation_queue';\nimport { PersistenceTransaction, ReferenceDelegate } from './persistence';\nimport { PersistencePromise } from './persistence_promise';\nimport { SimpleDb, SimpleDbStore, SimpleDbTransaction } from './simple_db';\n\n/** A mutation queue for a specific user, backed by IndexedDB. */\nexport class IndexedDbMutationQueue implements MutationQueue {\n /**\n * Caches the document keys for pending mutation batches. If the mutation\n * has been removed from IndexedDb, the cached value may continue to\n * be used to retrieve the batch's document keys. To remove a cached value\n * locally, `removeCachedMutationKeys()` should be invoked either directly\n * or through `removeMutationBatches()`.\n *\n * With multi-tab, when the primary client acknowledges or rejects a mutation,\n * this cache is used by secondary clients to invalidate the local\n * view of the documents that were previously affected by the mutation.\n */\n // PORTING NOTE: Multi-tab only.\n private documentKeysByBatchId = {} as { [batchId: number]: DocumentKeySet };\n\n constructor(\n /**\n * The normalized userId (e.g. null UID => \"\" userId) used to store /\n * retrieve mutations.\n */\n private userId: string,\n private readonly serializer: LocalSerializer,\n private readonly indexManager: IndexManager,\n private readonly referenceDelegate: ReferenceDelegate\n ) {}\n\n /**\n * Creates a new mutation queue for the given user.\n * @param user The user for which to create a mutation queue.\n * @param serializer The serializer to use when persisting to IndexedDb.\n */\n static forUser(\n user: User,\n serializer: LocalSerializer,\n indexManager: IndexManager,\n referenceDelegate: ReferenceDelegate\n ): IndexedDbMutationQueue {\n // TODO(mcg): Figure out what constraints there are on userIDs\n // In particular, are there any reserved characters? are empty ids allowed?\n // For the moment store these together in the same mutations table assuming\n // that empty userIDs aren't allowed.\n assert(user.uid !== '', 'UserID must not be an empty string.');\n const userId = user.isAuthenticated() ? user.uid! : '';\n return new IndexedDbMutationQueue(\n userId,\n serializer,\n indexManager,\n referenceDelegate\n );\n }\n\n checkEmpty(transaction: PersistenceTransaction): PersistencePromise<boolean> {\n let empty = true;\n const range = IDBKeyRange.bound(\n [this.userId, Number.NEGATIVE_INFINITY],\n [this.userId, Number.POSITIVE_INFINITY]\n );\n return mutationsStore(transaction)\n .iterate(\n { index: DbMutationBatch.userMutationsIndex, range },\n (key, value, control) => {\n empty = false;\n control.done();\n }\n )\n .next(() => empty);\n }\n\n acknowledgeBatch(\n transaction: PersistenceTransaction,\n batch: MutationBatch,\n streamToken: ProtoByteString\n ): PersistencePromise<void> {\n return this.getMutationQueueMetadata(transaction).next(metadata => {\n metadata.lastStreamToken = convertStreamToken(streamToken);\n\n return mutationQueuesStore(transaction).put(metadata);\n });\n }\n\n getLastStreamToken(\n transaction: PersistenceTransaction\n ): PersistencePromise<ProtoByteString> {\n return this.getMutationQueueMetadata(transaction).next<ProtoByteString>(\n metadata => metadata.lastStreamToken\n );\n }\n\n setLastStreamToken(\n transaction: PersistenceTransaction,\n streamToken: ProtoByteString\n ): PersistencePromise<void> {\n return this.getMutationQueueMetadata(transaction).next(metadata => {\n metadata.lastStreamToken = convertStreamToken(streamToken);\n return mutationQueuesStore(transaction).put(metadata);\n });\n }\n\n addMutationBatch(\n transaction: PersistenceTransaction,\n localWriteTime: Timestamp,\n baseMutations: Mutation[],\n mutations: Mutation[]\n ): PersistencePromise<MutationBatch> {\n const documentStore = documentMutationsStore(transaction);\n const mutationStore = mutationsStore(transaction);\n\n // The IndexedDb implementation in Chrome (and Firefox) does not handle\n // compound indices that include auto-generated keys correctly. To ensure\n // that the index entry is added correctly in all browsers, we perform two\n // writes: The first write is used to retrieve the next auto-generated Batch\n // ID, and the second write populates the index and stores the actual\n // mutation batch.\n // See: https://bugs.chromium.org/p/chromium/issues/detail?id=701972\n\n // We write an empty object to obtain key\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n return mutationStore.add({} as any).next(batchId => {\n assert(typeof batchId === 'number', 'Auto-generated key is not a number');\n\n const batch = new MutationBatch(\n batchId,\n localWriteTime,\n baseMutations,\n mutations\n );\n const dbBatch = this.serializer.toDbMutationBatch(this.userId, batch);\n\n const promises: Array<PersistencePromise<void>> = [];\n let collectionParents = new SortedSet<ResourcePath>((l, r) =>\n primitiveComparator(l.canonicalString(), r.canonicalString())\n );\n for (const mutation of mutations) {\n const indexKey = DbDocumentMutation.key(\n this.userId,\n mutation.key.path,\n batchId\n );\n collectionParents = collectionParents.add(mutation.key.path.popLast());\n promises.push(mutationStore.put(dbBatch));\n promises.push(\n documentStore.put(indexKey, DbDocumentMutation.PLACEHOLDER)\n );\n }\n\n collectionParents.forEach(parent => {\n promises.push(\n this.indexManager.addToCollectionParentIndex(transaction, parent)\n );\n });\n\n transaction.addOnCommittedListener(() => {\n this.documentKeysByBatchId[batchId] = batch.keys();\n });\n\n return PersistencePromise.waitFor(promises).next(() => batch);\n });\n }\n\n lookupMutationBatch(\n transaction: PersistenceTransaction,\n batchId: BatchId\n ): PersistencePromise<MutationBatch | null> {\n return mutationsStore(transaction)\n .get(batchId)\n .next(dbBatch => {\n if (dbBatch) {\n assert(\n dbBatch.userId === this.userId,\n `Unexpected user '${dbBatch.userId}' for mutation batch ${batchId}`\n );\n return this.serializer.fromDbMutationBatch(dbBatch);\n }\n return null;\n });\n }\n\n lookupMutationKeys(\n transaction: PersistenceTransaction,\n batchId: BatchId\n ): PersistencePromise<DocumentKeySet | null> {\n if (this.documentKeysByBatchId[batchId]) {\n return PersistencePromise.resolve<DocumentKeySet | null>(\n this.documentKeysByBatchId[batchId]\n );\n } else {\n return this.lookupMutationBatch(transaction, batchId).next(batch => {\n if (batch) {\n const keys = batch.keys();\n this.documentKeysByBatchId[batchId] = keys;\n return keys;\n } else {\n return null;\n }\n });\n }\n }\n\n getNextMutationBatchAfterBatchId(\n transaction: PersistenceTransaction,\n batchId: BatchId\n ): PersistencePromise<MutationBatch | null> {\n const nextBatchId = batchId + 1;\n\n const range = IDBKeyRange.lowerBound([this.userId, nextBatchId]);\n let foundBatch: MutationBatch | null = null;\n return mutationsStore(transaction)\n .iterate(\n { index: DbMutationBatch.userMutationsIndex, range },\n (key, dbBatch, control) => {\n if (dbBatch.userId === this.userId) {\n assert(\n dbBatch.batchId >= nextBatchId,\n 'Should have found mutation after ' + nextBatchId\n );\n foundBatch = this.serializer.fromDbMutationBatch(dbBatch);\n }\n control.done();\n }\n )\n .next(() => foundBatch);\n }\n\n getHighestUnacknowledgedBatchId(\n transaction: PersistenceTransaction\n ): PersistencePromise<BatchId> {\n const range = IDBKeyRange.upperBound([\n this.userId,\n Number.POSITIVE_INFINITY\n ]);\n\n let batchId = BATCHID_UNKNOWN;\n return mutationsStore(transaction)\n .iterate(\n { index: DbMutationBatch.userMutationsIndex, range, reverse: true },\n (key, dbBatch, control) => {\n batchId = dbBatch.batchId;\n control.done();\n }\n )\n .next(() => batchId);\n }\n\n getAllMutationBatches(\n transaction: PersistenceTransaction\n ): PersistencePromise<MutationBatch[]> {\n const range = IDBKeyRange.bound(\n [this.userId, BATCHID_UNKNOWN],\n [this.userId, Number.POSITIVE_INFINITY]\n );\n return mutationsStore(transaction)\n .loadAll(DbMutationBatch.userMutationsIndex, range)\n .next(dbBatches =>\n dbBatches.map(dbBatch => this.serializer.fromDbMutationBatch(dbBatch))\n );\n }\n\n getAllMutationBatchesAffectingDocumentKey(\n transaction: PersistenceTransaction,\n documentKey: DocumentKey\n ): PersistencePromise<MutationBatch[]> {\n // Scan the document-mutation index starting with a prefix starting with\n // the given documentKey.\n const indexPrefix = DbDocumentMutation.prefixForPath(\n this.userId,\n documentKey.path\n );\n const indexStart = IDBKeyRange.lowerBound(indexPrefix);\n\n const results: MutationBatch[] = [];\n return documentMutationsStore(transaction)\n .iterate({ range: indexStart }, (indexKey, _, control) => {\n const [userID, encodedPath, batchId] = indexKey;\n\n // Only consider rows matching exactly the specific key of\n // interest. Note that because we order by path first, and we\n // order terminators before path separators, we'll encounter all\n // the index rows for documentKey contiguously. In particular, all\n // the rows for documentKey will occur before any rows for\n // documents nested in a subcollection beneath documentKey so we\n // can stop as soon as we hit any such row.\n const path = EncodedResourcePath.decode(encodedPath);\n if (userID !== this.userId || !documentKey.path.isEqual(path)) {\n control.done();\n return;\n }\n // Look up the mutation batch in the store.\n return mutationsStore(transaction)\n .get(batchId)\n .next(mutation => {\n if (!mutation) {\n throw fail(\n 'Dangling document-mutation reference found: ' +\n indexKey +\n ' which points to ' +\n batchId\n );\n }\n assert(\n mutation.userId === this.userId,\n `Unexpected user '${mutation.userId}' for mutation batch ${batchId}`\n );\n results.push(this.serializer.fromDbMutationBatch(mutation));\n });\n })\n .next(() => results);\n }\n\n getAllMutationBatchesAffectingDocumentKeys(\n transaction: PersistenceTransaction,\n documentKeys: SortedMap<DocumentKey, unknown>\n ): PersistencePromise<MutationBatch[]> {\n let uniqueBatchIDs = new SortedSet<BatchId>(primitiveComparator);\n\n const promises: Array<PersistencePromise<void>> = [];\n documentKeys.forEach(documentKey => {\n const indexStart = DbDocumentMutation.prefixForPath(\n this.userId,\n documentKey.path\n );\n const range = IDBKeyRange.lowerBound(indexStart);\n\n const promise = documentMutationsStore(transaction).iterate(\n { range },\n (indexKey, _, control) => {\n const [userID, encodedPath, batchID] = indexKey;\n\n // Only consider rows matching exactly the specific key of\n // interest. Note that because we order by path first, and we\n // order terminators before path separators, we'll encounter all\n // the index rows for documentKey contiguously. In particular, all\n // the rows for documentKey will occur before any rows for\n // documents nested in a subcollection beneath documentKey so we\n // can stop as soon as we hit any such row.\n const path = EncodedResourcePath.decode(encodedPath);\n if (userID !== this.userId || !documentKey.path.isEqual(path)) {\n control.done();\n return;\n }\n\n uniqueBatchIDs = uniqueBatchIDs.add(batchID);\n }\n );\n\n promises.push(promise);\n });\n\n return PersistencePromise.waitFor(promises).next(() =>\n this.lookupMutationBatches(transaction, uniqueBatchIDs)\n );\n }\n\n getAllMutationBatchesAffectingQuery(\n transaction: PersistenceTransaction,\n query: Query\n ): PersistencePromise<MutationBatch[]> {\n assert(\n !query.isDocumentQuery(),\n \"Document queries shouldn't go down this path\"\n );\n assert(\n !query.isCollectionGroupQuery(),\n 'CollectionGroup queries should be handled in LocalDocumentsView'\n );\n\n const queryPath = query.path;\n const immediateChildrenLength = queryPath.length + 1;\n\n // TODO(mcg): Actually implement a single-collection query\n //\n // This is actually executing an ancestor query, traversing the whole\n // subtree below the collection which can be horrifically inefficient for\n // some structures. The right way to solve this is to implement the full\n // value index, but that's not in the cards in the near future so this is\n // the best we can do for the moment.\n //\n // Since we don't yet index the actual properties in the mutations, our\n // current approach is to just return all mutation batches that affect\n // documents in the collection being queried.\n const indexPrefix = DbDocumentMutation.prefixForPath(\n this.userId,\n queryPath\n );\n const indexStart = IDBKeyRange.lowerBound(indexPrefix);\n\n // Collect up unique batchIDs encountered during a scan of the index. Use a\n // SortedSet to accumulate batch IDs so they can be traversed in order in a\n // scan of the main table.\n let uniqueBatchIDs = new SortedSet<BatchId>(primitiveComparator);\n return documentMutationsStore(transaction)\n .iterate({ range: indexStart }, (indexKey, _, control) => {\n const [userID, encodedPath, batchID] = indexKey;\n const path = EncodedResourcePath.decode(encodedPath);\n if (userID !== this.userId || !queryPath.isPrefixOf(path)) {\n control.done();\n return;\n }\n // Rows with document keys more than one segment longer than the\n // query path can't be matches. For example, a query on 'rooms'\n // can't match the document /rooms/abc/messages/xyx.\n // TODO(mcg): we'll need a different scanner when we implement\n // ancestor queries.\n if (path.length !== immediateChildrenLength) {\n return;\n }\n uniqueBatchIDs = uniqueBatchIDs.add(batchID);\n })\n .next(() => this.lookupMutationBatches(transaction, uniqueBatchIDs));\n }\n\n private lookupMutationBatches(\n transaction: PersistenceTransaction,\n batchIDs: SortedSet<BatchId>\n ): PersistencePromise<MutationBatch[]> {\n const results: MutationBatch[] = [];\n const promises: Array<PersistencePromise<void>> = [];\n // TODO(rockwood): Implement this using iterate.\n batchIDs.forEach(batchId => {\n promises.push(\n mutationsStore(transaction)\n .get(batchId)\n .next(mutation => {\n if (mutation === null) {\n throw fail(\n 'Dangling document-mutation reference found, ' +\n 'which points to ' +\n batchId\n );\n }\n assert(\n mutation.userId === this.userId,\n `Unexpected user '${mutation.userId}' for mutation batch ${batchId}`\n );\n results.push(this.serializer.fromDbMutationBatch(mutation));\n })\n );\n });\n return PersistencePromise.waitFor(promises).next(() => results);\n }\n\n removeMutationBatch(\n transaction: PersistenceTransaction,\n batch: MutationBatch\n ): PersistencePromise<void> {\n return removeMutationBatch(\n (transaction as IndexedDbTransaction).simpleDbTransaction,\n this.userId,\n batch\n ).next(removedDocuments => {\n transaction.addOnCommittedListener(() => {\n this.removeCachedMutationKeys(batch.batchId);\n });\n return PersistencePromise.forEach(\n removedDocuments,\n (key: DocumentKey) => {\n return this.referenceDelegate.removeMutationReference(\n transaction,\n key\n );\n }\n );\n });\n }\n\n removeCachedMutationKeys(batchId: BatchId): void {\n delete this.documentKeysByBatchId[batchId];\n }\n\n performConsistencyCheck(\n txn: PersistenceTransaction\n ): PersistencePromise<void> {\n return this.checkEmpty(txn).next(empty => {\n if (!empty) {\n return PersistencePromise.resolve();\n }\n\n // Verify that there are no entries in the documentMutations index if\n // the queue is empty.\n const startRange = IDBKeyRange.lowerBound(\n DbDocumentMutation.prefixForUser(this.userId)\n );\n const danglingMutationReferences: ResourcePath[] = [];\n return documentMutationsStore(txn)\n .iterate({ range: startRange }, (key, _, control) => {\n const userID = key[0];\n if (userID !== this.userId) {\n control.done();\n return;\n } else {\n const path = EncodedResourcePath.decode(key[1]);\n danglingMutationReferences.push(path);\n }\n })\n .next(() => {\n assert(\n danglingMutationReferences.length === 0,\n 'Document leak -- detected dangling mutation references when queue is empty. ' +\n 'Dangling keys: ' +\n danglingMutationReferences.map(p => p.canonicalString())\n );\n });\n });\n }\n\n containsKey(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<boolean> {\n return mutationQueueContainsKey(txn, this.userId, key);\n }\n\n // PORTING NOTE: Multi-tab only (state is held in memory in other clients).\n /** Returns the mutation queue's metadata from IndexedDb. */\n private getMutationQueueMetadata(\n transaction: PersistenceTransaction\n ): PersistencePromise<DbMutationQueue> {\n return mutationQueuesStore(transaction)\n .get(this.userId)\n .next((metadata: DbMutationQueue | null) => {\n return (\n metadata ||\n new DbMutationQueue(\n this.userId,\n BATCHID_UNKNOWN,\n /*lastStreamToken=*/ ''\n )\n );\n });\n }\n}\n\n/**\n * @return true if the mutation queue for the given user contains a pending\n * mutation for the given key.\n */\nfunction mutationQueueContainsKey(\n txn: PersistenceTransaction,\n userId: string,\n key: DocumentKey\n): PersistencePromise<boolean> {\n const indexKey = DbDocumentMutation.prefixForPath(userId, key.path);\n const encodedPath = indexKey[1];\n const startRange = IDBKeyRange.lowerBound(indexKey);\n let containsKey = false;\n return documentMutationsStore(txn)\n .iterate({ range: startRange, keysOnly: true }, (key, value, control) => {\n const [userID, keyPath, /*batchID*/ _] = key;\n if (userID === userId && keyPath === encodedPath) {\n containsKey = true;\n }\n control.done();\n })\n .next(() => containsKey);\n}\n\n/** Returns true if any mutation queue contains the given document. */\nexport function mutationQueuesContainKey(\n txn: PersistenceTransaction,\n docKey: DocumentKey\n): PersistencePromise<boolean> {\n let found = false;\n return mutationQueuesStore(txn)\n .iterateSerial(userId => {\n return mutationQueueContainsKey(txn, userId, docKey).next(containsKey => {\n if (containsKey) {\n found = true;\n }\n return PersistencePromise.resolve(!containsKey);\n });\n })\n .next(() => found);\n}\n\n/**\n * Delete a mutation batch and the associated document mutations.\n * @return A PersistencePromise of the document mutations that were removed.\n */\nexport function removeMutationBatch(\n txn: SimpleDbTransaction,\n userId: string,\n batch: MutationBatch\n): PersistencePromise<DocumentKey[]> {\n const mutationStore = txn.store<DbMutationBatchKey, DbMutationBatch>(\n DbMutationBatch.store\n );\n const indexTxn = txn.store<DbDocumentMutationKey, DbDocumentMutation>(\n DbDocumentMutation.store\n );\n const promises: Array<PersistencePromise<void>> = [];\n\n const range = IDBKeyRange.only(batch.batchId);\n let numDeleted = 0;\n const removePromise = mutationStore.iterate(\n { range },\n (key, value, control) => {\n numDeleted++;\n return control.delete();\n }\n );\n promises.push(\n removePromise.next(() => {\n assert(\n numDeleted === 1,\n 'Dangling document-mutation reference found: Missing batch ' +\n batch.batchId\n );\n })\n );\n const removedDocuments: DocumentKey[] = [];\n for (const mutation of batch.mutations) {\n const indexKey = DbDocumentMutation.key(\n userId,\n mutation.key.path,\n batch.batchId\n );\n promises.push(indexTxn.delete(indexKey));\n removedDocuments.push(mutation.key);\n }\n return PersistencePromise.waitFor(promises).next(() => removedDocuments);\n}\n\nfunction convertStreamToken(token: ProtoByteString): string {\n if (token instanceof Uint8Array) {\n // TODO(b/78771403): Convert tokens to strings during deserialization\n assert(\n SimpleDb.isMockPersistence(),\n 'Persisting non-string stream tokens is only supported with mock persistence.'\n );\n return token.toString();\n } else {\n return token;\n }\n}\n\n/**\n * Helper to get a typed SimpleDbStore for the mutations object store.\n */\nfunction mutationsStore(\n txn: PersistenceTransaction\n): SimpleDbStore<DbMutationBatchKey, DbMutationBatch> {\n return IndexedDbPersistence.getStore<DbMutationBatchKey, DbMutationBatch>(\n txn,\n DbMutationBatch.store\n );\n}\n\n/**\n * Helper to get a typed SimpleDbStore for the mutationQueues object store.\n */\nfunction documentMutationsStore(\n txn: PersistenceTransaction\n): SimpleDbStore<DbDocumentMutationKey, DbDocumentMutation> {\n return IndexedDbPersistence.getStore<\n DbDocumentMutationKey,\n DbDocumentMutation\n >(txn, DbDocumentMutation.store);\n}\n\n/**\n * Helper to get a typed SimpleDbStore for the mutationQueues object store.\n */\nfunction mutationQueuesStore(\n txn: PersistenceTransaction\n): SimpleDbStore<DbMutationQueueKey, DbMutationQueue> {\n return IndexedDbPersistence.getStore<DbMutationQueueKey, DbMutationQueue>(\n txn,\n DbMutationQueue.store\n );\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Timestamp } from '../api/timestamp';\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { ListenSequenceNumber, TargetId } from '../core/types';\nimport { DocumentKeySet, documentKeySet } from '../model/collections';\nimport { DocumentKey } from '../model/document_key';\nimport { assert } from '../util/assert';\nimport { immediateSuccessor } from '../util/misc';\n\nimport { TargetIdGenerator } from '../core/target_id_generator';\nimport * as EncodedResourcePath from './encoded_resource_path';\nimport {\n IndexedDbLruDelegate,\n IndexedDbPersistence,\n IndexedDbTransaction\n} from './indexeddb_persistence';\nimport {\n DbTarget,\n DbTargetDocument,\n DbTargetDocumentKey,\n DbTargetGlobal,\n DbTargetGlobalKey,\n DbTargetKey\n} from './indexeddb_schema';\nimport { LocalSerializer } from './local_serializer';\nimport { ActiveTargets } from './lru_garbage_collector';\nimport { PersistenceTransaction } from './persistence';\nimport { PersistencePromise } from './persistence_promise';\nimport { TargetCache } from './target_cache';\nimport { TargetData } from './target_data';\nimport { SimpleDb, SimpleDbStore, SimpleDbTransaction } from './simple_db';\nimport { Target } from '../core/target';\n\nexport class IndexedDbTargetCache implements TargetCache {\n constructor(\n private readonly referenceDelegate: IndexedDbLruDelegate,\n private serializer: LocalSerializer\n ) {}\n\n // PORTING NOTE: We don't cache global metadata for the target cache, since\n // some of it (in particular `highestTargetId`) can be modified by secondary\n // tabs. We could perhaps be more granular (and e.g. still cache\n // `lastRemoteSnapshotVersion` in memory) but for simplicity we currently go\n // to IndexedDb whenever we need to read metadata. We can revisit if it turns\n // out to have a meaningful performance impact.\n\n private targetIdGenerator = TargetIdGenerator.forTargetCache();\n\n allocateTargetId(\n transaction: PersistenceTransaction\n ): PersistencePromise<TargetId> {\n return this.retrieveMetadata(transaction).next(metadata => {\n metadata.highestTargetId = this.targetIdGenerator.after(\n metadata.highestTargetId\n );\n return this.saveMetadata(transaction, metadata).next(\n () => metadata.highestTargetId\n );\n });\n }\n\n getLastRemoteSnapshotVersion(\n transaction: PersistenceTransaction\n ): PersistencePromise<SnapshotVersion> {\n return this.retrieveMetadata(transaction).next(metadata => {\n return SnapshotVersion.fromTimestamp(\n new Timestamp(\n metadata.lastRemoteSnapshotVersion.seconds,\n metadata.lastRemoteSnapshotVersion.nanoseconds\n )\n );\n });\n }\n\n getHighestSequenceNumber(\n transaction: PersistenceTransaction\n ): PersistencePromise<ListenSequenceNumber> {\n return getHighestListenSequenceNumber(\n (transaction as IndexedDbTransaction).simpleDbTransaction\n );\n }\n\n setTargetsMetadata(\n transaction: PersistenceTransaction,\n highestListenSequenceNumber: number,\n lastRemoteSnapshotVersion?: SnapshotVersion\n ): PersistencePromise<void> {\n return this.retrieveMetadata(transaction).next(metadata => {\n metadata.highestListenSequenceNumber = highestListenSequenceNumber;\n if (lastRemoteSnapshotVersion) {\n metadata.lastRemoteSnapshotVersion = lastRemoteSnapshotVersion.toTimestamp();\n }\n if (highestListenSequenceNumber > metadata.highestListenSequenceNumber) {\n metadata.highestListenSequenceNumber = highestListenSequenceNumber;\n }\n return this.saveMetadata(transaction, metadata);\n });\n }\n\n addTargetData(\n transaction: PersistenceTransaction,\n targetData: TargetData\n ): PersistencePromise<void> {\n return this.saveTargetData(transaction, targetData).next(() => {\n return this.retrieveMetadata(transaction).next(metadata => {\n metadata.targetCount += 1;\n this.updateMetadataFromTargetData(targetData, metadata);\n return this.saveMetadata(transaction, metadata);\n });\n });\n }\n\n updateTargetData(\n transaction: PersistenceTransaction,\n targetData: TargetData\n ): PersistencePromise<void> {\n return this.saveTargetData(transaction, targetData);\n }\n\n removeTargetData(\n transaction: PersistenceTransaction,\n targetData: TargetData\n ): PersistencePromise<void> {\n return this.removeMatchingKeysForTargetId(transaction, targetData.targetId)\n .next(() => targetsStore(transaction).delete(targetData.targetId))\n .next(() => this.retrieveMetadata(transaction))\n .next(metadata => {\n assert(metadata.targetCount > 0, 'Removing from an empty target cache');\n metadata.targetCount -= 1;\n return this.saveMetadata(transaction, metadata);\n });\n }\n\n /**\n * Drops any targets with sequence number less than or equal to the upper bound, excepting those\n * present in `activeTargetIds`. Document associations for the removed targets are also removed.\n * Returns the number of targets removed.\n */\n removeTargets(\n txn: PersistenceTransaction,\n upperBound: ListenSequenceNumber,\n activeTargetIds: ActiveTargets\n ): PersistencePromise<number> {\n let count = 0;\n const promises: Array<PersistencePromise<void>> = [];\n return targetsStore(txn)\n .iterate((key, value) => {\n const targetData = this.serializer.fromDbTarget(value);\n if (\n targetData.sequenceNumber <= upperBound &&\n activeTargetIds.get(targetData.targetId) === null\n ) {\n count++;\n promises.push(this.removeTargetData(txn, targetData));\n }\n })\n .next(() => PersistencePromise.waitFor(promises))\n .next(() => count);\n }\n\n /**\n * Call provided function with each `TargetData` that we have cached.\n */\n forEachTarget(\n txn: PersistenceTransaction,\n f: (q: TargetData) => void\n ): PersistencePromise<void> {\n return targetsStore(txn).iterate((key, value) => {\n const targetData = this.serializer.fromDbTarget(value);\n f(targetData);\n });\n }\n\n private retrieveMetadata(\n transaction: PersistenceTransaction\n ): PersistencePromise<DbTargetGlobal> {\n return retrieveMetadata(\n (transaction as IndexedDbTransaction).simpleDbTransaction\n );\n }\n\n private saveMetadata(\n transaction: PersistenceTransaction,\n metadata: DbTargetGlobal\n ): PersistencePromise<void> {\n return globalTargetStore(transaction).put(DbTargetGlobal.key, metadata);\n }\n\n private saveTargetData(\n transaction: PersistenceTransaction,\n targetData: TargetData\n ): PersistencePromise<void> {\n return targetsStore(transaction).put(\n this.serializer.toDbTarget(targetData)\n );\n }\n\n /**\n * In-place updates the provided metadata to account for values in the given\n * TargetData. Saving is done separately. Returns true if there were any\n * changes to the metadata.\n */\n private updateMetadataFromTargetData(\n targetData: TargetData,\n metadata: DbTargetGlobal\n ): boolean {\n let updated = false;\n if (targetData.targetId > metadata.highestTargetId) {\n metadata.highestTargetId = targetData.targetId;\n updated = true;\n }\n\n if (targetData.sequenceNumber > metadata.highestListenSequenceNumber) {\n metadata.highestListenSequenceNumber = targetData.sequenceNumber;\n updated = true;\n }\n return updated;\n }\n\n getTargetCount(\n transaction: PersistenceTransaction\n ): PersistencePromise<number> {\n return this.retrieveMetadata(transaction).next(\n metadata => metadata.targetCount\n );\n }\n\n getTargetData(\n transaction: PersistenceTransaction,\n target: Target\n ): PersistencePromise<TargetData | null> {\n // Iterating by the canonicalId may yield more than one result because\n // canonicalId values are not required to be unique per target. This query\n // depends on the queryTargets index to be efficient.\n const canonicalId = target.canonicalId();\n const range = IDBKeyRange.bound(\n [canonicalId, Number.NEGATIVE_INFINITY],\n [canonicalId, Number.POSITIVE_INFINITY]\n );\n let result: TargetData | null = null;\n return targetsStore(transaction)\n .iterate(\n { range, index: DbTarget.queryTargetsIndexName },\n (key, value, control) => {\n const found = this.serializer.fromDbTarget(value);\n // After finding a potential match, check that the target is\n // actually equal to the requested target.\n if (target.isEqual(found.target)) {\n result = found;\n control.done();\n }\n }\n )\n .next(() => result);\n }\n\n addMatchingKeys(\n txn: PersistenceTransaction,\n keys: DocumentKeySet,\n targetId: TargetId\n ): PersistencePromise<void> {\n // PORTING NOTE: The reverse index (documentsTargets) is maintained by\n // IndexedDb.\n const promises: Array<PersistencePromise<void>> = [];\n const store = documentTargetStore(txn);\n keys.forEach(key => {\n const path = EncodedResourcePath.encode(key.path);\n promises.push(store.put(new DbTargetDocument(targetId, path)));\n promises.push(this.referenceDelegate.addReference(txn, key));\n });\n return PersistencePromise.waitFor(promises);\n }\n\n removeMatchingKeys(\n txn: PersistenceTransaction,\n keys: DocumentKeySet,\n targetId: TargetId\n ): PersistencePromise<void> {\n // PORTING NOTE: The reverse index (documentsTargets) is maintained by\n // IndexedDb.\n const store = documentTargetStore(txn);\n return PersistencePromise.forEach(keys, (key: DocumentKey) => {\n const path = EncodedResourcePath.encode(key.path);\n return PersistencePromise.waitFor([\n store.delete([targetId, path]),\n this.referenceDelegate.removeReference(txn, key)\n ]);\n });\n }\n\n removeMatchingKeysForTargetId(\n txn: PersistenceTransaction,\n targetId: TargetId\n ): PersistencePromise<void> {\n const store = documentTargetStore(txn);\n const range = IDBKeyRange.bound(\n [targetId],\n [targetId + 1],\n /*lowerOpen=*/ false,\n /*upperOpen=*/ true\n );\n return store.delete(range);\n }\n\n getMatchingKeysForTargetId(\n txn: PersistenceTransaction,\n targetId: TargetId\n ): PersistencePromise<DocumentKeySet> {\n const range = IDBKeyRange.bound(\n [targetId],\n [targetId + 1],\n /*lowerOpen=*/ false,\n /*upperOpen=*/ true\n );\n const store = documentTargetStore(txn);\n let result = documentKeySet();\n\n return store\n .iterate({ range, keysOnly: true }, (key, _, control) => {\n const path = EncodedResourcePath.decode(key[1]);\n const docKey = new DocumentKey(path);\n result = result.add(docKey);\n })\n .next(() => result);\n }\n\n containsKey(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<boolean> {\n const path = EncodedResourcePath.encode(key.path);\n const range = IDBKeyRange.bound(\n [path],\n [immediateSuccessor(path)],\n /*lowerOpen=*/ false,\n /*upperOpen=*/ true\n );\n let count = 0;\n return documentTargetStore(txn!)\n .iterate(\n {\n index: DbTargetDocument.documentTargetsIndex,\n keysOnly: true,\n range\n },\n ([targetId, path], _, control) => {\n // Having a sentinel row for a document does not count as containing that document;\n // For the target cache, containing the document means the document is part of some\n // target.\n if (targetId !== 0) {\n count++;\n control.done();\n }\n }\n )\n .next(() => count > 0);\n }\n\n getTargetDataForTarget(\n transaction: PersistenceTransaction,\n targetId: TargetId\n ): PersistencePromise<TargetData | null> {\n return targetsStore(transaction)\n .get(targetId)\n .next(found => {\n if (found) {\n return this.serializer.fromDbTarget(found);\n } else {\n return null;\n }\n });\n }\n}\n\n/**\n * Helper to get a typed SimpleDbStore for the queries object store.\n */\nfunction targetsStore(\n txn: PersistenceTransaction\n): SimpleDbStore<DbTargetKey, DbTarget> {\n return IndexedDbPersistence.getStore<DbTargetKey, DbTarget>(\n txn,\n DbTarget.store\n );\n}\n\n/**\n * Helper to get a typed SimpleDbStore for the target globals object store.\n */\nfunction globalTargetStore(\n txn: PersistenceTransaction\n): SimpleDbStore<DbTargetGlobalKey, DbTargetGlobal> {\n return IndexedDbPersistence.getStore<DbTargetGlobalKey, DbTargetGlobal>(\n txn,\n DbTargetGlobal.store\n );\n}\n\nfunction retrieveMetadata(\n txn: SimpleDbTransaction\n): PersistencePromise<DbTargetGlobal> {\n const globalStore = SimpleDb.getStore<DbTargetGlobalKey, DbTargetGlobal>(\n txn,\n DbTargetGlobal.store\n );\n return globalStore.get(DbTargetGlobal.key).next(metadata => {\n assert(metadata !== null, 'Missing metadata row.');\n return metadata;\n });\n}\n\nexport function getHighestListenSequenceNumber(\n txn: SimpleDbTransaction\n): PersistencePromise<ListenSequenceNumber> {\n return retrieveMetadata(txn).next(\n targetGlobal => targetGlobal.highestListenSequenceNumber\n );\n}\n\n/**\n * Helper to get a typed SimpleDbStore for the document target object store.\n */\nexport function documentTargetStore(\n txn: PersistenceTransaction\n): SimpleDbStore<DbTargetDocumentKey, DbTargetDocument> {\n return IndexedDbPersistence.getStore<DbTargetDocumentKey, DbTargetDocument>(\n txn,\n DbTargetDocument.store\n );\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Query } from '../core/query';\nimport {\n DocumentKeySet,\n DocumentMap,\n documentMap,\n DocumentSizeEntries,\n DocumentSizeEntry,\n MaybeDocumentMap,\n maybeDocumentMap,\n nullableMaybeDocumentMap,\n NullableMaybeDocumentMap\n} from '../model/collections';\nimport { Document, MaybeDocument, NoDocument } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport { ResourcePath } from '../model/path';\nimport { primitiveComparator } from '../util/misc';\nimport { SortedMap } from '../util/sorted_map';\nimport { SortedSet } from '../util/sorted_set';\n\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { assert, fail } from '../util/assert';\nimport { IndexManager } from './index_manager';\nimport { IndexedDbPersistence } from './indexeddb_persistence';\nimport {\n DbRemoteDocument,\n DbRemoteDocumentGlobal,\n DbRemoteDocumentGlobalKey,\n DbRemoteDocumentKey\n} from './indexeddb_schema';\nimport { LocalSerializer } from './local_serializer';\nimport { PersistenceTransaction } from './persistence';\nimport { PersistencePromise } from './persistence_promise';\nimport { RemoteDocumentCache } from './remote_document_cache';\nimport { RemoteDocumentChangeBuffer } from './remote_document_change_buffer';\nimport { IterateOptions, SimpleDbStore } from './simple_db';\nimport { ObjectMap } from '../util/obj_map';\n\nexport class IndexedDbRemoteDocumentCache implements RemoteDocumentCache {\n /**\n * @param {LocalSerializer} serializer The document serializer.\n * @param {IndexManager} indexManager The query indexes that need to be maintained.\n */\n constructor(\n readonly serializer: LocalSerializer,\n private readonly indexManager: IndexManager\n ) {}\n\n /**\n * Adds the supplied entries to the cache.\n *\n * All calls of `addEntry` are required to go through the RemoteDocumentChangeBuffer\n * returned by `newChangeBuffer()` to ensure proper accounting of metadata.\n */\n private addEntry(\n transaction: PersistenceTransaction,\n key: DocumentKey,\n doc: DbRemoteDocument\n ): PersistencePromise<void> {\n const documentStore = remoteDocumentsStore(transaction);\n return documentStore.put(dbKey(key), doc);\n }\n\n /**\n * Removes a document from the cache.\n *\n * All calls of `removeEntry` are required to go through the RemoteDocumentChangeBuffer\n * returned by `newChangeBuffer()` to ensure proper accounting of metadata.\n */\n private removeEntry(\n transaction: PersistenceTransaction,\n documentKey: DocumentKey\n ): PersistencePromise<void> {\n const store = remoteDocumentsStore(transaction);\n const key = dbKey(documentKey);\n return store.delete(key);\n }\n\n /**\n * Updates the current cache size.\n *\n * Callers to `addEntry()` and `removeEntry()` *must* call this afterwards to update the\n * cache's metadata.\n */\n private updateMetadata(\n transaction: PersistenceTransaction,\n sizeDelta: number\n ): PersistencePromise<void> {\n return this.getMetadata(transaction).next(metadata => {\n metadata.byteSize += sizeDelta;\n return this.setMetadata(transaction, metadata);\n });\n }\n\n getEntry(\n transaction: PersistenceTransaction,\n documentKey: DocumentKey\n ): PersistencePromise<MaybeDocument | null> {\n return remoteDocumentsStore(transaction)\n .get(dbKey(documentKey))\n .next(dbRemoteDoc => {\n return this.maybeDecodeDocument(dbRemoteDoc);\n });\n }\n\n /**\n * Looks up an entry in the cache.\n *\n * @param documentKey The key of the entry to look up.\n * @return The cached MaybeDocument entry and its size, or null if we have nothing cached.\n */\n getSizedEntry(\n transaction: PersistenceTransaction,\n documentKey: DocumentKey\n ): PersistencePromise<DocumentSizeEntry | null> {\n return remoteDocumentsStore(transaction)\n .get(dbKey(documentKey))\n .next(dbRemoteDoc => {\n const doc = this.maybeDecodeDocument(dbRemoteDoc);\n return doc\n ? {\n maybeDocument: doc,\n size: dbDocumentSize(dbRemoteDoc!)\n }\n : null;\n });\n }\n\n getEntries(\n transaction: PersistenceTransaction,\n documentKeys: DocumentKeySet\n ): PersistencePromise<NullableMaybeDocumentMap> {\n let results = nullableMaybeDocumentMap();\n return this.forEachDbEntry(\n transaction,\n documentKeys,\n (key, dbRemoteDoc) => {\n const doc = this.maybeDecodeDocument(dbRemoteDoc);\n results = results.insert(key, doc);\n }\n ).next(() => results);\n }\n\n /**\n * Looks up several entries in the cache.\n *\n * @param documentKeys The set of keys entries to look up.\n * @return A map of MaybeDocuments indexed by key (if a document cannot be\n * found, the key will be mapped to null) and a map of sizes indexed by\n * key (zero if the key cannot be found).\n */\n getSizedEntries(\n transaction: PersistenceTransaction,\n documentKeys: DocumentKeySet\n ): PersistencePromise<DocumentSizeEntries> {\n let results = nullableMaybeDocumentMap();\n let sizeMap = new SortedMap<DocumentKey, number>(DocumentKey.comparator);\n return this.forEachDbEntry(\n transaction,\n documentKeys,\n (key, dbRemoteDoc) => {\n const doc = this.maybeDecodeDocument(dbRemoteDoc);\n if (doc) {\n results = results.insert(key, doc);\n sizeMap = sizeMap.insert(key, dbDocumentSize(dbRemoteDoc!));\n } else {\n results = results.insert(key, null);\n sizeMap = sizeMap.insert(key, 0);\n }\n }\n ).next(() => {\n return { maybeDocuments: results, sizeMap };\n });\n }\n\n private forEachDbEntry(\n transaction: PersistenceTransaction,\n documentKeys: DocumentKeySet,\n callback: (key: DocumentKey, doc: DbRemoteDocument | null) => void\n ): PersistencePromise<void> {\n if (documentKeys.isEmpty()) {\n return PersistencePromise.resolve();\n }\n\n const range = IDBKeyRange.bound(\n documentKeys.first()!.path.toArray(),\n documentKeys.last()!.path.toArray()\n );\n const keyIter = documentKeys.getIterator();\n let nextKey: DocumentKey | null = keyIter.getNext();\n\n return remoteDocumentsStore(transaction)\n .iterate({ range }, (potentialKeyRaw, dbRemoteDoc, control) => {\n const potentialKey = DocumentKey.fromSegments(potentialKeyRaw);\n\n // Go through keys not found in cache.\n while (nextKey && DocumentKey.comparator(nextKey!, potentialKey) < 0) {\n callback(nextKey!, null);\n nextKey = keyIter.getNext();\n }\n\n if (nextKey && nextKey!.isEqual(potentialKey)) {\n // Key found in cache.\n callback(nextKey!, dbRemoteDoc);\n nextKey = keyIter.hasNext() ? keyIter.getNext() : null;\n }\n\n // Skip to the next key (if there is one).\n if (nextKey) {\n control.skip(nextKey!.path.toArray());\n } else {\n control.done();\n }\n })\n .next(() => {\n // The rest of the keys are not in the cache. One case where `iterate`\n // above won't go through them is when the cache is empty.\n while (nextKey) {\n callback(nextKey!, null);\n nextKey = keyIter.hasNext() ? keyIter.getNext() : null;\n }\n });\n }\n\n getDocumentsMatchingQuery(\n transaction: PersistenceTransaction,\n query: Query,\n sinceReadTime: SnapshotVersion\n ): PersistencePromise<DocumentMap> {\n assert(\n !query.isCollectionGroupQuery(),\n 'CollectionGroup queries should be handled in LocalDocumentsView'\n );\n let results = documentMap();\n\n const immediateChildrenPathLength = query.path.length + 1;\n\n const iterationOptions: IterateOptions = {};\n if (sinceReadTime.isEqual(SnapshotVersion.MIN)) {\n // Documents are ordered by key, so we can use a prefix scan to narrow\n // down the documents we need to match the query against.\n const startKey = query.path.toArray();\n iterationOptions.range = IDBKeyRange.lowerBound(startKey);\n } else {\n // Execute an index-free query and filter by read time. This is safe\n // since all document changes to queries that have a\n // lastLimboFreeSnapshotVersion (`sinceReadTime`) have a read time set.\n const collectionKey = query.path.toArray();\n const readTimeKey = this.serializer.toDbTimestampKey(sinceReadTime);\n iterationOptions.range = IDBKeyRange.lowerBound(\n [collectionKey, readTimeKey],\n /* open= */ true\n );\n iterationOptions.index = DbRemoteDocument.collectionReadTimeIndex;\n }\n\n return remoteDocumentsStore(transaction)\n .iterate(iterationOptions, (key, dbRemoteDoc, control) => {\n // The query is actually returning any path that starts with the query\n // path prefix which may include documents in subcollections. For\n // example, a query on 'rooms' will return rooms/abc/messages/xyx but we\n // shouldn't match it. Fix this by discarding rows with document keys\n // more than one segment longer than the query path.\n if (key.length !== immediateChildrenPathLength) {\n return;\n }\n\n const maybeDoc = this.serializer.fromDbRemoteDocument(dbRemoteDoc);\n if (!query.path.isPrefixOf(maybeDoc.key.path)) {\n control.done();\n } else if (maybeDoc instanceof Document && query.matches(maybeDoc)) {\n results = results.insert(maybeDoc.key, maybeDoc);\n }\n })\n .next(() => results);\n }\n\n getNewDocumentChanges(\n transaction: PersistenceTransaction,\n sinceReadTime: SnapshotVersion\n ): PersistencePromise<{\n changedDocs: MaybeDocumentMap;\n readTime: SnapshotVersion;\n }> {\n let changedDocs = maybeDocumentMap();\n\n let lastReadTime = this.serializer.toDbTimestampKey(sinceReadTime);\n\n const documentsStore = remoteDocumentsStore(transaction);\n const range = IDBKeyRange.lowerBound(lastReadTime, true);\n return documentsStore\n .iterate(\n { index: DbRemoteDocument.readTimeIndex, range },\n (_, dbRemoteDoc) => {\n // Unlike `getEntry()` and others, `getNewDocumentChanges()` parses\n // the documents directly since we want to keep sentinel deletes.\n const doc = this.serializer.fromDbRemoteDocument(dbRemoteDoc);\n changedDocs = changedDocs.insert(doc.key, doc);\n lastReadTime = dbRemoteDoc.readTime!;\n }\n )\n .next(() => {\n return {\n changedDocs,\n readTime: this.serializer.fromDbTimestampKey(lastReadTime)\n };\n });\n }\n\n getLastReadTime(\n transaction: PersistenceTransaction\n ): PersistencePromise<SnapshotVersion> {\n const documentsStore = remoteDocumentsStore(transaction);\n\n // If there are no existing entries, we return SnapshotVersion.MIN.\n let readTime = SnapshotVersion.MIN;\n\n return documentsStore\n .iterate(\n { index: DbRemoteDocument.readTimeIndex, reverse: true },\n (key, dbRemoteDoc, control) => {\n if (dbRemoteDoc.readTime) {\n readTime = this.serializer.fromDbTimestampKey(dbRemoteDoc.readTime);\n }\n control.done();\n }\n )\n .next(() => readTime);\n }\n\n newChangeBuffer(options?: {\n trackRemovals: boolean;\n }): RemoteDocumentChangeBuffer {\n return new IndexedDbRemoteDocumentCache.RemoteDocumentChangeBuffer(\n this,\n !!options && options.trackRemovals\n );\n }\n\n getSize(txn: PersistenceTransaction): PersistencePromise<number> {\n return this.getMetadata(txn).next(metadata => metadata.byteSize);\n }\n\n private getMetadata(\n txn: PersistenceTransaction\n ): PersistencePromise<DbRemoteDocumentGlobal> {\n return documentGlobalStore(txn)\n .get(DbRemoteDocumentGlobal.key)\n .next(metadata => {\n assert(!!metadata, 'Missing document cache metadata');\n return metadata!;\n });\n }\n\n private setMetadata(\n txn: PersistenceTransaction,\n metadata: DbRemoteDocumentGlobal\n ): PersistencePromise<void> {\n return documentGlobalStore(txn).put(DbRemoteDocumentGlobal.key, metadata);\n }\n\n /**\n * Decodes `remoteDoc` and returns the document (or null, if the document\n * corresponds to the format used for sentinel deletes).\n */\n private maybeDecodeDocument(\n dbRemoteDoc: DbRemoteDocument | null\n ): MaybeDocument | null {\n if (dbRemoteDoc) {\n const doc = this.serializer.fromDbRemoteDocument(dbRemoteDoc);\n if (\n doc instanceof NoDocument &&\n doc.version.isEqual(SnapshotVersion.forDeletedDoc())\n ) {\n // The document is a sentinel removal and should only be used in the\n // `getNewDocumentChanges()`.\n return null;\n }\n\n return doc;\n }\n return null;\n }\n\n /**\n * Handles the details of adding and updating documents in the IndexedDbRemoteDocumentCache.\n *\n * Unlike the MemoryRemoteDocumentChangeBuffer, the IndexedDb implementation computes the size\n * delta for all submitted changes. This avoids having to re-read all documents from IndexedDb\n * when we apply the changes.\n */\n private static RemoteDocumentChangeBuffer = class extends RemoteDocumentChangeBuffer {\n // A map of document sizes prior to applying the changes in this buffer.\n protected documentSizes: ObjectMap<\n DocumentKey,\n number\n > = new ObjectMap(key => key.toString());\n\n /**\n * @param documentCache The IndexedDbRemoteDocumentCache to apply the changes to.\n * @param trackRemovals Whether to create sentinel deletes that can be tracked by\n * `getNewDocumentChanges()`.\n */\n constructor(\n private readonly documentCache: IndexedDbRemoteDocumentCache,\n private readonly trackRemovals: boolean\n ) {\n super();\n }\n\n protected applyChanges(\n transaction: PersistenceTransaction\n ): PersistencePromise<void> {\n const promises: Array<PersistencePromise<void>> = [];\n\n let sizeDelta = 0;\n\n let collectionParents = new SortedSet<ResourcePath>((l, r) =>\n primitiveComparator(l.canonicalString(), r.canonicalString())\n );\n\n this.changes.forEach((key, maybeDocument) => {\n const previousSize = this.documentSizes.get(key);\n assert(\n previousSize !== undefined,\n `Cannot modify a document that wasn't read (for ${key})`\n );\n if (maybeDocument) {\n assert(\n !this.readTime.isEqual(SnapshotVersion.MIN),\n 'Cannot add a document with a read time of zero'\n );\n const doc = this.documentCache.serializer.toDbRemoteDocument(\n maybeDocument,\n this.readTime\n );\n collectionParents = collectionParents.add(key.path.popLast());\n\n const size = dbDocumentSize(doc);\n sizeDelta += size - previousSize!;\n promises.push(this.documentCache.addEntry(transaction, key, doc));\n } else {\n sizeDelta -= previousSize!;\n if (this.trackRemovals) {\n // In order to track removals, we store a \"sentinel delete\" in the\n // RemoteDocumentCache. This entry is represented by a NoDocument\n // with a version of 0 and ignored by `maybeDecodeDocument()` but\n // preserved in `getNewDocumentChanges()`.\n const deletedDoc = this.documentCache.serializer.toDbRemoteDocument(\n new NoDocument(key, SnapshotVersion.forDeletedDoc()),\n this.readTime\n );\n promises.push(\n this.documentCache.addEntry(transaction, key, deletedDoc)\n );\n } else {\n promises.push(this.documentCache.removeEntry(transaction, key));\n }\n }\n });\n\n collectionParents.forEach(parent => {\n promises.push(\n this.documentCache.indexManager.addToCollectionParentIndex(\n transaction,\n parent\n )\n );\n });\n\n promises.push(this.documentCache.updateMetadata(transaction, sizeDelta));\n\n return PersistencePromise.waitFor(promises);\n }\n\n protected getFromCache(\n transaction: PersistenceTransaction,\n documentKey: DocumentKey\n ): PersistencePromise<MaybeDocument | null> {\n // Record the size of everything we load from the cache so we can compute a delta later.\n return this.documentCache\n .getSizedEntry(transaction, documentKey)\n .next(getResult => {\n if (getResult === null) {\n this.documentSizes.set(documentKey, 0);\n return null;\n } else {\n this.documentSizes.set(documentKey, getResult.size);\n return getResult.maybeDocument;\n }\n });\n }\n\n protected getAllFromCache(\n transaction: PersistenceTransaction,\n documentKeys: DocumentKeySet\n ): PersistencePromise<NullableMaybeDocumentMap> {\n // Record the size of everything we load from the cache so we can compute\n // a delta later.\n return this.documentCache\n .getSizedEntries(transaction, documentKeys)\n .next(({ maybeDocuments, sizeMap }) => {\n // Note: `getAllFromCache` returns two maps instead of a single map from\n // keys to `DocumentSizeEntry`s. This is to allow returning the\n // `NullableMaybeDocumentMap` directly, without a conversion.\n sizeMap.forEach((documentKey, size) => {\n this.documentSizes.set(documentKey, size);\n });\n return maybeDocuments;\n });\n }\n };\n}\n\nfunction documentGlobalStore(\n txn: PersistenceTransaction\n): SimpleDbStore<DbRemoteDocumentGlobalKey, DbRemoteDocumentGlobal> {\n return IndexedDbPersistence.getStore<\n DbRemoteDocumentGlobalKey,\n DbRemoteDocumentGlobal\n >(txn, DbRemoteDocumentGlobal.store);\n}\n\n/**\n * Helper to get a typed SimpleDbStore for the remoteDocuments object store.\n */\nfunction remoteDocumentsStore(\n txn: PersistenceTransaction\n): SimpleDbStore<DbRemoteDocumentKey, DbRemoteDocument> {\n return IndexedDbPersistence.getStore<DbRemoteDocumentKey, DbRemoteDocument>(\n txn,\n DbRemoteDocument.store\n );\n}\n\nfunction dbKey(docKey: DocumentKey): DbRemoteDocumentKey {\n return docKey.path.toArray();\n}\n\n/**\n * Retrusn an approximate size for the given document.\n */\nexport function dbDocumentSize(doc: DbRemoteDocument): number {\n let value: unknown;\n if (doc.document) {\n value = doc.document;\n } else if (doc.unknownDocument) {\n value = doc.unknownDocument;\n } else if (doc.noDocument) {\n value = doc.noDocument;\n } else {\n throw fail('Unknown remote document type');\n }\n return JSON.stringify(value).length;\n}\n","/**\n * @license\n * Copyright 2019 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ResourcePath } from '../model/path';\nimport { assert } from '../util/assert';\nimport { SortedSet } from '../util/sorted_set';\nimport { IndexManager } from './index_manager';\nimport { PersistenceTransaction } from './persistence';\nimport { PersistencePromise } from './persistence_promise';\n\n/**\n * An in-memory implementation of IndexManager.\n */\nexport class MemoryIndexManager implements IndexManager {\n private collectionParentIndex = new MemoryCollectionParentIndex();\n\n addToCollectionParentIndex(\n transaction: PersistenceTransaction,\n collectionPath: ResourcePath\n ): PersistencePromise<void> {\n this.collectionParentIndex.add(collectionPath);\n return PersistencePromise.resolve();\n }\n\n getCollectionParents(\n transaction: PersistenceTransaction,\n collectionId: string\n ): PersistencePromise<ResourcePath[]> {\n return PersistencePromise.resolve(\n this.collectionParentIndex.getEntries(collectionId)\n );\n }\n}\n\n/**\n * Internal implementation of the collection-parent index exposed by MemoryIndexManager.\n * Also used for in-memory caching by IndexedDbIndexManager and initial index population\n * in indexeddb_schema.ts\n */\nexport class MemoryCollectionParentIndex {\n private index = {} as {\n [collectionId: string]: SortedSet<ResourcePath>;\n };\n\n // Returns false if the entry already existed.\n add(collectionPath: ResourcePath): boolean {\n assert(collectionPath.length % 2 === 1, 'Expected a collection path.');\n const collectionId = collectionPath.lastSegment();\n const parentPath = collectionPath.popLast();\n const existingParents =\n this.index[collectionId] ||\n new SortedSet<ResourcePath>(ResourcePath.comparator);\n const added = !existingParents.has(parentPath);\n this.index[collectionId] = existingParents.add(parentPath);\n return added;\n }\n\n has(collectionPath: ResourcePath): boolean {\n const collectionId = collectionPath.lastSegment();\n const parentPath = collectionPath.popLast();\n const existingParents = this.index[collectionId];\n return existingParents && existingParents.has(parentPath);\n }\n\n getEntries(collectionId: string): ResourcePath[] {\n const parentPaths =\n this.index[collectionId] ||\n new SortedSet<ResourcePath>(ResourcePath.comparator);\n return parentPaths.toArray();\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { BatchId, ListenSequenceNumber, TargetId } from '../core/types';\nimport { ResourcePath } from '../model/path';\nimport * as api from '../protos/firestore_proto_api';\nimport { assert } from '../util/assert';\n\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { BATCHID_UNKNOWN } from '../model/mutation_batch';\nimport { decode, encode, EncodedResourcePath } from './encoded_resource_path';\nimport { removeMutationBatch } from './indexeddb_mutation_queue';\nimport { getHighestListenSequenceNumber } from './indexeddb_target_cache';\nimport { dbDocumentSize } from './indexeddb_remote_document_cache';\nimport { LocalSerializer } from './local_serializer';\nimport { MemoryCollectionParentIndex } from './memory_index_manager';\nimport { PersistencePromise } from './persistence_promise';\nimport { SimpleDbSchemaConverter, SimpleDbTransaction } from './simple_db';\n\n/**\n * Schema Version for the Web client:\n * 1. Initial version including Mutation Queue, Query Cache, and Remote Document\n * Cache\n * 2. Used to ensure a targetGlobal object exists and add targetCount to it. No\n * longer required because migration 3 unconditionally clears it.\n * 3. Dropped and re-created Query Cache to deal with cache corruption related\n * to limbo resolution. Addresses\n * https://github.com/firebase/firebase-ios-sdk/issues/1548\n * 4. Multi-Tab Support.\n * 5. Removal of held write acks.\n * 6. Create document global for tracking document cache size.\n * 7. Ensure every cached document has a sentinel row with a sequence number.\n * 8. Add collection-parent index for Collection Group queries.\n * 9. Change RemoteDocumentChanges store to be keyed by readTime rather than\n * an auto-incrementing ID. This is required for Index-Free queries.\n */\nexport const SCHEMA_VERSION = 9;\n\n/** Performs database creation and schema upgrades. */\nexport class SchemaConverter implements SimpleDbSchemaConverter {\n constructor(private readonly serializer: LocalSerializer) {}\n\n /**\n * Performs database creation and schema upgrades.\n *\n * Note that in production, this method is only ever used to upgrade the schema\n * to SCHEMA_VERSION. Different values of toVersion are only used for testing\n * and local feature development.\n */\n createOrUpgrade(\n db: IDBDatabase,\n txn: IDBTransaction,\n fromVersion: number,\n toVersion: number\n ): PersistencePromise<void> {\n assert(\n fromVersion < toVersion &&\n fromVersion >= 0 &&\n toVersion <= SCHEMA_VERSION,\n `Unexpected schema upgrade from v${fromVersion} to v{toVersion}.`\n );\n\n const simpleDbTransaction = new SimpleDbTransaction(txn);\n\n if (fromVersion < 1 && toVersion >= 1) {\n createPrimaryClientStore(db);\n createMutationQueue(db);\n createQueryCache(db);\n createRemoteDocumentCache(db);\n }\n\n // Migration 2 to populate the targetGlobal object no longer needed since\n // migration 3 unconditionally clears it.\n\n let p = PersistencePromise.resolve();\n if (fromVersion < 3 && toVersion >= 3) {\n // Brand new clients don't need to drop and recreate--only clients that\n // potentially have corrupt data.\n if (fromVersion !== 0) {\n dropQueryCache(db);\n createQueryCache(db);\n }\n p = p.next(() => writeEmptyTargetGlobalEntry(simpleDbTransaction));\n }\n\n if (fromVersion < 4 && toVersion >= 4) {\n if (fromVersion !== 0) {\n // Schema version 3 uses auto-generated keys to generate globally unique\n // mutation batch IDs (this was previously ensured internally by the\n // client). To migrate to the new schema, we have to read all mutations\n // and write them back out. We preserve the existing batch IDs to guarantee\n // consistency with other object stores. Any further mutation batch IDs will\n // be auto-generated.\n p = p.next(() =>\n upgradeMutationBatchSchemaAndMigrateData(db, simpleDbTransaction)\n );\n }\n\n p = p.next(() => {\n createClientMetadataStore(db);\n });\n }\n\n if (fromVersion < 5 && toVersion >= 5) {\n p = p.next(() => this.removeAcknowledgedMutations(simpleDbTransaction));\n }\n\n if (fromVersion < 6 && toVersion >= 6) {\n p = p.next(() => {\n createDocumentGlobalStore(db);\n return this.addDocumentGlobal(simpleDbTransaction);\n });\n }\n\n if (fromVersion < 7 && toVersion >= 7) {\n p = p.next(() => this.ensureSequenceNumbers(simpleDbTransaction));\n }\n\n if (fromVersion < 8 && toVersion >= 8) {\n p = p.next(() =>\n this.createCollectionParentIndex(db, simpleDbTransaction)\n );\n }\n\n if (fromVersion < 9 && toVersion >= 9) {\n p = p.next(() => {\n // Multi-Tab used to manage its own changelog, but this has been moved\n // to the DbRemoteDocument object store itself. Since the previous change\n // log only contained transient data, we can drop its object store.\n dropRemoteDocumentChangesStore(db);\n createRemoteDocumentReadTimeIndex(txn);\n });\n }\n return p;\n }\n\n private addDocumentGlobal(\n txn: SimpleDbTransaction\n ): PersistencePromise<void> {\n let byteCount = 0;\n return txn\n .store<DbRemoteDocumentKey, DbRemoteDocument>(DbRemoteDocument.store)\n .iterate((_, doc) => {\n byteCount += dbDocumentSize(doc);\n })\n .next(() => {\n const metadata = new DbRemoteDocumentGlobal(byteCount);\n return txn\n .store<DbRemoteDocumentGlobalKey, DbRemoteDocumentGlobal>(\n DbRemoteDocumentGlobal.store\n )\n .put(DbRemoteDocumentGlobal.key, metadata);\n });\n }\n\n private removeAcknowledgedMutations(\n txn: SimpleDbTransaction\n ): PersistencePromise<void> {\n const queuesStore = txn.store<DbMutationQueueKey, DbMutationQueue>(\n DbMutationQueue.store\n );\n const mutationsStore = txn.store<DbMutationBatchKey, DbMutationBatch>(\n DbMutationBatch.store\n );\n\n return queuesStore.loadAll().next(queues => {\n return PersistencePromise.forEach(queues, (queue: DbMutationQueue) => {\n const range = IDBKeyRange.bound(\n [queue.userId, BATCHID_UNKNOWN],\n [queue.userId, queue.lastAcknowledgedBatchId]\n );\n\n return mutationsStore\n .loadAll(DbMutationBatch.userMutationsIndex, range)\n .next(dbBatches => {\n return PersistencePromise.forEach(\n dbBatches,\n (dbBatch: DbMutationBatch) => {\n assert(\n dbBatch.userId === queue.userId,\n `Cannot process batch ${dbBatch.batchId} from unexpected user`\n );\n const batch = this.serializer.fromDbMutationBatch(dbBatch);\n\n return removeMutationBatch(\n txn,\n queue.userId,\n batch\n ).next(() => {});\n }\n );\n });\n });\n });\n }\n\n /**\n * Ensures that every document in the remote document cache has a corresponding sentinel row\n * with a sequence number. Missing rows are given the most recently used sequence number.\n */\n private ensureSequenceNumbers(\n txn: SimpleDbTransaction\n ): PersistencePromise<void> {\n const documentTargetStore = txn.store<\n DbTargetDocumentKey,\n DbTargetDocument\n >(DbTargetDocument.store);\n const documentsStore = txn.store<DbRemoteDocumentKey, DbRemoteDocument>(\n DbRemoteDocument.store\n );\n\n return getHighestListenSequenceNumber(txn).next(currentSequenceNumber => {\n const writeSentinelKey = (\n path: ResourcePath\n ): PersistencePromise<void> => {\n return documentTargetStore.put(\n new DbTargetDocument(0, encode(path), currentSequenceNumber)\n );\n };\n\n const promises: Array<PersistencePromise<void>> = [];\n return documentsStore\n .iterate((key, doc) => {\n const path = new ResourcePath(key);\n const docSentinelKey = sentinelKey(path);\n promises.push(\n documentTargetStore.get(docSentinelKey).next(maybeSentinel => {\n if (!maybeSentinel) {\n return writeSentinelKey(path);\n } else {\n return PersistencePromise.resolve();\n }\n })\n );\n })\n .next(() => PersistencePromise.waitFor(promises));\n });\n }\n\n private createCollectionParentIndex(\n db: IDBDatabase,\n txn: SimpleDbTransaction\n ): PersistencePromise<void> {\n // Create the index.\n db.createObjectStore(DbCollectionParent.store, {\n keyPath: DbCollectionParent.keyPath\n });\n\n const collectionParentsStore = txn.store<\n DbCollectionParentKey,\n DbCollectionParent\n >(DbCollectionParent.store);\n\n // Helper to add an index entry iff we haven't already written it.\n const cache = new MemoryCollectionParentIndex();\n const addEntry = (\n collectionPath: ResourcePath\n ): PersistencePromise<void> | undefined => {\n if (cache.add(collectionPath)) {\n const collectionId = collectionPath.lastSegment();\n const parentPath = collectionPath.popLast();\n return collectionParentsStore.put({\n collectionId,\n parent: encode(parentPath)\n });\n }\n };\n\n // Index existing remote documents.\n return txn\n .store<DbRemoteDocumentKey, DbRemoteDocument>(DbRemoteDocument.store)\n .iterate({ keysOnly: true }, (pathSegments, _) => {\n const path = new ResourcePath(pathSegments);\n return addEntry(path.popLast());\n })\n .next(() => {\n // Index existing mutations.\n return txn\n .store<DbDocumentMutationKey, DbDocumentMutation>(\n DbDocumentMutation.store\n )\n .iterate({ keysOnly: true }, ([userID, encodedPath, batchId], _) => {\n const path = decode(encodedPath);\n return addEntry(path.popLast());\n });\n });\n }\n}\n\nfunction sentinelKey(path: ResourcePath): DbTargetDocumentKey {\n return [0, encode(path)];\n}\n\n/**\n * Wrapper class to store timestamps (seconds and nanos) in IndexedDb objects.\n */\nexport class DbTimestamp {\n constructor(public seconds: number, public nanoseconds: number) {}\n}\n\n/** A timestamp type that can be used in IndexedDb keys. */\nexport type DbTimestampKey = [/* seconds */ number, /* nanos */ number];\n\n// The key for the singleton object in the DbPrimaryClient is a single string.\nexport type DbPrimaryClientKey = typeof DbPrimaryClient.key;\n\n/**\n * A singleton object to be stored in the 'owner' store in IndexedDb.\n *\n * A given database can have a single primary tab assigned at a given time. That\n * tab must validate that it is still holding the primary lease before every\n * operation that requires locked access. The primary tab should regularly\n * write an updated timestamp to this lease to prevent other tabs from\n * \"stealing\" the primary lease\n */\nexport class DbPrimaryClient {\n /**\n * Name of the IndexedDb object store.\n *\n * Note that the name 'owner' is chosen to ensure backwards compatibility with\n * older clients that only supported single locked access to the persistence\n * layer.\n */\n static store = 'owner';\n\n /**\n * The key string used for the single object that exists in the\n * DbPrimaryClient store.\n */\n static key = 'owner';\n\n constructor(\n public ownerId: string,\n /** Whether to allow shared access from multiple tabs. */\n public allowTabSynchronization: boolean,\n public leaseTimestampMs: number\n ) {}\n}\n\nfunction createPrimaryClientStore(db: IDBDatabase): void {\n db.createObjectStore(DbPrimaryClient.store);\n}\n\n/** Object keys in the 'mutationQueues' store are userId strings. */\nexport type DbMutationQueueKey = string;\n\n/**\n * An object to be stored in the 'mutationQueues' store in IndexedDb.\n *\n * Each user gets a single queue of MutationBatches to apply to the server.\n * DbMutationQueue tracks the metadata about the queue.\n */\nexport class DbMutationQueue {\n /** Name of the IndexedDb object store. */\n static store = 'mutationQueues';\n\n /** Keys are automatically assigned via the userId property. */\n static keyPath = 'userId';\n\n constructor(\n /**\n * The normalized user ID to which this queue belongs.\n */\n public userId: string,\n /**\n * An identifier for the highest numbered batch that has been acknowledged\n * by the server. All MutationBatches in this queue with batchIds less\n * than or equal to this value are considered to have been acknowledged by\n * the server.\n *\n * NOTE: this is deprecated and no longer used by the code.\n */\n public lastAcknowledgedBatchId: number,\n /**\n * A stream token that was previously sent by the server.\n *\n * See StreamingWriteRequest in datastore.proto for more details about\n * usage.\n *\n * After sending this token, earlier tokens may not be used anymore so\n * only a single stream token is retained.\n */\n public lastStreamToken: string\n ) {}\n}\n\n/** The 'mutations' store is keyed by batch ID. */\nexport type DbMutationBatchKey = BatchId;\n\n/**\n * An object to be stored in the 'mutations' store in IndexedDb.\n *\n * Represents a batch of user-level mutations intended to be sent to the server\n * in a single write. Each user-level batch gets a separate DbMutationBatch\n * with a new batchId.\n */\nexport class DbMutationBatch {\n /** Name of the IndexedDb object store. */\n static store = 'mutations';\n\n /** Keys are automatically assigned via the userId, batchId properties. */\n static keyPath = 'batchId';\n\n /** The index name for lookup of mutations by user. */\n static userMutationsIndex = 'userMutationsIndex';\n\n /** The user mutations index is keyed by [userId, batchId] pairs. */\n static userMutationsKeyPath = ['userId', 'batchId'];\n\n constructor(\n /**\n * The normalized user ID to which this batch belongs.\n */\n public userId: string,\n /**\n * An identifier for this batch, allocated using an auto-generated key.\n */\n public batchId: BatchId,\n /**\n * The local write time of the batch, stored as milliseconds since the\n * epoch.\n */\n public localWriteTimeMs: number,\n /**\n * A list of \"mutations\" that represent a partial base state from when this\n * write batch was initially created. During local application of the write\n * batch, these baseMutations are applied prior to the real writes in order\n * to override certain document fields from the remote document cache. This\n * is necessary in the case of non-idempotent writes (e.g. `increment()`\n * transforms) to make sure that the local view of the modified documents\n * doesn't flicker if the remote document cache receives the result of the\n * non-idempotent write before the write is removed from the queue.\n *\n * These mutations are never sent to the backend.\n */\n public baseMutations: api.Write[] | undefined,\n /**\n * A list of mutations to apply. All mutations will be applied atomically.\n *\n * Mutations are serialized via JsonProtoSerializer.toMutation().\n */\n public mutations: api.Write[]\n ) {}\n}\n\n/**\n * The key for a db document mutation, which is made up of a userID, path, and\n * batchId. Note that the path must be serialized into a form that indexedDB can\n * sort.\n */\nexport type DbDocumentMutationKey = [string, EncodedResourcePath, BatchId];\n\nfunction createMutationQueue(db: IDBDatabase): void {\n db.createObjectStore(DbMutationQueue.store, {\n keyPath: DbMutationQueue.keyPath\n });\n\n const mutationBatchesStore = db.createObjectStore(DbMutationBatch.store, {\n keyPath: DbMutationBatch.keyPath,\n autoIncrement: true\n });\n mutationBatchesStore.createIndex(\n DbMutationBatch.userMutationsIndex,\n DbMutationBatch.userMutationsKeyPath,\n { unique: true }\n );\n\n db.createObjectStore(DbDocumentMutation.store);\n}\n\n/**\n * Upgrade function to migrate the 'mutations' store from V1 to V3. Loads\n * and rewrites all data.\n */\nfunction upgradeMutationBatchSchemaAndMigrateData(\n db: IDBDatabase,\n txn: SimpleDbTransaction\n): PersistencePromise<void> {\n const v1MutationsStore = txn.store<[string, number], DbMutationBatch>(\n DbMutationBatch.store\n );\n return v1MutationsStore.loadAll().next(existingMutations => {\n db.deleteObjectStore(DbMutationBatch.store);\n\n const mutationsStore = db.createObjectStore(DbMutationBatch.store, {\n keyPath: DbMutationBatch.keyPath,\n autoIncrement: true\n });\n mutationsStore.createIndex(\n DbMutationBatch.userMutationsIndex,\n DbMutationBatch.userMutationsKeyPath,\n { unique: true }\n );\n\n const v3MutationsStore = txn.store<DbMutationBatchKey, DbMutationBatch>(\n DbMutationBatch.store\n );\n const writeAll = existingMutations.map(mutation =>\n v3MutationsStore.put(mutation)\n );\n\n return PersistencePromise.waitFor(writeAll);\n });\n}\n\n/**\n * An object to be stored in the 'documentMutations' store in IndexedDb.\n *\n * A manually maintained index of all the mutation batches that affect a given\n * document key. The rows in this table are references based on the contents of\n * DbMutationBatch.mutations.\n */\nexport class DbDocumentMutation {\n static store = 'documentMutations';\n\n /**\n * Creates a [userId] key for use in the DbDocumentMutations index to iterate\n * over all of a user's document mutations.\n */\n static prefixForUser(userId: string): [string] {\n return [userId];\n }\n\n /**\n * Creates a [userId, encodedPath] key for use in the DbDocumentMutations\n * index to iterate over all at document mutations for a given path or lower.\n */\n static prefixForPath(\n userId: string,\n path: ResourcePath\n ): [string, EncodedResourcePath] {\n return [userId, encode(path)];\n }\n\n /**\n * Creates a full index key of [userId, encodedPath, batchId] for inserting\n * and deleting into the DbDocumentMutations index.\n */\n static key(\n userId: string,\n path: ResourcePath,\n batchId: BatchId\n ): DbDocumentMutationKey {\n return [userId, encode(path), batchId];\n }\n\n /**\n * Because we store all the useful information for this store in the key,\n * there is no useful information to store as the value. The raw (unencoded)\n * path cannot be stored because IndexedDb doesn't store prototype\n * information.\n */\n static PLACEHOLDER = new DbDocumentMutation();\n\n private constructor() {}\n}\n\n/**\n * A key in the 'remoteDocuments' object store is a string array containing the\n * segments that make up the path.\n */\nexport type DbRemoteDocumentKey = string[];\n\nfunction createRemoteDocumentCache(db: IDBDatabase): void {\n db.createObjectStore(DbRemoteDocument.store);\n}\n\n/**\n * Represents the known absence of a document at a particular version.\n * Stored in IndexedDb as part of a DbRemoteDocument object.\n */\nexport class DbNoDocument {\n constructor(public path: string[], public readTime: DbTimestamp) {}\n}\n\n/**\n * Represents a document that is known to exist but whose data is unknown.\n * Stored in IndexedDb as part of a DbRemoteDocument object.\n */\nexport class DbUnknownDocument {\n constructor(public path: string[], public version: DbTimestamp) {}\n}\n\n/**\n * An object to be stored in the 'remoteDocuments' store in IndexedDb.\n * It represents either:\n *\n * - A complete document.\n * - A \"no document\" representing a document that is known not to exist (at\n * some version).\n * - An \"unknown document\" representing a document that is known to exist (at\n * some version) but whose contents are unknown.\n *\n * Note: This is the persisted equivalent of a MaybeDocument and could perhaps\n * be made more general if necessary.\n */\nexport class DbRemoteDocument {\n static store = 'remoteDocuments';\n\n /**\n * An index that provides access to all entries sorted by read time (which\n * corresponds to the last modification time of each row).\n *\n * This index is used to provide a changelog for Multi-Tab.\n */\n static readTimeIndex = 'readTimeIndex';\n\n static readTimeIndexPath = 'readTime';\n\n /**\n * An index that provides access to documents in a collection sorted by read\n * time.\n *\n * This index is used to allow the RemoteDocumentCache to fetch newly changed\n * documents in a collection.\n */\n static collectionReadTimeIndex = 'collectionReadTimeIndex';\n\n static collectionReadTimeIndexPath = ['parentPath', 'readTime'];\n\n // TODO: We are currently storing full document keys almost three times\n // (once as part of the primary key, once - partly - as `parentPath` and once\n // inside the encoded documents). During our next migration, we should\n // rewrite the primary key as parentPath + document ID which would allow us\n // to drop one value.\n\n constructor(\n /**\n * Set to an instance of DbUnknownDocument if the data for a document is\n * not known, but it is known that a document exists at the specified\n * version (e.g. it had a successful update applied to it)\n */\n public unknownDocument: DbUnknownDocument | null | undefined,\n /**\n * Set to an instance of a DbNoDocument if it is known that no document\n * exists.\n */\n public noDocument: DbNoDocument | null,\n /**\n * Set to an instance of a Document if there's a cached version of the\n * document.\n */\n public document: api.Document | null,\n /**\n * Documents that were written to the remote document store based on\n * a write acknowledgment are marked with `hasCommittedMutations`. These\n * documents are potentially inconsistent with the backend's copy and use\n * the write's commit version as their document version.\n */\n public hasCommittedMutations: boolean | undefined,\n\n /**\n * When the document was read from the backend. Undefined for data written\n * prior to schema version 9.\n */\n public readTime: DbTimestampKey | undefined,\n\n /**\n * The path of the collection this document is part of. Undefined for data\n * written prior to schema version 9.\n */\n public parentPath: string[] | undefined\n ) {}\n}\n\n/**\n * Contains a single entry that has metadata about the remote document cache.\n */\nexport class DbRemoteDocumentGlobal {\n static store = 'remoteDocumentGlobal';\n\n static key = 'remoteDocumentGlobalKey';\n\n /**\n * @param byteSize Approximately the total size in bytes of all the documents in the document\n * cache.\n */\n constructor(public byteSize: number) {}\n}\n\nexport type DbRemoteDocumentGlobalKey = typeof DbRemoteDocumentGlobal.key;\n\nfunction createDocumentGlobalStore(db: IDBDatabase): void {\n db.createObjectStore(DbRemoteDocumentGlobal.store);\n}\n\n/**\n * A key in the 'targets' object store is a targetId of the query.\n */\nexport type DbTargetKey = TargetId;\n\n/**\n * The persisted type for a query nested with in the 'targets' store in\n * IndexedDb. We use the proto definitions for these two kinds of queries in\n * order to avoid writing extra serialization logic.\n */\nexport type DbQuery = api.QueryTarget | api.DocumentsTarget;\n\n/**\n * An object to be stored in the 'targets' store in IndexedDb.\n *\n * This is based on and should be kept in sync with the proto used in the iOS\n * client.\n *\n * Each query the client listens to against the server is tracked on disk so\n * that the query can be efficiently resumed on restart.\n */\nexport class DbTarget {\n static store = 'targets';\n\n /** Keys are automatically assigned via the targetId property. */\n static keyPath = 'targetId';\n\n /** The name of the queryTargets index. */\n static queryTargetsIndexName = 'queryTargetsIndex';\n\n /**\n * The index of all canonicalIds to the targets that they match. This is not\n * a unique mapping because canonicalId does not promise a unique name for all\n * possible queries, so we append the targetId to make the mapping unique.\n */\n static queryTargetsKeyPath = ['canonicalId', 'targetId'];\n\n constructor(\n /**\n * An auto-generated sequential numeric identifier for the query.\n *\n * Queries are stored using their canonicalId as the key, but these\n * canonicalIds can be quite long so we additionally assign a unique\n * queryId which can be used by referenced data structures (e.g.\n * indexes) to minimize the on-disk cost.\n */\n public targetId: TargetId,\n /**\n * The canonical string representing this query. This is not unique.\n */\n public canonicalId: string,\n /**\n * The last readTime received from the Watch Service for this query.\n *\n * This is the same value as TargetChange.read_time in the protos.\n */\n public readTime: DbTimestamp,\n /**\n * An opaque, server-assigned token that allows watching a query to be\n * resumed after disconnecting without retransmitting all the data\n * that matches the query. The resume token essentially identifies a\n * point in time from which the server should resume sending results.\n *\n * This is related to the snapshotVersion in that the resumeToken\n * effectively also encodes that value, but the resumeToken is opaque\n * and sometimes encodes additional information.\n *\n * A consequence of this is that the resumeToken should be used when\n * asking the server to reason about where this client is in the watch\n * stream, but the client should use the snapshotVersion for its own\n * purposes.\n *\n * This is the same value as TargetChange.resume_token in the protos.\n */\n public resumeToken: string,\n /**\n * A sequence number representing the last time this query was\n * listened to, used for garbage collection purposes.\n *\n * Conventionally this would be a timestamp value, but device-local\n * clocks are unreliable and they must be able to create new listens\n * even while disconnected. Instead this should be a monotonically\n * increasing number that's incremented on each listen call.\n *\n * This is different from the queryId since the queryId is an\n * immutable identifier assigned to the Query on first use while\n * lastListenSequenceNumber is updated every time the query is\n * listened to.\n */\n public lastListenSequenceNumber: number,\n /**\n * Denotes the maximum snapshot version at which the associated query view\n * contained no limbo documents. Undefined for data written prior to\n * schema version 9.\n */\n public lastLimboFreeSnapshotVersion: DbTimestamp | undefined,\n /**\n * The query for this target.\n *\n * Because canonical ids are not unique we must store the actual query. We\n * use the proto to have an object we can persist without having to\n * duplicate translation logic to and from a `Query` object.\n */\n public query: DbQuery\n ) {}\n}\n\n/**\n * The key for a DbTargetDocument, containing a targetId and an encoded resource\n * path.\n */\nexport type DbTargetDocumentKey = [TargetId, EncodedResourcePath];\n\n/**\n * An object representing an association between a target and a document, or a\n * sentinel row marking the last sequence number at which a document was used.\n * Each document cached must have a corresponding sentinel row before lru\n * garbage collection is enabled.\n *\n * The target associations and sentinel rows are co-located so that orphaned\n * documents and their sequence numbers can be identified efficiently via a scan\n * of this store.\n */\nexport class DbTargetDocument {\n /** Name of the IndexedDb object store. */\n static store = 'targetDocuments';\n\n /** Keys are automatically assigned via the targetId, path properties. */\n static keyPath = ['targetId', 'path'];\n\n /** The index name for the reverse index. */\n static documentTargetsIndex = 'documentTargetsIndex';\n\n /** We also need to create the reverse index for these properties. */\n static documentTargetsKeyPath = ['path', 'targetId'];\n\n constructor(\n /**\n * The targetId identifying a target or 0 for a sentinel row.\n */\n public targetId: TargetId,\n /**\n * The path to the document, as encoded in the key.\n */\n public path: EncodedResourcePath,\n /**\n * If this is a sentinel row, this should be the sequence number of the last\n * time the document specified by `path` was used. Otherwise, it should be\n * `undefined`.\n */\n public sequenceNumber?: ListenSequenceNumber\n ) {\n assert(\n (targetId === 0) === (sequenceNumber !== undefined),\n 'A target-document row must either have targetId == 0 and a defined sequence number, or a non-zero targetId and no sequence number'\n );\n }\n}\n\n/**\n * The type to represent the single allowed key for the DbTargetGlobal store.\n */\nexport type DbTargetGlobalKey = typeof DbTargetGlobal.key;\n\n/**\n * A record of global state tracked across all Targets, tracked separately\n * to avoid the need for extra indexes.\n *\n * This should be kept in-sync with the proto used in the iOS client.\n */\nexport class DbTargetGlobal {\n /**\n * The key string used for the single object that exists in the\n * DbTargetGlobal store.\n */\n static key = 'targetGlobalKey';\n static store = 'targetGlobal';\n\n constructor(\n /**\n * The highest numbered target id across all targets.\n *\n * See DbTarget.targetId.\n */\n public highestTargetId: TargetId,\n /**\n * The highest numbered lastListenSequenceNumber across all targets.\n *\n * See DbTarget.lastListenSequenceNumber.\n */\n public highestListenSequenceNumber: number,\n /**\n * A global snapshot version representing the last consistent snapshot we\n * received from the backend. This is monotonically increasing and any\n * snapshots received from the backend prior to this version (e.g. for\n * targets resumed with a resumeToken) should be suppressed (buffered)\n * until the backend has caught up to this snapshot version again. This\n * prevents our cache from ever going backwards in time.\n */\n public lastRemoteSnapshotVersion: DbTimestamp,\n /**\n * The number of targets persisted.\n */\n public targetCount: number\n ) {}\n}\n\n/**\n * The key for a DbCollectionParent entry, containing the collection ID\n * and the parent path that contains it. Note that the parent path will be an\n * empty path in the case of root-level collections.\n */\nexport type DbCollectionParentKey = [string, EncodedResourcePath];\n\n/**\n * An object representing an association between a Collection id (e.g. 'messages')\n * to a parent path (e.g. '/chats/123') that contains it as a (sub)collection.\n * This is used to efficiently find all collections to query when performing\n * a Collection Group query.\n */\nexport class DbCollectionParent {\n /** Name of the IndexedDb object store. */\n static store = 'collectionParents';\n\n /** Keys are automatically assigned via the collectionId, parent properties. */\n static keyPath = ['collectionId', 'parent'];\n\n constructor(\n /**\n * The collectionId (e.g. 'messages')\n */\n public collectionId: string,\n /**\n * The path to the parent (either a document location or an empty path for\n * a root-level collection).\n */\n public parent: EncodedResourcePath\n ) {}\n}\n\nfunction createQueryCache(db: IDBDatabase): void {\n const targetDocumentsStore = db.createObjectStore(DbTargetDocument.store, {\n keyPath: DbTargetDocument.keyPath\n });\n targetDocumentsStore.createIndex(\n DbTargetDocument.documentTargetsIndex,\n DbTargetDocument.documentTargetsKeyPath,\n { unique: true }\n );\n\n const targetStore = db.createObjectStore(DbTarget.store, {\n keyPath: DbTarget.keyPath\n });\n\n // NOTE: This is unique only because the TargetId is the suffix.\n targetStore.createIndex(\n DbTarget.queryTargetsIndexName,\n DbTarget.queryTargetsKeyPath,\n { unique: true }\n );\n db.createObjectStore(DbTargetGlobal.store);\n}\n\nfunction dropQueryCache(db: IDBDatabase): void {\n db.deleteObjectStore(DbTargetDocument.store);\n db.deleteObjectStore(DbTarget.store);\n db.deleteObjectStore(DbTargetGlobal.store);\n}\n\nfunction dropRemoteDocumentChangesStore(db: IDBDatabase): void {\n if (db.objectStoreNames.contains('remoteDocumentChanges')) {\n db.deleteObjectStore('remoteDocumentChanges');\n }\n}\n\n/**\n * Creates the target global singleton row.\n *\n * @param {IDBTransaction} txn The version upgrade transaction for indexeddb\n */\nfunction writeEmptyTargetGlobalEntry(\n txn: SimpleDbTransaction\n): PersistencePromise<void> {\n const globalStore = txn.store<DbTargetGlobalKey, DbTargetGlobal>(\n DbTargetGlobal.store\n );\n const metadata = new DbTargetGlobal(\n /*highestTargetId=*/ 0,\n /*lastListenSequenceNumber=*/ 0,\n SnapshotVersion.MIN.toTimestamp(),\n /*targetCount=*/ 0\n );\n return globalStore.put(DbTargetGlobal.key, metadata);\n}\n\n/**\n * Creates indices on the RemoteDocuments store used for both multi-tab\n * and Index-Free queries.\n */\nfunction createRemoteDocumentReadTimeIndex(txn: IDBTransaction): void {\n const remoteDocumentStore = txn.objectStore(DbRemoteDocument.store);\n remoteDocumentStore.createIndex(\n DbRemoteDocument.readTimeIndex,\n DbRemoteDocument.readTimeIndexPath,\n { unique: false }\n );\n remoteDocumentStore.createIndex(\n DbRemoteDocument.collectionReadTimeIndex,\n DbRemoteDocument.collectionReadTimeIndexPath,\n { unique: false }\n );\n}\n\n/**\n * A record of the metadata state of each client.\n *\n * PORTING NOTE: This is used to synchronize multi-tab state and does not need\n * to be ported to iOS or Android.\n */\nexport class DbClientMetadata {\n /** Name of the IndexedDb object store. */\n static store = 'clientMetadata';\n\n /** Keys are automatically assigned via the clientId properties. */\n static keyPath = 'clientId';\n\n constructor(\n // Note: Previous schema versions included a field\n // \"lastProcessedDocumentChangeId\". Don't use anymore.\n\n /** The auto-generated client id assigned at client startup. */\n public clientId: string,\n /** The last time this state was updated. */\n public updateTimeMs: number,\n /** Whether the client's network connection is enabled. */\n public networkEnabled: boolean,\n /** Whether this client is running in a foreground tab. */\n public inForeground: boolean\n ) {}\n}\n\n/** Object keys in the 'clientMetadata' store are clientId strings. */\nexport type DbClientMetadataKey = string;\n\nfunction createClientMetadataStore(db: IDBDatabase): void {\n db.createObjectStore(DbClientMetadata.store, {\n keyPath: DbClientMetadata.keyPath\n });\n}\n\n// Visible for testing\nexport const V1_STORES = [\n DbMutationQueue.store,\n DbMutationBatch.store,\n DbDocumentMutation.store,\n DbRemoteDocument.store,\n DbTarget.store,\n DbPrimaryClient.store,\n DbTargetGlobal.store,\n DbTargetDocument.store\n];\n\n// V2 is no longer usable (see comment at top of file)\n\n// Visible for testing\nexport const V3_STORES = V1_STORES;\n\n// Visible for testing\n// Note: DbRemoteDocumentChanges is no longer used and dropped with v9.\nexport const V4_STORES = [...V3_STORES, DbClientMetadata.store];\n\n// V5 does not change the set of stores.\n\nexport const V6_STORES = [...V4_STORES, DbRemoteDocumentGlobal.store];\n\n// V7 does not change the set of stores.\n\nexport const V8_STORES = [...V6_STORES, DbCollectionParent.store];\n\n// V9 does not change the set of stores.\n\n/**\n * The list of all default IndexedDB stores used throughout the SDK. This is\n * used when creating transactions so that access across all stores is done\n * atomically.\n */\nexport const ALL_STORES = V8_STORES;\n","/**\n * @license\n * Copyright 2019 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ResourcePath } from '../model/path';\nimport { assert } from '../util/assert';\nimport { immediateSuccessor } from '../util/misc';\nimport { decode, encode } from './encoded_resource_path';\nimport { IndexManager } from './index_manager';\nimport { IndexedDbPersistence } from './indexeddb_persistence';\nimport { DbCollectionParent, DbCollectionParentKey } from './indexeddb_schema';\nimport { MemoryCollectionParentIndex } from './memory_index_manager';\nimport { PersistenceTransaction } from './persistence';\nimport { PersistencePromise } from './persistence_promise';\nimport { SimpleDbStore } from './simple_db';\n\n/**\n * A persisted implementation of IndexManager.\n */\nexport class IndexedDbIndexManager implements IndexManager {\n /**\n * An in-memory copy of the index entries we've already written since the SDK\n * launched. Used to avoid re-writing the same entry repeatedly.\n *\n * This is *NOT* a complete cache of what's in persistence and so can never be used to\n * satisfy reads.\n */\n private collectionParentsCache = new MemoryCollectionParentIndex();\n\n /**\n * Adds a new entry to the collection parent index.\n *\n * Repeated calls for the same collectionPath should be avoided within a\n * transaction as IndexedDbIndexManager only caches writes once a transaction\n * has been committed.\n */\n addToCollectionParentIndex(\n transaction: PersistenceTransaction,\n collectionPath: ResourcePath\n ): PersistencePromise<void> {\n assert(collectionPath.length % 2 === 1, 'Expected a collection path.');\n if (!this.collectionParentsCache.has(collectionPath)) {\n const collectionId = collectionPath.lastSegment();\n const parentPath = collectionPath.popLast();\n\n transaction.addOnCommittedListener(() => {\n // Add the collection to the in memory cache only if the transaction was\n // successfully committed.\n this.collectionParentsCache.add(collectionPath);\n });\n\n const collectionParent: DbCollectionParent = {\n collectionId,\n parent: encode(parentPath)\n };\n return collectionParentsStore(transaction).put(collectionParent);\n }\n return PersistencePromise.resolve();\n }\n\n getCollectionParents(\n transaction: PersistenceTransaction,\n collectionId: string\n ): PersistencePromise<ResourcePath[]> {\n const parentPaths = [] as ResourcePath[];\n const range = IDBKeyRange.bound(\n [collectionId, ''],\n [immediateSuccessor(collectionId), ''],\n /*lowerOpen=*/ false,\n /*upperOpen=*/ true\n );\n return collectionParentsStore(transaction)\n .loadAll(range)\n .next(entries => {\n for (const entry of entries) {\n // This collectionId guard shouldn't be necessary (and isn't as long\n // as we're running in a real browser), but there's a bug in\n // indexeddbshim that breaks our range in our tests running in node:\n // https://github.com/axemclion/IndexedDBShim/issues/334\n if (entry.collectionId !== collectionId) {\n break;\n }\n parentPaths.push(decode(entry.parent));\n }\n return parentPaths;\n });\n }\n}\n\n/**\n * Helper to get a typed SimpleDbStore for the collectionParents\n * document store.\n */\nfunction collectionParentsStore(\n txn: PersistenceTransaction\n): SimpleDbStore<DbCollectionParentKey, DbCollectionParent> {\n return IndexedDbPersistence.getStore<\n DbCollectionParentKey,\n DbCollectionParent\n >(txn, DbCollectionParent.store);\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Timestamp } from '../api/timestamp';\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport {\n Document,\n MaybeDocument,\n NoDocument,\n UnknownDocument\n} from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport { MutationBatch } from '../model/mutation_batch';\nimport * as api from '../protos/firestore_proto_api';\nimport { JsonProtoSerializer } from '../remote/serializer';\nimport { assert, fail } from '../util/assert';\n\nimport { documentKeySet, DocumentKeySet } from '../model/collections';\nimport { Target } from '../core/target';\nimport { decode, encode, EncodedResourcePath } from './encoded_resource_path';\nimport {\n DbMutationBatch,\n DbNoDocument,\n DbQuery,\n DbRemoteDocument,\n DbTarget,\n DbTimestamp,\n DbTimestampKey,\n DbUnknownDocument\n} from './indexeddb_schema';\nimport { SimpleDb } from './simple_db';\nimport { TargetData, TargetPurpose } from './target_data';\n\n/** Serializer for values stored in the LocalStore. */\nexport class LocalSerializer {\n constructor(private remoteSerializer: JsonProtoSerializer) {}\n\n /** Decodes a remote document from storage locally to a Document. */\n fromDbRemoteDocument(remoteDoc: DbRemoteDocument): MaybeDocument {\n if (remoteDoc.document) {\n return this.remoteSerializer.fromDocument(\n remoteDoc.document,\n !!remoteDoc.hasCommittedMutations\n );\n } else if (remoteDoc.noDocument) {\n const key = DocumentKey.fromSegments(remoteDoc.noDocument.path);\n const version = this.fromDbTimestamp(remoteDoc.noDocument.readTime);\n return new NoDocument(key, version, {\n hasCommittedMutations: !!remoteDoc.hasCommittedMutations\n });\n } else if (remoteDoc.unknownDocument) {\n const key = DocumentKey.fromSegments(remoteDoc.unknownDocument.path);\n const version = this.fromDbTimestamp(remoteDoc.unknownDocument.version);\n return new UnknownDocument(key, version);\n } else {\n return fail('Unexpected DbRemoteDocument');\n }\n }\n\n /** Encodes a document for storage locally. */\n toDbRemoteDocument(\n maybeDoc: MaybeDocument,\n readTime: SnapshotVersion\n ): DbRemoteDocument {\n const dbReadTime = this.toDbTimestampKey(readTime);\n const parentPath = maybeDoc.key.path.popLast().toArray();\n if (maybeDoc instanceof Document) {\n const doc = maybeDoc.proto\n ? maybeDoc.proto\n : this.remoteSerializer.toDocument(maybeDoc);\n const hasCommittedMutations = maybeDoc.hasCommittedMutations;\n return new DbRemoteDocument(\n /* unknownDocument= */ null,\n /* noDocument= */ null,\n doc,\n hasCommittedMutations,\n dbReadTime,\n parentPath\n );\n } else if (maybeDoc instanceof NoDocument) {\n const path = maybeDoc.key.path.toArray();\n const readTime = this.toDbTimestamp(maybeDoc.version);\n const hasCommittedMutations = maybeDoc.hasCommittedMutations;\n return new DbRemoteDocument(\n /* unknownDocument= */ null,\n new DbNoDocument(path, readTime),\n /* document= */ null,\n hasCommittedMutations,\n dbReadTime,\n parentPath\n );\n } else if (maybeDoc instanceof UnknownDocument) {\n const path = maybeDoc.key.path.toArray();\n const readTime = this.toDbTimestamp(maybeDoc.version);\n return new DbRemoteDocument(\n new DbUnknownDocument(path, readTime),\n /* noDocument= */ null,\n /* document= */ null,\n /* hasCommittedMutations= */ true,\n dbReadTime,\n parentPath\n );\n } else {\n return fail('Unexpected MaybeDocument');\n }\n }\n\n toDbTimestampKey(snapshotVersion: SnapshotVersion): DbTimestampKey {\n const timestamp = snapshotVersion.toTimestamp();\n return [timestamp.seconds, timestamp.nanoseconds];\n }\n\n fromDbTimestampKey(dbTimestampKey: DbTimestampKey): SnapshotVersion {\n const timestamp = new Timestamp(dbTimestampKey[0], dbTimestampKey[1]);\n return SnapshotVersion.fromTimestamp(timestamp);\n }\n\n private toDbTimestamp(snapshotVersion: SnapshotVersion): DbTimestamp {\n const timestamp = snapshotVersion.toTimestamp();\n return new DbTimestamp(timestamp.seconds, timestamp.nanoseconds);\n }\n\n private fromDbTimestamp(dbTimestamp: DbTimestamp): SnapshotVersion {\n const timestamp = new Timestamp(\n dbTimestamp.seconds,\n dbTimestamp.nanoseconds\n );\n return SnapshotVersion.fromTimestamp(timestamp);\n }\n\n /** Encodes a batch of mutations into a DbMutationBatch for local storage. */\n toDbMutationBatch(userId: string, batch: MutationBatch): DbMutationBatch {\n const serializedBaseMutations = batch.baseMutations.map(m =>\n this.remoteSerializer.toMutation(m)\n );\n const serializedMutations = batch.mutations.map(m =>\n this.remoteSerializer.toMutation(m)\n );\n return new DbMutationBatch(\n userId,\n batch.batchId,\n batch.localWriteTime.toMillis(),\n serializedBaseMutations,\n serializedMutations\n );\n }\n\n /** Decodes a DbMutationBatch into a MutationBatch */\n fromDbMutationBatch(dbBatch: DbMutationBatch): MutationBatch {\n const baseMutations = (dbBatch.baseMutations || []).map(m =>\n this.remoteSerializer.fromMutation(m)\n );\n const mutations = dbBatch.mutations.map(m =>\n this.remoteSerializer.fromMutation(m)\n );\n const timestamp = Timestamp.fromMillis(dbBatch.localWriteTimeMs);\n return new MutationBatch(\n dbBatch.batchId,\n timestamp,\n baseMutations,\n mutations\n );\n }\n\n /*\n * Encodes a set of document keys into an array of EncodedResourcePaths.\n */\n toDbResourcePaths(keys: DocumentKeySet): EncodedResourcePath[] {\n const encodedKeys: EncodedResourcePath[] = [];\n\n keys.forEach(key => {\n encodedKeys.push(encode(key.path));\n });\n\n return encodedKeys;\n }\n\n /** Decodes an array of EncodedResourcePaths into a set of document keys. */\n fromDbResourcePaths(encodedPaths: EncodedResourcePath[]): DocumentKeySet {\n let keys = documentKeySet();\n\n for (const documentKey of encodedPaths) {\n keys = keys.add(new DocumentKey(decode(documentKey)));\n }\n\n return keys;\n }\n\n /** Decodes a DbTarget into TargetData */\n fromDbTarget(dbTarget: DbTarget): TargetData {\n const version = this.fromDbTimestamp(dbTarget.readTime);\n const lastLimboFreeSnapshotVersion =\n dbTarget.lastLimboFreeSnapshotVersion !== undefined\n ? this.fromDbTimestamp(dbTarget.lastLimboFreeSnapshotVersion)\n : SnapshotVersion.MIN;\n // TODO(b/140573486): Convert to platform representation\n const resumeToken = dbTarget.resumeToken;\n\n let target: Target;\n if (isDocumentQuery(dbTarget.query)) {\n target = this.remoteSerializer.fromDocumentsTarget(dbTarget.query);\n } else {\n target = this.remoteSerializer.fromQueryTarget(dbTarget.query);\n }\n return new TargetData(\n target,\n dbTarget.targetId,\n TargetPurpose.Listen,\n dbTarget.lastListenSequenceNumber,\n version,\n lastLimboFreeSnapshotVersion,\n resumeToken\n );\n }\n\n /** Encodes TargetData into a DbTarget for storage locally. */\n toDbTarget(targetData: TargetData): DbTarget {\n assert(\n TargetPurpose.Listen === targetData.purpose,\n 'Only queries with purpose ' +\n TargetPurpose.Listen +\n ' may be stored, got ' +\n targetData.purpose\n );\n const dbTimestamp = this.toDbTimestamp(targetData.snapshotVersion);\n const dbLastLimboFreeTimestamp = this.toDbTimestamp(\n targetData.lastLimboFreeSnapshotVersion\n );\n let queryProto: DbQuery;\n if (targetData.target.isDocumentQuery()) {\n queryProto = this.remoteSerializer.toDocumentsTarget(targetData.target);\n } else {\n queryProto = this.remoteSerializer.toQueryTarget(targetData.target);\n }\n\n let resumeToken: string;\n\n if (targetData.resumeToken instanceof Uint8Array) {\n // TODO(b/78771403): Convert tokens to strings during deserialization\n assert(\n SimpleDb.isMockPersistence(),\n 'Persisting non-string stream tokens is only supported with mock persistence .'\n );\n resumeToken = targetData.resumeToken.toString();\n } else {\n resumeToken = targetData.resumeToken;\n }\n\n // lastListenSequenceNumber is always 0 until we do real GC.\n return new DbTarget(\n targetData.targetId,\n targetData.target.canonicalId(),\n dbTimestamp,\n resumeToken,\n targetData.sequenceNumber,\n dbLastLimboFreeTimestamp,\n queryProto\n );\n }\n}\n\n/**\n * A helper function for figuring out what kind of query has been stored.\n */\nfunction isDocumentQuery(dbQuery: DbQuery): dbQuery is api.DocumentsTarget {\n return (dbQuery as api.DocumentsTarget).documents !== undefined;\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { User } from '../auth/user';\nimport { DatabaseInfo } from '../core/database_info';\nimport { ListenSequence, SequenceNumberSyncer } from '../core/listen_sequence';\nimport { ListenSequenceNumber, TargetId } from '../core/types';\nimport { DocumentKey } from '../model/document_key';\nimport { Platform } from '../platform/platform';\nimport { JsonProtoSerializer } from '../remote/serializer';\nimport { assert, fail } from '../util/assert';\nimport { AsyncQueue, TimerId } from '../util/async_queue';\nimport { Code, FirestoreError } from '../util/error';\nimport * as log from '../util/log';\nimport { CancelablePromise } from '../util/promise';\n\nimport { decode, encode, EncodedResourcePath } from './encoded_resource_path';\nimport { IndexedDbIndexManager } from './indexeddb_index_manager';\nimport {\n IndexedDbMutationQueue,\n mutationQueuesContainKey\n} from './indexeddb_mutation_queue';\nimport { IndexedDbRemoteDocumentCache } from './indexeddb_remote_document_cache';\nimport {\n ALL_STORES,\n DbClientMetadata,\n DbClientMetadataKey,\n DbPrimaryClient,\n DbPrimaryClientKey,\n DbTargetDocument,\n DbTargetGlobal,\n SCHEMA_VERSION,\n SchemaConverter\n} from './indexeddb_schema';\nimport {\n documentTargetStore,\n getHighestListenSequenceNumber,\n IndexedDbTargetCache\n} from './indexeddb_target_cache';\nimport { LocalSerializer } from './local_serializer';\nimport {\n ActiveTargets,\n LruDelegate,\n LruGarbageCollector,\n LruParams\n} from './lru_garbage_collector';\nimport { MutationQueue } from './mutation_queue';\nimport {\n Persistence,\n PersistenceTransaction,\n PersistenceTransactionMode,\n PRIMARY_LEASE_LOST_ERROR_MSG,\n PrimaryStateListener,\n ReferenceDelegate\n} from './persistence';\nimport { PersistencePromise } from './persistence_promise';\nimport { ReferenceSet } from './reference_set';\nimport { ClientId } from './shared_client_state';\nimport { TargetData } from './target_data';\nimport { SimpleDb, SimpleDbStore, SimpleDbTransaction } from './simple_db';\n\nconst LOG_TAG = 'IndexedDbPersistence';\n\n/**\n * Oldest acceptable age in milliseconds for client metadata before the client\n * is considered inactive and its associated data is garbage collected.\n */\nconst MAX_CLIENT_AGE_MS = 30 * 60 * 1000; // 30 minutes\n\n/**\n * Oldest acceptable metadata age for clients that may participate in the\n * primary lease election. Clients that have not updated their client metadata\n * within 5 seconds are not eligible to receive a primary lease.\n */\nconst MAX_PRIMARY_ELIGIBLE_AGE_MS = 5000;\n\n/**\n * The interval at which clients will update their metadata, including\n * refreshing their primary lease if held or potentially trying to acquire it if\n * not held.\n *\n * Primary clients may opportunistically refresh their metadata earlier\n * if they're already performing an IndexedDB operation.\n */\nconst CLIENT_METADATA_REFRESH_INTERVAL_MS = 4000;\n/** User-facing error when the primary lease is required but not available. */\nconst PRIMARY_LEASE_EXCLUSIVE_ERROR_MSG =\n 'Another tab has exclusive access to the persistence layer. ' +\n 'To allow shared access, make sure to invoke ' +\n '`enablePersistence()` with `synchronizeTabs:true` in all tabs.';\nconst UNSUPPORTED_PLATFORM_ERROR_MSG =\n 'This platform is either missing' +\n ' IndexedDB or is known to have an incomplete implementation. Offline' +\n ' persistence has been disabled.';\n\n// The format of the LocalStorage key that stores zombied client is:\n// firestore_zombie_<persistence_prefix>_<instance_key>\nconst ZOMBIED_CLIENTS_KEY_PREFIX = 'firestore_zombie';\n\nexport class IndexedDbTransaction extends PersistenceTransaction {\n constructor(\n readonly simpleDbTransaction: SimpleDbTransaction,\n readonly currentSequenceNumber: ListenSequenceNumber\n ) {\n super();\n }\n}\n\n/**\n * An IndexedDB-backed instance of Persistence. Data is stored persistently\n * across sessions.\n *\n * On Web only, the Firestore SDKs support shared access to its persistence\n * layer. This allows multiple browser tabs to read and write to IndexedDb and\n * to synchronize state even without network connectivity. Shared access is\n * currently optional and not enabled unless all clients invoke\n * `enablePersistence()` with `{synchronizeTabs:true}`.\n *\n * In multi-tab mode, if multiple clients are active at the same time, the SDK\n * will designate one client as the “primary client”. An effort is made to pick\n * a visible, network-connected and active client, and this client is\n * responsible for letting other clients know about its presence. The primary\n * client writes a unique client-generated identifier (the client ID) to\n * IndexedDb’s “owner” store every 4 seconds. If the primary client fails to\n * update this entry, another client can acquire the lease and take over as\n * primary.\n *\n * Some persistence operations in the SDK are designated as primary-client only\n * operations. This includes the acknowledgment of mutations and all updates of\n * remote documents. The effects of these operations are written to persistence\n * and then broadcast to other tabs via LocalStorage (see\n * `WebStorageSharedClientState`), which then refresh their state from\n * persistence.\n *\n * Similarly, the primary client listens to notifications sent by secondary\n * clients to discover persistence changes written by secondary clients, such as\n * the addition of new mutations and query targets.\n *\n * If multi-tab is not enabled and another tab already obtained the primary\n * lease, IndexedDbPersistence enters a failed state and all subsequent\n * operations will automatically fail.\n *\n * Additionally, there is an optimization so that when a tab is closed, the\n * primary lease is released immediately (this is especially important to make\n * sure that a refreshed tab is able to immediately re-acquire the primary\n * lease). Unfortunately, IndexedDB cannot be reliably used in window.unload\n * since it is an asynchronous API. So in addition to attempting to give up the\n * lease, the leaseholder writes its client ID to a \"zombiedClient\" entry in\n * LocalStorage which acts as an indicator that another tab should go ahead and\n * take the primary lease immediately regardless of the current lease timestamp.\n *\n * TODO(b/114226234): Remove `synchronizeTabs` section when multi-tab is no\n * longer optional.\n */\nexport class IndexedDbPersistence implements Persistence {\n static getStore<Key extends IDBValidKey, Value>(\n txn: PersistenceTransaction,\n store: string\n ): SimpleDbStore<Key, Value> {\n if (txn instanceof IndexedDbTransaction) {\n return SimpleDb.getStore<Key, Value>(txn.simpleDbTransaction, store);\n } else {\n throw fail(\n 'IndexedDbPersistence must use instances of IndexedDbTransaction'\n );\n }\n }\n\n /**\n * The name of the main (and currently only) IndexedDB database. this name is\n * appended to the prefix provided to the IndexedDbPersistence constructor.\n */\n static MAIN_DATABASE = 'main';\n\n static async createIndexedDbPersistence(options: {\n allowTabSynchronization: boolean;\n persistenceKey: string;\n clientId: ClientId;\n platform: Platform;\n lruParams: LruParams;\n queue: AsyncQueue;\n serializer: JsonProtoSerializer;\n sequenceNumberSyncer: SequenceNumberSyncer;\n }): Promise<IndexedDbPersistence> {\n if (!IndexedDbPersistence.isAvailable()) {\n throw new FirestoreError(\n Code.UNIMPLEMENTED,\n UNSUPPORTED_PLATFORM_ERROR_MSG\n );\n }\n\n const persistence = new IndexedDbPersistence(\n options.allowTabSynchronization,\n options.persistenceKey,\n options.clientId,\n options.platform,\n options.lruParams,\n options.queue,\n options.serializer,\n options.sequenceNumberSyncer\n );\n await persistence.start();\n return persistence;\n }\n\n private readonly document: Document | null;\n private readonly window: Window;\n\n // Technically these types should be `| undefined` because they are\n // initialized asynchronously by start(), but that would be more misleading\n // than useful.\n private simpleDb!: SimpleDb;\n private listenSequence!: ListenSequence;\n\n private _started = false;\n private isPrimary = false;\n private networkEnabled = true;\n private dbName: string;\n\n /** Our window.unload handler, if registered. */\n private windowUnloadHandler: (() => void) | null = null;\n private inForeground = false;\n\n private serializer: LocalSerializer;\n\n /** Our 'visibilitychange' listener if registered. */\n private documentVisibilityHandler: ((e?: Event) => void) | null = null;\n\n /** The client metadata refresh task. */\n private clientMetadataRefresher: CancelablePromise<void> | null = null;\n\n /** The last time we garbage collected the client metadata object store. */\n private lastGarbageCollectionTime = Number.NEGATIVE_INFINITY;\n\n /** A listener to notify on primary state changes. */\n private primaryStateListener: PrimaryStateListener = _ => Promise.resolve();\n\n private readonly targetCache: IndexedDbTargetCache;\n private readonly indexManager: IndexedDbIndexManager;\n private readonly remoteDocumentCache: IndexedDbRemoteDocumentCache;\n private readonly webStorage: Storage;\n readonly referenceDelegate: IndexedDbLruDelegate;\n\n private constructor(\n private readonly allowTabSynchronization: boolean,\n private readonly persistenceKey: string,\n private readonly clientId: ClientId,\n platform: Platform,\n lruParams: LruParams,\n private readonly queue: AsyncQueue,\n serializer: JsonProtoSerializer,\n private readonly sequenceNumberSyncer: SequenceNumberSyncer\n ) {\n this.referenceDelegate = new IndexedDbLruDelegate(this, lruParams);\n this.dbName = persistenceKey + IndexedDbPersistence.MAIN_DATABASE;\n this.serializer = new LocalSerializer(serializer);\n this.document = platform.document;\n this.targetCache = new IndexedDbTargetCache(\n this.referenceDelegate,\n this.serializer\n );\n this.indexManager = new IndexedDbIndexManager();\n this.remoteDocumentCache = new IndexedDbRemoteDocumentCache(\n this.serializer,\n this.indexManager\n );\n if (platform.window && platform.window.localStorage) {\n this.window = platform.window;\n this.webStorage = this.window.localStorage;\n } else {\n throw new FirestoreError(\n Code.UNIMPLEMENTED,\n 'IndexedDB persistence is only available on platforms that support LocalStorage.'\n );\n }\n }\n\n /**\n * Attempt to start IndexedDb persistence.\n *\n * @return {Promise<void>} Whether persistence was enabled.\n */\n private start(): Promise<void> {\n assert(!this.started, 'IndexedDbPersistence double-started!');\n assert(this.window !== null, \"Expected 'window' to be defined\");\n\n return SimpleDb.openOrCreate(\n this.dbName,\n SCHEMA_VERSION,\n new SchemaConverter(this.serializer)\n )\n .then(db => {\n this.simpleDb = db;\n // NOTE: This is expected to fail sometimes (in the case of another tab already\n // having the persistence lock), so it's the first thing we should do.\n return this.updateClientMetadataAndTryBecomePrimary();\n })\n .then(() => {\n this.attachVisibilityHandler();\n this.attachWindowUnloadHook();\n\n this.scheduleClientMetadataAndPrimaryLeaseRefreshes();\n\n return this.simpleDb.runTransaction(\n 'readonly-idempotent',\n [DbTargetGlobal.store],\n txn => getHighestListenSequenceNumber(txn)\n );\n })\n .then(highestListenSequenceNumber => {\n this.listenSequence = new ListenSequence(\n highestListenSequenceNumber,\n this.sequenceNumberSyncer\n );\n })\n .then(() => {\n this._started = true;\n })\n .catch(reason => {\n this.simpleDb && this.simpleDb.close();\n return Promise.reject(reason);\n });\n }\n\n setPrimaryStateListener(\n primaryStateListener: PrimaryStateListener\n ): Promise<void> {\n this.primaryStateListener = async primaryState => {\n if (this.started) {\n return primaryStateListener(primaryState);\n }\n };\n return primaryStateListener(this.isPrimary);\n }\n\n setDatabaseDeletedListener(\n databaseDeletedListener: () => Promise<void>\n ): void {\n this.simpleDb.setVersionChangeListener(async event => {\n // Check if an attempt is made to delete IndexedDB.\n if (event.newVersion === null) {\n await databaseDeletedListener();\n }\n });\n }\n\n setNetworkEnabled(networkEnabled: boolean): void {\n if (this.networkEnabled !== networkEnabled) {\n this.networkEnabled = networkEnabled;\n // Schedule a primary lease refresh for immediate execution. The eventual\n // lease update will be propagated via `primaryStateListener`.\n this.queue.enqueueAndForget(async () => {\n if (this.started) {\n await this.updateClientMetadataAndTryBecomePrimary();\n }\n });\n }\n }\n\n /**\n * Updates the client metadata in IndexedDb and attempts to either obtain or\n * extend the primary lease for the local client. Asynchronously notifies the\n * primary state listener if the client either newly obtained or released its\n * primary lease.\n */\n private updateClientMetadataAndTryBecomePrimary(): Promise<void> {\n return this.simpleDb\n .runTransaction('readwrite-idempotent', ALL_STORES, txn => {\n const metadataStore = clientMetadataStore(txn);\n return metadataStore\n .put(\n new DbClientMetadata(\n this.clientId,\n Date.now(),\n this.networkEnabled,\n this.inForeground\n )\n )\n .next(() => {\n if (this.isPrimary) {\n return this.verifyPrimaryLease(txn).next(success => {\n if (!success) {\n this.isPrimary = false;\n this.queue.enqueueAndForget(() =>\n this.primaryStateListener(false)\n );\n }\n });\n }\n })\n .next(() => this.canActAsPrimary(txn))\n .next(canActAsPrimary => {\n if (this.isPrimary && !canActAsPrimary) {\n return this.releasePrimaryLeaseIfHeld(txn).next(() => false);\n } else if (canActAsPrimary) {\n return this.acquireOrExtendPrimaryLease(txn).next(() => true);\n } else {\n return /* canActAsPrimary= */ false;\n }\n });\n })\n .catch(e => {\n if (!this.allowTabSynchronization) {\n throw e;\n }\n\n log.debug(\n LOG_TAG,\n 'Releasing owner lease after error during lease refresh',\n e\n );\n return /* isPrimary= */ false;\n })\n .then(isPrimary => {\n if (this.isPrimary !== isPrimary) {\n this.queue.enqueueAndForget(() =>\n this.primaryStateListener(isPrimary)\n );\n }\n this.isPrimary = isPrimary;\n });\n }\n\n private verifyPrimaryLease(\n txn: SimpleDbTransaction\n ): PersistencePromise<boolean> {\n const store = primaryClientStore(txn);\n return store.get(DbPrimaryClient.key).next(primaryClient => {\n return PersistencePromise.resolve(this.isLocalClient(primaryClient));\n });\n }\n\n private removeClientMetadata(\n txn: SimpleDbTransaction\n ): PersistencePromise<void> {\n const metadataStore = clientMetadataStore(txn);\n return metadataStore.delete(this.clientId);\n }\n\n /**\n * If the garbage collection threshold has passed, prunes the\n * RemoteDocumentChanges and the ClientMetadata store based on the last update\n * time of all clients.\n */\n private async maybeGarbageCollectMultiClientState(): Promise<void> {\n if (\n this.isPrimary &&\n !this.isWithinAge(this.lastGarbageCollectionTime, MAX_CLIENT_AGE_MS)\n ) {\n this.lastGarbageCollectionTime = Date.now();\n\n const inactiveClients = await this.runTransaction(\n 'maybeGarbageCollectMultiClientState',\n 'readwrite-primary-idempotent',\n txn => {\n const metadataStore = IndexedDbPersistence.getStore<\n DbClientMetadataKey,\n DbClientMetadata\n >(txn, DbClientMetadata.store);\n\n return metadataStore.loadAll().next(existingClients => {\n const active = this.filterActiveClients(\n existingClients,\n MAX_CLIENT_AGE_MS\n );\n const inactive = existingClients.filter(\n client => active.indexOf(client) === -1\n );\n\n // Delete metadata for clients that are no longer considered active.\n return PersistencePromise.forEach(\n inactive,\n (inactiveClient: DbClientMetadata) =>\n metadataStore.delete(inactiveClient.clientId)\n ).next(() => inactive);\n });\n }\n );\n\n // Delete potential leftover entries that may continue to mark the\n // inactive clients as zombied in LocalStorage.\n // Ideally we'd delete the IndexedDb and LocalStorage zombie entries for\n // the client atomically, but we can't. So we opt to delete the IndexedDb\n // entries first to avoid potentially reviving a zombied client.\n inactiveClients.forEach(inactiveClient => {\n this.window.localStorage.removeItem(\n this.zombiedClientLocalStorageKey(inactiveClient.clientId)\n );\n });\n }\n }\n\n /**\n * Schedules a recurring timer to update the client metadata and to either\n * extend or acquire the primary lease if the client is eligible.\n */\n private scheduleClientMetadataAndPrimaryLeaseRefreshes(): void {\n this.clientMetadataRefresher = this.queue.enqueueAfterDelay(\n TimerId.ClientMetadataRefresh,\n CLIENT_METADATA_REFRESH_INTERVAL_MS,\n () => {\n return this.updateClientMetadataAndTryBecomePrimary()\n .then(() => this.maybeGarbageCollectMultiClientState())\n .then(() => this.scheduleClientMetadataAndPrimaryLeaseRefreshes());\n }\n );\n }\n\n /** Checks whether `client` is the local client. */\n private isLocalClient(client: DbPrimaryClient | null): boolean {\n return client ? client.ownerId === this.clientId : false;\n }\n\n /**\n * Evaluate the state of all active clients and determine whether the local\n * client is or can act as the holder of the primary lease. Returns whether\n * the client is eligible for the lease, but does not actually acquire it.\n * May return 'false' even if there is no active leaseholder and another\n * (foreground) client should become leaseholder instead.\n */\n private canActAsPrimary(\n txn: SimpleDbTransaction\n ): PersistencePromise<boolean> {\n const store = primaryClientStore(txn);\n return store\n .get(DbPrimaryClient.key)\n .next(currentPrimary => {\n const currentLeaseIsValid =\n currentPrimary !== null &&\n this.isWithinAge(\n currentPrimary.leaseTimestampMs,\n MAX_PRIMARY_ELIGIBLE_AGE_MS\n ) &&\n !this.isClientZombied(currentPrimary.ownerId);\n\n // A client is eligible for the primary lease if:\n // - its network is enabled and the client's tab is in the foreground.\n // - its network is enabled and no other client's tab is in the\n // foreground.\n // - every clients network is disabled and the client's tab is in the\n // foreground.\n // - every clients network is disabled and no other client's tab is in\n // the foreground.\n if (currentLeaseIsValid) {\n if (this.isLocalClient(currentPrimary) && this.networkEnabled) {\n return true;\n }\n\n if (!this.isLocalClient(currentPrimary)) {\n if (!currentPrimary!.allowTabSynchronization) {\n // Fail the `canActAsPrimary` check if the current leaseholder has\n // not opted into multi-tab synchronization. If this happens at\n // client startup, we reject the Promise returned by\n // `enablePersistence()` and the user can continue to use Firestore\n // with in-memory persistence.\n // If this fails during a lease refresh, we will instead block the\n // AsyncQueue from executing further operations. Note that this is\n // acceptable since mixing & matching different `synchronizeTabs`\n // settings is not supported.\n //\n // TODO(b/114226234): Remove this check when `synchronizeTabs` can\n // no longer be turned off.\n throw new FirestoreError(\n Code.FAILED_PRECONDITION,\n PRIMARY_LEASE_EXCLUSIVE_ERROR_MSG\n );\n }\n\n return false;\n }\n }\n\n if (this.networkEnabled && this.inForeground) {\n return true;\n }\n\n return clientMetadataStore(txn)\n .loadAll()\n .next(existingClients => {\n // Process all existing clients and determine whether at least one of\n // them is better suited to obtain the primary lease.\n const preferredCandidate = this.filterActiveClients(\n existingClients,\n MAX_PRIMARY_ELIGIBLE_AGE_MS\n ).find(otherClient => {\n if (this.clientId !== otherClient.clientId) {\n const otherClientHasBetterNetworkState =\n !this.networkEnabled && otherClient.networkEnabled;\n const otherClientHasBetterVisibility =\n !this.inForeground && otherClient.inForeground;\n const otherClientHasSameNetworkState =\n this.networkEnabled === otherClient.networkEnabled;\n if (\n otherClientHasBetterNetworkState ||\n (otherClientHasBetterVisibility &&\n otherClientHasSameNetworkState)\n ) {\n return true;\n }\n }\n return false;\n });\n return preferredCandidate === undefined;\n });\n })\n .next(canActAsPrimary => {\n if (this.isPrimary !== canActAsPrimary) {\n log.debug(\n LOG_TAG,\n `Client ${\n canActAsPrimary ? 'is' : 'is not'\n } eligible for a primary lease.`\n );\n }\n return canActAsPrimary;\n });\n }\n\n async shutdown(): Promise<void> {\n // The shutdown() operations are idempotent and can be called even when\n // start() aborted (e.g. because it couldn't acquire the persistence lease).\n this._started = false;\n\n this.markClientZombied();\n if (this.clientMetadataRefresher) {\n this.clientMetadataRefresher.cancel();\n this.clientMetadataRefresher = null;\n }\n this.detachVisibilityHandler();\n this.detachWindowUnloadHook();\n await this.simpleDb.runTransaction(\n 'readwrite-idempotent',\n [DbPrimaryClient.store, DbClientMetadata.store],\n txn => {\n return this.releasePrimaryLeaseIfHeld(txn).next(() =>\n this.removeClientMetadata(txn)\n );\n }\n );\n this.simpleDb.close();\n\n // Remove the entry marking the client as zombied from LocalStorage since\n // we successfully deleted its metadata from IndexedDb.\n this.removeClientZombiedEntry();\n }\n\n /**\n * Returns clients that are not zombied and have an updateTime within the\n * provided threshold.\n */\n private filterActiveClients(\n clients: DbClientMetadata[],\n activityThresholdMs: number\n ): DbClientMetadata[] {\n return clients.filter(\n client =>\n this.isWithinAge(client.updateTimeMs, activityThresholdMs) &&\n !this.isClientZombied(client.clientId)\n );\n }\n\n getActiveClients(): Promise<ClientId[]> {\n return this.simpleDb.runTransaction(\n 'readonly-idempotent',\n [DbClientMetadata.store],\n txn => {\n return clientMetadataStore(txn)\n .loadAll()\n .next(clients =>\n this.filterActiveClients(clients, MAX_CLIENT_AGE_MS).map(\n clientMetadata => clientMetadata.clientId\n )\n );\n }\n );\n }\n\n static async clearPersistence(persistenceKey: string): Promise<void> {\n if (!IndexedDbPersistence.isAvailable()) {\n return Promise.resolve();\n }\n const dbName = persistenceKey + IndexedDbPersistence.MAIN_DATABASE;\n await SimpleDb.delete(dbName);\n }\n\n get started(): boolean {\n return this._started;\n }\n\n getMutationQueue(user: User): MutationQueue {\n assert(\n this.started,\n 'Cannot initialize MutationQueue before persistence is started.'\n );\n return IndexedDbMutationQueue.forUser(\n user,\n this.serializer,\n this.indexManager,\n this.referenceDelegate\n );\n }\n\n getTargetCache(): IndexedDbTargetCache {\n assert(\n this.started,\n 'Cannot initialize TargetCache before persistence is started.'\n );\n return this.targetCache;\n }\n\n getRemoteDocumentCache(): IndexedDbRemoteDocumentCache {\n assert(\n this.started,\n 'Cannot initialize RemoteDocumentCache before persistence is started.'\n );\n return this.remoteDocumentCache;\n }\n\n getIndexManager(): IndexedDbIndexManager {\n assert(\n this.started,\n 'Cannot initialize IndexManager before persistence is started.'\n );\n return this.indexManager;\n }\n\n runTransaction<T>(\n action: string,\n mode: PersistenceTransactionMode,\n transactionOperation: (\n transaction: PersistenceTransaction\n ) => PersistencePromise<T>\n ): Promise<T> {\n log.debug(LOG_TAG, 'Starting transaction:', action);\n\n // TODO(schmidt-sebastian): Simplify once all transactions are idempotent.\n const idempotent = mode.endsWith('idempotent');\n const readonly = mode.startsWith('readonly');\n const simpleDbMode = readonly\n ? idempotent\n ? 'readonly-idempotent'\n : 'readonly'\n : idempotent\n ? 'readwrite-idempotent'\n : 'readwrite';\n\n let persistenceTransaction: PersistenceTransaction;\n\n // Do all transactions as readwrite against all object stores, since we\n // are the only reader/writer.\n return this.simpleDb\n .runTransaction(simpleDbMode, ALL_STORES, simpleDbTxn => {\n persistenceTransaction = new IndexedDbTransaction(\n simpleDbTxn,\n this.listenSequence.next()\n );\n\n if (\n mode === 'readwrite-primary' ||\n mode === 'readwrite-primary-idempotent'\n ) {\n // While we merely verify that we have (or can acquire) the lease\n // immediately, we wait to extend the primary lease until after\n // executing transactionOperation(). This ensures that even if the\n // transactionOperation takes a long time, we'll use a recent\n // leaseTimestampMs in the extended (or newly acquired) lease.\n return this.verifyPrimaryLease(simpleDbTxn)\n .next(holdsPrimaryLease => {\n if (holdsPrimaryLease) {\n return /* holdsPrimaryLease= */ true;\n }\n return this.canActAsPrimary(simpleDbTxn);\n })\n .next(holdsPrimaryLease => {\n if (!holdsPrimaryLease) {\n log.error(\n `Failed to obtain primary lease for action '${action}'.`\n );\n this.isPrimary = false;\n this.queue.enqueueAndForget(() =>\n this.primaryStateListener(false)\n );\n throw new FirestoreError(\n Code.FAILED_PRECONDITION,\n PRIMARY_LEASE_LOST_ERROR_MSG\n );\n }\n return transactionOperation(persistenceTransaction);\n })\n .next(result => {\n return this.acquireOrExtendPrimaryLease(simpleDbTxn).next(\n () => result\n );\n });\n } else {\n return this.verifyAllowTabSynchronization(simpleDbTxn).next(() =>\n transactionOperation(persistenceTransaction)\n );\n }\n })\n .then(result => {\n persistenceTransaction.raiseOnCommittedEvent();\n return result;\n });\n }\n\n /**\n * Verifies that the current tab is the primary leaseholder or alternatively\n * that the leaseholder has opted into multi-tab synchronization.\n */\n // TODO(b/114226234): Remove this check when `synchronizeTabs` can no longer\n // be turned off.\n private verifyAllowTabSynchronization(\n txn: SimpleDbTransaction\n ): PersistencePromise<void> {\n const store = primaryClientStore(txn);\n return store.get(DbPrimaryClient.key).next(currentPrimary => {\n const currentLeaseIsValid =\n currentPrimary !== null &&\n this.isWithinAge(\n currentPrimary.leaseTimestampMs,\n MAX_PRIMARY_ELIGIBLE_AGE_MS\n ) &&\n !this.isClientZombied(currentPrimary.ownerId);\n\n if (currentLeaseIsValid && !this.isLocalClient(currentPrimary)) {\n if (!currentPrimary!.allowTabSynchronization) {\n throw new FirestoreError(\n Code.FAILED_PRECONDITION,\n PRIMARY_LEASE_EXCLUSIVE_ERROR_MSG\n );\n }\n }\n });\n }\n\n /**\n * Obtains or extends the new primary lease for the local client. This\n * method does not verify that the client is eligible for this lease.\n */\n private acquireOrExtendPrimaryLease(\n txn: SimpleDbTransaction\n ): PersistencePromise<void> {\n const newPrimary = new DbPrimaryClient(\n this.clientId,\n this.allowTabSynchronization,\n Date.now()\n );\n return primaryClientStore(txn).put(DbPrimaryClient.key, newPrimary);\n }\n\n static isAvailable(): boolean {\n return SimpleDb.isAvailable();\n }\n\n /**\n * Generates a string used as a prefix when storing data in IndexedDB and\n * LocalStorage.\n */\n static buildStoragePrefix(databaseInfo: DatabaseInfo): string {\n // Use two different prefix formats:\n //\n // * firestore / persistenceKey / projectID . databaseID / ...\n // * firestore / persistenceKey / projectID / ...\n //\n // projectIDs are DNS-compatible names and cannot contain dots\n // so there's no danger of collisions.\n let database = databaseInfo.databaseId.projectId;\n if (!databaseInfo.databaseId.isDefaultDatabase) {\n database += '.' + databaseInfo.databaseId.database;\n }\n\n return 'firestore/' + databaseInfo.persistenceKey + '/' + database + '/';\n }\n\n /** Checks the primary lease and removes it if we are the current primary. */\n private releasePrimaryLeaseIfHeld(\n txn: SimpleDbTransaction\n ): PersistencePromise<void> {\n const store = primaryClientStore(txn);\n return store.get(DbPrimaryClient.key).next(primaryClient => {\n if (this.isLocalClient(primaryClient)) {\n log.debug(LOG_TAG, 'Releasing primary lease.');\n return store.delete(DbPrimaryClient.key);\n } else {\n return PersistencePromise.resolve();\n }\n });\n }\n\n /** Verifies that `updateTimeMs` is within `maxAgeMs`. */\n private isWithinAge(updateTimeMs: number, maxAgeMs: number): boolean {\n const now = Date.now();\n const minAcceptable = now - maxAgeMs;\n const maxAcceptable = now;\n if (updateTimeMs < minAcceptable) {\n return false;\n } else if (updateTimeMs > maxAcceptable) {\n log.error(\n `Detected an update time that is in the future: ${updateTimeMs} > ${maxAcceptable}`\n );\n return false;\n }\n\n return true;\n }\n\n private attachVisibilityHandler(): void {\n if (\n this.document !== null &&\n typeof this.document.addEventListener === 'function'\n ) {\n this.documentVisibilityHandler = () => {\n this.queue.enqueueAndForget(() => {\n this.inForeground = this.document!.visibilityState === 'visible';\n return this.updateClientMetadataAndTryBecomePrimary();\n });\n };\n\n this.document.addEventListener(\n 'visibilitychange',\n this.documentVisibilityHandler\n );\n\n this.inForeground = this.document.visibilityState === 'visible';\n }\n }\n\n private detachVisibilityHandler(): void {\n if (this.documentVisibilityHandler) {\n assert(\n this.document !== null &&\n typeof this.document.addEventListener === 'function',\n \"Expected 'document.addEventListener' to be a function\"\n );\n this.document.removeEventListener(\n 'visibilitychange',\n this.documentVisibilityHandler\n );\n this.documentVisibilityHandler = null;\n }\n }\n\n /**\n * Attaches a window.unload handler that will synchronously write our\n * clientId to a \"zombie client id\" location in LocalStorage. This can be used\n * by tabs trying to acquire the primary lease to determine that the lease\n * is no longer valid even if the timestamp is recent. This is particularly\n * important for the refresh case (so the tab correctly re-acquires the\n * primary lease). LocalStorage is used for this rather than IndexedDb because\n * it is a synchronous API and so can be used reliably from an unload\n * handler.\n */\n private attachWindowUnloadHook(): void {\n if (typeof this.window.addEventListener === 'function') {\n this.windowUnloadHandler = () => {\n // Note: In theory, this should be scheduled on the AsyncQueue since it\n // accesses internal state. We execute this code directly during shutdown\n // to make sure it gets a chance to run.\n this.markClientZombied();\n\n this.queue.enqueueAndForget(() => {\n // Attempt graceful shutdown (including releasing our primary lease),\n // but there's no guarantee it will complete.\n return this.shutdown();\n });\n };\n this.window.addEventListener('unload', this.windowUnloadHandler);\n }\n }\n\n private detachWindowUnloadHook(): void {\n if (this.windowUnloadHandler) {\n assert(\n typeof this.window.removeEventListener === 'function',\n \"Expected 'window.removeEventListener' to be a function\"\n );\n this.window.removeEventListener('unload', this.windowUnloadHandler);\n this.windowUnloadHandler = null;\n }\n }\n\n /**\n * Returns whether a client is \"zombied\" based on its LocalStorage entry.\n * Clients become zombied when their tab closes without running all of the\n * cleanup logic in `shutdown()`.\n */\n private isClientZombied(clientId: ClientId): boolean {\n try {\n const isZombied =\n this.webStorage.getItem(this.zombiedClientLocalStorageKey(clientId)) !==\n null;\n log.debug(\n LOG_TAG,\n `Client '${clientId}' ${\n isZombied ? 'is' : 'is not'\n } zombied in LocalStorage`\n );\n return isZombied;\n } catch (e) {\n // Gracefully handle if LocalStorage isn't working.\n log.error(LOG_TAG, 'Failed to get zombied client id.', e);\n return false;\n }\n }\n\n /**\n * Record client as zombied (a client that had its tab closed). Zombied\n * clients are ignored during primary tab selection.\n */\n private markClientZombied(): void {\n try {\n this.webStorage.setItem(\n this.zombiedClientLocalStorageKey(this.clientId),\n String(Date.now())\n );\n } catch (e) {\n // Gracefully handle if LocalStorage isn't available / working.\n log.error('Failed to set zombie client id.', e);\n }\n }\n\n /** Removes the zombied client entry if it exists. */\n private removeClientZombiedEntry(): void {\n try {\n this.webStorage.removeItem(\n this.zombiedClientLocalStorageKey(this.clientId)\n );\n } catch (e) {\n // Ignore\n }\n }\n\n private zombiedClientLocalStorageKey(clientId: ClientId): string {\n return `${ZOMBIED_CLIENTS_KEY_PREFIX}_${this.persistenceKey}_${clientId}`;\n }\n}\n\n/**\n * Helper to get a typed SimpleDbStore for the primary client object store.\n */\nfunction primaryClientStore(\n txn: SimpleDbTransaction\n): SimpleDbStore<DbPrimaryClientKey, DbPrimaryClient> {\n return txn.store<DbPrimaryClientKey, DbPrimaryClient>(DbPrimaryClient.store);\n}\n\n/**\n * Helper to get a typed SimpleDbStore for the client metadata object store.\n */\nfunction clientMetadataStore(\n txn: SimpleDbTransaction\n): SimpleDbStore<DbClientMetadataKey, DbClientMetadata> {\n return txn.store<DbClientMetadataKey, DbClientMetadata>(\n DbClientMetadata.store\n );\n}\n\n/** Provides LRU functionality for IndexedDB persistence. */\nexport class IndexedDbLruDelegate implements ReferenceDelegate, LruDelegate {\n private inMemoryPins: ReferenceSet | null = null;\n\n readonly garbageCollector: LruGarbageCollector;\n\n constructor(private readonly db: IndexedDbPersistence, params: LruParams) {\n this.garbageCollector = new LruGarbageCollector(this, params);\n }\n\n getSequenceNumberCount(\n txn: PersistenceTransaction\n ): PersistencePromise<number> {\n const docCountPromise = this.orphanedDocmentCount(txn);\n const targetCountPromise = this.db.getTargetCache().getTargetCount(txn);\n return targetCountPromise.next(targetCount =>\n docCountPromise.next(docCount => targetCount + docCount)\n );\n }\n\n private orphanedDocmentCount(\n txn: PersistenceTransaction\n ): PersistencePromise<number> {\n let orphanedCount = 0;\n return this.forEachOrphanedDocumentSequenceNumber(txn, _ => {\n orphanedCount++;\n }).next(() => orphanedCount);\n }\n\n forEachTarget(\n txn: PersistenceTransaction,\n f: (q: TargetData) => void\n ): PersistencePromise<void> {\n return this.db.getTargetCache().forEachTarget(txn, f);\n }\n\n forEachOrphanedDocumentSequenceNumber(\n txn: PersistenceTransaction,\n f: (sequenceNumber: ListenSequenceNumber) => void\n ): PersistencePromise<void> {\n return this.forEachOrphanedDocument(txn, (docKey, sequenceNumber) =>\n f(sequenceNumber)\n );\n }\n\n setInMemoryPins(inMemoryPins: ReferenceSet): void {\n this.inMemoryPins = inMemoryPins;\n }\n\n addReference(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<void> {\n return writeSentinelKey(txn, key);\n }\n\n removeReference(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<void> {\n return writeSentinelKey(txn, key);\n }\n\n removeTargets(\n txn: PersistenceTransaction,\n upperBound: ListenSequenceNumber,\n activeTargetIds: ActiveTargets\n ): PersistencePromise<number> {\n return this.db\n .getTargetCache()\n .removeTargets(txn, upperBound, activeTargetIds);\n }\n\n removeMutationReference(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<void> {\n return writeSentinelKey(txn, key);\n }\n\n /**\n * Returns true if anything would prevent this document from being garbage\n * collected, given that the document in question is not present in any\n * targets and has a sequence number less than or equal to the upper bound for\n * the collection run.\n */\n private isPinned(\n txn: PersistenceTransaction,\n docKey: DocumentKey\n ): PersistencePromise<boolean> {\n if (this.inMemoryPins!.containsKey(docKey)) {\n return PersistencePromise.resolve<boolean>(true);\n } else {\n return mutationQueuesContainKey(txn, docKey);\n }\n }\n\n removeOrphanedDocuments(\n txn: PersistenceTransaction,\n upperBound: ListenSequenceNumber\n ): PersistencePromise<number> {\n const documentCache = this.db.getRemoteDocumentCache();\n const changeBuffer = documentCache.newChangeBuffer();\n\n const promises: Array<PersistencePromise<void>> = [];\n let documentCount = 0;\n\n const iteration = this.forEachOrphanedDocument(\n txn,\n (docKey, sequenceNumber) => {\n if (sequenceNumber <= upperBound) {\n const p = this.isPinned(txn, docKey).next(isPinned => {\n if (!isPinned) {\n documentCount++;\n // Our size accounting requires us to read all documents before\n // removing them.\n return changeBuffer.getEntry(txn, docKey).next(() => {\n changeBuffer.removeEntry(docKey);\n return documentTargetStore(txn).delete(sentinelKey(docKey));\n });\n }\n });\n promises.push(p);\n }\n }\n );\n\n return iteration\n .next(() => PersistencePromise.waitFor(promises))\n .next(() => changeBuffer.apply(txn))\n .next(() => documentCount);\n }\n\n removeTarget(\n txn: PersistenceTransaction,\n targetData: TargetData\n ): PersistencePromise<void> {\n const updated = targetData.withSequenceNumber(txn.currentSequenceNumber);\n return this.db.getTargetCache().updateTargetData(txn, updated);\n }\n\n updateLimboDocument(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<void> {\n return writeSentinelKey(txn, key);\n }\n\n /**\n * Call provided function for each document in the cache that is 'orphaned'. Orphaned\n * means not a part of any target, so the only entry in the target-document index for\n * that document will be the sentinel row (targetId 0), which will also have the sequence\n * number for the last time the document was accessed.\n */\n private forEachOrphanedDocument(\n txn: PersistenceTransaction,\n f: (docKey: DocumentKey, sequenceNumber: ListenSequenceNumber) => void\n ): PersistencePromise<void> {\n const store = documentTargetStore(txn);\n let nextToReport: ListenSequenceNumber = ListenSequence.INVALID;\n let nextPath: EncodedResourcePath;\n return store\n .iterate(\n {\n index: DbTargetDocument.documentTargetsIndex\n },\n ([targetId, docKey], { path, sequenceNumber }) => {\n if (targetId === 0) {\n // if nextToReport is valid, report it, this is a new key so the\n // last one must not be a member of any targets.\n if (nextToReport !== ListenSequence.INVALID) {\n f(new DocumentKey(decode(nextPath)), nextToReport);\n }\n // set nextToReport to be this sequence number. It's the next one we\n // might report, if we don't find any targets for this document.\n // Note that the sequence number must be defined when the targetId\n // is 0.\n nextToReport = sequenceNumber!;\n nextPath = path;\n } else {\n // set nextToReport to be invalid, we know we don't need to report\n // this one since we found a target for it.\n nextToReport = ListenSequence.INVALID;\n }\n }\n )\n .next(() => {\n // Since we report sequence numbers after getting to the next key, we\n // need to check if the last key we iterated over was an orphaned\n // document and report it.\n if (nextToReport !== ListenSequence.INVALID) {\n f(new DocumentKey(decode(nextPath)), nextToReport);\n }\n });\n }\n\n getCacheSize(txn: PersistenceTransaction): PersistencePromise<number> {\n return this.db.getRemoteDocumentCache().getSize(txn);\n }\n}\n\nfunction sentinelKey(key: DocumentKey): [TargetId, EncodedResourcePath] {\n return [0, encode(key.path)];\n}\n\n/**\n * @return A value suitable for writing a sentinel row in the target-document\n * store.\n */\nfunction sentinelRow(\n key: DocumentKey,\n sequenceNumber: ListenSequenceNumber\n): DbTargetDocument {\n return new DbTargetDocument(0, encode(key.path), sequenceNumber);\n}\n\nfunction writeSentinelKey(\n txn: PersistenceTransaction,\n key: DocumentKey\n): PersistencePromise<void> {\n return documentTargetStore(txn).put(\n sentinelRow(key, txn.currentSequenceNumber)\n );\n}\n","/**\n * @license\n * Copyright 2019 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { QueryEngine } from './query_engine';\nimport { LocalDocumentsView } from './local_documents_view';\nimport { PersistenceTransaction } from './persistence';\nimport { PersistencePromise } from './persistence_promise';\nimport { Query, LimitType } from '../core/query';\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport {\n DocumentKeySet,\n DocumentMap,\n MaybeDocumentMap\n} from '../model/collections';\nimport { Document } from '../model/document';\nimport { assert } from '../util/assert';\nimport { debug, getLogLevel, LogLevel } from '../util/log';\nimport { SortedSet } from '../util/sorted_set';\n\n// TOOD(b/140938512): Drop SimpleQueryEngine and rename IndexFreeQueryEngine.\n\n/**\n * A query engine that takes advantage of the target document mapping in the\n * QueryCache. The IndexFreeQueryEngine optimizes query execution by only\n * reading the documents that previously matched a query plus any documents that were\n * edited after the query was last listened to.\n *\n * There are some cases where Index-Free queries are not guaranteed to produce\n * the same results as full collection scans. In these cases, the\n * IndexFreeQueryEngine falls back to full query processing. These cases are:\n *\n * - Limit queries where a document that matched the query previously no longer\n * matches the query.\n *\n * - Limit queries where a document edit may cause the document to sort below\n * another document that is in the local cache.\n *\n * - Queries that have never been CURRENT or free of Limbo documents.\n */\nexport class IndexFreeQueryEngine implements QueryEngine {\n private localDocumentsView: LocalDocumentsView | undefined;\n\n setLocalDocumentsView(localDocuments: LocalDocumentsView): void {\n this.localDocumentsView = localDocuments;\n }\n\n getDocumentsMatchingQuery(\n transaction: PersistenceTransaction,\n query: Query,\n lastLimboFreeSnapshotVersion: SnapshotVersion,\n remoteKeys: DocumentKeySet\n ): PersistencePromise<DocumentMap> {\n assert(\n this.localDocumentsView !== undefined,\n 'setLocalDocumentsView() not called'\n );\n\n // Queries that match all documents don't benefit from using\n // IndexFreeQueries. It is more efficient to scan all documents in a\n // collection, rather than to perform individual lookups.\n if (query.matchesAllDocuments()) {\n return this.executeFullCollectionScan(transaction, query);\n }\n\n // Queries that have never seen a snapshot without limbo free documents\n // should also be run as a full collection scan.\n if (lastLimboFreeSnapshotVersion.isEqual(SnapshotVersion.MIN)) {\n return this.executeFullCollectionScan(transaction, query);\n }\n\n return this.localDocumentsView!.getDocuments(transaction, remoteKeys).next(\n documents => {\n const previousResults = this.applyQuery(query, documents);\n\n if (\n (query.hasLimitToFirst() || query.hasLimitToLast()) &&\n this.needsRefill(\n query.limitType,\n previousResults,\n remoteKeys,\n lastLimboFreeSnapshotVersion\n )\n ) {\n return this.executeFullCollectionScan(transaction, query);\n }\n\n if (getLogLevel() <= LogLevel.DEBUG) {\n debug(\n 'IndexFreeQueryEngine',\n 'Re-using previous result from %s to execute query: %s',\n lastLimboFreeSnapshotVersion.toString(),\n query.toString()\n );\n }\n\n // Retrieve all results for documents that were updated since the last\n // limbo-document free remote snapshot.\n return this.localDocumentsView!.getDocumentsMatchingQuery(\n transaction,\n query,\n lastLimboFreeSnapshotVersion\n ).next(updatedResults => {\n // We merge `previousResults` into `updateResults`, since\n // `updateResults` is already a DocumentMap. If a document is\n // contained in both lists, then its contents are the same.\n previousResults.forEach(doc => {\n updatedResults = updatedResults.insert(doc.key, doc);\n });\n return updatedResults;\n });\n }\n );\n }\n\n /** Applies the query filter and sorting to the provided documents. */\n private applyQuery(\n query: Query,\n documents: MaybeDocumentMap\n ): SortedSet<Document> {\n // Sort the documents and re-apply the query filter since previously\n // matching documents do not necessarily still match the query.\n let queryResults = new SortedSet<Document>((d1, d2) =>\n query.docComparator(d1, d2)\n );\n documents.forEach((_, maybeDoc) => {\n if (maybeDoc instanceof Document && query.matches(maybeDoc)) {\n queryResults = queryResults.add(maybeDoc);\n }\n });\n return queryResults;\n }\n\n /**\n * Determines if a limit query needs to be refilled from cache, making it\n * ineligible for index-free execution.\n *\n * @param sortedPreviousResults The documents that matched the query when it\n * was last synchronized, sorted by the query's comparator.\n * @param remoteKeys The document keys that matched the query at the last\n * snapshot.\n * @param limboFreeSnapshotVersion The version of the snapshot when the query\n * was last synchronized.\n */\n private needsRefill(\n limitType: LimitType,\n sortedPreviousResults: SortedSet<Document>,\n remoteKeys: DocumentKeySet,\n limboFreeSnapshotVersion: SnapshotVersion\n ): boolean {\n // The query needs to be refilled if a previously matching document no\n // longer matches.\n if (remoteKeys.size !== sortedPreviousResults.size) {\n return true;\n }\n\n // Limit queries are not eligible for index-free query execution if there is\n // a potential that an older document from cache now sorts before a document\n // that was previously part of the limit. This, however, can only happen if\n // the document at the edge of the limit goes out of limit.\n // If a document that is not the limit boundary sorts differently,\n // the boundary of the limit itself did not change and documents from cache\n // will continue to be \"rejected\" by this boundary. Therefore, we can ignore\n // any modifications that don't affect the last document.\n const docAtLimitEdge =\n limitType === LimitType.First\n ? sortedPreviousResults.last()\n : sortedPreviousResults.first();\n if (!docAtLimitEdge) {\n // We don't need to refill the query if there were already no documents.\n return false;\n }\n return (\n docAtLimitEdge.hasPendingWrites ||\n docAtLimitEdge.version.compareTo(limboFreeSnapshotVersion) > 0\n );\n }\n\n private executeFullCollectionScan(\n transaction: PersistenceTransaction,\n query: Query\n ): PersistencePromise<DocumentMap> {\n if (getLogLevel() <= LogLevel.DEBUG) {\n debug(\n 'IndexFreeQueryEngine',\n 'Using full collection scan to execute query: %s',\n query.toString()\n );\n }\n\n return this.localDocumentsView!.getDocumentsMatchingQuery(\n transaction,\n query,\n SnapshotVersion.MIN\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Timestamp } from '../api/timestamp';\nimport { Query } from '../core/query';\nimport { BatchId, ProtoByteString } from '../core/types';\nimport { DocumentKeySet } from '../model/collections';\nimport { DocumentKey } from '../model/document_key';\nimport { Mutation } from '../model/mutation';\nimport { MutationBatch, BATCHID_UNKNOWN } from '../model/mutation_batch';\nimport { emptyByteString } from '../platform/platform';\nimport { assert } from '../util/assert';\nimport { primitiveComparator } from '../util/misc';\nimport { SortedMap } from '../util/sorted_map';\nimport { SortedSet } from '../util/sorted_set';\n\nimport { IndexManager } from './index_manager';\nimport { MutationQueue } from './mutation_queue';\nimport { PersistenceTransaction, ReferenceDelegate } from './persistence';\nimport { PersistencePromise } from './persistence_promise';\nimport { DocReference } from './reference_set';\n\nexport class MemoryMutationQueue implements MutationQueue {\n /**\n * The set of all mutations that have been sent but not yet been applied to\n * the backend.\n */\n private mutationQueue: MutationBatch[] = [];\n\n /** Next value to use when assigning sequential IDs to each mutation batch. */\n private nextBatchId: BatchId = 1;\n\n /** The last received stream token from the server, used to acknowledge which\n * responses the client has processed. Stream tokens are opaque checkpoint\n * markers whose only real value is their inclusion in the next request.\n */\n private lastStreamToken: ProtoByteString = emptyByteString();\n\n /** An ordered mapping between documents and the mutations batch IDs. */\n private batchesByDocumentKey = new SortedSet(DocReference.compareByKey);\n\n constructor(\n private readonly indexManager: IndexManager,\n private readonly referenceDelegate: ReferenceDelegate\n ) {}\n\n checkEmpty(transaction: PersistenceTransaction): PersistencePromise<boolean> {\n return PersistencePromise.resolve(this.mutationQueue.length === 0);\n }\n\n acknowledgeBatch(\n transaction: PersistenceTransaction,\n batch: MutationBatch,\n streamToken: ProtoByteString\n ): PersistencePromise<void> {\n const batchId = batch.batchId;\n const batchIndex = this.indexOfExistingBatchId(batchId, 'acknowledged');\n assert(\n batchIndex === 0,\n 'Can only acknowledge the first batch in the mutation queue'\n );\n\n // Verify that the batch in the queue is the one to be acknowledged.\n const check = this.mutationQueue[batchIndex];\n assert(\n batchId === check.batchId,\n 'Queue ordering failure: expected batch ' +\n batchId +\n ', got batch ' +\n check.batchId\n );\n\n this.lastStreamToken = streamToken;\n return PersistencePromise.resolve();\n }\n\n getLastStreamToken(\n transaction: PersistenceTransaction\n ): PersistencePromise<ProtoByteString> {\n return PersistencePromise.resolve(this.lastStreamToken);\n }\n\n setLastStreamToken(\n transaction: PersistenceTransaction,\n streamToken: ProtoByteString\n ): PersistencePromise<void> {\n this.lastStreamToken = streamToken;\n return PersistencePromise.resolve();\n }\n\n addMutationBatch(\n transaction: PersistenceTransaction,\n localWriteTime: Timestamp,\n baseMutations: Mutation[],\n mutations: Mutation[]\n ): PersistencePromise<MutationBatch> {\n assert(mutations.length !== 0, 'Mutation batches should not be empty');\n\n const batchId = this.nextBatchId;\n this.nextBatchId++;\n\n if (this.mutationQueue.length > 0) {\n const prior = this.mutationQueue[this.mutationQueue.length - 1];\n assert(\n prior.batchId < batchId,\n 'Mutation batchIDs must be monotonically increasing order'\n );\n }\n\n const batch = new MutationBatch(\n batchId,\n localWriteTime,\n baseMutations,\n mutations\n );\n this.mutationQueue.push(batch);\n\n // Track references by document key and index collection parents.\n for (const mutation of mutations) {\n this.batchesByDocumentKey = this.batchesByDocumentKey.add(\n new DocReference(mutation.key, batchId)\n );\n\n this.indexManager.addToCollectionParentIndex(\n transaction,\n mutation.key.path.popLast()\n );\n }\n\n return PersistencePromise.resolve(batch);\n }\n\n lookupMutationBatch(\n transaction: PersistenceTransaction,\n batchId: BatchId\n ): PersistencePromise<MutationBatch | null> {\n return PersistencePromise.resolve(this.findMutationBatch(batchId));\n }\n\n lookupMutationKeys(\n transaction: PersistenceTransaction,\n batchId: BatchId\n ): PersistencePromise<DocumentKeySet | null> {\n const mutationBatch = this.findMutationBatch(batchId);\n assert(mutationBatch != null, 'Failed to find local mutation batch.');\n return PersistencePromise.resolve<DocumentKeySet | null>(\n mutationBatch.keys()\n );\n }\n\n getNextMutationBatchAfterBatchId(\n transaction: PersistenceTransaction,\n batchId: BatchId\n ): PersistencePromise<MutationBatch | null> {\n const nextBatchId = batchId + 1;\n\n // The requested batchId may still be out of range so normalize it to the\n // start of the queue.\n const rawIndex = this.indexOfBatchId(nextBatchId);\n const index = rawIndex < 0 ? 0 : rawIndex;\n return PersistencePromise.resolve(\n this.mutationQueue.length > index ? this.mutationQueue[index] : null\n );\n }\n\n getHighestUnacknowledgedBatchId(): PersistencePromise<BatchId> {\n return PersistencePromise.resolve(\n this.mutationQueue.length === 0 ? BATCHID_UNKNOWN : this.nextBatchId - 1\n );\n }\n\n getAllMutationBatches(\n transaction: PersistenceTransaction\n ): PersistencePromise<MutationBatch[]> {\n return PersistencePromise.resolve(this.mutationQueue.slice());\n }\n\n getAllMutationBatchesAffectingDocumentKey(\n transaction: PersistenceTransaction,\n documentKey: DocumentKey\n ): PersistencePromise<MutationBatch[]> {\n const start = new DocReference(documentKey, 0);\n const end = new DocReference(documentKey, Number.POSITIVE_INFINITY);\n const result: MutationBatch[] = [];\n this.batchesByDocumentKey.forEachInRange([start, end], ref => {\n assert(\n documentKey.isEqual(ref.key),\n \"Should only iterate over a single key's batches\"\n );\n const batch = this.findMutationBatch(ref.targetOrBatchId);\n assert(\n batch !== null,\n 'Batches in the index must exist in the main table'\n );\n result.push(batch!);\n });\n\n return PersistencePromise.resolve(result);\n }\n\n getAllMutationBatchesAffectingDocumentKeys(\n transaction: PersistenceTransaction,\n documentKeys: SortedMap<DocumentKey, unknown>\n ): PersistencePromise<MutationBatch[]> {\n let uniqueBatchIDs = new SortedSet<number>(primitiveComparator);\n\n documentKeys.forEach(documentKey => {\n const start = new DocReference(documentKey, 0);\n const end = new DocReference(documentKey, Number.POSITIVE_INFINITY);\n this.batchesByDocumentKey.forEachInRange([start, end], ref => {\n assert(\n documentKey.isEqual(ref.key),\n \"For each key, should only iterate over a single key's batches\"\n );\n\n uniqueBatchIDs = uniqueBatchIDs.add(ref.targetOrBatchId);\n });\n });\n\n return PersistencePromise.resolve(this.findMutationBatches(uniqueBatchIDs));\n }\n\n getAllMutationBatchesAffectingQuery(\n transaction: PersistenceTransaction,\n query: Query\n ): PersistencePromise<MutationBatch[]> {\n assert(\n !query.isCollectionGroupQuery(),\n 'CollectionGroup queries should be handled in LocalDocumentsView'\n );\n // Use the query path as a prefix for testing if a document matches the\n // query.\n const prefix = query.path;\n const immediateChildrenPathLength = prefix.length + 1;\n\n // Construct a document reference for actually scanning the index. Unlike\n // the prefix the document key in this reference must have an even number of\n // segments. The empty segment can be used a suffix of the query path\n // because it precedes all other segments in an ordered traversal.\n let startPath = prefix;\n if (!DocumentKey.isDocumentKey(startPath)) {\n startPath = startPath.child('');\n }\n\n const start = new DocReference(new DocumentKey(startPath), 0);\n\n // Find unique batchIDs referenced by all documents potentially matching the\n // query.\n let uniqueBatchIDs = new SortedSet<number>(primitiveComparator);\n\n this.batchesByDocumentKey.forEachWhile(ref => {\n const rowKeyPath = ref.key.path;\n if (!prefix.isPrefixOf(rowKeyPath)) {\n return false;\n } else {\n // Rows with document keys more than one segment longer than the query\n // path can't be matches. For example, a query on 'rooms' can't match\n // the document /rooms/abc/messages/xyx.\n // TODO(mcg): we'll need a different scanner when we implement\n // ancestor queries.\n if (rowKeyPath.length === immediateChildrenPathLength) {\n uniqueBatchIDs = uniqueBatchIDs.add(ref.targetOrBatchId);\n }\n return true;\n }\n }, start);\n\n return PersistencePromise.resolve(this.findMutationBatches(uniqueBatchIDs));\n }\n\n private findMutationBatches(batchIDs: SortedSet<number>): MutationBatch[] {\n // Construct an array of matching batches, sorted by batchID to ensure that\n // multiple mutations affecting the same document key are applied in order.\n const result: MutationBatch[] = [];\n batchIDs.forEach(batchId => {\n const batch = this.findMutationBatch(batchId);\n if (batch !== null) {\n result.push(batch);\n }\n });\n return result;\n }\n\n removeMutationBatch(\n transaction: PersistenceTransaction,\n batch: MutationBatch\n ): PersistencePromise<void> {\n // Find the position of the first batch for removal. This need not be the\n // first entry in the queue.\n const batchIndex = this.indexOfExistingBatchId(batch.batchId, 'removed');\n assert(\n batchIndex === 0,\n 'Can only remove the first entry of the mutation queue'\n );\n this.mutationQueue.shift();\n\n let references = this.batchesByDocumentKey;\n return PersistencePromise.forEach(batch.mutations, (mutation: Mutation) => {\n const ref = new DocReference(mutation.key, batch.batchId);\n references = references.delete(ref);\n return this.referenceDelegate.removeMutationReference(\n transaction,\n mutation.key\n );\n }).next(() => {\n this.batchesByDocumentKey = references;\n });\n }\n\n removeCachedMutationKeys(batchId: BatchId): void {\n // No-op since the memory mutation queue does not maintain a separate cache.\n }\n\n containsKey(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<boolean> {\n const ref = new DocReference(key, 0);\n const firstRef = this.batchesByDocumentKey.firstAfterOrEqual(ref);\n return PersistencePromise.resolve(key.isEqual(firstRef && firstRef.key));\n }\n\n performConsistencyCheck(\n txn: PersistenceTransaction\n ): PersistencePromise<void> {\n if (this.mutationQueue.length === 0) {\n assert(\n this.batchesByDocumentKey.isEmpty(),\n 'Document leak -- detected dangling mutation references when queue is empty.'\n );\n }\n return PersistencePromise.resolve();\n }\n\n /**\n * Finds the index of the given batchId in the mutation queue and asserts that\n * the resulting index is within the bounds of the queue.\n *\n * @param batchId The batchId to search for\n * @param action A description of what the caller is doing, phrased in passive\n * form (e.g. \"acknowledged\" in a routine that acknowledges batches).\n */\n private indexOfExistingBatchId(batchId: BatchId, action: string): number {\n const index = this.indexOfBatchId(batchId);\n assert(\n index >= 0 && index < this.mutationQueue.length,\n 'Batches must exist to be ' + action\n );\n return index;\n }\n\n /**\n * Finds the index of the given batchId in the mutation queue. This operation\n * is O(1).\n *\n * @return The computed index of the batch with the given batchId, based on\n * the state of the queue. Note this index can be negative if the requested\n * batchId has already been remvoed from the queue or past the end of the\n * queue if the batchId is larger than the last added batch.\n */\n private indexOfBatchId(batchId: BatchId): number {\n if (this.mutationQueue.length === 0) {\n // As an index this is past the end of the queue\n return 0;\n }\n\n // Examine the front of the queue to figure out the difference between the\n // batchId and indexes in the array. Note that since the queue is ordered\n // by batchId, if the first batch has a larger batchId then the requested\n // batchId doesn't exist in the queue.\n const firstBatchId = this.mutationQueue[0].batchId;\n return batchId - firstBatchId;\n }\n\n /**\n * A version of lookupMutationBatch that doesn't return a promise, this makes\n * other functions that uses this code easier to read and more efficent.\n */\n private findMutationBatch(batchId: BatchId): MutationBatch | null {\n const index = this.indexOfBatchId(batchId);\n if (index < 0 || index >= this.mutationQueue.length) {\n return null;\n }\n\n const batch = this.mutationQueue[index];\n assert(batch.batchId === batchId, 'If found batch must match');\n return batch;\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Query } from '../core/query';\nimport {\n DocumentKeySet,\n DocumentMap,\n documentMap,\n DocumentSizeEntry,\n MaybeDocumentMap,\n NullableMaybeDocumentMap,\n nullableMaybeDocumentMap\n} from '../model/collections';\nimport { Document, MaybeDocument } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\n\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { assert } from '../util/assert';\nimport { SortedMap } from '../util/sorted_map';\nimport { IndexManager } from './index_manager';\nimport { PersistenceTransaction } from './persistence';\nimport { PersistencePromise } from './persistence_promise';\nimport { RemoteDocumentCache } from './remote_document_cache';\nimport { RemoteDocumentChangeBuffer } from './remote_document_change_buffer';\n\nexport type DocumentSizer = (doc: MaybeDocument) => number;\n\n/** Miscellaneous collection types / constants. */\ninterface MemoryRemoteDocumentCacheEntry extends DocumentSizeEntry {\n readTime: SnapshotVersion;\n}\n\ntype DocumentEntryMap = SortedMap<DocumentKey, MemoryRemoteDocumentCacheEntry>;\nfunction documentEntryMap(): DocumentEntryMap {\n return new SortedMap<DocumentKey, MemoryRemoteDocumentCacheEntry>(\n DocumentKey.comparator\n );\n}\n\nexport class MemoryRemoteDocumentCache implements RemoteDocumentCache {\n /** Underlying cache of documents and their read times. */\n private docs = documentEntryMap();\n\n /** Size of all cached documents. */\n private size = 0;\n\n /**\n * @param sizer Used to assess the size of a document. For eager GC, this is expected to just\n * return 0 to avoid unnecessarily doing the work of calculating the size.\n */\n constructor(\n private readonly indexManager: IndexManager,\n private readonly sizer: DocumentSizer\n ) {}\n\n /**\n * Adds the supplied entry to the cache and updates the cache size as appropriate.\n *\n * All calls of `addEntry` are required to go through the RemoteDocumentChangeBuffer\n * returned by `newChangeBuffer()`.\n */\n private addEntry(\n transaction: PersistenceTransaction,\n doc: MaybeDocument,\n readTime: SnapshotVersion\n ): PersistencePromise<void> {\n assert(\n !readTime.isEqual(SnapshotVersion.MIN),\n 'Cannot add a document with a read time of zero'\n );\n\n const key = doc.key;\n const entry = this.docs.get(key);\n const previousSize = entry ? entry.size : 0;\n const currentSize = this.sizer(doc);\n\n this.docs = this.docs.insert(key, {\n maybeDocument: doc,\n size: currentSize,\n readTime\n });\n\n this.size += currentSize - previousSize;\n\n return this.indexManager.addToCollectionParentIndex(\n transaction,\n key.path.popLast()\n );\n }\n\n /**\n * Removes the specified entry from the cache and updates the cache size as appropriate.\n *\n * All calls of `removeEntry` are required to go through the RemoteDocumentChangeBuffer\n * returned by `newChangeBuffer()`.\n */\n private removeEntry(documentKey: DocumentKey): void {\n const entry = this.docs.get(documentKey);\n if (entry) {\n this.docs = this.docs.remove(documentKey);\n this.size -= entry.size;\n }\n }\n\n getEntry(\n transaction: PersistenceTransaction,\n documentKey: DocumentKey\n ): PersistencePromise<MaybeDocument | null> {\n const entry = this.docs.get(documentKey);\n return PersistencePromise.resolve(entry ? entry.maybeDocument : null);\n }\n\n getEntries(\n transaction: PersistenceTransaction,\n documentKeys: DocumentKeySet\n ): PersistencePromise<NullableMaybeDocumentMap> {\n let results = nullableMaybeDocumentMap();\n documentKeys.forEach(documentKey => {\n const entry = this.docs.get(documentKey);\n results = results.insert(documentKey, entry ? entry.maybeDocument : null);\n });\n return PersistencePromise.resolve(results);\n }\n\n getDocumentsMatchingQuery(\n transaction: PersistenceTransaction,\n query: Query,\n sinceReadTime: SnapshotVersion\n ): PersistencePromise<DocumentMap> {\n assert(\n !query.isCollectionGroupQuery(),\n 'CollectionGroup queries should be handled in LocalDocumentsView'\n );\n let results = documentMap();\n\n // Documents are ordered by key, so we can use a prefix scan to narrow down\n // the documents we need to match the query against.\n const prefix = new DocumentKey(query.path.child(''));\n const iterator = this.docs.getIteratorFrom(prefix);\n while (iterator.hasNext()) {\n const {\n key,\n value: { maybeDocument, readTime }\n } = iterator.getNext();\n if (!query.path.isPrefixOf(key.path)) {\n break;\n }\n if (readTime.compareTo(sinceReadTime) <= 0) {\n continue;\n }\n if (maybeDocument instanceof Document && query.matches(maybeDocument)) {\n results = results.insert(maybeDocument.key, maybeDocument);\n }\n }\n return PersistencePromise.resolve(results);\n }\n\n forEachDocumentKey(\n transaction: PersistenceTransaction,\n f: (key: DocumentKey) => PersistencePromise<void>\n ): PersistencePromise<void> {\n return PersistencePromise.forEach(this.docs, (key: DocumentKey) => f(key));\n }\n\n getNewDocumentChanges(\n transaction: PersistenceTransaction,\n sinceReadTime: SnapshotVersion\n ): PersistencePromise<{\n changedDocs: MaybeDocumentMap;\n readTime: SnapshotVersion;\n }> {\n throw new Error(\n 'getNewDocumentChanges() is not supported with MemoryPersistence'\n );\n }\n\n getLastReadTime(\n transaction: PersistenceTransaction\n ): PersistencePromise<SnapshotVersion> {\n return PersistencePromise.resolve(SnapshotVersion.MIN);\n }\n\n newChangeBuffer(options?: {\n trackRemovals: boolean;\n }): RemoteDocumentChangeBuffer {\n // `trackRemovals` is ignores since the MemoryRemoteDocumentCache keeps\n // a separate changelog and does not need special handling for removals.\n return new MemoryRemoteDocumentCache.RemoteDocumentChangeBuffer(this);\n }\n\n getSize(txn: PersistenceTransaction): PersistencePromise<number> {\n return PersistencePromise.resolve(this.size);\n }\n\n /**\n * Handles the details of adding and updating documents in the MemoryRemoteDocumentCache.\n */\n private static RemoteDocumentChangeBuffer = class extends RemoteDocumentChangeBuffer {\n constructor(private readonly documentCache: MemoryRemoteDocumentCache) {\n super();\n }\n\n protected applyChanges(\n transaction: PersistenceTransaction\n ): PersistencePromise<void> {\n const promises: Array<PersistencePromise<void>> = [];\n this.changes.forEach((key, doc) => {\n if (doc) {\n promises.push(\n this.documentCache.addEntry(transaction, doc, this.readTime)\n );\n } else {\n this.documentCache.removeEntry(key);\n }\n });\n return PersistencePromise.waitFor(promises);\n }\n\n protected getFromCache(\n transaction: PersistenceTransaction,\n documentKey: DocumentKey\n ): PersistencePromise<MaybeDocument | null> {\n return this.documentCache.getEntry(transaction, documentKey);\n }\n\n protected getAllFromCache(\n transaction: PersistenceTransaction,\n documentKeys: DocumentKeySet\n ): PersistencePromise<NullableMaybeDocumentMap> {\n return this.documentCache.getEntries(transaction, documentKeys);\n }\n };\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { SnapshotVersion } from '../core/snapshot_version';\nimport { TargetIdGenerator } from '../core/target_id_generator';\nimport { ListenSequenceNumber, TargetId } from '../core/types';\nimport { DocumentKeySet } from '../model/collections';\nimport { DocumentKey } from '../model/document_key';\nimport { assert, fail } from '../util/assert';\nimport { ObjectMap } from '../util/obj_map';\n\nimport { ActiveTargets } from './lru_garbage_collector';\nimport { MemoryPersistence } from './memory_persistence';\nimport { PersistenceTransaction } from './persistence';\nimport { PersistencePromise } from './persistence_promise';\nimport { ReferenceSet } from './reference_set';\nimport { TargetCache } from './target_cache';\nimport { TargetData } from './target_data';\nimport { Target } from '../core/target';\n\nexport class MemoryTargetCache implements TargetCache {\n /**\n * Maps a target to the data about that target\n */\n private targets = new ObjectMap<Target, TargetData>(t => t.canonicalId());\n\n /** The last received snapshot version. */\n private lastRemoteSnapshotVersion = SnapshotVersion.MIN;\n /** The highest numbered target ID encountered. */\n private highestTargetId: TargetId = 0;\n /** The highest sequence number encountered. */\n private highestSequenceNumber: ListenSequenceNumber = 0;\n /**\n * A ordered bidirectional mapping between documents and the remote target\n * IDs.\n */\n private references = new ReferenceSet();\n\n private targetCount = 0;\n\n private targetIdGenerator = TargetIdGenerator.forTargetCache();\n\n constructor(private readonly persistence: MemoryPersistence) {}\n\n forEachTarget(\n txn: PersistenceTransaction,\n f: (q: TargetData) => void\n ): PersistencePromise<void> {\n this.targets.forEach((_, targetData) => f(targetData));\n return PersistencePromise.resolve();\n }\n\n getLastRemoteSnapshotVersion(\n transaction: PersistenceTransaction\n ): PersistencePromise<SnapshotVersion> {\n return PersistencePromise.resolve(this.lastRemoteSnapshotVersion);\n }\n\n getHighestSequenceNumber(\n transaction: PersistenceTransaction\n ): PersistencePromise<ListenSequenceNumber> {\n return PersistencePromise.resolve(this.highestSequenceNumber);\n }\n\n allocateTargetId(\n transaction: PersistenceTransaction\n ): PersistencePromise<TargetId> {\n const nextTargetId = this.targetIdGenerator.after(this.highestTargetId);\n this.highestTargetId = nextTargetId;\n return PersistencePromise.resolve(nextTargetId);\n }\n\n setTargetsMetadata(\n transaction: PersistenceTransaction,\n highestListenSequenceNumber: number,\n lastRemoteSnapshotVersion?: SnapshotVersion\n ): PersistencePromise<void> {\n if (lastRemoteSnapshotVersion) {\n this.lastRemoteSnapshotVersion = lastRemoteSnapshotVersion;\n }\n if (highestListenSequenceNumber > this.highestSequenceNumber) {\n this.highestSequenceNumber = highestListenSequenceNumber;\n }\n return PersistencePromise.resolve();\n }\n\n private saveTargetData(targetData: TargetData): void {\n this.targets.set(targetData.target, targetData);\n const targetId = targetData.targetId;\n if (targetId > this.highestTargetId) {\n this.highestTargetId = targetId;\n }\n if (targetData.sequenceNumber > this.highestSequenceNumber) {\n this.highestSequenceNumber = targetData.sequenceNumber;\n }\n }\n\n addTargetData(\n transaction: PersistenceTransaction,\n targetData: TargetData\n ): PersistencePromise<void> {\n assert(\n !this.targets.has(targetData.target),\n 'Adding a target that already exists'\n );\n this.saveTargetData(targetData);\n this.targetCount += 1;\n return PersistencePromise.resolve();\n }\n\n updateTargetData(\n transaction: PersistenceTransaction,\n targetData: TargetData\n ): PersistencePromise<void> {\n assert(\n this.targets.has(targetData.target),\n 'Updating a non-existent target'\n );\n this.saveTargetData(targetData);\n return PersistencePromise.resolve();\n }\n\n removeTargetData(\n transaction: PersistenceTransaction,\n targetData: TargetData\n ): PersistencePromise<void> {\n assert(this.targetCount > 0, 'Removing a target from an empty cache');\n assert(\n this.targets.has(targetData.target),\n 'Removing a non-existent target from the cache'\n );\n this.targets.delete(targetData.target);\n this.references.removeReferencesForId(targetData.targetId);\n this.targetCount -= 1;\n return PersistencePromise.resolve();\n }\n\n removeTargets(\n transaction: PersistenceTransaction,\n upperBound: ListenSequenceNumber,\n activeTargetIds: ActiveTargets\n ): PersistencePromise<number> {\n let count = 0;\n const removals: Array<PersistencePromise<void>> = [];\n this.targets.forEach((key, targetData) => {\n if (\n targetData.sequenceNumber <= upperBound &&\n activeTargetIds.get(targetData.targetId) === null\n ) {\n this.targets.delete(key);\n removals.push(\n this.removeMatchingKeysForTargetId(transaction, targetData.targetId)\n );\n count++;\n }\n });\n return PersistencePromise.waitFor(removals).next(() => count);\n }\n\n getTargetCount(\n transaction: PersistenceTransaction\n ): PersistencePromise<number> {\n return PersistencePromise.resolve(this.targetCount);\n }\n\n getTargetData(\n transaction: PersistenceTransaction,\n target: Target\n ): PersistencePromise<TargetData | null> {\n const targetData = this.targets.get(target) || null;\n return PersistencePromise.resolve(targetData);\n }\n\n getTargetDataForTarget(\n transaction: PersistenceTransaction,\n targetId: TargetId\n ): never {\n // This method is only needed for multi-tab and we can't implement it\n // efficiently without additional data structures.\n return fail('Not yet implemented.');\n }\n\n addMatchingKeys(\n txn: PersistenceTransaction,\n keys: DocumentKeySet,\n targetId: TargetId\n ): PersistencePromise<void> {\n this.references.addReferences(keys, targetId);\n const referenceDelegate = this.persistence.referenceDelegate;\n const promises: Array<PersistencePromise<void>> = [];\n if (referenceDelegate) {\n keys.forEach(key => {\n promises.push(referenceDelegate.addReference(txn, key));\n });\n }\n return PersistencePromise.waitFor(promises);\n }\n\n removeMatchingKeys(\n txn: PersistenceTransaction,\n keys: DocumentKeySet,\n targetId: TargetId\n ): PersistencePromise<void> {\n this.references.removeReferences(keys, targetId);\n const referenceDelegate = this.persistence.referenceDelegate;\n const promises: Array<PersistencePromise<void>> = [];\n if (referenceDelegate) {\n keys.forEach(key => {\n promises.push(referenceDelegate.removeReference(txn, key));\n });\n }\n return PersistencePromise.waitFor(promises);\n }\n\n removeMatchingKeysForTargetId(\n txn: PersistenceTransaction,\n targetId: TargetId\n ): PersistencePromise<void> {\n this.references.removeReferencesForId(targetId);\n return PersistencePromise.resolve();\n }\n\n getMatchingKeysForTargetId(\n txn: PersistenceTransaction,\n targetId: TargetId\n ): PersistencePromise<DocumentKeySet> {\n const matchingKeys = this.references.referencesForId(targetId);\n return PersistencePromise.resolve(matchingKeys);\n }\n\n containsKey(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<boolean> {\n return PersistencePromise.resolve(this.references.containsKey(key));\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { User } from '../auth/user';\nimport { Document, MaybeDocument } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport { fail } from '../util/assert';\nimport { debug } from '../util/log';\nimport * as obj from '../util/obj';\nimport { ObjectMap } from '../util/obj_map';\nimport { encode } from './encoded_resource_path';\nimport {\n ActiveTargets,\n LruDelegate,\n LruGarbageCollector,\n LruParams\n} from './lru_garbage_collector';\n\nimport { ListenSequence } from '../core/listen_sequence';\nimport { ListenSequenceNumber } from '../core/types';\nimport { MemoryIndexManager } from './memory_index_manager';\nimport { MemoryMutationQueue } from './memory_mutation_queue';\nimport { MemoryRemoteDocumentCache } from './memory_remote_document_cache';\nimport { MemoryTargetCache } from './memory_target_cache';\nimport { MutationQueue } from './mutation_queue';\nimport {\n Persistence,\n PersistenceTransaction,\n PersistenceTransactionMode,\n PrimaryStateListener,\n ReferenceDelegate\n} from './persistence';\nimport { PersistencePromise } from './persistence_promise';\nimport { ReferenceSet } from './reference_set';\nimport { ClientId } from './shared_client_state';\nimport { TargetData } from './target_data';\n\nconst LOG_TAG = 'MemoryPersistence';\n\n/**\n * A memory-backed instance of Persistence. Data is stored only in RAM and\n * not persisted across sessions.\n */\nexport class MemoryPersistence implements Persistence {\n /**\n * Note that these are retained here to make it easier to write tests\n * affecting both the in-memory and IndexedDB-backed persistence layers. Tests\n * can create a new LocalStore wrapping this Persistence instance and this\n * will make the in-memory persistence layer behave as if it were actually\n * persisting values.\n */\n private readonly indexManager: MemoryIndexManager;\n private mutationQueues: { [user: string]: MemoryMutationQueue } = {};\n private readonly remoteDocumentCache: MemoryRemoteDocumentCache;\n private readonly targetCache: MemoryTargetCache;\n private readonly listenSequence = new ListenSequence(0);\n\n private _started = false;\n\n readonly referenceDelegate: MemoryLruDelegate | MemoryEagerDelegate;\n\n static createLruPersistence(\n clientId: ClientId,\n params: LruParams\n ): MemoryPersistence {\n const factory = (p: MemoryPersistence): MemoryLruDelegate =>\n new MemoryLruDelegate(p, params);\n return new MemoryPersistence(clientId, factory);\n }\n\n static createEagerPersistence(clientId: ClientId): MemoryPersistence {\n const factory = (p: MemoryPersistence): MemoryEagerDelegate =>\n new MemoryEagerDelegate(p);\n return new MemoryPersistence(clientId, factory);\n }\n\n /**\n * The constructor accepts a factory for creating a reference delegate. This\n * allows both the delegate and this instance to have strong references to\n * each other without having nullable fields that would then need to be\n * checked or asserted on every access.\n */\n private constructor(\n private readonly clientId: ClientId,\n referenceDelegateFactory: (\n p: MemoryPersistence\n ) => MemoryLruDelegate | MemoryEagerDelegate\n ) {\n this._started = true;\n this.referenceDelegate = referenceDelegateFactory(this);\n this.targetCache = new MemoryTargetCache(this);\n const sizer = (doc: MaybeDocument): number =>\n this.referenceDelegate.documentSize(doc);\n this.indexManager = new MemoryIndexManager();\n this.remoteDocumentCache = new MemoryRemoteDocumentCache(\n this.indexManager,\n sizer\n );\n }\n\n shutdown(): Promise<void> {\n // No durable state to ensure is closed on shutdown.\n this._started = false;\n return Promise.resolve();\n }\n\n get started(): boolean {\n return this._started;\n }\n\n async getActiveClients(): Promise<ClientId[]> {\n return [this.clientId];\n }\n\n setPrimaryStateListener(\n primaryStateListener: PrimaryStateListener\n ): Promise<void> {\n // All clients using memory persistence act as primary.\n return primaryStateListener(true);\n }\n\n setDatabaseDeletedListener(): void {\n // No op.\n }\n\n setNetworkEnabled(networkEnabled: boolean): void {\n // No op.\n }\n\n getIndexManager(): MemoryIndexManager {\n return this.indexManager;\n }\n\n getMutationQueue(user: User): MutationQueue {\n let queue = this.mutationQueues[user.toKey()];\n if (!queue) {\n queue = new MemoryMutationQueue(\n this.indexManager,\n this.referenceDelegate\n );\n this.mutationQueues[user.toKey()] = queue;\n }\n return queue;\n }\n\n getTargetCache(): MemoryTargetCache {\n return this.targetCache;\n }\n\n getRemoteDocumentCache(): MemoryRemoteDocumentCache {\n return this.remoteDocumentCache;\n }\n\n runTransaction<T>(\n action: string,\n mode: PersistenceTransactionMode,\n transactionOperation: (\n transaction: PersistenceTransaction\n ) => PersistencePromise<T>\n ): Promise<T> {\n debug(LOG_TAG, 'Starting transaction:', action);\n const txn = new MemoryTransaction(this.listenSequence.next());\n this.referenceDelegate.onTransactionStarted();\n return transactionOperation(txn)\n .next(result => {\n return this.referenceDelegate\n .onTransactionCommitted(txn)\n .next(() => result);\n })\n .toPromise()\n .then(result => {\n txn.raiseOnCommittedEvent();\n return result;\n });\n }\n\n mutationQueuesContainKey(\n transaction: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<boolean> {\n return PersistencePromise.or(\n obj\n .values(this.mutationQueues)\n .map(queue => () => queue.containsKey(transaction, key))\n );\n }\n}\n\n/**\n * Memory persistence is not actually transactional, but future implementations\n * may have transaction-scoped state.\n */\nexport class MemoryTransaction extends PersistenceTransaction {\n constructor(readonly currentSequenceNumber: ListenSequenceNumber) {\n super();\n }\n}\n\nexport class MemoryEagerDelegate implements ReferenceDelegate {\n private inMemoryPins: ReferenceSet | null = null;\n private _orphanedDocuments: Set<DocumentKey> | null = null;\n\n constructor(private readonly persistence: MemoryPersistence) {}\n\n private get orphanedDocuments(): Set<DocumentKey> {\n if (!this._orphanedDocuments) {\n throw fail('orphanedDocuments is only valid during a transaction.');\n } else {\n return this._orphanedDocuments;\n }\n }\n\n setInMemoryPins(inMemoryPins: ReferenceSet): void {\n this.inMemoryPins = inMemoryPins;\n }\n\n addReference(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<void> {\n this.orphanedDocuments.delete(key);\n return PersistencePromise.resolve();\n }\n\n removeReference(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<void> {\n this.orphanedDocuments.add(key);\n return PersistencePromise.resolve();\n }\n\n removeMutationReference(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<void> {\n this.orphanedDocuments.add(key);\n return PersistencePromise.resolve();\n }\n\n removeTarget(\n txn: PersistenceTransaction,\n targetData: TargetData\n ): PersistencePromise<void> {\n const cache = this.persistence.getTargetCache();\n return cache\n .getMatchingKeysForTargetId(txn, targetData.targetId)\n .next(keys => {\n keys.forEach(key => this.orphanedDocuments.add(key));\n })\n .next(() => cache.removeTargetData(txn, targetData));\n }\n\n onTransactionStarted(): void {\n this._orphanedDocuments = new Set<DocumentKey>();\n }\n\n onTransactionCommitted(\n txn: PersistenceTransaction\n ): PersistencePromise<void> {\n // Remove newly orphaned documents.\n const cache = this.persistence.getRemoteDocumentCache();\n const changeBuffer = cache.newChangeBuffer();\n return PersistencePromise.forEach(\n this.orphanedDocuments,\n (key: DocumentKey) => {\n return this.isReferenced(txn, key).next(isReferenced => {\n if (!isReferenced) {\n changeBuffer.removeEntry(key);\n }\n });\n }\n ).next(() => {\n this._orphanedDocuments = null;\n return changeBuffer.apply(txn);\n });\n }\n\n updateLimboDocument(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<void> {\n return this.isReferenced(txn, key).next(isReferenced => {\n if (isReferenced) {\n this.orphanedDocuments.delete(key);\n } else {\n this.orphanedDocuments.add(key);\n }\n });\n }\n\n documentSize(doc: MaybeDocument): number {\n // For eager GC, we don't care about the document size, there are no size thresholds.\n return 0;\n }\n\n private isReferenced(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<boolean> {\n return PersistencePromise.or([\n () => this.persistence.getTargetCache().containsKey(txn, key),\n () => this.persistence.mutationQueuesContainKey(txn, key),\n () => PersistencePromise.resolve(this.inMemoryPins!.containsKey(key))\n ]);\n }\n}\n\nexport class MemoryLruDelegate implements ReferenceDelegate, LruDelegate {\n private inMemoryPins: ReferenceSet | null = null;\n private orphanedSequenceNumbers: ObjectMap<\n DocumentKey,\n ListenSequenceNumber\n > = new ObjectMap(k => encode(k.path));\n\n readonly garbageCollector: LruGarbageCollector;\n\n constructor(\n private readonly persistence: MemoryPersistence,\n lruParams: LruParams\n ) {\n this.garbageCollector = new LruGarbageCollector(this, lruParams);\n }\n\n // No-ops, present so memory persistence doesn't have to care which delegate\n // it has.\n onTransactionStarted(): void {}\n\n onTransactionCommitted(\n txn: PersistenceTransaction\n ): PersistencePromise<void> {\n return PersistencePromise.resolve();\n }\n\n forEachTarget(\n txn: PersistenceTransaction,\n f: (q: TargetData) => void\n ): PersistencePromise<void> {\n return this.persistence.getTargetCache().forEachTarget(txn, f);\n }\n\n getSequenceNumberCount(\n txn: PersistenceTransaction\n ): PersistencePromise<number> {\n const docCountPromise = this.orphanedDocumentCount(txn);\n const targetCountPromise = this.persistence\n .getTargetCache()\n .getTargetCount(txn);\n return targetCountPromise.next(targetCount =>\n docCountPromise.next(docCount => targetCount + docCount)\n );\n }\n\n private orphanedDocumentCount(\n txn: PersistenceTransaction\n ): PersistencePromise<number> {\n let orphanedCount = 0;\n return this.forEachOrphanedDocumentSequenceNumber(txn, _ => {\n orphanedCount++;\n }).next(() => orphanedCount);\n }\n\n forEachOrphanedDocumentSequenceNumber(\n txn: PersistenceTransaction,\n f: (sequenceNumber: ListenSequenceNumber) => void\n ): PersistencePromise<void> {\n return PersistencePromise.forEach(\n this.orphanedSequenceNumbers,\n (key, sequenceNumber) => {\n // Pass in the exact sequence number as the upper bound so we know it won't be pinned by\n // being too recent.\n return this.isPinned(txn, key, sequenceNumber).next(isPinned => {\n if (!isPinned) {\n return f(sequenceNumber);\n } else {\n return PersistencePromise.resolve();\n }\n });\n }\n );\n }\n\n setInMemoryPins(inMemoryPins: ReferenceSet): void {\n this.inMemoryPins = inMemoryPins;\n }\n\n removeTargets(\n txn: PersistenceTransaction,\n upperBound: ListenSequenceNumber,\n activeTargetIds: ActiveTargets\n ): PersistencePromise<number> {\n return this.persistence\n .getTargetCache()\n .removeTargets(txn, upperBound, activeTargetIds);\n }\n\n removeOrphanedDocuments(\n txn: PersistenceTransaction,\n upperBound: ListenSequenceNumber\n ): PersistencePromise<number> {\n let count = 0;\n const cache = this.persistence.getRemoteDocumentCache();\n const changeBuffer = cache.newChangeBuffer();\n const p = cache.forEachDocumentKey(txn, key => {\n return this.isPinned(txn, key, upperBound).next(isPinned => {\n if (!isPinned) {\n count++;\n changeBuffer.removeEntry(key);\n }\n });\n });\n return p.next(() => changeBuffer.apply(txn)).next(() => count);\n }\n\n removeMutationReference(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<void> {\n this.orphanedSequenceNumbers.set(key, txn.currentSequenceNumber);\n return PersistencePromise.resolve();\n }\n\n removeTarget(\n txn: PersistenceTransaction,\n targetData: TargetData\n ): PersistencePromise<void> {\n const updated = targetData.withSequenceNumber(txn.currentSequenceNumber);\n return this.persistence.getTargetCache().updateTargetData(txn, updated);\n }\n\n addReference(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<void> {\n this.orphanedSequenceNumbers.set(key, txn.currentSequenceNumber);\n return PersistencePromise.resolve();\n }\n\n removeReference(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<void> {\n this.orphanedSequenceNumbers.set(key, txn.currentSequenceNumber);\n return PersistencePromise.resolve();\n }\n\n updateLimboDocument(\n txn: PersistenceTransaction,\n key: DocumentKey\n ): PersistencePromise<void> {\n this.orphanedSequenceNumbers.set(key, txn.currentSequenceNumber);\n return PersistencePromise.resolve();\n }\n\n documentSize(maybeDoc: MaybeDocument): number {\n let documentSize = maybeDoc.key.toString().length;\n if (maybeDoc instanceof Document) {\n documentSize += maybeDoc.data().approximateByteSize();\n }\n return documentSize;\n }\n\n private isPinned(\n txn: PersistenceTransaction,\n key: DocumentKey,\n upperBound: ListenSequenceNumber\n ): PersistencePromise<boolean> {\n return PersistencePromise.or([\n () => this.persistence.mutationQueuesContainKey(txn, key),\n () => PersistencePromise.resolve(this.inMemoryPins!.containsKey(key)),\n () => this.persistence.getTargetCache().containsKey(txn, key),\n () => {\n const orphanedAt = this.orphanedSequenceNumbers.get(key);\n return PersistencePromise.resolve(\n orphanedAt !== undefined && orphanedAt > upperBound\n );\n }\n ]);\n }\n\n getCacheSize(txn: PersistenceTransaction): PersistencePromise<number> {\n return this.persistence.getRemoteDocumentCache().getSize(txn);\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { CredentialsProvider } from '../api/credentials';\nimport { User } from '../auth/user';\nimport { IndexedDbPersistence } from '../local/indexeddb_persistence';\nimport { IndexFreeQueryEngine } from '../local/index_free_query_engine';\nimport { LocalStore } from '../local/local_store';\nimport { MemoryPersistence } from '../local/memory_persistence';\nimport { Persistence } from '../local/persistence';\nimport { Document, MaybeDocument, NoDocument } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport { Mutation } from '../model/mutation';\nimport { Platform } from '../platform/platform';\nimport { Datastore } from '../remote/datastore';\nimport { RemoteStore } from '../remote/remote_store';\nimport { JsonProtoSerializer } from '../remote/serializer';\nimport { AsyncQueue } from '../util/async_queue';\nimport { Code, FirestoreError } from '../util/error';\nimport { debug } from '../util/log';\nimport { Deferred } from '../util/promise';\nimport {\n EventManager,\n ListenOptions,\n Observer,\n QueryListener\n} from './event_manager';\nimport { SyncEngine } from './sync_engine';\nimport { View } from './view';\n\nimport {\n LruGarbageCollector,\n LruParams,\n LruScheduler\n} from '../local/lru_garbage_collector';\nimport {\n MemorySharedClientState,\n SharedClientState,\n WebStorageSharedClientState\n} from '../local/shared_client_state';\nimport { AutoId } from '../util/misc';\nimport { DatabaseId, DatabaseInfo } from './database_info';\nimport { Query } from './query';\nimport { Transaction } from './transaction';\nimport { OnlineState, OnlineStateSource } from './types';\nimport { ViewSnapshot } from './view_snapshot';\n\nconst LOG_TAG = 'FirestoreClient';\n\n/** DOMException error code constants. */\nconst DOM_EXCEPTION_INVALID_STATE = 11;\nconst DOM_EXCEPTION_ABORTED = 20;\nconst DOM_EXCEPTION_QUOTA_EXCEEDED = 22;\n\nexport class IndexedDbPersistenceSettings {\n constructor(\n readonly cacheSizeBytes: number,\n readonly synchronizeTabs: boolean\n ) {}\n\n lruParams(): LruParams {\n return LruParams.withCacheSize(this.cacheSizeBytes);\n }\n}\n\nexport class MemoryPersistenceSettings {}\n\nexport type InternalPersistenceSettings =\n | IndexedDbPersistenceSettings\n | MemoryPersistenceSettings;\n\n/**\n * FirestoreClient is a top-level class that constructs and owns all of the\n * pieces of the client SDK architecture. It is responsible for creating the\n * async queue that is shared by all of the other components in the system.\n */\nexport class FirestoreClient {\n // NOTE: These should technically have '|undefined' in the types, since\n // they're initialized asynchronously rather than in the constructor, but\n // given that all work is done on the async queue and we assert that\n // initialization completes before any other work is queued, we're cheating\n // with the types rather than littering the code with '!' or unnecessary\n // undefined checks.\n private eventMgr!: EventManager;\n private persistence!: Persistence;\n private localStore!: LocalStore;\n private remoteStore!: RemoteStore;\n private syncEngine!: SyncEngine;\n // PORTING NOTE: SharedClientState is only used for multi-tab web.\n private sharedClientState!: SharedClientState;\n\n private lruScheduler?: LruScheduler;\n\n private readonly clientId = AutoId.newId();\n\n constructor(\n private platform: Platform,\n private databaseInfo: DatabaseInfo,\n private credentials: CredentialsProvider,\n /**\n * Asynchronous queue responsible for all of our internal processing. When\n * we get incoming work from the user (via public API) or the network\n * (incoming GRPC messages), we should always schedule onto this queue.\n * This ensures all of our work is properly serialized (e.g. we don't\n * start processing a new operation while the previous one is waiting for\n * an async I/O to complete).\n */\n private asyncQueue: AsyncQueue\n ) {}\n\n /**\n * Starts up the FirestoreClient, returning only whether or not enabling\n * persistence succeeded.\n *\n * The intent here is to \"do the right thing\" as far as users are concerned.\n * Namely, in cases where offline persistence is requested and possible,\n * enable it, but otherwise fall back to persistence disabled. For the most\n * part we expect this to succeed one way or the other so we don't expect our\n * users to actually wait on the firestore.enablePersistence Promise since\n * they generally won't care.\n *\n * Of course some users actually do care about whether or not persistence\n * was successfully enabled, so the Promise returned from this method\n * indicates this outcome.\n *\n * This presents a problem though: even before enablePersistence resolves or\n * rejects, users may have made calls to e.g. firestore.collection() which\n * means that the FirestoreClient in there will be available and will be\n * enqueuing actions on the async queue.\n *\n * Meanwhile any failure of an operation on the async queue causes it to\n * panic and reject any further work, on the premise that unhandled errors\n * are fatal.\n *\n * Consequently the fallback is handled internally here in start, and if the\n * fallback succeeds we signal success to the async queue even though the\n * start() itself signals failure.\n *\n * @param persistenceSettings Settings object to configure offline\n * persistence.\n * @returns A deferred result indicating the user-visible result of enabling\n * offline persistence. This method will reject this if IndexedDB fails to\n * start for any reason. If usePersistence is false this is\n * unconditionally resolved.\n */\n start(persistenceSettings: InternalPersistenceSettings): Promise<void> {\n this.verifyNotTerminated();\n // We defer our initialization until we get the current user from\n // setChangeListener(). We block the async queue until we got the initial\n // user and the initialization is completed. This will prevent any scheduled\n // work from happening before initialization is completed.\n //\n // If initializationDone resolved then the FirestoreClient is in a usable\n // state.\n const initializationDone = new Deferred<void>();\n\n // If usePersistence is true, certain classes of errors while starting are\n // recoverable but only by falling back to persistence disabled.\n //\n // If there's an error in the first case but not in recovery we cannot\n // reject the promise blocking the async queue because this will cause the\n // async queue to panic.\n const persistenceResult = new Deferred<void>();\n\n let initialized = false;\n this.credentials.setChangeListener(user => {\n if (!initialized) {\n initialized = true;\n\n this.initializePersistence(persistenceSettings, persistenceResult, user)\n .then(maybeLruGc => this.initializeRest(user, maybeLruGc))\n .then(initializationDone.resolve, initializationDone.reject);\n } else {\n this.asyncQueue.enqueueAndForget(() => {\n return this.handleCredentialChange(user);\n });\n }\n });\n\n // Block the async queue until initialization is done\n this.asyncQueue.enqueueAndForget(() => {\n return initializationDone.promise;\n });\n\n // Return only the result of enabling persistence. Note that this does not\n // need to await the completion of initializationDone because the result of\n // this method should not reflect any other kind of failure to start.\n return persistenceResult.promise;\n }\n\n /** Enables the network connection and requeues all pending operations. */\n enableNetwork(): Promise<void> {\n this.verifyNotTerminated();\n return this.asyncQueue.enqueue(() => {\n return this.syncEngine.enableNetwork();\n });\n }\n\n /**\n * Initializes persistent storage, attempting to use IndexedDB if\n * usePersistence is true or memory-only if false.\n *\n * If IndexedDB fails because it's already open in another tab or because the\n * platform can't possibly support our implementation then this method rejects\n * the persistenceResult and falls back on memory-only persistence.\n *\n * @param persistenceSettings Settings object to configure offline persistence\n * @param persistenceResult A deferred result indicating the user-visible\n * result of enabling offline persistence. This method will reject this if\n * IndexedDB fails to start for any reason. If usePersistence is false\n * this is unconditionally resolved.\n * @returns a Promise indicating whether or not initialization should\n * continue, i.e. that one of the persistence implementations actually\n * succeeded.\n */\n private initializePersistence(\n persistenceSettings: InternalPersistenceSettings,\n persistenceResult: Deferred<void>,\n user: User\n ): Promise<LruGarbageCollector | null> {\n if (persistenceSettings instanceof IndexedDbPersistenceSettings) {\n return this.startIndexedDbPersistence(user, persistenceSettings)\n .then(maybeLruGc => {\n persistenceResult.resolve();\n return maybeLruGc;\n })\n .catch(error => {\n // Regardless of whether or not the retry succeeds, from an user\n // perspective, offline persistence has failed.\n persistenceResult.reject(error);\n\n // An unknown failure on the first stage shuts everything down.\n if (!this.canFallback(error)) {\n throw error;\n }\n console.warn(\n 'Error enabling offline persistence. Falling back to' +\n ' persistence disabled: ' +\n error\n );\n return this.startMemoryPersistence();\n });\n } else {\n // When usePersistence == false, enabling offline persistence is defined\n // to unconditionally succeed. This allows start() to have the same\n // signature for both cases, despite the fact that the returned promise\n // is only used in the enablePersistence call.\n persistenceResult.resolve();\n return this.startMemoryPersistence();\n }\n }\n\n /**\n * Decides whether the provided error allows us to gracefully disable\n * persistence (as opposed to crashing the client).\n */\n private canFallback(error: FirestoreError | DOMException): boolean {\n if (error instanceof FirestoreError) {\n return (\n error.code === Code.FAILED_PRECONDITION ||\n error.code === Code.UNIMPLEMENTED\n );\n } else if (\n typeof DOMException !== 'undefined' &&\n error instanceof DOMException\n ) {\n // There are a few known circumstances where we can open IndexedDb but\n // trying to read/write will fail (e.g. quota exceeded). For\n // well-understood cases, we attempt to detect these and then gracefully\n // fall back to memory persistence.\n // NOTE: Rather than continue to add to this list, we could decide to\n // always fall back, with the risk that we might accidentally hide errors\n // representing actual SDK bugs.\n return (\n // When the browser is out of quota we could get either quota exceeded\n // or an aborted error depending on whether the error happened during\n // schema migration.\n error.code === DOM_EXCEPTION_QUOTA_EXCEEDED ||\n error.code === DOM_EXCEPTION_ABORTED ||\n // Firefox Private Browsing mode disables IndexedDb and returns\n // INVALID_STATE for any usage.\n error.code === DOM_EXCEPTION_INVALID_STATE\n );\n }\n\n return true;\n }\n\n /**\n * Checks that the client has not been terminated. Ensures that other methods on\n * this class cannot be called after the client is terminated.\n */\n private verifyNotTerminated(): void {\n if (this.asyncQueue.isShuttingDown) {\n throw new FirestoreError(\n Code.FAILED_PRECONDITION,\n 'The client has already been terminated.'\n );\n }\n }\n\n /**\n * Starts IndexedDB-based persistence.\n *\n * @returns A promise indicating success or failure.\n */\n private startIndexedDbPersistence(\n user: User,\n settings: IndexedDbPersistenceSettings\n ): Promise<LruGarbageCollector> {\n // TODO(http://b/33384523): For now we just disable garbage collection\n // when persistence is enabled.\n const persistenceKey = IndexedDbPersistence.buildStoragePrefix(\n this.databaseInfo\n );\n // Opt to use proto3 JSON in case the platform doesn't support Uint8Array.\n const serializer = new JsonProtoSerializer(this.databaseInfo.databaseId, {\n useProto3Json: true\n });\n\n return Promise.resolve().then(async () => {\n if (\n settings.synchronizeTabs &&\n !WebStorageSharedClientState.isAvailable(this.platform)\n ) {\n throw new FirestoreError(\n Code.UNIMPLEMENTED,\n 'IndexedDB persistence is only available on platforms that support LocalStorage.'\n );\n }\n\n const lruParams = settings.lruParams();\n\n this.sharedClientState = settings.synchronizeTabs\n ? new WebStorageSharedClientState(\n this.asyncQueue,\n this.platform,\n persistenceKey,\n this.clientId,\n user\n )\n : new MemorySharedClientState();\n\n const persistence = await IndexedDbPersistence.createIndexedDbPersistence(\n {\n allowTabSynchronization: settings.synchronizeTabs,\n persistenceKey,\n clientId: this.clientId,\n platform: this.platform,\n queue: this.asyncQueue,\n serializer,\n lruParams,\n sequenceNumberSyncer: this.sharedClientState\n }\n );\n\n this.persistence = persistence;\n return persistence.referenceDelegate.garbageCollector;\n });\n }\n\n /**\n * Starts Memory-backed persistence. In practice this cannot fail.\n *\n * @returns A promise that will successfully resolve.\n */\n private startMemoryPersistence(): Promise<LruGarbageCollector | null> {\n this.persistence = MemoryPersistence.createEagerPersistence(this.clientId);\n this.sharedClientState = new MemorySharedClientState();\n return Promise.resolve(null);\n }\n\n /**\n * Initializes the rest of the FirestoreClient, assuming the initial user\n * has been obtained from the credential provider and some persistence\n * implementation is available in this.persistence.\n */\n private initializeRest(\n user: User,\n maybeLruGc: LruGarbageCollector | null\n ): Promise<void> {\n debug(LOG_TAG, 'Initializing. user=', user.uid);\n return this.platform\n .loadConnection(this.databaseInfo)\n .then(async connection => {\n const queryEngine = new IndexFreeQueryEngine();\n this.localStore = new LocalStore(this.persistence, queryEngine, user);\n await this.localStore.start();\n\n if (maybeLruGc) {\n // We're running LRU Garbage collection. Set up the scheduler.\n this.lruScheduler = new LruScheduler(\n maybeLruGc,\n this.asyncQueue,\n this.localStore\n );\n }\n\n const connectivityMonitor = this.platform.newConnectivityMonitor();\n const serializer = this.platform.newSerializer(\n this.databaseInfo.databaseId\n );\n const datastore = new Datastore(\n this.asyncQueue,\n connection,\n this.credentials,\n serializer\n );\n\n const remoteStoreOnlineStateChangedHandler = (\n onlineState: OnlineState\n ): void =>\n this.syncEngine.applyOnlineStateChange(\n onlineState,\n OnlineStateSource.RemoteStore\n );\n const sharedClientStateOnlineStateChangedHandler = (\n onlineState: OnlineState\n ): void =>\n this.syncEngine.applyOnlineStateChange(\n onlineState,\n OnlineStateSource.SharedClientState\n );\n\n this.remoteStore = new RemoteStore(\n this.localStore,\n datastore,\n this.asyncQueue,\n remoteStoreOnlineStateChangedHandler,\n connectivityMonitor\n );\n\n this.syncEngine = new SyncEngine(\n this.localStore,\n this.remoteStore,\n this.sharedClientState,\n user\n );\n\n this.sharedClientState.onlineStateHandler = sharedClientStateOnlineStateChangedHandler;\n\n // Set up wiring between sync engine and other components\n this.remoteStore.syncEngine = this.syncEngine;\n this.sharedClientState.syncEngine = this.syncEngine;\n\n this.eventMgr = new EventManager(this.syncEngine);\n\n // PORTING NOTE: LocalStore doesn't need an explicit start() on the Web.\n await this.sharedClientState.start();\n await this.remoteStore.start();\n\n // NOTE: This will immediately call the listener, so we make sure to\n // set it after localStore / remoteStore are started.\n await this.persistence.setPrimaryStateListener(async isPrimary => {\n await this.syncEngine.applyPrimaryState(isPrimary);\n if (this.lruScheduler) {\n if (isPrimary && !this.lruScheduler.started) {\n this.lruScheduler.start();\n } else if (!isPrimary) {\n this.lruScheduler.stop();\n }\n }\n });\n\n // When a user calls clearPersistence() in one client, all other clients\n // need to be terminated to allow the delete to succeed.\n await this.persistence.setDatabaseDeletedListener(async () => {\n await this.terminate();\n });\n });\n }\n\n private handleCredentialChange(user: User): Promise<void> {\n this.asyncQueue.verifyOperationInProgress();\n\n debug(LOG_TAG, 'Credential Changed. Current user: ' + user.uid);\n return this.syncEngine.handleCredentialChange(user);\n }\n\n /** Disables the network connection. Pending operations will not complete. */\n disableNetwork(): Promise<void> {\n this.verifyNotTerminated();\n return this.asyncQueue.enqueue(() => {\n return this.syncEngine.disableNetwork();\n });\n }\n\n terminate(): Promise<void> {\n return this.asyncQueue.enqueueAndInitiateShutdown(async () => {\n // PORTING NOTE: LocalStore does not need an explicit shutdown on web.\n if (this.lruScheduler) {\n this.lruScheduler.stop();\n }\n await this.remoteStore.shutdown();\n await this.sharedClientState.shutdown();\n await this.persistence.shutdown();\n\n // `removeChangeListener` must be called after shutting down the\n // RemoteStore as it will prevent the RemoteStore from retrieving\n // auth tokens.\n this.credentials.removeChangeListener();\n });\n }\n\n /**\n * Returns a Promise that resolves when all writes that were pending at the time this\n * method was called received server acknowledgement. An acknowledgement can be either acceptance\n * or rejection.\n */\n waitForPendingWrites(): Promise<void> {\n this.verifyNotTerminated();\n\n const deferred = new Deferred<void>();\n this.asyncQueue.enqueueAndForget(() => {\n return this.syncEngine.registerPendingWritesCallback(deferred);\n });\n return deferred.promise;\n }\n\n listen(\n query: Query,\n observer: Observer<ViewSnapshot>,\n options: ListenOptions\n ): QueryListener {\n this.verifyNotTerminated();\n const listener = new QueryListener(query, observer, options);\n this.asyncQueue.enqueueAndForget(() => {\n return this.eventMgr.listen(listener);\n });\n return listener;\n }\n\n unlisten(listener: QueryListener): void {\n // Checks for termination but does not raise error, allowing unlisten after\n // termination to be a no-op.\n if (this.clientTerminated) {\n return;\n }\n this.asyncQueue.enqueueAndForget(() => {\n return this.eventMgr.unlisten(listener);\n });\n }\n\n getDocumentFromLocalCache(docKey: DocumentKey): Promise<Document | null> {\n this.verifyNotTerminated();\n return this.asyncQueue\n .enqueue(() => {\n return this.localStore.readDocument(docKey);\n })\n .then((maybeDoc: MaybeDocument | null) => {\n if (maybeDoc instanceof Document) {\n return maybeDoc;\n } else if (maybeDoc instanceof NoDocument) {\n return null;\n } else {\n throw new FirestoreError(\n Code.UNAVAILABLE,\n 'Failed to get document from cache. (However, this document may ' +\n \"exist on the server. Run again without setting 'source' in \" +\n 'the GetOptions to attempt to retrieve the document from the ' +\n 'server.)'\n );\n }\n });\n }\n\n getDocumentsFromLocalCache(query: Query): Promise<ViewSnapshot> {\n this.verifyNotTerminated();\n return this.asyncQueue.enqueue(async () => {\n const queryResult = await this.localStore.executeQuery(\n query,\n /* usePreviousResults= */ true\n );\n const view = new View(query, queryResult.remoteKeys);\n const viewDocChanges = view.computeDocChanges(queryResult.documents);\n return view.applyChanges(\n viewDocChanges,\n /* updateLimboDocuments= */ false\n ).snapshot!;\n });\n }\n\n write(mutations: Mutation[]): Promise<void> {\n this.verifyNotTerminated();\n const deferred = new Deferred<void>();\n this.asyncQueue.enqueueAndForget(() =>\n this.syncEngine.write(mutations, deferred)\n );\n return deferred.promise;\n }\n\n databaseId(): DatabaseId {\n return this.databaseInfo.databaseId;\n }\n\n addSnapshotsInSyncListener(observer: Observer<void>): void {\n this.verifyNotTerminated();\n this.asyncQueue.enqueueAndForget(() => {\n this.eventMgr.addSnapshotsInSyncListener(observer);\n return Promise.resolve();\n });\n }\n\n removeSnapshotsInSyncListener(observer: Observer<void>): void {\n // Checks for shutdown but does not raise error, allowing remove after\n // shutdown to be a no-op.\n if (this.clientTerminated) {\n return;\n }\n this.eventMgr.removeSnapshotsInSyncListener(observer);\n }\n\n get clientTerminated(): boolean {\n // Technically, the asyncQueue is still running, but only accepting operations\n // related to termination or supposed to be run after termination. It is effectively\n // terminated to the eyes of users.\n return this.asyncQueue.isShuttingDown;\n }\n\n transaction<T>(\n updateFunction: (transaction: Transaction) => Promise<T>\n ): Promise<T> {\n this.verifyNotTerminated();\n const deferred = new Deferred<T>();\n this.asyncQueue.enqueueAndForget(() => {\n this.syncEngine.runTransaction(this.asyncQueue, updateFunction, deferred);\n return Promise.resolve();\n });\n return deferred.promise;\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Observer } from '../core/event_manager';\nimport { EventHandler } from './misc';\n\n/*\n * A wrapper implementation of Observer<T> that will dispatch events\n * asynchronously. To allow immediate silencing, a mute call is added which\n * causes events scheduled to no longer be raised.\n */\nexport class AsyncObserver<T> implements Observer<T> {\n /**\n * When set to true, will not raise future events. Necessary to deal with\n * async detachment of listener.\n */\n private muted = false;\n\n constructor(private observer: Observer<T>) {}\n\n next(value: T): void {\n this.scheduleEvent(this.observer.next, value);\n }\n\n error(error: Error): void {\n this.scheduleEvent(this.observer.error, error);\n }\n\n mute(): void {\n this.muted = true;\n }\n\n private scheduleEvent<E>(eventHandler: EventHandler<E>, event: E): void {\n if (!this.muted) {\n setTimeout(() => {\n if (!this.muted) {\n eventHandler(event);\n }\n }, 0);\n }\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { JsonObject } from '../model/field_value';\n\n/**\n * Observer/Subscribe interfaces.\n */\nexport type NextFn<T> = (value: T) => void;\nexport type ErrorFn = (error: Error) => void;\nexport type CompleteFn = () => void;\n\n// Allow for any of the Observer methods to be undefined.\nexport interface PartialObserver<T> {\n next?: NextFn<T>;\n error?: ErrorFn;\n complete?: CompleteFn;\n}\n\nexport interface Unsubscribe {\n (): void;\n}\n\nexport function isPartialObserver(obj: unknown): boolean {\n return implementsAnyMethods(obj, ['next', 'error', 'complete']);\n}\n\n/**\n * Returns true if obj is an object and contains at least one of the specified\n * methods.\n */\nfunction implementsAnyMethods(obj: unknown, methods: string[]): boolean {\n if (typeof obj !== 'object' || obj === null) {\n return false;\n }\n\n const object = obj as JsonObject<unknown>;\n for (const method of methods) {\n if (method in object && typeof object[method] === 'function') {\n return true;\n }\n }\n return false;\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport * as firestore from '@firebase/firestore-types';\n\nimport { FirebaseApp } from '@firebase/app-types';\nimport { FirebaseService, _FirebaseApp } from '@firebase/app-types/private';\nimport { DatabaseId, DatabaseInfo } from '../core/database_info';\nimport { ListenOptions } from '../core/event_manager';\nimport {\n FirestoreClient,\n IndexedDbPersistenceSettings,\n InternalPersistenceSettings,\n MemoryPersistenceSettings\n} from '../core/firestore_client';\nimport {\n Bound,\n Direction,\n FieldFilter,\n Filter,\n Operator,\n OrderBy,\n Query as InternalQuery\n} from '../core/query';\nimport { Transaction as InternalTransaction } from '../core/transaction';\nimport { ChangeType, ViewSnapshot } from '../core/view_snapshot';\nimport { IndexedDbPersistence } from '../local/indexeddb_persistence';\nimport { LruParams } from '../local/lru_garbage_collector';\nimport { Document, MaybeDocument, NoDocument } from '../model/document';\nimport { DocumentKey } from '../model/document_key';\nimport {\n ArrayValue,\n FieldValue,\n FieldValueOptions,\n ObjectValue,\n RefValue,\n ServerTimestampValue\n} from '../model/field_value';\nimport { DeleteMutation, Mutation, Precondition } from '../model/mutation';\nimport { FieldPath, ResourcePath } from '../model/path';\nimport { PlatformSupport } from '../platform/platform';\nimport { makeConstructorPrivate } from '../util/api';\nimport { assert, fail } from '../util/assert';\nimport { AsyncObserver } from '../util/async_observer';\nimport { AsyncQueue } from '../util/async_queue';\nimport { Code, FirestoreError } from '../util/error';\nimport {\n invalidClassError,\n validateArgType,\n validateAtLeastNumberOfArgs,\n validateBetweenNumberOfArgs,\n validateDefined,\n validateExactNumberOfArgs,\n validateNamedOptionalPropertyEquals,\n validateNamedOptionalType,\n validateNamedType,\n validateOptionalArgType,\n validateOptionalArrayElements,\n validateOptionNames,\n validatePositiveNumber,\n validateStringEnum,\n valueDescription\n} from '../util/input_validation';\n// eslint-disable-next-line import/no-duplicates\nimport * as log from '../util/log';\n// eslint-disable-next-line import/no-duplicates\nimport { LogLevel } from '../util/log';\nimport { AutoId } from '../util/misc';\nimport * as objUtils from '../util/obj';\nimport { Rejecter, Resolver } from '../util/promise';\nimport { Deferred } from './../util/promise';\nimport { FieldPath as ExternalFieldPath } from './field_path';\n\nimport {\n CredentialsProvider,\n CredentialsSettings,\n EmptyCredentialsProvider,\n FirebaseCredentialsProvider,\n makeCredentialsProvider\n} from './credentials';\nimport {\n CompleteFn,\n ErrorFn,\n isPartialObserver,\n NextFn,\n PartialObserver,\n Unsubscribe\n} from './observer';\nimport {\n DocumentKeyReference,\n fieldPathFromArgument,\n UserDataConverter\n} from './user_data_converter';\nimport { FirebaseAuthInternalName } from '@firebase/auth-interop-types';\nimport { Provider } from '@firebase/component';\n\n// settings() defaults:\nconst DEFAULT_HOST = 'firestore.googleapis.com';\nconst DEFAULT_SSL = true;\nconst DEFAULT_TIMESTAMPS_IN_SNAPSHOTS = true;\nconst DEFAULT_FORCE_LONG_POLLING = false;\n\n/**\n * Constant used to indicate the LRU garbage collection should be disabled.\n * Set this value as the `cacheSizeBytes` on the settings passed to the\n * `Firestore` instance.\n */\nexport const CACHE_SIZE_UNLIMITED = LruParams.COLLECTION_DISABLED;\n\n// enablePersistence() defaults:\nconst DEFAULT_SYNCHRONIZE_TABS = false;\n\n/** Undocumented, private additional settings not exposed in our public API. */\ninterface PrivateSettings extends firestore.Settings {\n // Can be a google-auth-library or gapi client.\n credentials?: CredentialsSettings;\n}\n\n/**\n * Options that can be provided in the Firestore constructor when not using\n * Firebase (aka standalone mode).\n */\nexport interface FirestoreDatabase {\n projectId: string;\n database?: string;\n}\n\n/**\n * A concrete type describing all the values that can be applied via a\n * user-supplied firestore.Settings object. This is a separate type so that\n * defaults can be supplied and the value can be checked for equality.\n */\nclass FirestoreSettings {\n /** The hostname to connect to. */\n readonly host: string;\n\n /** Whether to use SSL when connecting. */\n readonly ssl: boolean;\n\n readonly timestampsInSnapshots: boolean;\n\n readonly cacheSizeBytes: number;\n\n readonly forceLongPolling: boolean;\n\n // Can be a google-auth-library or gapi client.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n credentials?: any;\n\n constructor(settings: PrivateSettings) {\n if (settings.host === undefined) {\n if (settings.ssl !== undefined) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n \"Can't provide ssl option if host option is not set\"\n );\n }\n this.host = DEFAULT_HOST;\n this.ssl = DEFAULT_SSL;\n } else {\n validateNamedType('settings', 'non-empty string', 'host', settings.host);\n this.host = settings.host;\n\n validateNamedOptionalType('settings', 'boolean', 'ssl', settings.ssl);\n this.ssl = objUtils.defaulted(settings.ssl, DEFAULT_SSL);\n }\n validateOptionNames('settings', settings, [\n 'host',\n 'ssl',\n 'credentials',\n 'timestampsInSnapshots',\n 'cacheSizeBytes',\n 'experimentalForceLongPolling'\n ]);\n\n validateNamedOptionalType(\n 'settings',\n 'object',\n 'credentials',\n settings.credentials\n );\n this.credentials = settings.credentials;\n\n validateNamedOptionalType(\n 'settings',\n 'boolean',\n 'timestampsInSnapshots',\n settings.timestampsInSnapshots\n );\n\n // Nobody should set timestampsInSnapshots anymore, but the error depends on\n // whether they set it to true or false...\n if (settings.timestampsInSnapshots === true) {\n log.error(`\n The timestampsInSnapshots setting now defaults to true and you no\n longer need to explicitly set it. In a future release, the setting\n will be removed entirely and so it is recommended that you remove it\n from your firestore.settings() call now.`);\n } else if (settings.timestampsInSnapshots === false) {\n log.error(`\n The timestampsInSnapshots setting will soon be removed. YOU MUST UPDATE\n YOUR CODE.\n\n To hide this warning, stop using the timestampsInSnapshots setting in your\n firestore.settings({ ... }) call.\n\n Once you remove the setting, Timestamps stored in Cloud Firestore will be\n read back as Firebase Timestamp objects instead of as system Date objects.\n So you will also need to update code expecting a Date to instead expect a\n Timestamp. For example:\n\n // Old:\n const date = snapshot.get('created_at');\n // New:\n const timestamp = snapshot.get('created_at'); const date =\n timestamp.toDate();\n\n Please audit all existing usages of Date when you enable the new\n behavior.`);\n }\n this.timestampsInSnapshots = objUtils.defaulted(\n settings.timestampsInSnapshots,\n DEFAULT_TIMESTAMPS_IN_SNAPSHOTS\n );\n\n validateNamedOptionalType(\n 'settings',\n 'number',\n 'cacheSizeBytes',\n settings.cacheSizeBytes\n );\n if (settings.cacheSizeBytes === undefined) {\n this.cacheSizeBytes = LruParams.DEFAULT_CACHE_SIZE_BYTES;\n } else {\n if (\n settings.cacheSizeBytes !== CACHE_SIZE_UNLIMITED &&\n settings.cacheSizeBytes < LruParams.MINIMUM_CACHE_SIZE_BYTES\n ) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `cacheSizeBytes must be at least ${LruParams.MINIMUM_CACHE_SIZE_BYTES}`\n );\n } else {\n this.cacheSizeBytes = settings.cacheSizeBytes;\n }\n }\n\n validateNamedOptionalType(\n 'settings',\n 'boolean',\n 'experimentalForceLongPolling',\n settings.experimentalForceLongPolling\n );\n this.forceLongPolling =\n settings.experimentalForceLongPolling === undefined\n ? DEFAULT_FORCE_LONG_POLLING\n : settings.experimentalForceLongPolling;\n }\n\n isEqual(other: FirestoreSettings): boolean {\n return (\n this.host === other.host &&\n this.ssl === other.ssl &&\n this.timestampsInSnapshots === other.timestampsInSnapshots &&\n this.credentials === other.credentials &&\n this.cacheSizeBytes === other.cacheSizeBytes &&\n this.forceLongPolling === other.forceLongPolling\n );\n }\n}\n\n/**\n * The root reference to the database.\n */\nexport class Firestore implements firestore.FirebaseFirestore, FirebaseService {\n // The objects that are a part of this API are exposed to third-parties as\n // compiled javascript so we want to flag our private members with a leading\n // underscore to discourage their use.\n readonly _databaseId: DatabaseId;\n private readonly _persistenceKey: string;\n private _credentials: CredentialsProvider;\n private readonly _firebaseApp: FirebaseApp | null = null;\n private _settings: FirestoreSettings;\n\n // The firestore client instance. This will be available as soon as\n // configureClient is called, but any calls against it will block until\n // setup has completed.\n //\n // Operations on the _firestoreClient don't block on _firestoreReady. Those\n // are already set to synchronize on the async queue.\n private _firestoreClient: FirestoreClient | undefined;\n\n // Public for use in tests.\n // TODO(mikelehen): Use modularized initialization instead.\n readonly _queue = new AsyncQueue();\n\n readonly _dataConverter: UserDataConverter;\n\n constructor(\n databaseIdOrApp: FirestoreDatabase | FirebaseApp,\n authProvider: Provider<FirebaseAuthInternalName>\n ) {\n if (typeof (databaseIdOrApp as FirebaseApp).options === 'object') {\n // This is very likely a Firebase app object\n // TODO(b/34177605): Can we somehow use instanceof?\n const app = databaseIdOrApp as FirebaseApp;\n this._firebaseApp = app;\n this._databaseId = Firestore.databaseIdFromApp(app);\n this._persistenceKey = app.name;\n this._credentials = new FirebaseCredentialsProvider(authProvider);\n } else {\n const external = databaseIdOrApp as FirestoreDatabase;\n if (!external.projectId) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Must provide projectId'\n );\n }\n\n this._databaseId = new DatabaseId(external.projectId, external.database);\n // Use a default persistenceKey that lines up with FirebaseApp.\n this._persistenceKey = '[DEFAULT]';\n this._credentials = new EmptyCredentialsProvider();\n }\n\n this._settings = new FirestoreSettings({});\n this._dataConverter = this.createDataConverter(this._databaseId);\n }\n\n settings(settingsLiteral: firestore.Settings): void {\n validateExactNumberOfArgs('Firestore.settings', arguments, 1);\n validateArgType('Firestore.settings', 'object', 1, settingsLiteral);\n\n if (\n objUtils.contains(settingsLiteral as objUtils.Dict<{}>, 'persistence')\n ) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n '\"persistence\" is now specified with a separate call to ' +\n 'firestore.enablePersistence().'\n );\n }\n\n const newSettings = new FirestoreSettings(settingsLiteral);\n if (this._firestoreClient && !this._settings.isEqual(newSettings)) {\n throw new FirestoreError(\n Code.FAILED_PRECONDITION,\n 'Firestore has already been started and its settings can no longer ' +\n 'be changed. You can only call settings() before calling any other ' +\n 'methods on a Firestore object.'\n );\n }\n\n this._settings = newSettings;\n if (newSettings.credentials !== undefined) {\n this._credentials = makeCredentialsProvider(newSettings.credentials);\n }\n }\n\n enableNetwork(): Promise<void> {\n this.ensureClientConfigured();\n return this._firestoreClient!.enableNetwork();\n }\n\n disableNetwork(): Promise<void> {\n this.ensureClientConfigured();\n return this._firestoreClient!.disableNetwork();\n }\n\n enablePersistence(settings?: firestore.PersistenceSettings): Promise<void> {\n if (this._firestoreClient) {\n throw new FirestoreError(\n Code.FAILED_PRECONDITION,\n 'Firestore has already been started and persistence can no longer ' +\n 'be enabled. You can only call enablePersistence() before calling ' +\n 'any other methods on a Firestore object.'\n );\n }\n\n let synchronizeTabs = false;\n\n if (settings) {\n if (settings.experimentalTabSynchronization !== undefined) {\n log.error(\n \"The 'experimentalTabSynchronization' setting has been renamed to \" +\n \"'synchronizeTabs'. In a future release, the setting will be removed \" +\n 'and it is recommended that you update your ' +\n \"firestore.enablePersistence() call to use 'synchronizeTabs'.\"\n );\n }\n synchronizeTabs = objUtils.defaulted(\n settings.synchronizeTabs !== undefined\n ? settings.synchronizeTabs\n : settings.experimentalTabSynchronization,\n DEFAULT_SYNCHRONIZE_TABS\n );\n }\n\n return this.configureClient(\n new IndexedDbPersistenceSettings(\n this._settings.cacheSizeBytes,\n synchronizeTabs\n )\n );\n }\n\n clearPersistence(): Promise<void> {\n const persistenceKey = IndexedDbPersistence.buildStoragePrefix(\n this.makeDatabaseInfo()\n );\n const deferred = new Deferred<void>();\n this._queue.enqueueAndForgetEvenAfterShutdown(async () => {\n try {\n if (\n this._firestoreClient !== undefined &&\n !this._firestoreClient.clientTerminated\n ) {\n throw new FirestoreError(\n Code.FAILED_PRECONDITION,\n 'Persistence cannot be cleared after this Firestore instance is initialized.'\n );\n }\n await IndexedDbPersistence.clearPersistence(persistenceKey);\n deferred.resolve();\n } catch (e) {\n deferred.reject(e);\n }\n });\n return deferred.promise;\n }\n\n terminate(): Promise<void> {\n (this.app as _FirebaseApp)._removeServiceInstance('firestore');\n return this.INTERNAL.delete();\n }\n\n get _isTerminated(): boolean {\n this.ensureClientConfigured();\n return this._firestoreClient!.clientTerminated;\n }\n\n waitForPendingWrites(): Promise<void> {\n this.ensureClientConfigured();\n return this._firestoreClient!.waitForPendingWrites();\n }\n\n onSnapshotsInSync(observer: PartialObserver<void>): Unsubscribe;\n onSnapshotsInSync(onSync: () => void): Unsubscribe;\n onSnapshotsInSync(arg: unknown): Unsubscribe {\n this.ensureClientConfigured();\n\n if (isPartialObserver(arg)) {\n return this.onSnapshotsInSyncInternal(arg as PartialObserver<void>);\n } else {\n validateArgType('Firestore.onSnapshotsInSync', 'function', 1, arg);\n const observer: PartialObserver<void> = {\n next: arg as () => void\n };\n return this.onSnapshotsInSyncInternal(observer);\n }\n }\n\n private onSnapshotsInSyncInternal(\n observer: PartialObserver<void>\n ): Unsubscribe {\n const errHandler = (err: Error): void => {\n throw fail('Uncaught Error in onSnapshotsInSync');\n };\n const asyncObserver = new AsyncObserver<void>({\n next: () => {\n if (observer.next) {\n observer.next();\n }\n },\n error: errHandler\n });\n this._firestoreClient!.addSnapshotsInSyncListener(asyncObserver);\n return () => {\n asyncObserver.mute();\n this._firestoreClient!.removeSnapshotsInSyncListener(asyncObserver);\n };\n }\n\n ensureClientConfigured(): FirestoreClient {\n if (!this._firestoreClient) {\n // Kick off starting the client but don't actually wait for it.\n // eslint-disable-next-line @typescript-eslint/no-floating-promises\n this.configureClient(new MemoryPersistenceSettings());\n }\n return this._firestoreClient as FirestoreClient;\n }\n\n private makeDatabaseInfo(): DatabaseInfo {\n return new DatabaseInfo(\n this._databaseId,\n this._persistenceKey,\n this._settings.host,\n this._settings.ssl,\n this._settings.forceLongPolling\n );\n }\n\n private configureClient(\n persistenceSettings: InternalPersistenceSettings\n ): Promise<void> {\n assert(!!this._settings.host, 'FirestoreSettings.host is not set');\n\n assert(!this._firestoreClient, 'configureClient() called multiple times');\n\n const databaseInfo = this.makeDatabaseInfo();\n\n this._firestoreClient = new FirestoreClient(\n PlatformSupport.getPlatform(),\n databaseInfo,\n this._credentials,\n this._queue\n );\n\n return this._firestoreClient.start(persistenceSettings);\n }\n\n private createDataConverter(databaseId: DatabaseId): UserDataConverter {\n const preConverter = (value: unknown): unknown => {\n if (value instanceof DocumentReference) {\n const thisDb = databaseId;\n const otherDb = value.firestore._databaseId;\n if (!otherDb.isEqual(thisDb)) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Document reference is for database ' +\n `${otherDb.projectId}/${otherDb.database} but should be ` +\n `for database ${thisDb.projectId}/${thisDb.database}`\n );\n }\n return new DocumentKeyReference(databaseId, value._key);\n } else {\n return value;\n }\n };\n return new UserDataConverter(preConverter);\n }\n\n private static databaseIdFromApp(app: FirebaseApp): DatabaseId {\n const options = app.options as objUtils.Dict<{}>;\n if (!objUtils.contains(options, 'projectId')) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n '\"projectId\" not provided in firebase.initializeApp.'\n );\n }\n\n const projectId = options['projectId'];\n if (!projectId || typeof projectId !== 'string') {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'projectId must be a string in FirebaseApp.options'\n );\n }\n return new DatabaseId(projectId);\n }\n\n get app(): FirebaseApp {\n if (!this._firebaseApp) {\n throw new FirestoreError(\n Code.FAILED_PRECONDITION,\n \"Firestore was not initialized using the Firebase SDK. 'app' is \" +\n 'not available'\n );\n }\n return this._firebaseApp;\n }\n\n INTERNAL = {\n delete: async (): Promise<void> => {\n // The client must be initalized to ensure that all subsequent API usage\n // throws an exception.\n this.ensureClientConfigured();\n await this._firestoreClient!.terminate();\n }\n };\n\n collection(pathString: string): firestore.CollectionReference {\n validateExactNumberOfArgs('Firestore.collection', arguments, 1);\n validateArgType('Firestore.collection', 'non-empty string', 1, pathString);\n this.ensureClientConfigured();\n return new CollectionReference(ResourcePath.fromString(pathString), this);\n }\n\n doc(pathString: string): firestore.DocumentReference {\n validateExactNumberOfArgs('Firestore.doc', arguments, 1);\n validateArgType('Firestore.doc', 'non-empty string', 1, pathString);\n this.ensureClientConfigured();\n return DocumentReference.forPath(ResourcePath.fromString(pathString), this);\n }\n\n collectionGroup(collectionId: string): firestore.Query {\n validateExactNumberOfArgs('Firestore.collectionGroup', arguments, 1);\n validateArgType(\n 'Firestore.collectionGroup',\n 'non-empty string',\n 1,\n collectionId\n );\n if (collectionId.indexOf('/') >= 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid collection ID '${collectionId}' passed to function ` +\n `Firestore.collectionGroup(). Collection IDs must not contain '/'.`\n );\n }\n this.ensureClientConfigured();\n return new Query(\n new InternalQuery(ResourcePath.EMPTY_PATH, collectionId),\n this\n );\n }\n\n runTransaction<T>(\n updateFunction: (transaction: firestore.Transaction) => Promise<T>\n ): Promise<T> {\n validateExactNumberOfArgs('Firestore.runTransaction', arguments, 1);\n validateArgType('Firestore.runTransaction', 'function', 1, updateFunction);\n return this.ensureClientConfigured().transaction(\n (transaction: InternalTransaction) => {\n return updateFunction(new Transaction(this, transaction));\n }\n );\n }\n\n batch(): firestore.WriteBatch {\n this.ensureClientConfigured();\n\n return new WriteBatch(this);\n }\n\n static get logLevel(): firestore.LogLevel {\n switch (log.getLogLevel()) {\n case LogLevel.DEBUG:\n return 'debug';\n case LogLevel.ERROR:\n return 'error';\n case LogLevel.SILENT:\n return 'silent';\n default:\n return fail('Unknown log level: ' + log.getLogLevel());\n }\n }\n\n static setLogLevel(level: firestore.LogLevel): void {\n validateExactNumberOfArgs('Firestore.setLogLevel', arguments, 1);\n validateArgType('Firestore.setLogLevel', 'non-empty string', 1, level);\n switch (level) {\n case 'debug':\n log.setLogLevel(log.LogLevel.DEBUG);\n break;\n case 'error':\n log.setLogLevel(log.LogLevel.ERROR);\n break;\n case 'silent':\n log.setLogLevel(log.LogLevel.SILENT);\n break;\n default:\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Invalid log level: ' + level\n );\n }\n }\n\n // Note: this is not a property because the minifier can't work correctly with\n // the way TypeScript compiler outputs properties.\n _areTimestampsInSnapshotsEnabled(): boolean {\n return this._settings.timestampsInSnapshots;\n }\n}\n\n/**\n * A reference to a transaction.\n */\nexport class Transaction implements firestore.Transaction {\n constructor(\n private _firestore: Firestore,\n private _transaction: InternalTransaction\n ) {}\n\n get<T>(\n documentRef: firestore.DocumentReference<T>\n ): Promise<firestore.DocumentSnapshot<T>> {\n validateExactNumberOfArgs('Transaction.get', arguments, 1);\n const ref = validateReference(\n 'Transaction.get',\n documentRef,\n this._firestore\n );\n return this._transaction\n .lookup([ref._key])\n .then((docs: MaybeDocument[]) => {\n if (!docs || docs.length !== 1) {\n return fail('Mismatch in docs returned from document lookup.');\n }\n const doc = docs[0];\n if (doc instanceof NoDocument) {\n return new DocumentSnapshot<T>(\n this._firestore,\n ref._key,\n null,\n /* fromCache= */ false,\n /* hasPendingWrites= */ false,\n ref._converter\n );\n } else if (doc instanceof Document) {\n return new DocumentSnapshot<T>(\n this._firestore,\n ref._key,\n doc,\n /* fromCache= */ false,\n /* hasPendingWrites= */ false,\n ref._converter\n );\n } else {\n throw fail(\n `BatchGetDocumentsRequest returned unexpected document type: ${doc.constructor.name}`\n );\n }\n });\n }\n\n set<T>(\n documentRef: firestore.DocumentReference<T>,\n value: T,\n options?: firestore.SetOptions\n ): Transaction {\n validateBetweenNumberOfArgs('Transaction.set', arguments, 2, 3);\n const ref = validateReference(\n 'Transaction.set',\n documentRef,\n this._firestore\n );\n options = validateSetOptions('Transaction.set', options);\n const [convertedValue, functionName] = applyFirestoreDataConverter(\n ref._converter,\n value,\n 'Transaction.set'\n );\n const parsed =\n options.merge || options.mergeFields\n ? this._firestore._dataConverter.parseMergeData(\n functionName,\n convertedValue,\n options.mergeFields\n )\n : this._firestore._dataConverter.parseSetData(\n functionName,\n convertedValue\n );\n this._transaction.set(ref._key, parsed);\n return this;\n }\n\n update(\n documentRef: firestore.DocumentReference<unknown>,\n value: firestore.UpdateData\n ): Transaction;\n update(\n documentRef: firestore.DocumentReference<unknown>,\n field: string | ExternalFieldPath,\n value: unknown,\n ...moreFieldsAndValues: unknown[]\n ): Transaction;\n update(\n documentRef: firestore.DocumentReference<unknown>,\n fieldOrUpdateData: string | ExternalFieldPath | firestore.UpdateData,\n value?: unknown,\n ...moreFieldsAndValues: unknown[]\n ): Transaction {\n let ref;\n let parsed;\n\n if (\n typeof fieldOrUpdateData === 'string' ||\n fieldOrUpdateData instanceof ExternalFieldPath\n ) {\n validateAtLeastNumberOfArgs('Transaction.update', arguments, 3);\n ref = validateReference(\n 'Transaction.update',\n documentRef,\n this._firestore\n );\n parsed = this._firestore._dataConverter.parseUpdateVarargs(\n 'Transaction.update',\n fieldOrUpdateData,\n value,\n moreFieldsAndValues\n );\n } else {\n validateExactNumberOfArgs('Transaction.update', arguments, 2);\n ref = validateReference(\n 'Transaction.update',\n documentRef,\n this._firestore\n );\n parsed = this._firestore._dataConverter.parseUpdateData(\n 'Transaction.update',\n fieldOrUpdateData\n );\n }\n\n this._transaction.update(ref._key, parsed);\n return this;\n }\n\n delete(documentRef: firestore.DocumentReference<unknown>): Transaction {\n validateExactNumberOfArgs('Transaction.delete', arguments, 1);\n const ref = validateReference(\n 'Transaction.delete',\n documentRef,\n this._firestore\n );\n this._transaction.delete(ref._key);\n return this;\n }\n}\n\nexport class WriteBatch implements firestore.WriteBatch {\n private _mutations = [] as Mutation[];\n private _committed = false;\n\n constructor(private _firestore: Firestore) {}\n\n set<T>(\n documentRef: firestore.DocumentReference<T>,\n value: T,\n options?: firestore.SetOptions\n ): WriteBatch {\n validateBetweenNumberOfArgs('WriteBatch.set', arguments, 2, 3);\n this.verifyNotCommitted();\n const ref = validateReference(\n 'WriteBatch.set',\n documentRef,\n this._firestore\n );\n options = validateSetOptions('WriteBatch.set', options);\n const [convertedValue, functionName] = applyFirestoreDataConverter(\n ref._converter,\n value,\n 'WriteBatch.set'\n );\n const parsed =\n options.merge || options.mergeFields\n ? this._firestore._dataConverter.parseMergeData(\n functionName,\n convertedValue,\n options.mergeFields\n )\n : this._firestore._dataConverter.parseSetData(\n functionName,\n convertedValue\n );\n this._mutations = this._mutations.concat(\n parsed.toMutations(ref._key, Precondition.NONE)\n );\n return this;\n }\n\n update(\n documentRef: firestore.DocumentReference<unknown>,\n value: firestore.UpdateData\n ): WriteBatch;\n update(\n documentRef: firestore.DocumentReference<unknown>,\n field: string | ExternalFieldPath,\n value: unknown,\n ...moreFieldsAndValues: unknown[]\n ): WriteBatch;\n update(\n documentRef: firestore.DocumentReference<unknown>,\n fieldOrUpdateData: string | ExternalFieldPath | firestore.UpdateData,\n value?: unknown,\n ...moreFieldsAndValues: unknown[]\n ): WriteBatch {\n this.verifyNotCommitted();\n\n let ref;\n let parsed;\n\n if (\n typeof fieldOrUpdateData === 'string' ||\n fieldOrUpdateData instanceof ExternalFieldPath\n ) {\n validateAtLeastNumberOfArgs('WriteBatch.update', arguments, 3);\n ref = validateReference(\n 'WriteBatch.update',\n documentRef,\n this._firestore\n );\n parsed = this._firestore._dataConverter.parseUpdateVarargs(\n 'WriteBatch.update',\n fieldOrUpdateData,\n value,\n moreFieldsAndValues\n );\n } else {\n validateExactNumberOfArgs('WriteBatch.update', arguments, 2);\n ref = validateReference(\n 'WriteBatch.update',\n documentRef,\n this._firestore\n );\n parsed = this._firestore._dataConverter.parseUpdateData(\n 'WriteBatch.update',\n fieldOrUpdateData\n );\n }\n\n this._mutations = this._mutations.concat(\n parsed.toMutations(ref._key, Precondition.exists(true))\n );\n return this;\n }\n\n delete(documentRef: firestore.DocumentReference<unknown>): WriteBatch {\n validateExactNumberOfArgs('WriteBatch.delete', arguments, 1);\n this.verifyNotCommitted();\n const ref = validateReference(\n 'WriteBatch.delete',\n documentRef,\n this._firestore\n );\n this._mutations = this._mutations.concat(\n new DeleteMutation(ref._key, Precondition.NONE)\n );\n return this;\n }\n\n async commit(): Promise<void> {\n this.verifyNotCommitted();\n this._committed = true;\n if (this._mutations.length > 0) {\n return this._firestore.ensureClientConfigured().write(this._mutations);\n }\n }\n\n private verifyNotCommitted(): void {\n if (this._committed) {\n throw new FirestoreError(\n Code.FAILED_PRECONDITION,\n 'A write batch can no longer be used after commit() ' +\n 'has been called.'\n );\n }\n }\n}\n\n/**\n * A reference to a particular document in a collection in the database.\n */\nexport class DocumentReference<T = firestore.DocumentData>\n implements firestore.DocumentReference<T> {\n private _firestoreClient: FirestoreClient;\n\n constructor(\n public _key: DocumentKey,\n readonly firestore: Firestore,\n readonly _converter?: firestore.FirestoreDataConverter<T>\n ) {\n this._firestoreClient = this.firestore.ensureClientConfigured();\n }\n\n static forPath<U>(\n path: ResourcePath,\n firestore: Firestore,\n converter?: firestore.FirestoreDataConverter<U>\n ): DocumentReference<U> {\n if (path.length % 2 !== 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Invalid document reference. Document ' +\n 'references must have an even number of segments, but ' +\n `${path.canonicalString()} has ${path.length}`\n );\n }\n return new DocumentReference(new DocumentKey(path), firestore, converter);\n }\n\n get id(): string {\n return this._key.path.lastSegment();\n }\n\n get parent(): firestore.CollectionReference<T> {\n return new CollectionReference(\n this._key.path.popLast(),\n this.firestore,\n this._converter\n );\n }\n\n get path(): string {\n return this._key.path.canonicalString();\n }\n\n collection(\n pathString: string\n ): firestore.CollectionReference<firestore.DocumentData> {\n validateExactNumberOfArgs('DocumentReference.collection', arguments, 1);\n validateArgType(\n 'DocumentReference.collection',\n 'non-empty string',\n 1,\n pathString\n );\n if (!pathString) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Must provide a non-empty collection name to collection()'\n );\n }\n const path = ResourcePath.fromString(pathString);\n return new CollectionReference(this._key.path.child(path), this.firestore);\n }\n\n isEqual(other: firestore.DocumentReference<T>): boolean {\n if (!(other instanceof DocumentReference)) {\n throw invalidClassError('isEqual', 'DocumentReference', 1, other);\n }\n return (\n this.firestore === other.firestore &&\n this._key.isEqual(other._key) &&\n this._converter === other._converter\n );\n }\n\n set(\n value: firestore.DocumentData,\n options?: firestore.SetOptions\n ): Promise<void>;\n set(value: T, options?: firestore.SetOptions): Promise<void> {\n validateBetweenNumberOfArgs('DocumentReference.set', arguments, 1, 2);\n options = validateSetOptions('DocumentReference.set', options);\n const [convertedValue, functionName] = applyFirestoreDataConverter(\n this._converter,\n value,\n 'DocumentReference.set'\n );\n const parsed =\n options.merge || options.mergeFields\n ? this.firestore._dataConverter.parseMergeData(\n functionName,\n convertedValue,\n options.mergeFields\n )\n : this.firestore._dataConverter.parseSetData(\n functionName,\n convertedValue\n );\n return this._firestoreClient.write(\n parsed.toMutations(this._key, Precondition.NONE)\n );\n }\n\n update(value: firestore.UpdateData): Promise<void>;\n update(\n field: string | ExternalFieldPath,\n value: unknown,\n ...moreFieldsAndValues: unknown[]\n ): Promise<void>;\n update(\n fieldOrUpdateData: string | ExternalFieldPath | firestore.UpdateData,\n value?: unknown,\n ...moreFieldsAndValues: unknown[]\n ): Promise<void> {\n let parsed;\n\n if (\n typeof fieldOrUpdateData === 'string' ||\n fieldOrUpdateData instanceof ExternalFieldPath\n ) {\n validateAtLeastNumberOfArgs('DocumentReference.update', arguments, 2);\n parsed = this.firestore._dataConverter.parseUpdateVarargs(\n 'DocumentReference.update',\n fieldOrUpdateData,\n value,\n moreFieldsAndValues\n );\n } else {\n validateExactNumberOfArgs('DocumentReference.update', arguments, 1);\n parsed = this.firestore._dataConverter.parseUpdateData(\n 'DocumentReference.update',\n fieldOrUpdateData\n );\n }\n\n return this._firestoreClient.write(\n parsed.toMutations(this._key, Precondition.exists(true))\n );\n }\n\n delete(): Promise<void> {\n validateExactNumberOfArgs('DocumentReference.delete', arguments, 0);\n return this._firestoreClient.write([\n new DeleteMutation(this._key, Precondition.NONE)\n ]);\n }\n\n onSnapshot(\n observer: PartialObserver<firestore.DocumentSnapshot<T>>\n ): Unsubscribe;\n onSnapshot(\n options: firestore.SnapshotListenOptions,\n observer: PartialObserver<firestore.DocumentSnapshot<T>>\n ): Unsubscribe;\n onSnapshot(\n onNext: NextFn<firestore.DocumentSnapshot<T>>,\n onError?: ErrorFn,\n onCompletion?: CompleteFn\n ): Unsubscribe;\n onSnapshot(\n options: firestore.SnapshotListenOptions,\n onNext: NextFn<firestore.DocumentSnapshot<T>>,\n onError?: ErrorFn,\n onCompletion?: CompleteFn\n ): Unsubscribe;\n\n onSnapshot(...args: unknown[]): Unsubscribe {\n validateBetweenNumberOfArgs(\n 'DocumentReference.onSnapshot',\n arguments,\n 1,\n 4\n );\n let options: firestore.SnapshotListenOptions = {\n includeMetadataChanges: false\n };\n let observer: PartialObserver<firestore.DocumentSnapshot<T>>;\n let currArg = 0;\n if (\n typeof args[currArg] === 'object' &&\n !isPartialObserver(args[currArg])\n ) {\n options = args[currArg] as firestore.SnapshotListenOptions;\n validateOptionNames('DocumentReference.onSnapshot', options, [\n 'includeMetadataChanges'\n ]);\n validateNamedOptionalType(\n 'DocumentReference.onSnapshot',\n 'boolean',\n 'includeMetadataChanges',\n options.includeMetadataChanges\n );\n currArg++;\n }\n\n const internalOptions = {\n includeMetadataChanges: options.includeMetadataChanges\n };\n\n if (isPartialObserver(args[currArg])) {\n observer = args[currArg] as PartialObserver<\n firestore.DocumentSnapshot<T>\n >;\n } else {\n validateArgType(\n 'DocumentReference.onSnapshot',\n 'function',\n currArg,\n args[currArg]\n );\n validateOptionalArgType(\n 'DocumentReference.onSnapshot',\n 'function',\n currArg + 1,\n args[currArg + 1]\n );\n validateOptionalArgType(\n 'DocumentReference.onSnapshot',\n 'function',\n currArg + 2,\n args[currArg + 2]\n );\n observer = {\n next: args[currArg] as NextFn<firestore.DocumentSnapshot<T>>,\n error: args[currArg + 1] as ErrorFn,\n complete: args[currArg + 2] as CompleteFn\n };\n }\n return this.onSnapshotInternal(internalOptions, observer);\n }\n\n private onSnapshotInternal(\n options: ListenOptions,\n observer: PartialObserver<firestore.DocumentSnapshot<T>>\n ): Unsubscribe {\n let errHandler = (err: Error): void => {\n console.error('Uncaught Error in onSnapshot:', err);\n };\n if (observer.error) {\n errHandler = observer.error.bind(observer);\n }\n\n const asyncObserver = new AsyncObserver<ViewSnapshot>({\n next: snapshot => {\n if (observer.next) {\n assert(\n snapshot.docs.size <= 1,\n 'Too many documents returned on a document query'\n );\n const doc = snapshot.docs.get(this._key);\n\n observer.next(\n new DocumentSnapshot(\n this.firestore,\n this._key,\n doc,\n snapshot.fromCache,\n snapshot.hasPendingWrites,\n this._converter\n )\n );\n }\n },\n error: errHandler\n });\n const internalListener = this._firestoreClient.listen(\n InternalQuery.atPath(this._key.path),\n asyncObserver,\n options\n );\n\n return () => {\n asyncObserver.mute();\n this._firestoreClient.unlisten(internalListener);\n };\n }\n\n get(options?: firestore.GetOptions): Promise<firestore.DocumentSnapshot<T>> {\n validateBetweenNumberOfArgs('DocumentReference.get', arguments, 0, 1);\n validateGetOptions('DocumentReference.get', options);\n return new Promise(\n (resolve: Resolver<firestore.DocumentSnapshot<T>>, reject: Rejecter) => {\n if (options && options.source === 'cache') {\n this.firestore\n .ensureClientConfigured()\n .getDocumentFromLocalCache(this._key)\n .then(doc => {\n resolve(\n new DocumentSnapshot(\n this.firestore,\n this._key,\n doc,\n /*fromCache=*/ true,\n doc instanceof Document ? doc.hasLocalMutations : false,\n this._converter\n )\n );\n }, reject);\n } else {\n this.getViaSnapshotListener(resolve, reject, options);\n }\n }\n );\n }\n\n private getViaSnapshotListener(\n resolve: Resolver<firestore.DocumentSnapshot<T>>,\n reject: Rejecter,\n options?: firestore.GetOptions\n ): void {\n const unlisten = this.onSnapshotInternal(\n {\n includeMetadataChanges: true,\n waitForSyncWhenOnline: true\n },\n {\n next: (snap: firestore.DocumentSnapshot<T>) => {\n // Remove query first before passing event to user to avoid\n // user actions affecting the now stale query.\n unlisten();\n\n if (!snap.exists && snap.metadata.fromCache) {\n // TODO(dimond): If we're online and the document doesn't\n // exist then we resolve with a doc.exists set to false. If\n // we're offline however, we reject the Promise in this\n // case. Two options: 1) Cache the negative response from\n // the server so we can deliver that even when you're\n // offline 2) Actually reject the Promise in the online case\n // if the document doesn't exist.\n reject(\n new FirestoreError(\n Code.UNAVAILABLE,\n 'Failed to get document because the client is ' + 'offline.'\n )\n );\n } else if (\n snap.exists &&\n snap.metadata.fromCache &&\n options &&\n options.source === 'server'\n ) {\n reject(\n new FirestoreError(\n Code.UNAVAILABLE,\n 'Failed to get document from server. (However, this ' +\n 'document does exist in the local cache. Run again ' +\n 'without setting source to \"server\" to ' +\n 'retrieve the cached document.)'\n )\n );\n } else {\n resolve(snap);\n }\n },\n error: reject\n }\n );\n }\n\n withConverter<U>(\n converter: firestore.FirestoreDataConverter<U>\n ): firestore.DocumentReference<U> {\n return new DocumentReference<U>(this._key, this.firestore, converter);\n }\n}\n\nclass SnapshotMetadata implements firestore.SnapshotMetadata {\n constructor(\n readonly hasPendingWrites: boolean,\n readonly fromCache: boolean\n ) {}\n\n isEqual(other: firestore.SnapshotMetadata): boolean {\n return (\n this.hasPendingWrites === other.hasPendingWrites &&\n this.fromCache === other.fromCache\n );\n }\n}\n\n/**\n * Options interface that can be provided to configure the deserialization of\n * DocumentSnapshots.\n */\nexport interface SnapshotOptions extends firestore.SnapshotOptions {}\n\nexport class DocumentSnapshot<T = firestore.DocumentData>\n implements firestore.DocumentSnapshot<T> {\n constructor(\n private _firestore: Firestore,\n private _key: DocumentKey,\n public _document: Document | null,\n private _fromCache: boolean,\n private _hasPendingWrites: boolean,\n private readonly _converter?: firestore.FirestoreDataConverter<T>\n ) {}\n\n data(options?: firestore.SnapshotOptions): T | undefined {\n validateBetweenNumberOfArgs('DocumentSnapshot.data', arguments, 0, 1);\n options = validateSnapshotOptions('DocumentSnapshot.data', options);\n if (!this._document) {\n return undefined;\n } else {\n // We only want to use the converter and create a new DocumentSnapshot\n // if a converter has been provided.\n if (this._converter) {\n const snapshot = new QueryDocumentSnapshot(\n this._firestore,\n this._key,\n this._document,\n this._fromCache,\n this._hasPendingWrites\n );\n return this._converter.fromFirestore(snapshot, options);\n } else {\n return this.toJSObject(\n this._document.data(),\n FieldValueOptions.fromSnapshotOptions(\n options,\n this._firestore._areTimestampsInSnapshotsEnabled()\n )\n ) as T;\n }\n }\n }\n\n get(\n fieldPath: string | ExternalFieldPath,\n options?: firestore.SnapshotOptions\n ): unknown {\n validateBetweenNumberOfArgs('DocumentSnapshot.get', arguments, 1, 2);\n options = validateSnapshotOptions('DocumentSnapshot.get', options);\n if (this._document) {\n const value = this._document\n .data()\n .field(fieldPathFromArgument('DocumentSnapshot.get', fieldPath));\n if (value !== null) {\n return this.toJSValue(\n value,\n FieldValueOptions.fromSnapshotOptions(\n options,\n this._firestore._areTimestampsInSnapshotsEnabled()\n )\n );\n }\n }\n return undefined;\n }\n\n get id(): string {\n return this._key.path.lastSegment();\n }\n\n get ref(): firestore.DocumentReference<T> {\n return new DocumentReference<T>(\n this._key,\n this._firestore,\n this._converter\n );\n }\n\n get exists(): boolean {\n return this._document !== null;\n }\n\n get metadata(): firestore.SnapshotMetadata {\n return new SnapshotMetadata(this._hasPendingWrites, this._fromCache);\n }\n\n isEqual(other: firestore.DocumentSnapshot<T>): boolean {\n if (!(other instanceof DocumentSnapshot)) {\n throw invalidClassError('isEqual', 'DocumentSnapshot', 1, other);\n }\n return (\n this._firestore === other._firestore &&\n this._fromCache === other._fromCache &&\n this._key.isEqual(other._key) &&\n (this._document === null\n ? other._document === null\n : this._document.isEqual(other._document)) &&\n this._converter === other._converter\n );\n }\n\n private toJSObject(\n data: ObjectValue,\n options: FieldValueOptions\n ): firestore.DocumentData {\n const result: firestore.DocumentData = {};\n data.forEach((key, value) => {\n result[key] = this.toJSValue(value, options);\n });\n return result;\n }\n\n private toJSValue(value: FieldValue, options: FieldValueOptions): unknown {\n if (value instanceof ObjectValue) {\n return this.toJSObject(value, options);\n } else if (value instanceof ArrayValue) {\n return this.toJSArray(value, options);\n } else if (value instanceof RefValue) {\n const key = value.value(options);\n const database = this._firestore.ensureClientConfigured().databaseId();\n if (!value.databaseId.isEqual(database)) {\n // TODO(b/64130202): Somehow support foreign references.\n log.error(\n `Document ${this._key.path} contains a document ` +\n `reference within a different database (` +\n `${value.databaseId.projectId}/${value.databaseId.database}) which is not ` +\n `supported. It will be treated as a reference in the current ` +\n `database (${database.projectId}/${database.database}) ` +\n `instead.`\n );\n }\n return new DocumentReference(key, this._firestore, this._converter);\n } else {\n return value.value(options);\n }\n }\n\n private toJSArray(data: ArrayValue, options: FieldValueOptions): unknown[] {\n return data.internalValue.map(value => {\n return this.toJSValue(value, options);\n });\n }\n}\n\nexport class QueryDocumentSnapshot<T = firestore.DocumentData>\n extends DocumentSnapshot<T>\n implements firestore.QueryDocumentSnapshot<T> {\n data(options?: SnapshotOptions): T {\n const data = super.data(options);\n assert(\n data !== undefined,\n 'Document in a QueryDocumentSnapshot should exist'\n );\n return data;\n }\n}\n\nexport class Query<T = firestore.DocumentData> implements firestore.Query<T> {\n constructor(\n public _query: InternalQuery,\n readonly firestore: Firestore,\n protected readonly _converter?: firestore.FirestoreDataConverter<T>\n ) {}\n\n where(\n field: string | ExternalFieldPath,\n opStr: firestore.WhereFilterOp,\n value: unknown\n ): firestore.Query<T> {\n validateExactNumberOfArgs('Query.where', arguments, 3);\n validateDefined('Query.where', 3, value);\n\n // Enumerated from the WhereFilterOp type in index.d.ts.\n const whereFilterOpEnums = [\n '<',\n '<=',\n '==',\n '>=',\n '>',\n 'array-contains',\n 'in',\n 'array-contains-any'\n ];\n validateStringEnum('Query.where', whereFilterOpEnums, 2, opStr);\n\n let fieldValue: FieldValue;\n const fieldPath = fieldPathFromArgument('Query.where', field);\n const operator = Operator.fromString(opStr);\n if (fieldPath.isKeyField()) {\n if (\n operator === Operator.ARRAY_CONTAINS ||\n operator === Operator.ARRAY_CONTAINS_ANY\n ) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid Query. You can't perform '${operator.toString()}' ` +\n 'queries on FieldPath.documentId().'\n );\n } else if (operator === Operator.IN) {\n this.validateDisjunctiveFilterElements(value, operator);\n const referenceList: FieldValue[] = [];\n for (const arrayValue of value as FieldValue[]) {\n referenceList.push(this.parseDocumentIdValue(arrayValue));\n }\n fieldValue = new ArrayValue(referenceList);\n } else {\n fieldValue = this.parseDocumentIdValue(value);\n }\n } else {\n if (\n operator === Operator.IN ||\n operator === Operator.ARRAY_CONTAINS_ANY\n ) {\n this.validateDisjunctiveFilterElements(value, operator);\n }\n fieldValue = this.firestore._dataConverter.parseQueryValue(\n 'Query.where',\n value,\n // We only allow nested arrays for IN queries.\n /** allowArrays = */ operator === Operator.IN ? true : false\n );\n }\n const filter = FieldFilter.create(fieldPath, operator, fieldValue);\n this.validateNewFilter(filter);\n return new Query(\n this._query.addFilter(filter),\n this.firestore,\n this._converter\n );\n }\n\n orderBy(\n field: string | ExternalFieldPath,\n directionStr?: firestore.OrderByDirection\n ): firestore.Query<T> {\n validateBetweenNumberOfArgs('Query.orderBy', arguments, 1, 2);\n validateOptionalArgType(\n 'Query.orderBy',\n 'non-empty string',\n 2,\n directionStr\n );\n let direction: Direction;\n if (directionStr === undefined || directionStr === 'asc') {\n direction = Direction.ASCENDING;\n } else if (directionStr === 'desc') {\n direction = Direction.DESCENDING;\n } else {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Function Query.orderBy() has unknown direction '${directionStr}', ` +\n `expected 'asc' or 'desc'.`\n );\n }\n if (this._query.startAt !== null) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Invalid query. You must not call Query.startAt() or ' +\n 'Query.startAfter() before calling Query.orderBy().'\n );\n }\n if (this._query.endAt !== null) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Invalid query. You must not call Query.endAt() or ' +\n 'Query.endBefore() before calling Query.orderBy().'\n );\n }\n const fieldPath = fieldPathFromArgument('Query.orderBy', field);\n const orderBy = new OrderBy(fieldPath, direction);\n this.validateNewOrderBy(orderBy);\n return new Query(\n this._query.addOrderBy(orderBy),\n this.firestore,\n this._converter\n );\n }\n\n limit(n: number): firestore.Query<T> {\n validateExactNumberOfArgs('Query.limit', arguments, 1);\n validateArgType('Query.limit', 'number', 1, n);\n validatePositiveNumber('Query.limit', 1, n);\n return new Query(\n this._query.withLimitToFirst(n),\n this.firestore,\n this._converter\n );\n }\n\n limitToLast(n: number): firestore.Query<T> {\n validateExactNumberOfArgs('Query.limitToLast', arguments, 1);\n validateArgType('Query.limitToLast', 'number', 1, n);\n validatePositiveNumber('Query.limitToLast', 1, n);\n return new Query(\n this._query.withLimitToLast(n),\n this.firestore,\n this._converter\n );\n }\n\n startAt(\n docOrField: unknown | firestore.DocumentSnapshot<unknown>,\n ...fields: unknown[]\n ): firestore.Query<T> {\n validateAtLeastNumberOfArgs('Query.startAt', arguments, 1);\n const bound = this.boundFromDocOrFields(\n 'Query.startAt',\n docOrField,\n fields,\n /*before=*/ true\n );\n return new Query(\n this._query.withStartAt(bound),\n this.firestore,\n this._converter\n );\n }\n\n startAfter(\n docOrField: unknown | firestore.DocumentSnapshot<unknown>,\n ...fields: unknown[]\n ): firestore.Query<T> {\n validateAtLeastNumberOfArgs('Query.startAfter', arguments, 1);\n const bound = this.boundFromDocOrFields(\n 'Query.startAfter',\n docOrField,\n fields,\n /*before=*/ false\n );\n return new Query(\n this._query.withStartAt(bound),\n this.firestore,\n this._converter\n );\n }\n\n endBefore(\n docOrField: unknown | firestore.DocumentSnapshot<unknown>,\n ...fields: unknown[]\n ): firestore.Query<T> {\n validateAtLeastNumberOfArgs('Query.endBefore', arguments, 1);\n const bound = this.boundFromDocOrFields(\n 'Query.endBefore',\n docOrField,\n fields,\n /*before=*/ true\n );\n return new Query(\n this._query.withEndAt(bound),\n this.firestore,\n this._converter\n );\n }\n\n endAt(\n docOrField: unknown | firestore.DocumentSnapshot<unknown>,\n ...fields: unknown[]\n ): firestore.Query<T> {\n validateAtLeastNumberOfArgs('Query.endAt', arguments, 1);\n const bound = this.boundFromDocOrFields(\n 'Query.endAt',\n docOrField,\n fields,\n /*before=*/ false\n );\n return new Query(\n this._query.withEndAt(bound),\n this.firestore,\n this._converter\n );\n }\n\n isEqual(other: firestore.Query<T>): boolean {\n if (!(other instanceof Query)) {\n throw invalidClassError('isEqual', 'Query', 1, other);\n }\n return (\n this.firestore === other.firestore && this._query.isEqual(other._query)\n );\n }\n\n withConverter<U>(\n converter: firestore.FirestoreDataConverter<U>\n ): firestore.Query<U> {\n return new Query<U>(this._query, this.firestore, converter);\n }\n\n /** Helper function to create a bound from a document or fields */\n private boundFromDocOrFields(\n methodName: string,\n docOrField: unknown | firestore.DocumentSnapshot<T>,\n fields: unknown[],\n before: boolean\n ): Bound {\n validateDefined(methodName, 1, docOrField);\n if (docOrField instanceof DocumentSnapshot) {\n if (fields.length > 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Too many arguments provided to ${methodName}().`\n );\n }\n const snap = docOrField;\n if (!snap.exists) {\n throw new FirestoreError(\n Code.NOT_FOUND,\n `Can't use a DocumentSnapshot that doesn't exist for ` +\n `${methodName}().`\n );\n }\n return this.boundFromDocument(methodName, snap._document!, before);\n } else {\n const allFields = [docOrField].concat(fields);\n return this.boundFromFields(methodName, allFields, before);\n }\n }\n\n /**\n * Create a Bound from a query and a document.\n *\n * Note that the Bound will always include the key of the document\n * and so only the provided document will compare equal to the returned\n * position.\n *\n * Will throw if the document does not contain all fields of the order by\n * of the query or if any of the fields in the order by are an uncommitted\n * server timestamp.\n */\n private boundFromDocument(\n methodName: string,\n doc: Document,\n before: boolean\n ): Bound {\n const components: FieldValue[] = [];\n\n // Because people expect to continue/end a query at the exact document\n // provided, we need to use the implicit sort order rather than the explicit\n // sort order, because it's guaranteed to contain the document key. That way\n // the position becomes unambiguous and the query continues/ends exactly at\n // the provided document. Without the key (by using the explicit sort\n // orders), multiple documents could match the position, yielding duplicate\n // results.\n for (const orderBy of this._query.orderBy) {\n if (orderBy.field.isKeyField()) {\n components.push(new RefValue(this.firestore._databaseId, doc.key));\n } else {\n const value = doc.field(orderBy.field);\n if (value instanceof ServerTimestampValue) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Invalid query. You are trying to start or end a query using a ' +\n 'document for which the field \"' +\n orderBy.field +\n '\" is an uncommitted server timestamp. (Since the value of ' +\n 'this field is unknown, you cannot start/end a query with it.)'\n );\n } else if (value !== null) {\n components.push(value);\n } else {\n const field = orderBy.field.canonicalString();\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid query. You are trying to start or end a query using a ` +\n `document for which the field '${field}' (used as the ` +\n `orderBy) does not exist.`\n );\n }\n }\n }\n return new Bound(components, before);\n }\n\n /**\n * Converts a list of field values to a Bound for the given query.\n */\n private boundFromFields(\n methodName: string,\n values: unknown[],\n before: boolean\n ): Bound {\n // Use explicit order by's because it has to match the query the user made\n const orderBy = this._query.explicitOrderBy;\n if (values.length > orderBy.length) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Too many arguments provided to ${methodName}(). ` +\n `The number of arguments must be less than or equal to the ` +\n `number of Query.orderBy() clauses`\n );\n }\n\n const components: FieldValue[] = [];\n for (let i = 0; i < values.length; i++) {\n const rawValue = values[i];\n const orderByComponent = orderBy[i];\n if (orderByComponent.field.isKeyField()) {\n if (typeof rawValue !== 'string') {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid query. Expected a string for document ID in ` +\n `${methodName}(), but got a ${typeof rawValue}`\n );\n }\n if (\n !this._query.isCollectionGroupQuery() &&\n rawValue.indexOf('/') !== -1\n ) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid query. When querying a collection and ordering by FieldPath.documentId(), ` +\n `the value passed to ${methodName}() must be a plain document ID, but ` +\n `'${rawValue}' contains a slash.`\n );\n }\n const path = this._query.path.child(ResourcePath.fromString(rawValue));\n if (!DocumentKey.isDocumentKey(path)) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid query. When querying a collection group and ordering by ` +\n `FieldPath.documentId(), the value passed to ${methodName}() must result in a ` +\n `valid document path, but '${path}' is not because it contains an odd number ` +\n `of segments.`\n );\n }\n const key = new DocumentKey(path);\n components.push(new RefValue(this.firestore._databaseId, key));\n } else {\n const wrapped = this.firestore._dataConverter.parseQueryValue(\n methodName,\n rawValue\n );\n components.push(wrapped);\n }\n }\n\n return new Bound(components, before);\n }\n\n onSnapshot(\n observer: PartialObserver<firestore.QuerySnapshot<T>>\n ): Unsubscribe;\n onSnapshot(\n options: firestore.SnapshotListenOptions,\n observer: PartialObserver<firestore.QuerySnapshot<T>>\n ): Unsubscribe;\n onSnapshot(\n onNext: NextFn<firestore.QuerySnapshot<T>>,\n onError?: ErrorFn,\n onCompletion?: CompleteFn\n ): Unsubscribe;\n onSnapshot(\n options: firestore.SnapshotListenOptions,\n onNext: NextFn<firestore.QuerySnapshot<T>>,\n onError?: ErrorFn,\n onCompletion?: CompleteFn\n ): Unsubscribe;\n\n onSnapshot(...args: unknown[]): Unsubscribe {\n validateBetweenNumberOfArgs('Query.onSnapshot', arguments, 1, 4);\n let options: firestore.SnapshotListenOptions = {};\n let observer: PartialObserver<firestore.QuerySnapshot<T>>;\n let currArg = 0;\n if (\n typeof args[currArg] === 'object' &&\n !isPartialObserver(args[currArg])\n ) {\n options = args[currArg] as firestore.SnapshotListenOptions;\n validateOptionNames('Query.onSnapshot', options, [\n 'includeMetadataChanges'\n ]);\n validateNamedOptionalType(\n 'Query.onSnapshot',\n 'boolean',\n 'includeMetadataChanges',\n options.includeMetadataChanges\n );\n currArg++;\n }\n\n if (isPartialObserver(args[currArg])) {\n observer = args[currArg] as PartialObserver<firestore.QuerySnapshot<T>>;\n } else {\n validateArgType('Query.onSnapshot', 'function', currArg, args[currArg]);\n validateOptionalArgType(\n 'Query.onSnapshot',\n 'function',\n currArg + 1,\n args[currArg + 1]\n );\n validateOptionalArgType(\n 'Query.onSnapshot',\n 'function',\n currArg + 2,\n args[currArg + 2]\n );\n observer = {\n next: args[currArg] as NextFn<firestore.QuerySnapshot<T>>,\n error: args[currArg + 1] as ErrorFn,\n complete: args[currArg + 2] as CompleteFn\n };\n }\n this.validateHasExplicitOrderByForLimitToLast(this._query);\n return this.onSnapshotInternal(options, observer);\n }\n\n private onSnapshotInternal(\n options: ListenOptions,\n observer: PartialObserver<firestore.QuerySnapshot<T>>\n ): Unsubscribe {\n let errHandler = (err: Error): void => {\n console.error('Uncaught Error in onSnapshot:', err);\n };\n if (observer.error) {\n errHandler = observer.error.bind(observer);\n }\n\n const asyncObserver = new AsyncObserver<ViewSnapshot>({\n next: (result: ViewSnapshot): void => {\n if (observer.next) {\n observer.next(\n new QuerySnapshot(\n this.firestore,\n this._query,\n result,\n this._converter\n )\n );\n }\n },\n error: errHandler\n });\n\n const firestoreClient = this.firestore.ensureClientConfigured();\n const internalListener = firestoreClient.listen(\n this._query,\n asyncObserver,\n options\n );\n return (): void => {\n asyncObserver.mute();\n firestoreClient.unlisten(internalListener);\n };\n }\n\n private validateHasExplicitOrderByForLimitToLast(query: InternalQuery): void {\n if (query.hasLimitToLast() && query.explicitOrderBy.length === 0) {\n throw new FirestoreError(\n Code.UNIMPLEMENTED,\n 'limitToLast() queries require specifying at least one orderBy() clause'\n );\n }\n }\n\n get(options?: firestore.GetOptions): Promise<firestore.QuerySnapshot<T>> {\n validateBetweenNumberOfArgs('Query.get', arguments, 0, 1);\n validateGetOptions('Query.get', options);\n this.validateHasExplicitOrderByForLimitToLast(this._query);\n return new Promise(\n (resolve: Resolver<firestore.QuerySnapshot<T>>, reject: Rejecter) => {\n if (options && options.source === 'cache') {\n this.firestore\n .ensureClientConfigured()\n .getDocumentsFromLocalCache(this._query)\n .then((viewSnap: ViewSnapshot) => {\n resolve(\n new QuerySnapshot(\n this.firestore,\n this._query,\n viewSnap,\n this._converter\n )\n );\n }, reject);\n } else {\n this.getViaSnapshotListener(resolve, reject, options);\n }\n }\n );\n }\n\n private getViaSnapshotListener(\n resolve: Resolver<firestore.QuerySnapshot<T>>,\n reject: Rejecter,\n options?: firestore.GetOptions\n ): void {\n const unlisten = this.onSnapshotInternal(\n {\n includeMetadataChanges: true,\n waitForSyncWhenOnline: true\n },\n {\n next: (result: firestore.QuerySnapshot<T>) => {\n // Remove query first before passing event to user to avoid\n // user actions affecting the now stale query.\n unlisten();\n\n if (\n result.metadata.fromCache &&\n options &&\n options.source === 'server'\n ) {\n reject(\n new FirestoreError(\n Code.UNAVAILABLE,\n 'Failed to get documents from server. (However, these ' +\n 'documents may exist in the local cache. Run again ' +\n 'without setting source to \"server\" to ' +\n 'retrieve the cached documents.)'\n )\n );\n } else {\n resolve(result);\n }\n },\n error: reject\n }\n );\n }\n\n /**\n * Parses the given documentIdValue into a ReferenceValue, throwing\n * appropriate errors if the value is anything other than a DocumentReference\n * or String, or if the string is malformed.\n */\n private parseDocumentIdValue(documentIdValue: unknown): RefValue {\n if (typeof documentIdValue === 'string') {\n if (documentIdValue === '') {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Invalid query. When querying with FieldPath.documentId(), you ' +\n 'must provide a valid document ID, but it was an empty string.'\n );\n }\n if (\n !this._query.isCollectionGroupQuery() &&\n documentIdValue.indexOf('/') !== -1\n ) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid query. When querying a collection by ` +\n `FieldPath.documentId(), you must provide a plain document ID, but ` +\n `'${documentIdValue}' contains a '/' character.`\n );\n }\n const path = this._query.path.child(\n ResourcePath.fromString(documentIdValue)\n );\n if (!DocumentKey.isDocumentKey(path)) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid query. When querying a collection group by ` +\n `FieldPath.documentId(), the value provided must result in a valid document path, ` +\n `but '${path}' is not because it has an odd number of segments (${path.length}).`\n );\n }\n return new RefValue(this.firestore._databaseId, new DocumentKey(path));\n } else if (documentIdValue instanceof DocumentReference) {\n const ref = documentIdValue as DocumentReference<T>;\n return new RefValue(this.firestore._databaseId, ref._key);\n } else {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid query. When querying with FieldPath.documentId(), you must provide a valid ` +\n `string or a DocumentReference, but it was: ` +\n `${valueDescription(documentIdValue)}.`\n );\n }\n }\n\n /**\n * Validates that the value passed into a disjunctrive filter satisfies all\n * array requirements.\n */\n private validateDisjunctiveFilterElements(\n value: unknown,\n operator: Operator\n ): void {\n if (!Array.isArray(value) || value.length === 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Invalid Query. A non-empty array is required for ' +\n `'${operator.toString()}' filters.`\n );\n }\n if (value.length > 10) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid Query. '${operator.toString()}' filters support a ` +\n 'maximum of 10 elements in the value array.'\n );\n }\n if (value.indexOf(null) >= 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid Query. '${operator.toString()}' filters cannot contain 'null' ` +\n 'in the value array.'\n );\n }\n if (value.filter(element => Number.isNaN(element)).length > 0) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid Query. '${operator.toString()}' filters cannot contain 'NaN' ` +\n 'in the value array.'\n );\n }\n }\n\n private validateNewFilter(filter: Filter): void {\n if (filter instanceof FieldFilter) {\n const arrayOps = [Operator.ARRAY_CONTAINS, Operator.ARRAY_CONTAINS_ANY];\n const disjunctiveOps = [Operator.IN, Operator.ARRAY_CONTAINS_ANY];\n const isArrayOp = arrayOps.indexOf(filter.op) >= 0;\n const isDisjunctiveOp = disjunctiveOps.indexOf(filter.op) >= 0;\n\n if (filter.isInequality()) {\n const existingField = this._query.getInequalityFilterField();\n if (existingField !== null && !existingField.isEqual(filter.field)) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Invalid query. All where filters with an inequality' +\n ' (<, <=, >, or >=) must be on the same field. But you have' +\n ` inequality filters on '${existingField.toString()}'` +\n ` and '${filter.field.toString()}'`\n );\n }\n\n const firstOrderByField = this._query.getFirstOrderByField();\n if (firstOrderByField !== null) {\n this.validateOrderByAndInequalityMatch(\n filter.field,\n firstOrderByField\n );\n }\n } else if (isDisjunctiveOp || isArrayOp) {\n // You can have at most 1 disjunctive filter and 1 array filter. Check if\n // the new filter conflicts with an existing one.\n let conflictingOp: Operator | null = null;\n if (isDisjunctiveOp) {\n conflictingOp = this._query.findFilterOperator(disjunctiveOps);\n }\n if (conflictingOp === null && isArrayOp) {\n conflictingOp = this._query.findFilterOperator(arrayOps);\n }\n if (conflictingOp != null) {\n // We special case when it's a duplicate op to give a slightly clearer error message.\n if (conflictingOp === filter.op) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Invalid query. You cannot use more than one ' +\n `'${filter.op.toString()}' filter.`\n );\n } else {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid query. You cannot use '${filter.op.toString()}' filters ` +\n `with '${conflictingOp.toString()}' filters.`\n );\n }\n }\n }\n }\n }\n\n private validateNewOrderBy(orderBy: OrderBy): void {\n if (this._query.getFirstOrderByField() === null) {\n // This is the first order by. It must match any inequality.\n const inequalityField = this._query.getInequalityFilterField();\n if (inequalityField !== null) {\n this.validateOrderByAndInequalityMatch(inequalityField, orderBy.field);\n }\n }\n }\n\n private validateOrderByAndInequalityMatch(\n inequality: FieldPath,\n orderBy: FieldPath\n ): void {\n if (!orderBy.isEqual(inequality)) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid query. You have a where filter with an inequality ` +\n `(<, <=, >, or >=) on field '${inequality.toString()}' ` +\n `and so you must also use '${inequality.toString()}' ` +\n `as your first Query.orderBy(), but your first Query.orderBy() ` +\n `is on field '${orderBy.toString()}' instead.`\n );\n }\n }\n}\n\nexport class QuerySnapshot<T = firestore.DocumentData>\n implements firestore.QuerySnapshot<T> {\n private _cachedChanges: Array<firestore.DocumentChange<T>> | null = null;\n private _cachedChangesIncludeMetadataChanges: boolean | null = null;\n\n readonly metadata: firestore.SnapshotMetadata;\n\n constructor(\n private readonly _firestore: Firestore,\n private readonly _originalQuery: InternalQuery,\n private readonly _snapshot: ViewSnapshot,\n private readonly _converter?: firestore.FirestoreDataConverter<T>\n ) {\n this.metadata = new SnapshotMetadata(\n _snapshot.hasPendingWrites,\n _snapshot.fromCache\n );\n }\n\n get docs(): Array<firestore.QueryDocumentSnapshot<T>> {\n const result: Array<firestore.QueryDocumentSnapshot<T>> = [];\n this.forEach(doc => result.push(doc));\n return result;\n }\n\n get empty(): boolean {\n return this._snapshot.docs.isEmpty();\n }\n\n get size(): number {\n return this._snapshot.docs.size;\n }\n\n forEach(\n callback: (result: firestore.QueryDocumentSnapshot<T>) => void,\n thisArg?: unknown\n ): void {\n validateBetweenNumberOfArgs('QuerySnapshot.forEach', arguments, 1, 2);\n validateArgType('QuerySnapshot.forEach', 'function', 1, callback);\n this._snapshot.docs.forEach(doc => {\n callback.call(thisArg, this.convertToDocumentImpl(doc));\n });\n }\n\n get query(): firestore.Query<T> {\n return new Query(this._originalQuery, this._firestore, this._converter);\n }\n\n docChanges(\n options?: firestore.SnapshotListenOptions\n ): Array<firestore.DocumentChange<T>> {\n if (options) {\n validateOptionNames('QuerySnapshot.docChanges', options, [\n 'includeMetadataChanges'\n ]);\n validateNamedOptionalType(\n 'QuerySnapshot.docChanges',\n 'boolean',\n 'includeMetadataChanges',\n options.includeMetadataChanges\n );\n }\n\n const includeMetadataChanges = !!(\n options && options.includeMetadataChanges\n );\n\n if (includeMetadataChanges && this._snapshot.excludesMetadataChanges) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'To include metadata changes with your document changes, you must ' +\n 'also pass { includeMetadataChanges:true } to onSnapshot().'\n );\n }\n\n if (\n !this._cachedChanges ||\n this._cachedChangesIncludeMetadataChanges !== includeMetadataChanges\n ) {\n this._cachedChanges = changesFromSnapshot<T>(\n this._firestore,\n includeMetadataChanges,\n this._snapshot,\n this._converter\n );\n this._cachedChangesIncludeMetadataChanges = includeMetadataChanges;\n }\n\n return this._cachedChanges;\n }\n\n /** Check the equality. The call can be very expensive. */\n isEqual(other: firestore.QuerySnapshot<T>): boolean {\n if (!(other instanceof QuerySnapshot)) {\n throw invalidClassError('isEqual', 'QuerySnapshot', 1, other);\n }\n\n return (\n this._firestore === other._firestore &&\n this._originalQuery.isEqual(other._originalQuery) &&\n this._snapshot.isEqual(other._snapshot) &&\n this._converter === other._converter\n );\n }\n\n private convertToDocumentImpl(doc: Document): QueryDocumentSnapshot<T> {\n return new QueryDocumentSnapshot(\n this._firestore,\n doc.key,\n doc,\n this.metadata.fromCache,\n this._snapshot.mutatedKeys.has(doc.key),\n this._converter\n );\n }\n}\n\n// TODO(2018/11/01): As of 2018/04/17 we're changing docChanges from an array\n// into a method. Because this is a runtime breaking change and somewhat subtle\n// (both Array and Function have a .length, etc.), we'll replace commonly-used\n// properties (including Symbol.iterator) to throw a custom error message. In\n// ~6 months we can delete the custom error as most folks will have hopefully\n// migrated.\nfunction throwDocChangesMethodError(): never {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'QuerySnapshot.docChanges has been changed from a property into a ' +\n 'method, so usages like \"querySnapshot.docChanges\" should become ' +\n '\"querySnapshot.docChanges()\"'\n );\n}\n\nconst docChangesPropertiesToOverride = [\n 'length',\n 'forEach',\n 'map',\n ...(typeof Symbol !== 'undefined' ? [Symbol.iterator] : [])\n];\ndocChangesPropertiesToOverride.forEach(property => {\n /**\n * We are (re-)defining properties on QuerySnapshot.prototype.docChanges which\n * is a Function. This could fail, in particular in the case of 'length' which\n * already exists on Function.prototype and on IE11 is improperly defined with\n * `{ configurable: false }`. So we wrap this in a try/catch to ensure that we\n * still have a functional SDK.\n */\n try {\n Object.defineProperty(QuerySnapshot.prototype.docChanges, property, {\n get: () => throwDocChangesMethodError()\n });\n } catch (err) {} // Ignore this failure intentionally\n});\n\nexport class CollectionReference<T = firestore.DocumentData> extends Query<T>\n implements firestore.CollectionReference<T> {\n constructor(\n readonly _path: ResourcePath,\n firestore: Firestore,\n _converter?: firestore.FirestoreDataConverter<T>\n ) {\n super(InternalQuery.atPath(_path), firestore, _converter);\n if (_path.length % 2 !== 1) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Invalid collection reference. Collection ' +\n 'references must have an odd number of segments, but ' +\n `${_path.canonicalString()} has ${_path.length}`\n );\n }\n }\n\n get id(): string {\n return this._query.path.lastSegment();\n }\n\n get parent(): firestore.DocumentReference<firestore.DocumentData> | null {\n const parentPath = this._query.path.popLast();\n if (parentPath.isEmpty()) {\n return null;\n } else {\n return new DocumentReference<firestore.DocumentData>(\n new DocumentKey(parentPath),\n this.firestore\n );\n }\n }\n\n get path(): string {\n return this._query.path.canonicalString();\n }\n\n doc(pathString?: string): firestore.DocumentReference<T> {\n validateBetweenNumberOfArgs('CollectionReference.doc', arguments, 0, 1);\n // We allow omission of 'pathString' but explicitly prohibit passing in both\n // 'undefined' and 'null'.\n if (arguments.length === 0) {\n pathString = AutoId.newId();\n }\n validateArgType(\n 'CollectionReference.doc',\n 'non-empty string',\n 1,\n pathString\n );\n if (pathString === '') {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Document path must be a non-empty string'\n );\n }\n const path = ResourcePath.fromString(pathString!);\n return DocumentReference.forPath<T>(\n this._query.path.child(path),\n this.firestore,\n this._converter\n );\n }\n\n add(value: T): Promise<firestore.DocumentReference<T>> {\n validateExactNumberOfArgs('CollectionReference.add', arguments, 1);\n validateArgType('CollectionReference.add', 'object', 1, value);\n const docRef = this.doc();\n return docRef.set(value).then(() => docRef);\n }\n\n withConverter<U>(\n converter: firestore.FirestoreDataConverter<U>\n ): firestore.CollectionReference<U> {\n return new CollectionReference<U>(this._path, this.firestore, converter);\n }\n}\n\nfunction validateSetOptions(\n methodName: string,\n options: firestore.SetOptions | undefined\n): firestore.SetOptions {\n if (options === undefined) {\n return {\n merge: false\n };\n }\n\n validateOptionNames(methodName, options, ['merge', 'mergeFields']);\n validateNamedOptionalType(methodName, 'boolean', 'merge', options.merge);\n validateOptionalArrayElements(\n methodName,\n 'mergeFields',\n 'a string or a FieldPath',\n options.mergeFields,\n element =>\n typeof element === 'string' || element instanceof ExternalFieldPath\n );\n\n if (options.mergeFields !== undefined && options.merge !== undefined) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n `Invalid options passed to function ${methodName}(): You cannot specify both \"merge\" ` +\n `and \"mergeFields\".`\n );\n }\n\n return options;\n}\n\nfunction validateSnapshotOptions(\n methodName: string,\n options: firestore.SnapshotOptions | undefined\n): firestore.SnapshotOptions {\n if (options === undefined) {\n return {};\n }\n\n validateOptionNames(methodName, options, ['serverTimestamps']);\n validateNamedOptionalPropertyEquals(\n methodName,\n 'options',\n 'serverTimestamps',\n options.serverTimestamps,\n ['estimate', 'previous', 'none']\n );\n return options;\n}\n\nfunction validateGetOptions(\n methodName: string,\n options: firestore.GetOptions | undefined\n): void {\n validateOptionalArgType(methodName, 'object', 1, options);\n if (options) {\n validateOptionNames(methodName, options, ['source']);\n validateNamedOptionalPropertyEquals(\n methodName,\n 'options',\n 'source',\n options.source,\n ['default', 'server', 'cache']\n );\n }\n}\n\nfunction validateReference<T>(\n methodName: string,\n documentRef: firestore.DocumentReference<T>,\n firestore: Firestore\n): DocumentReference<T> {\n if (!(documentRef instanceof DocumentReference)) {\n throw invalidClassError(methodName, 'DocumentReference', 1, documentRef);\n } else if (documentRef.firestore !== firestore) {\n throw new FirestoreError(\n Code.INVALID_ARGUMENT,\n 'Provided document reference is from a different Firestore instance.'\n );\n } else {\n return documentRef;\n }\n}\n\n/**\n * Calculates the array of firestore.DocumentChange's for a given ViewSnapshot.\n *\n * Exported for testing.\n */\nexport function changesFromSnapshot<T>(\n firestore: Firestore,\n includeMetadataChanges: boolean,\n snapshot: ViewSnapshot,\n converter?: firestore.FirestoreDataConverter<T>\n): Array<firestore.DocumentChange<T>> {\n if (snapshot.oldDocs.isEmpty()) {\n // Special case the first snapshot because index calculation is easy and\n // fast\n let lastDoc: Document;\n let index = 0;\n return snapshot.docChanges.map(change => {\n const doc = new QueryDocumentSnapshot<T>(\n firestore,\n change.doc.key,\n change.doc,\n snapshot.fromCache,\n snapshot.mutatedKeys.has(change.doc.key),\n converter\n );\n assert(\n change.type === ChangeType.Added,\n 'Invalid event type for first snapshot'\n );\n assert(\n !lastDoc || snapshot.query.docComparator(lastDoc, change.doc) < 0,\n 'Got added events in wrong order'\n );\n lastDoc = change.doc;\n return {\n type: 'added' as firestore.DocumentChangeType,\n doc,\n oldIndex: -1,\n newIndex: index++\n };\n });\n } else {\n // A DocumentSet that is updated incrementally as changes are applied to use\n // to lookup the index of a document.\n let indexTracker = snapshot.oldDocs;\n return snapshot.docChanges\n .filter(\n change => includeMetadataChanges || change.type !== ChangeType.Metadata\n )\n .map(change => {\n const doc = new QueryDocumentSnapshot<T>(\n firestore,\n change.doc.key,\n change.doc,\n snapshot.fromCache,\n snapshot.mutatedKeys.has(change.doc.key),\n converter\n );\n let oldIndex = -1;\n let newIndex = -1;\n if (change.type !== ChangeType.Added) {\n oldIndex = indexTracker.indexOf(change.doc.key);\n assert(oldIndex >= 0, 'Index for document not found');\n indexTracker = indexTracker.delete(change.doc.key);\n }\n if (change.type !== ChangeType.Removed) {\n indexTracker = indexTracker.add(change.doc);\n newIndex = indexTracker.indexOf(change.doc.key);\n }\n return { type: resultChangeType(change.type), doc, oldIndex, newIndex };\n });\n }\n}\n\nfunction resultChangeType(type: ChangeType): firestore.DocumentChangeType {\n switch (type) {\n case ChangeType.Added:\n return 'added';\n case ChangeType.Modified:\n case ChangeType.Metadata:\n return 'modified';\n case ChangeType.Removed:\n return 'removed';\n default:\n return fail('Unknown change type: ' + type);\n }\n}\n\n/**\n * Converts custom model object of type T into DocumentData by applying the\n * converter if it exists.\n *\n * This function is used when converting user objects to DocumentData\n * because we want to provide the user with a more specific error message if\n * their set() or fails due to invalid data originating from a toFirestore()\n * call.\n */\nfunction applyFirestoreDataConverter<T>(\n converter: firestore.FirestoreDataConverter<T> | undefined,\n value: T,\n functionName: string\n): [firestore.DocumentData, string] {\n let convertedValue;\n if (converter) {\n convertedValue = converter.toFirestore(value);\n functionName = 'toFirestore() in ' + functionName;\n } else {\n convertedValue = value as firestore.DocumentData;\n }\n return [convertedValue, functionName];\n}\n\n// Export the classes with a private constructor (it will fail if invoked\n// at runtime). Note that this still allows instanceof checks.\n\n// We're treating the variables as class names, so disable checking for lower\n// case variable names.\nexport const PublicFirestore = makeConstructorPrivate(\n Firestore,\n 'Use firebase.firestore() instead.'\n);\nexport const PublicTransaction = makeConstructorPrivate(\n Transaction,\n 'Use firebase.firestore().runTransaction() instead.'\n);\nexport const PublicWriteBatch = makeConstructorPrivate(\n WriteBatch,\n 'Use firebase.firestore().batch() instead.'\n);\nexport const PublicDocumentReference = makeConstructorPrivate(\n DocumentReference,\n 'Use firebase.firestore().doc() instead.'\n);\nexport const PublicDocumentSnapshot = makeConstructorPrivate(DocumentSnapshot);\nexport const PublicQueryDocumentSnapshot = makeConstructorPrivate(\n QueryDocumentSnapshot\n);\nexport const PublicQuery = makeConstructorPrivate(Query);\nexport const PublicQuerySnapshot = makeConstructorPrivate(QuerySnapshot);\nexport const PublicCollectionReference = makeConstructorPrivate(\n CollectionReference,\n 'Use firebase.firestore().collection() instead.'\n);\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { FirebaseNamespace } from '@firebase/app-types';\nimport { _FirebaseNamespace } from '@firebase/app-types/private';\nimport { PublicBlob } from '../api/blob';\nimport {\n CACHE_SIZE_UNLIMITED,\n Firestore,\n PublicCollectionReference,\n PublicDocumentReference,\n PublicDocumentSnapshot,\n PublicFirestore,\n PublicQuery,\n PublicQueryDocumentSnapshot,\n PublicQuerySnapshot,\n PublicTransaction,\n PublicWriteBatch\n} from '../api/database';\nimport { FieldPath } from '../api/field_path';\nimport { PublicFieldValue } from '../api/field_value';\nimport { GeoPoint } from '../api/geo_point';\nimport { Timestamp } from '../api/timestamp';\nimport { shallowCopy } from '../util/obj';\nimport { Component, ComponentType } from '@firebase/component';\n\nconst firestoreNamespace = {\n Firestore: PublicFirestore,\n GeoPoint,\n Timestamp,\n Blob: PublicBlob,\n Transaction: PublicTransaction,\n WriteBatch: PublicWriteBatch,\n DocumentReference: PublicDocumentReference,\n DocumentSnapshot: PublicDocumentSnapshot,\n Query: PublicQuery,\n QueryDocumentSnapshot: PublicQueryDocumentSnapshot,\n QuerySnapshot: PublicQuerySnapshot,\n CollectionReference: PublicCollectionReference,\n FieldPath,\n FieldValue: PublicFieldValue,\n setLogLevel: Firestore.setLogLevel,\n CACHE_SIZE_UNLIMITED\n};\n\n/**\n * Configures Firestore as part of the Firebase SDK by calling registerService.\n */\nexport function configureForFirebase(firebase: FirebaseNamespace): void {\n (firebase as _FirebaseNamespace).INTERNAL.registerComponent(\n new Component(\n 'firestore',\n container => {\n const app = container.getProvider('app').getImmediate()!;\n return new Firestore(app, container.getProvider('auth-internal'));\n },\n ComponentType.PUBLIC\n ).setServiceProps(shallowCopy(firestoreNamespace))\n );\n}\n\n/**\n * Exports the Firestore namespace into the provided `exportObject` object under\n * the key 'firestore'. This is used for wrapped binary that exposes Firestore\n * as a goog module.\n */\nexport function configureForStandalone(exportObject: {\n [key: string]: {};\n}): void {\n const copiedNamespace = shallowCopy(firestoreNamespace);\n // Unlike the use with Firebase, the standalone allows the use of the\n // constructor, so export it's internal class\n copiedNamespace['Firestore'] = Firestore;\n exportObject['firestore'] = copiedNamespace;\n}\n","/**\n * @license\n * Copyright 2019 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ConnectivityMonitor, NetworkStatus } from './connectivity_monitor';\n\nexport class NoopConnectivityMonitor implements ConnectivityMonitor {\n addCallback(callback: (status: NetworkStatus) => void): void {\n // No-op.\n }\n\n shutdown(): void {\n // No-op.\n }\n}\n","/**\n * @license\n * Copyright 2019 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { debug } from '../util/log';\nimport {\n ConnectivityMonitor,\n ConnectivityMonitorCallback,\n NetworkStatus\n} from './../remote/connectivity_monitor';\n\nconst LOG_TAG = 'ConnectivityMonitor';\n\n/**\n * Browser implementation of ConnectivityMonitor.\n */\nexport class BrowserConnectivityMonitor implements ConnectivityMonitor {\n private readonly networkAvailableListener = (): void =>\n this.onNetworkAvailable();\n private readonly networkUnavailableListener = (): void =>\n this.onNetworkUnavailable();\n private callbacks: ConnectivityMonitorCallback[] = [];\n\n constructor() {\n this.configureNetworkMonitoring();\n }\n\n addCallback(callback: (status: NetworkStatus) => void): void {\n this.callbacks.push(callback);\n }\n\n shutdown(): void {\n window.removeEventListener('online', this.networkAvailableListener);\n window.removeEventListener('offline', this.networkUnavailableListener);\n }\n\n private configureNetworkMonitoring(): void {\n window.addEventListener('online', this.networkAvailableListener);\n window.addEventListener('offline', this.networkUnavailableListener);\n }\n\n private onNetworkAvailable(): void {\n debug(LOG_TAG, 'Network connectivity changed: AVAILABLE');\n for (const callback of this.callbacks) {\n callback(NetworkStatus.AVAILABLE);\n }\n }\n\n private onNetworkUnavailable(): void {\n debug(LOG_TAG, 'Network connectivity changed: UNAVAILABLE');\n for (const callback of this.callbacks) {\n callback(NetworkStatus.UNAVAILABLE);\n }\n }\n\n // TODO(chenbrian): Consider passing in window either into this component or\n // here for testing via FakeWindow.\n /** Checks that all used attributes of window are available. */\n static isAvailable(): boolean {\n return (\n typeof window !== 'undefined' &&\n window.addEventListener !== undefined &&\n window.removeEventListener !== undefined\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { assert } from '../util/assert';\nimport { FirestoreError } from '../util/error';\n\nimport { Stream } from './connection';\n\n/**\n * Provides a simple helper class that implements the Stream interface to\n * bridge to other implementations that are streams but do not implement the\n * interface. The stream callbacks are invoked with the callOn... methods.\n */\nexport class StreamBridge<I, O> implements Stream<I, O> {\n private wrappedOnOpen: (() => void) | undefined;\n private wrappedOnClose: ((err?: FirestoreError) => void) | undefined;\n private wrappedOnMessage: ((msg: O) => void) | undefined;\n\n private sendFn: (msg: I) => void;\n private closeFn: () => void;\n\n constructor(args: { sendFn: (msg: I) => void; closeFn: () => void }) {\n this.sendFn = args.sendFn;\n this.closeFn = args.closeFn;\n }\n\n onOpen(callback: () => void): void {\n assert(!this.wrappedOnOpen, 'Called onOpen on stream twice!');\n this.wrappedOnOpen = callback;\n }\n\n onClose(callback: (err?: FirestoreError) => void): void {\n assert(!this.wrappedOnClose, 'Called onClose on stream twice!');\n this.wrappedOnClose = callback;\n }\n\n onMessage(callback: (msg: O) => void): void {\n assert(!this.wrappedOnMessage, 'Called onMessage on stream twice!');\n this.wrappedOnMessage = callback;\n }\n\n close(): void {\n this.closeFn();\n }\n\n send(msg: I): void {\n this.sendFn(msg);\n }\n\n callOnOpen(): void {\n assert(\n this.wrappedOnOpen !== undefined,\n 'Cannot call onOpen because no callback was set'\n );\n this.wrappedOnOpen();\n }\n\n callOnClose(err?: FirestoreError): void {\n assert(\n this.wrappedOnClose !== undefined,\n 'Cannot call onClose because no callback was set'\n );\n this.wrappedOnClose(err);\n }\n\n callOnMessage(msg: O): void {\n assert(\n this.wrappedOnMessage !== undefined,\n 'Cannot call onMessage because no callback was set'\n );\n this.wrappedOnMessage(msg);\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n createWebChannelTransport,\n ErrorCode,\n EventType,\n WebChannel,\n WebChannelError,\n WebChannelOptions,\n XhrIo\n} from '@firebase/webchannel-wrapper';\n\nimport {\n isBrowserExtension,\n isElectron,\n isIE,\n isReactNative,\n isUWP\n} from '@firebase/util';\n\nimport { Token } from '../api/credentials';\nimport { DatabaseId, DatabaseInfo } from '../core/database_info';\nimport { SDK_VERSION } from '../core/version';\nimport { Connection, Stream } from '../remote/connection';\nimport {\n mapCodeFromRpcStatus,\n mapCodeFromHttpResponseErrorStatus\n} from '../remote/rpc_error';\nimport { StreamBridge } from '../remote/stream_bridge';\nimport { assert, fail } from '../util/assert';\nimport { Code, FirestoreError } from '../util/error';\nimport * as log from '../util/log';\nimport { Indexable } from '../util/misc';\nimport { Rejecter, Resolver } from '../util/promise';\nimport { StringMap } from '../util/types';\n\nconst LOG_TAG = 'Connection';\n\nconst RPC_STREAM_SERVICE = 'google.firestore.v1.Firestore';\nconst RPC_URL_VERSION = 'v1';\n\n/**\n * Maps RPC names to the corresponding REST endpoint name.\n * Uses Object Literal notation to avoid renaming.\n */\nconst RPC_NAME_REST_MAPPING: { [key: string]: string } = {};\nRPC_NAME_REST_MAPPING['BatchGetDocuments'] = 'batchGet';\nRPC_NAME_REST_MAPPING['Commit'] = 'commit';\n\n// TODO(b/38203344): The SDK_VERSION is set independently from Firebase because\n// we are doing out-of-band releases. Once we release as part of Firebase, we\n// should use the Firebase version instead.\nconst X_GOOG_API_CLIENT_VALUE = 'gl-js/ fire/' + SDK_VERSION;\n\nconst XHR_TIMEOUT_SECS = 15;\n\nexport class WebChannelConnection implements Connection {\n private readonly databaseId: DatabaseId;\n private readonly baseUrl: string;\n private readonly forceLongPolling: boolean;\n\n constructor(info: DatabaseInfo) {\n this.databaseId = info.databaseId;\n const proto = info.ssl ? 'https' : 'http';\n this.baseUrl = proto + '://' + info.host;\n this.forceLongPolling = info.forceLongPolling;\n }\n\n /**\n * Modifies the headers for a request, adding any authorization token if\n * present and any additional headers for the request.\n */\n private modifyHeadersForRequest(\n headers: StringMap,\n token: Token | null\n ): void {\n if (token) {\n for (const header in token.authHeaders) {\n if (token.authHeaders.hasOwnProperty(header)) {\n headers[header] = token.authHeaders[header];\n }\n }\n }\n headers['X-Goog-Api-Client'] = X_GOOG_API_CLIENT_VALUE;\n }\n\n invokeRPC<Req, Resp>(\n rpcName: string,\n request: Req,\n token: Token | null\n ): Promise<Resp> {\n const url = this.makeUrl(rpcName);\n\n return new Promise((resolve: Resolver<Resp>, reject: Rejecter) => {\n const xhr = new XhrIo();\n xhr.listenOnce(EventType.COMPLETE, () => {\n try {\n switch (xhr.getLastErrorCode()) {\n case ErrorCode.NO_ERROR:\n const json = xhr.getResponseJson() as Resp;\n log.debug(LOG_TAG, 'XHR received:', JSON.stringify(json));\n resolve(json);\n break;\n case ErrorCode.TIMEOUT:\n log.debug(LOG_TAG, 'RPC \"' + rpcName + '\" timed out');\n reject(\n new FirestoreError(Code.DEADLINE_EXCEEDED, 'Request time out')\n );\n break;\n case ErrorCode.HTTP_ERROR:\n const status = xhr.getStatus();\n log.debug(\n LOG_TAG,\n 'RPC \"' + rpcName + '\" failed with status:',\n status,\n 'response text:',\n xhr.getResponseText()\n );\n if (status > 0) {\n const responseError = (xhr.getResponseJson() as WebChannelError)\n .error;\n if (\n !!responseError &&\n !!responseError.status &&\n !!responseError.message\n ) {\n const firestoreErrorCode = mapCodeFromHttpResponseErrorStatus(\n responseError.status\n );\n reject(\n new FirestoreError(\n firestoreErrorCode,\n responseError.message\n )\n );\n } else {\n reject(\n new FirestoreError(\n Code.UNKNOWN,\n 'Server responded with status ' + xhr.getStatus()\n )\n );\n }\n } else {\n // If we received an HTTP_ERROR but there's no status code,\n // it's most probably a connection issue\n log.debug(LOG_TAG, 'RPC \"' + rpcName + '\" failed');\n reject(\n new FirestoreError(Code.UNAVAILABLE, 'Connection failed.')\n );\n }\n break;\n default:\n fail(\n 'RPC \"' +\n rpcName +\n '\" failed with unanticipated ' +\n 'webchannel error ' +\n xhr.getLastErrorCode() +\n ': ' +\n xhr.getLastError() +\n ', giving up.'\n );\n }\n } finally {\n log.debug(LOG_TAG, 'RPC \"' + rpcName + '\" completed.');\n }\n });\n\n // The database field is already encoded in URL. Specifying it again in\n // the body is not necessary in production, and will cause duplicate field\n // errors in the Firestore Emulator. Let's remove it.\n const jsonObj = ({ ...request } as unknown) as Indexable;\n delete jsonObj.database;\n\n const requestString = JSON.stringify(jsonObj);\n log.debug(LOG_TAG, 'XHR sending: ', url + ' ' + requestString);\n // Content-Type: text/plain will avoid preflight requests which might\n // mess with CORS and redirects by proxies. If we add custom headers\n // we will need to change this code to potentially use the\n // $httpOverwrite parameter supported by ESF to avoid\n // triggering preflight requests.\n const headers: StringMap = { 'Content-Type': 'text/plain' };\n\n this.modifyHeadersForRequest(headers, token);\n\n xhr.send(url, 'POST', requestString, headers, XHR_TIMEOUT_SECS);\n });\n }\n\n invokeStreamingRPC<Req, Resp>(\n rpcName: string,\n request: Req,\n token: Token | null\n ): Promise<Resp[]> {\n // The REST API automatically aggregates all of the streamed results, so we\n // can just use the normal invoke() method.\n return this.invokeRPC<Req, Resp[]>(rpcName, request, token);\n }\n\n openStream<Req, Resp>(\n rpcName: string,\n token: Token | null\n ): Stream<Req, Resp> {\n const urlParts = [\n this.baseUrl,\n '/',\n RPC_STREAM_SERVICE,\n '/',\n rpcName,\n '/channel'\n ];\n const webchannelTransport = createWebChannelTransport();\n const request: WebChannelOptions = {\n // Background channel test avoids the initial two test calls and decreases\n // initial cold start time.\n // TODO(dimond): wenboz@ mentioned this might affect use with proxies and\n // we should monitor closely for any reports.\n backgroundChannelTest: true,\n // Required for backend stickiness, routing behavior is based on this\n // parameter.\n httpSessionIdParam: 'gsessionid',\n initMessageHeaders: {},\n messageUrlParams: {\n // This param is used to improve routing and project isolation by the\n // backend and must be included in every request.\n database: `projects/${this.databaseId.projectId}/databases/${this.databaseId.database}`\n },\n sendRawJson: true,\n supportsCrossDomainXhr: true,\n internalChannelParams: {\n // Override the default timeout (randomized between 10-20 seconds) since\n // a large write batch on a slow internet connection may take a long\n // time to send to the backend. Rather than have WebChannel impose a\n // tight timeout which could lead to infinite timeouts and retries, we\n // set it very large (5-10 minutes) and rely on the browser's builtin\n // timeouts to kick in if the request isn't working.\n forwardChannelRequestTimeoutMs: 10 * 60 * 1000\n },\n forceLongPolling: this.forceLongPolling\n };\n\n this.modifyHeadersForRequest(request.initMessageHeaders!, token);\n\n // Sending the custom headers we just added to request.initMessageHeaders\n // (Authorization, etc.) will trigger the browser to make a CORS preflight\n // request because the XHR will no longer meet the criteria for a \"simple\"\n // CORS request:\n // https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#Simple_requests\n //\n // Therefore to avoid the CORS preflight request (an extra network\n // roundtrip), we use the httpHeadersOverwriteParam option to specify that\n // the headers should instead be encoded into a special \"$httpHeaders\" query\n // parameter, which is recognized by the webchannel backend. This is\n // formally defined here:\n // https://github.com/google/closure-library/blob/b0e1815b13fb92a46d7c9b3c30de5d6a396a3245/closure/goog/net/rpc/httpcors.js#L32\n //\n // TODO(b/145624756): There is a backend bug where $httpHeaders isn't respected if the request\n // doesn't have an Origin header. So we have to exclude a few browser environments that are\n // known to (sometimes) not include an Origin. See\n // https://github.com/firebase/firebase-js-sdk/issues/1491.\n if (\n !isReactNative() &&\n !isElectron() &&\n !isIE() &&\n !isUWP() &&\n !isBrowserExtension()\n ) {\n request.httpHeadersOverwriteParam = '$httpHeaders';\n }\n\n const url = urlParts.join('');\n log.debug(LOG_TAG, 'Creating WebChannel: ' + url + ' ' + request);\n const channel = webchannelTransport.createWebChannel(url, request);\n\n // WebChannel supports sending the first message with the handshake - saving\n // a network round trip. However, it will have to call send in the same\n // JS event loop as open. In order to enforce this, we delay actually\n // opening the WebChannel until send is called. Whether we have called\n // open is tracked with this variable.\n let opened = false;\n\n // A flag to determine whether the stream was closed (by us or through an\n // error/close event) to avoid delivering multiple close events or sending\n // on a closed stream\n let closed = false;\n\n const streamBridge = new StreamBridge<Req, Resp>({\n sendFn: (msg: Req) => {\n if (!closed) {\n if (!opened) {\n log.debug(LOG_TAG, 'Opening WebChannel transport.');\n channel.open();\n opened = true;\n }\n log.debug(LOG_TAG, 'WebChannel sending:', msg);\n channel.send(msg);\n } else {\n log.debug(LOG_TAG, 'Not sending because WebChannel is closed:', msg);\n }\n },\n closeFn: () => channel.close()\n });\n\n // Closure events are guarded and exceptions are swallowed, so catch any\n // exception and rethrow using a setTimeout so they become visible again.\n // Note that eventually this function could go away if we are confident\n // enough the code is exception free.\n const unguardedEventListen = <T>(\n type: string,\n fn: (param?: T) => void\n ): void => {\n // TODO(dimond): closure typing seems broken because WebChannel does\n // not implement goog.events.Listenable\n channel.listen(type, (param: unknown) => {\n try {\n fn(param as T);\n } catch (e) {\n setTimeout(() => {\n throw e;\n }, 0);\n }\n });\n };\n\n unguardedEventListen(WebChannel.EventType.OPEN, () => {\n if (!closed) {\n log.debug(LOG_TAG, 'WebChannel transport opened.');\n }\n });\n\n unguardedEventListen(WebChannel.EventType.CLOSE, () => {\n if (!closed) {\n closed = true;\n log.debug(LOG_TAG, 'WebChannel transport closed');\n streamBridge.callOnClose();\n }\n });\n\n unguardedEventListen<Error>(WebChannel.EventType.ERROR, err => {\n if (!closed) {\n closed = true;\n log.debug(LOG_TAG, 'WebChannel transport errored:', err);\n streamBridge.callOnClose(\n new FirestoreError(\n Code.UNAVAILABLE,\n 'The operation could not be completed'\n )\n );\n }\n });\n\n // WebChannel delivers message events as array. If batching is not enabled\n // (it's off by default) each message will be delivered alone, resulting in\n // a single element array.\n interface WebChannelResponse {\n data: Resp[];\n }\n\n unguardedEventListen<WebChannelResponse>(\n WebChannel.EventType.MESSAGE,\n msg => {\n if (!closed) {\n const msgData = msg!.data[0];\n assert(!!msgData, 'Got a webchannel message without data.');\n // TODO(b/35143891): There is a bug in One Platform that caused errors\n // (and only errors) to be wrapped in an extra array. To be forward\n // compatible with the bug we need to check either condition. The latter\n // can be removed once the fix has been rolled out.\n // Use any because msgData.error is not typed.\n const msgDataOrError: WebChannelError | object = msgData;\n const error =\n msgDataOrError.error ||\n (msgDataOrError as WebChannelError[])[0]?.error;\n if (error) {\n log.debug(LOG_TAG, 'WebChannel received error:', error);\n // error.status will be a string like 'OK' or 'NOT_FOUND'.\n const status: string = error.status;\n let code = mapCodeFromRpcStatus(status);\n let message = error.message;\n if (code === undefined) {\n code = Code.INTERNAL;\n message =\n 'Unknown error status: ' +\n status +\n ' with message ' +\n error.message;\n }\n // Mark closed so no further events are propagated\n closed = true;\n streamBridge.callOnClose(new FirestoreError(code, message));\n channel.close();\n } else {\n log.debug(LOG_TAG, 'WebChannel received:', msgData);\n streamBridge.callOnMessage(msgData);\n }\n }\n }\n );\n\n setTimeout(() => {\n // Technically we could/should wait for the WebChannel opened event,\n // but because we want to send the first message with the WebChannel\n // handshake we pretend the channel opened here (asynchronously), and\n // then delay the actual open until the first message is sent.\n streamBridge.callOnOpen();\n }, 0);\n return streamBridge;\n }\n\n // visible for testing\n makeUrl(rpcName: string): string {\n const urlRpcName = RPC_NAME_REST_MAPPING[rpcName];\n assert(urlRpcName !== undefined, 'Unknown REST mapping for: ' + rpcName);\n return (\n this.baseUrl +\n '/' +\n RPC_URL_VERSION +\n '/projects/' +\n this.databaseId.projectId +\n '/databases/' +\n this.databaseId.database +\n '/documents:' +\n urlRpcName\n );\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { DatabaseId, DatabaseInfo } from '../core/database_info';\nimport { Platform } from '../platform/platform';\nimport { Connection } from '../remote/connection';\nimport { JsonProtoSerializer } from '../remote/serializer';\nimport { ConnectivityMonitor } from './../remote/connectivity_monitor';\n\nimport { NoopConnectivityMonitor } from '../remote/connectivity_monitor_noop';\nimport { BrowserConnectivityMonitor } from './browser_connectivity_monitor';\nimport { WebChannelConnection } from './webchannel_connection';\n\nexport class BrowserPlatform implements Platform {\n readonly base64Available: boolean;\n\n readonly emptyByteString = '';\n\n constructor() {\n this.base64Available = typeof atob !== 'undefined';\n }\n\n get document(): Document | null {\n return typeof document !== 'undefined' ? document : null;\n }\n\n get window(): Window | null {\n return typeof window !== 'undefined' ? window : null;\n }\n\n loadConnection(databaseInfo: DatabaseInfo): Promise<Connection> {\n return Promise.resolve(new WebChannelConnection(databaseInfo));\n }\n\n newConnectivityMonitor(): ConnectivityMonitor {\n if (BrowserConnectivityMonitor.isAvailable()) {\n return new BrowserConnectivityMonitor();\n } else {\n return new NoopConnectivityMonitor();\n }\n }\n\n newSerializer(databaseId: DatabaseId): JsonProtoSerializer {\n return new JsonProtoSerializer(databaseId, { useProto3Json: true });\n }\n\n formatJSON(value: unknown): string {\n return JSON.stringify(value);\n }\n\n atob(encoded: string): string {\n return atob(encoded);\n }\n\n btoa(raw: string): string {\n return btoa(raw);\n }\n}\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { PlatformSupport } from '../platform/platform';\nimport { BrowserPlatform } from './browser_platform';\n\n/**\n * This code needs to run before Firestore is used. This can be achieved in\n * several ways:\n * 1) Through the JSCompiler compiling this code and then (automatically)\n * executing it before exporting the Firestore symbols.\n * 2) Through importing this module first in a Firestore main module\n */\nPlatformSupport.setPlatform(new BrowserPlatform());\n","/**\n * @license\n * Copyright 2017 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport firebase from '@firebase/app';\nimport { configureForFirebase } from './src/platform/config';\nimport './src/platform_browser/browser_init';\n\nimport * as types from '@firebase/firestore-types';\nimport { FirebaseNamespace } from '@firebase/app-types';\n\nimport { name, version } from './package.json';\n\nexport function registerFirestore(instance: FirebaseNamespace): void {\n configureForFirebase(instance);\n instance.registerVersion(name, version);\n}\n\nregisterFirestore(firebase);\n\ndeclare module '@firebase/app-types' {\n interface FirebaseNamespace {\n firestore?: {\n (app?: FirebaseApp): types.FirebaseFirestore;\n Blob: typeof types.Blob;\n CollectionReference: typeof types.CollectionReference;\n DocumentReference: typeof types.DocumentReference;\n DocumentSnapshot: typeof types.DocumentSnapshot;\n FieldPath: typeof types.FieldPath;\n FieldValue: typeof types.FieldValue;\n Firestore: typeof types.FirebaseFirestore;\n GeoPoint: typeof types.GeoPoint;\n Query: typeof types.Query;\n QueryDocumentSnapshot: typeof types.QueryDocumentSnapshot;\n QuerySnapshot: typeof types.QuerySnapshot;\n Timestamp: typeof types.Timestamp;\n Transaction: typeof types.Transaction;\n WriteBatch: typeof types.WriteBatch;\n setLogLevel: typeof types.setLogLevel;\n };\n }\n interface FirebaseApp {\n firestore?(): types.FirebaseFirestore;\n }\n}\n"],"names":["LogLevel","SDK_VERSION","firebase","__PRIVATE_logClient","Logger","logLevel","__PRIVATE_FirebaseLogLevel","DEBUG","SILENT","ERROR","setLogLevel","__PRIVATE_newLevel","error","debug","tag","msg","_i","obj","args","map","platform","__PRIVATE_PlatformSupport","e","fail","__PRIVATE_failure","message","Error","assert","__PRIVATE_assertion","__PRIVATE_chars","__PRIVATE_autoId","__PRIVATE_i","charAt","Math","floor","random","length","left","right","isEqual","s","__PRIVATE_databaseId","persistenceKey","host","ssl","forceLongPolling","this","__PRIVATE_DEFAULT_DATABASE_NAME","projectId","database","Object","__PRIVATE_DatabaseId","other","__PRIVATE_primitiveComparator","OnlineState","OnlineStateSource","uid","User","__PRIVATE_otherUser","Code","OK","CANCELLED","UNKNOWN","INVALID_ARGUMENT","DEADLINE_EXCEEDED","NOT_FOUND","ALREADY_EXISTS","PERMISSION_DENIED","UNAUTHENTICATED","RESOURCE_EXHAUSTED","FAILED_PRECONDITION","ABORTED","OUT_OF_RANGE","UNIMPLEMENTED","INTERNAL","UNAVAILABLE","DATA_LOSS","code","_super","_this","toString","name","__extends","value","user","__PRIVATE_EmptyCredentialsProvider","Promise","resolve","__PRIVATE_changeListener","__PRIVATE_authProvider","currentUser","auth","getImmediate","optional","addAuthTokenListener","get","then","__PRIVATE_FirebaseCredentialsProvider","__PRIVATE_initialTokenCounter","forceRefresh","getToken","__PRIVATE_tokenData","FirestoreError","accessToken","removeAuthTokenListener","__PRIVATE_currentUid","getUid","__PRIVATE_gapi","__PRIVATE_sessionIndex","headers","X-Goog-AuthUser","__PRIVATE_authHeader","__PRIVATE_FirstPartyCredentialsProvider","credentials","type","__PRIVATE_client","contains","key","prototype","hasOwnProperty","call","defaultValue","undefined","fn","num","Number","isNaN","forEach","functionName","__PRIVATE_formatPlural","__PRIVATE_numberOfArgs","__PRIVATE_minNumberOfArgs","__PRIVATE_maxNumberOfArgs","position","__PRIVATE_argument","__PRIVATE_validateType","__PRIVATE_ordinal","__PRIVATE_validateArgType","__PRIVATE_optionName","__PRIVATE_validateNamedType","__PRIVATE_typeDescription","__PRIVATE_validator","Array","__PRIVATE_valueDescription","__PRIVATE_validateArrayElements","__PRIVATE_inputName","input","__PRIVATE_expected","__PRIVATE_expectedDescription","val","push","__PRIVATE_actualDescription","join","__PRIVATE_validateNamedPropertyEquals","__PRIVATE_enums","some","element","__PRIVATE_isPlainObject","description","getPrototypeOf","substring","JSON","stringify","__PRIVATE_customObjectName","constructor","results","exec","__PRIVATE_tryGetCustomObjectType","options","__PRIVATE_optionNames","obj.forEach","__PRIVATE__","indexOf","n","str","latitude","longitude","__PRIVATE_validateExactNumberOfArgs","arguments","isFinite","GeoPoint","seconds","nanoseconds","Timestamp","fromMillis","Date","now","date","getTime","milliseconds","toMillis","timestamp","__PRIVATE_SnapshotVersion","MIN","segments","offset","__PRIVATE_BasePath","__PRIVATE_nameOrPath","slice","limit","__PRIVATE_segment","size","index","__PRIVATE_potentialChild","end","p1","p2","__PRIVATE_len","min","ResourcePath","path","split","filter","__PRIVATE_identifierRegExp","FieldPath","test","replace","__PRIVATE_current","__PRIVATE_addCurrentSegment","__PRIVATE_inBackticks","c","next","__PRIVATE_DocumentKey","collectionId","k1","k2","__PRIVATE_comparator","root","__PRIVATE_LLRBNode","EMPTY","__PRIVATE_SortedMap","remove","node","cmp","__PRIVATE_prunedNodes","action","k","v","__PRIVATE_descriptions","__PRIVATE_startKey","__PRIVATE_isReverse","pop","result","color","RED","__PRIVATE_smallest","__PRIVATE_nl","__PRIVATE_nr","__PRIVATE_blackDepth","pow","__PRIVATE_LLRBEmptyNode","data","keys","add","__PRIVATE_SortedSet","__PRIVATE_elem","cb","range","__PRIVATE_iter","start","has","__PRIVATE_thisIt","__PRIVATE_otherIt","__PRIVATE_thisElem","__PRIVATE_otherElem","__PRIVATE_res","targetId","previousValue","__PRIVATE_localWriteTime","__PRIVATE_transformResult","__PRIVATE_ServerTimestampTransform","elements","apply","__PRIVATE_ArrayUnionTransformOperation","__PRIVATE_coercedFieldValuesArray","find","_a","ArrayValue","__PRIVATE_misc.__PRIVATE_arrayEquals","__PRIVATE_ArrayRemoveTransformOperation","__PRIVATE_operand","__PRIVATE_baseValue","__PRIVATE_sum","__PRIVATE_NumericIncrementTransformOperation","fields","__PRIVATE_fieldsAsSet","fieldPath","found","__PRIVATE_fieldMaskPath","__PRIVATE_FieldMask","field","transform","FieldTransform","version","transformResults","MutationType","updateTime","exists","Precondition","__PRIVATE_maybeDoc","Document","__PRIVATE_precondition","__PRIVATE_MutationType","Set","__PRIVATE_mutationResult","hasCommittedMutations","__PRIVATE_baseDoc","__PRIVATE_Mutation","vn","__PRIVATE_SetMutation","__PRIVATE_fieldMask","__PRIVATE_newData","__PRIVATE_PatchMutation","__PRIVATE_ObjectValue","newValue","set","delete","fieldTransforms","doc","__PRIVATE_baseObject","__PRIVATE_existingValue","__PRIVATE_fieldTransform","__PRIVATE_coercedValue","__PRIVATE_TransformMutation","__PRIVATE_serverTransformResults","__PRIVATE_DeleteMutation","__PRIVATE_VerifyMutation","TypeOrder","ServerTimestampBehavior","__PRIVATE_serverTimestampBehavior","timestampsInSnapshots","serverTimestamps","__PRIVATE_ServerTimestampBehavior","FieldValue","__PRIVATE_TypeOrder","__PRIVATE_NullValue","__PRIVATE_internalValue","__PRIVATE_BooleanValue","__PRIVATE_NumberValue","__PRIVATE_IntegerValue","__PRIVATE_numericEquals","__PRIVATE_DoubleValue","NaN","Infinity","__PRIVATE_StringValue","__PRIVATE_TimestampValue","toDate","__PRIVATE_ServerTimestampValue","__PRIVATE_BlobValue","__PRIVATE_RefValue","__PRIVATE_GeoPointValue","__PRIVATE_it1","__PRIVATE_it2","__PRIVATE_next1","__PRIVATE_next2","to","child","newChild","__PRIVATE_pathSegment","__PRIVATE_currentPath","__PRIVATE_nestedFields","__PRIVATE_nestedPath","__PRIVATE_childName","minLength","reduce","__PRIVATE_totalSize","__PRIVATE_d1","__PRIVATE_d2","__PRIVATE_objectValue","proto","converter","Map","__PRIVATE_canonicalPath","__PRIVATE_fieldValue","__PRIVATE_protoValue","result_1","mapValue","v1","v2","__PRIVATE_NoDocument","__PRIVATE_UnknownDocument","__PRIVATE_NumberAsAny","MIN_SAFE_INTEGER","MAX_SAFE_INTEGER","isInteger","isSafeInteger","collectionGroup","orderBy","filters","startAt","endAt","Target","canonicalId","_c","_b","__PRIVATE_isNullOrUndefined","LimitType","__PRIVATE_explicitOrderBy","__PRIVATE_limitType","Query","__PRIVATE_inequalityField","__PRIVATE_firstOrderByField","__PRIVATE_foundKeyOrdering","__PRIVATE_lastDirection","dir","__PRIVATE_Direction","ASCENDING","FieldFilter","__PRIVATE_newFilters","concat","__PRIVATE_newOrderBy","__PRIVATE_LimitType","bound","__PRIVATE_comparedOnKeyField","__PRIVATE_comp","compare","__PRIVATE_operators","op","__PRIVATE_orderBys","DESCENDING","before","__PRIVATE_docPath","matches","__PRIVATE_Operator","LESS_THAN","LESS_THAN_OR_EQUAL","EQUAL","GREATER_THAN_OR_EQUAL","GREATER_THAN","ARRAY_CONTAINS","IN","ARRAY_CONTAINS_ANY","every","__PRIVATE_comparison","Filter","__PRIVATE_KeyFieldFilter","__PRIVATE_refValue","__PRIVATE_KeyFieldInFilter","__PRIVATE_ArrayContainsFilter","__PRIVATE_InFilter","arrayValue","__PRIVATE_ArrayContainsAnyFilter","__PRIVATE_lhsElem","__PRIVATE_Bound","__PRIVATE_orderByComponent","component","__PRIVATE_docValue","__PRIVATE_thisPosition","__PRIVATE_otherPosition","__PRIVATE_OrderBy","__PRIVATE_KEY_ORDERING_ASC","__PRIVATE_KEY_ORDERING_DESC","TargetPurpose","target","__PRIVATE_purpose","sequenceNumber","__PRIVATE_snapshotVersion","lastLimboFreeSnapshotVersion","resumeToken","__PRIVATE_TargetData","count","ExistenceFilter","log.error","__PRIVATE_RpcCode","RpcCode","__PRIVATE_EMPTY_MAYBE_DOCUMENT_MAP","__PRIVATE_maybeDocumentMap","__PRIVATE_EMPTY_DOCUMENT_MAP","__PRIVATE_EMPTY_DOCUMENT_VERSION_MAP","__PRIVATE_EMPTY_DOCUMENT_KEY_SET","keys_1","__PRIVATE_EMPTY_TARGET_ID_SET","__PRIVATE_documentMap","__PRIVATE_oldSet","__PRIVATE_DocumentSet","__PRIVATE_thisDoc","__PRIVATE_otherDoc","__PRIVATE_docStrings","__PRIVATE_keyedMap","__PRIVATE_sortedSet","__PRIVATE_newSet","ChangeType","SyncState","__PRIVATE_DocumentChangeSet","__PRIVATE_change","__PRIVATE_oldChange","__PRIVATE_ChangeType","__PRIVATE_changes","query","docs","__PRIVATE_oldDocs","docChanges","__PRIVATE_mutatedKeys","fromCache","__PRIVATE_syncStateChanged","__PRIVATE_excludesMetadataChanges","documents","__PRIVATE_ViewSnapshot","__PRIVATE_otherChanges","__PRIVATE_targetChanges","__PRIVATE_targetMismatches","__PRIVATE_documentUpdates","__PRIVATE_resolvedLimboDocuments","TargetChange","__PRIVATE_targetIdSet","__PRIVATE_documentKeySet","__PRIVATE_addedDocuments","__PRIVATE_modifiedDocuments","__PRIVATE_removedDocuments","__PRIVATE_emptyByteString","__PRIVATE_updatedTargetIds","removedTargetIds","__PRIVATE_newDoc","__PRIVATE_existenceFilter","WatchTargetChangeState","state","targetIds","cause","__PRIVATE_snapshotChangesMap","__PRIVATE_TargetState","__PRIVATE_changeType","__PRIVATE_metadataProvider","__PRIVATE_documentTargetMap","__PRIVATE_docChange","targetChange","__PRIVATE_targetState","__PRIVATE_WatchTargetChangeState","removeTarget","__PRIVATE_objUtils.__PRIVATE_forEachNumber","__PRIVATE_watchChange","__PRIVATE_expectedCount","__PRIVATE_targetData","__PRIVATE_targets","__PRIVATE_isOnlyLimboTarget","__PRIVATE_TargetPurpose","__PRIVATE_remoteEvent","document","__PRIVATE_updatedDocument","__PRIVATE_WatchChangeAggregator","__PRIVATE_targetMapping","__PRIVATE_targetActive","__PRIVATE_dirs","__PRIVATE_ops","__PRIVATE_DIRECTIONS","__PRIVATE_OPERATORS","__PRIVATE_ISO_REG_EXP","RegExp","__PRIVATE_typeUtils.__PRIVATE_isNullOrUndefined","Uint8Array","__PRIVATE_byteString","status","__PRIVATE_mapCodeFromRpcCode","toISOString","nanos","__PRIVATE_parseInt64","__PRIVATE_utc","__PRIVATE_fraction","__PRIVATE_nanoStr","substr","bytes","toBase64","toUint8Array","blob","Blob","fromBase64String","fromUint8Array","__PRIVATE_JsonProtoSerializer","__PRIVATE_resource","__PRIVATE_resourceName","__PRIVATE_fieldValue.__PRIVATE_NullValue","nullValue","__PRIVATE_fieldValue.__PRIVATE_BooleanValue","booleanValue","__PRIVATE_fieldValue.__PRIVATE_IntegerValue","integerValue","__PRIVATE_fieldValue.__PRIVATE_DoubleValue","doubleValue","__PRIVATE_fieldValue.__PRIVATE_StringValue","stringValue","__PRIVATE_fieldValue.__PRIVATE_ObjectValue","__PRIVATE_fieldValue.ArrayValue","__PRIVATE_fieldValue.__PRIVATE_TimestampValue","timestampValue","__PRIVATE_fieldValue.__PRIVATE_GeoPointValue","geoPointValue","__PRIVATE_fieldValue.__PRIVATE_BlobValue","bytesValue","__PRIVATE_fieldValue.__PRIVATE_RefValue","referenceValue","of","POSITIVE_INFINITY","NEGATIVE_INFINITY","__PRIVATE_assertPresent","values","__PRIVATE_dbId","fromVersion","object","array","missing","readTime","documentChange","toVersion","documentDelete","documentRemove","__PRIVATE_mapRpcCodeFromCode","targetChangeType","__PRIVATE_causeProto","__PRIVATE_entityChange","__PRIVATE_docDelete","__PRIVATE_docRemove","__PRIVATE_mutation","update","updateMask","verify","currentDocument","NONE","commitTime","__PRIVATE_protos","setToServerValue","appendMissingElements","removeAllFromArray","increment","instance","__PRIVATE_fieldValue.__PRIVATE_NumberValue","__PRIVATE_documentsTarget","structuredQuery","parent","from","allDescendants","where","__PRIVATE_fromCount","__PRIVATE_filterBy","goog-listen-tags","compositeFilter","unaryFilter","fieldFilter","f","__PRIVATE_accum","order","cursor","__PRIVATE_fieldReference","direction","create","__PRIVATE_nanField","__PRIVATE_nullField","__PRIVATE_canonicalFields","fieldPaths","__PRIVATE_cls","__PRIVATE_optionalMessage","__PRIVATE_staticProperty","__PRIVATE_PublicConstructor","__PRIVATE_binaryString","__PRIVATE_assertBase64Available","base64","atob","__PRIVATE_assertUint8ArrayAvailable","__PRIVATE_invalidClassError","char","String","fromCharCode","btoa","buffer","charCodeAt","__PRIVATE_PublicBlob","__PRIVATE_makeConstructorPrivate","__PRIVATE_mapKeyFn","__PRIVATE_ObjectMap","id","matches_1","__PRIVATE_otherKey","splice","__PRIVATE_objUtil.forEach","entries","entries_1","__PRIVATE_objUtil.__PRIVATE_isEmpty","batchId","baseMutations","mutations","__PRIVATE_docKey","__PRIVATE_batchResult","__PRIVATE_mutationResults","__PRIVATE_maybeDocs","__PRIVATE_mutatedDocuments","__PRIVATE_m","__PRIVATE_mutatedDocument","__PRIVATE_MutationBatch","batch","__PRIVATE_commitVersion","streamToken","__PRIVATE_docVersions","__PRIVATE_MutationBatchResult","__PRIVATE_versionMap","__PRIVATE_documentVersionMap","__PRIVATE_DocReference","ref","__PRIVATE_emptyKey","__PRIVATE_startRef","__PRIVATE_endRef","__PRIVATE_firstRef","__PRIVATE_targetOrBatchId","callback","PersistencePromise","__PRIVATE_nextFn","__PRIVATE_catchFn","reject","all","__PRIVATE_resolvedCount","done","__PRIVATE_err","__PRIVATE_predicates","p","predicate","__PRIVATE_isTrue","collection","__PRIVATE_promises","r","__PRIVATE_RemoteDocumentChangeBuffer","__PRIVATE_maybeDocument","transaction","__PRIVATE_documentKey","__PRIVATE_bufferedEntry","__PRIVATE_documentKeys","__PRIVATE_PRIMARY_LEASE_LOST_ERROR_MSG","listener","__PRIVATE_remoteDocumentCache","__PRIVATE_mutationQueue","__PRIVATE_indexManager","__PRIVATE_batches","__PRIVATE_inBatches","__PRIVATE_nullableMaybeDocumentMap","__PRIVATE_localView","getEntries","__PRIVATE_baseDocs","__PRIVATE_sinceReadTime","__PRIVATE_parents","__PRIVATE_collectionQuery","__PRIVATE_mutationBatches","__PRIVATE_queryResults","__PRIVATE_matchingMutationBatches","__PRIVATE_mergedDocuments","__PRIVATE_mutatedDoc","__PRIVATE_existingDocuments","__PRIVATE_missingBaseDocEntriesForPatching","__PRIVATE_missingBaseDocs","__PRIVATE_addedKeys","__PRIVATE_removedKeys","__PRIVATE_viewSnapshot","__PRIVATE_sequenceNumberSyncer","__PRIVATE_externalPreviousValue","max","__PRIVATE_ListenSequence","__PRIVATE_nextValue","promise","TimerId","__PRIVATE_asyncQueue","__PRIVATE_timerId","__PRIVATE_targetTimeMs","__PRIVATE_removalCallback","bind","catch","__PRIVATE_delayMs","__PRIVATE_delayedOp","__PRIVATE_DelayedOperation","setTimeout","reason","clearTimeout","enqueue","__PRIVATE_AsyncQueue","__PRIVATE_newTail","stack","__PRIVATE_removedOp","__PRIVATE_lastTimerId","__PRIVATE_TimerId","sort","a","b","__PRIVATE_aSequence","__PRIVATE_aIndex","__PRIVATE_bSequence","__PRIVATE_bIndex","__PRIVATE_seqCmp","__PRIVATE_maxElements","__PRIVATE_entry","__PRIVATE_highestValue","last","__PRIVATE_bufferEntryComparator","__PRIVATE_RollingSequenceNumberBuffer","__PRIVATE_GC_DID_NOT_RUN","Io","To","Eo","Ro","__PRIVATE_cacheSizeCollectionThreshold","__PRIVATE_percentileToCollect","__PRIVATE_maximumSequenceNumbersToCollect","__PRIVATE_cacheSize","__PRIVATE_LruParams","__PRIVATE_garbageCollector","__PRIVATE_localStore","__PRIVATE_LruScheduler","cancel","delay","log.debug","__PRIVATE_delegate","__PRIVATE_params","txn","__PRIVATE_percentile","targetCount","maxValue","upperBound","activeTargetIds","__PRIVATE_upperBoundSequenceNumber","__PRIVATE_sequenceNumbersToCollect","__PRIVATE_targetsRemoved","__PRIVATE_countedTargetsTs","__PRIVATE_foundUpperBoundTs","__PRIVATE_removedTargetsTs","__PRIVATE_removedDocumentsTs","__PRIVATE_startTs","__PRIVATE_sequenceNumbers","__PRIVATE_numTargetsRemoved","__PRIVATE_documentsRemoved","log.__PRIVATE_getLogLevel","log.LogLevel","__PRIVATE_LOG_TAG","persistence","__PRIVATE_queryEngine","__PRIVATE_initialUser","t","__PRIVATE_LocalStore","__PRIVATE_newMutationQueue","__PRIVATE_newLocalDocuments","runTransaction","__PRIVATE_oldBatches","__PRIVATE_promisedOldBatches","__PRIVATE_newBatches","__PRIVATE_removedBatchIds","__PRIVATE_addedBatchIds","__PRIVATE_changedKeys","_e","_d","__PRIVATE_affectedDocuments","bh","yh","_h","__PRIVATE_existingDocs","mutations_1","Hu","__PRIVATE_affected","__PRIVATE_documentBuffer","Ph","__PRIVATE_affectedKeys","__PRIVATE_remoteVersion","__PRIVATE_newTargetDataByTargetMap","__PRIVATE_oldTargetData","__PRIVATE_newTargetData","__PRIVATE_changedDocs","__PRIVATE_updatedKeys","__PRIVATE_existingDoc","hasPendingWrites","__PRIVATE_updateRemoteVersion","lastRemoteSnapshotVersion","__PRIVATE_viewChanges","__PRIVATE_viewChange","__PRIVATE_updatedTargetData","__PRIVATE_afterBatchId","__PRIVATE_cached","__PRIVATE_keepPersistedTargetData","mode","__PRIVATE_removed","__PRIVATE_usePreviousResults","__PRIVATE_remoteKeys","rc","networkEnabled","__PRIVATE_docKeys","__PRIVATE_promiseChain","__PRIVATE_remoteDoc","__PRIVATE_ackVersion","__PRIVATE_cachedTargetData","fieldNames","__PRIVATE_minNumberOfElements","__PRIVATE_validateNamedArrayAtLeastNumberOfElements","__PRIVATE_InternalFieldPath","__PRIVATE_RESERVED","__PRIVATE__methodName","__PRIVATE_FieldValueImpl","__PRIVATE_validateNoArgs","__PRIVATE_DeleteFieldValueImpl","__PRIVATE_ServerTimestampFieldValueImpl","__PRIVATE_validateAtLeastNumberOfArgs","__PRIVATE__elements","__PRIVATE__operand","__PRIVATE_PublicFieldValue","__PRIVATE_RESERVED_FIELD_REGEX","__PRIVATE_dataSource","__PRIVATE_UserDataSource","UserDataSource","methodName","__PRIVATE_arrayElement","__PRIVATE_childPath","context","__PRIVATE_fieldDescription","__PRIVATE_ParseContext","__PRIVATE_isWrite","__PRIVATE_preConverter","__PRIVATE_validatePlainObject","__PRIVATE_updateData","__PRIVATE_validatedFieldPaths","fieldPaths_1","__PRIVATE_stringOrFieldPath","__PRIVATE_fieldPathFromDotSeparatedString","__PRIVATE_fieldMaskPaths","__PRIVATE_childContext","__PRIVATE_parsedValue","mask","moreFieldsAndValues","__PRIVATE_fieldPathFromArgument","value_1","__PRIVATE_allowArrays","__PRIVATE_parsed","__PRIVATE_errorMessage","__PRIVATE_looksLikeJsonObject","__PRIVATE_isEmpty","__PRIVATE_entryIndex","array_1","__PRIVATE_parsedEntry","__PRIVATE_parsedElements","arrayUnion","arrayRemove","__PRIVATE_numericIncrement","__PRIVATE_typeUtils.isSafeInteger","fromDate","search","__PRIVATE_fromDotSeparatedString","__PRIVATE_DEFAULT_BACKOFF_INITIAL_DELAY_MS","__PRIVATE_DEFAULT_BACKOFF_FACTOR","__PRIVATE_DEFAULT_BACKOFF_MAX_DELAY_MS","__PRIVATE_queue","__PRIVATE_initialDelayMs","__PRIVATE_backoffFactor","__PRIVATE_maxDelayMs","reset","__PRIVATE_ExponentialBackoff","__PRIVATE_desiredDelayWithJitterMs","__PRIVATE_delaySoFarMs","__PRIVATE_remainingDelayMs","PersistentStreamState","__PRIVATE_connectionTimerId","__PRIVATE_idleTimerId","__PRIVATE_connection","__PRIVATE_credentialsProvider","__PRIVATE_PersistentStreamState","__PRIVATE_PersistentStream","close","stream","send","__PRIVATE_finalState","__PRIVATE_dispatchIfNotClosed","__PRIVATE_closeCount","token","__PRIVATE_rpcError","onMessage","__PRIVATE_startCloseCount","serializer","__PRIVATE_PersistentListenStream","__PRIVATE_watchChangeProto","snapshot","request","addTarget","labels","__PRIVATE_PersistentWriteStream","__PRIVATE_responseProto","lastStreamToken","writeResults","writes","__PRIVATE_Datastore","response","__PRIVATE_rpcName","__PRIVATE_datastore","Transaction","write","__PRIVATE_unwritten","__PRIVATE__version","commit","__PRIVATE_docVersion","__PRIVATE_existingVersion","__PRIVATE_onlineStateHandler","__PRIVATE_OnlineState","__PRIVATE_OnlineStateTracker","__PRIVATE_newState","details","__PRIVATE_connectivityMonitor","Ra","ya","Da","Oa","Na","__PRIVATE_RemoteStore","enableNetwork","stop","__PRIVATE_objUtils.contains","__PRIVATE_objUtils.__PRIVATE_isEmpty","isPrimary","__PRIVATE_requestTargetData","__PRIVATE_lastBatchIdRetrieved","shift","__PRIVATE_success","__PRIVATE_isPermanentError","CLIENT_STATE_KEY_PREFIX","createWebStorageClientStateKey","clientId","MUTATION_BATCH_KEY_PREFIX","createWebStorageMutationBatchKey","__PRIVATE_mutationKey","QUERY_TARGET_KEY_PREFIX","createWebStorageQueryTargetMetadataKey","ONLINE_STATE_KEY_PREFIX","SEQUENCE_NUMBER_KEY_PREFIX","__PRIVATE_mutationBatch","parse","__PRIVATE_validData","__PRIVATE_firestoreError","__PRIVATE_batchMetadata","updateTimeMs","__PRIVATE_clientState","__PRIVATE_activeTargetIdsSet","onlineState","__PRIVATE_localClientId","__PRIVATE_WebStorageSharedClientState","__PRIVATE_escapedPersistenceKey","storage","window","localStorage","createWebStorageSequenceNumberKey","createWebStorageOnlineStateKey","addEventListener","__PRIVATE_existingClients","__PRIVATE_storageItem","getItem","__PRIVATE_RemoteClientState","__PRIVATE_onlineStateJSON","event_1","setItem","__PRIVATE_activeTargets","__PRIVATE_objUtils.forEach","__PRIVATE_queryState","metadata","__PRIVATE_QueryTargetMetadata","removeItem","removeEventListener","event","storageArea","__PRIVATE_mutationMetadata","__PRIVATE_queryTargetMetadata","__PRIVATE_seqString","__PRIVATE_fromWebStorageSequenceNumber","__PRIVATE_mutationState","__PRIVATE_targetKey","__PRIVATE_targetMetadata","match","userId","__PRIVATE_MutationMetadata","__PRIVATE_SharedOnlineState","__PRIVATE_existingTargets","__PRIVATE_newTargets","__PRIVATE_addedTargets","__PRIVATE_removedTargets","__PRIVATE_MemorySharedClientState","__PRIVATE_RESERVED_BITS","GeneratorIds","__PRIVATE_generatorId","seed","__PRIVATE_TargetIdGenerator","__PRIVATE_nextId","__PRIVATE_GeneratorIds","__PRIVATE__syncedDocuments","__PRIVATE_previousChanges","__PRIVATE_changeSet","__PRIVATE_oldDocumentSet","__PRIVATE_newMutatedKeys","__PRIVATE_newDocumentSet","__PRIVATE_needsRefill","__PRIVATE_lastDocInLimit","__PRIVATE_firstDocInLimit","first","__PRIVATE_newMaybeDoc","__PRIVATE_oldDoc","__PRIVATE_oldDocHadPendingMutations","__PRIVATE_newDocHasPendingMutations","__PRIVATE_changeApplied","track","Hl","Xl","Zl","$i","__PRIVATE_updateLimboDocuments","__PRIVATE_c1","__PRIVATE_c2","__PRIVATE_compareChangeType","__PRIVATE_limboChanges","__PRIVATE_newSyncState","__PRIVATE_SyncState","ed","__PRIVATE_oldLimboDocuments","__PRIVATE_queryResult","__PRIVATE_RETRY_COUNT","__PRIVATE_remoteStore","updateFunction","__PRIVATE_deferred","__PRIVATE_userPromise","__PRIVATE_commitError","__PRIVATE_userPromiseError","view","__PRIVATE_sharedClientState","q","__PRIVATE_SyncEngine","__PRIVATE_syncEngineListener","__PRIVATE_queryView","status_1","listen","__PRIVATE_viewDocChanges","__PRIVATE_synthesizedTargetChange","__PRIVATE_queries","__PRIVATE_userCallback","__PRIVATE_limboResolution","__PRIVATE_ignoreIfPrimaryLeaseLoss","source","__PRIVATE_OnlineStateSource","__PRIVATE_newViewSnapshots","__PRIVATE_limboKey","__PRIVATE_batchState","__PRIVATE_mutationBatchResult","__PRIVATE_highestBatchId","__PRIVATE_callbacks","clear","__PRIVATE_newCallbacks","__PRIVATE_limboKeys","__PRIVATE_limboTargetId","__PRIVATE_limboChange","__PRIVATE_newSnaps","__PRIVATE_docChangesInAllViews","__PRIVATE_queriesProcessed","__PRIVATE_LocalViewChanges","__PRIVATE_fnName","__PRIVATE_userChanged","__PRIVATE_activeQueries","p_1","__PRIVATE_synthesizedRemoteEvent","__PRIVATE_RemoteEvent","__PRIVATE_added","this_1","disableNetwork","__PRIVATE_keySet","__PRIVATE_syncEngine","subscribe","__PRIVATE_EventManager","__PRIVATE_firstListen","__PRIVATE_queryInfo","__PRIVATE_lastListen","__PRIVATE_viewSnaps","__PRIVATE_raisedEvent","__PRIVATE_viewSnap","onError","observer","__PRIVATE_queryObserver","__PRIVATE_snap","includeMetadataChanges","__PRIVATE_QueryListener","__PRIVATE_maybeOnline","__PRIVATE_hasPendingWritesChanged","__PRIVATE_escapeChar","__PRIVATE_encodedSeparatorChar","__PRIVATE_encodedNul","__PRIVATE_encodedEscape","encode","__PRIVATE_encodeSeparator","__PRIVATE_encodeSegment","__PRIVATE_resultBuf","decode","__PRIVATE_lastReasonableEscapeIndex","__PRIVATE_segmentBuilder","__PRIVATE_currentPiece","db","__PRIVATE_SimpleDb","getUA","__PRIVATE_schemaConverter","indexedDB","open","onsuccess","onblocked","onerror","onupgradeneeded","oldVersion","createOrUpgrade","SCHEMA_VERSION","__PRIVATE_wrapRequest","deleteDatabase","navigator","__PRIVATE_ua","__PRIVATE_iOSVersion","__PRIVATE_isUnsupportedIOS","__PRIVATE_androidVersion","__PRIVATE_isUnsupportedAndroid","__PRIVATE_process","store","__PRIVATE_iOSVersionRegex","__PRIVATE_androidVersionRegex","__PRIVATE_versionChangeListener","onversionchange","__PRIVATE_objectStores","__PRIVATE_transactionFn","__PRIVATE_readonly","startsWith","__PRIVATE_idempotent","endsWith","__PRIVATE_attemptNumber","__PRIVATE_SimpleDbTransaction","__PRIVATE_transactionFnResult","abort","__PRIVATE_retryable","error_1","__PRIVATE_dbCursor","__PRIVATE_IterationController","oncomplete","onabort","__PRIVATE_checkForAndReportiOSError","objectStoreNames","aborted","__PRIVATE_storeName","objectStore","__PRIVATE_SimpleDbStore","__PRIVATE_keyOrValue","put","__PRIVATE_indexOrRange","control","__PRIVATE_optionsOrCallback","__PRIVATE_cursorRequest","primaryKey","__PRIVATE_shouldContinue","continue","controller","__PRIVATE_userResult","__PRIVATE_indexName","reverse","openKeyCursor","openCursor","__PRIVATE_reportedIOSError","__PRIVATE_IOS_ERROR","__PRIVATE_newError","__PRIVATE_referenceDelegate","empty","IDBKeyRange","__PRIVATE_mutationsStore","DbMutationBatch","userMutationsIndex","__PRIVATE_convertStreamToken","__PRIVATE_mutationQueuesStore","__PRIVATE_documentStore","__PRIVATE_documentMutationsStore","__PRIVATE_mutationStore","__PRIVATE_dbBatch","__PRIVATE_collectionParents","__PRIVATE_l","__PRIVATE_indexKey","DbDocumentMutation","PLACEHOLDER","__PRIVATE_nextBatchId","lowerBound","__PRIVATE_foundBatch","__PRIVATE_dbBatches","__PRIVATE_indexPrefix","prefixForPath","__PRIVATE_indexStart","__PRIVATE_userID","__PRIVATE_encodedPath","EncodedResourcePath.decode","__PRIVATE_uniqueBatchIDs","__PRIVATE_batchID","__PRIVATE_queryPath","__PRIVATE_immediateChildrenLength","__PRIVATE_batchIDs","__PRIVATE_removeMutationBatch","__PRIVATE_startRange","prefixForUser","__PRIVATE_danglingMutationReferences","__PRIVATE_mutationQueueContainsKey","DbMutationQueue","__PRIVATE_containsKey","Rv","keyPath","__PRIVATE_indexTxn","only","__PRIVATE_numDeleted","__PRIVATE_removePromise","__PRIVATE_IndexedDbPersistence","highestTargetId","after","__PRIVATE_getHighestListenSequenceNumber","highestListenSequenceNumber","__PRIVATE_targetsStore","__PRIVATE_retrieveMetadata","DbTargetGlobal","updated","DbTarget","queryTargetsIndexName","__PRIVATE_documentTargetStore","EncodedResourcePath.encode","DbTargetDocument","__PRIVATE_immediateSuccessor","documentTargetsIndex","__PRIVATE_targetGlobal","__PRIVATE_remoteDocumentsStore","__PRIVATE_dbKey","__PRIVATE_IndexedDbRemoteDocumentCache","__PRIVATE_sizeDelta","getMetadata","byteSize","__PRIVATE_dbRemoteDoc","$v","__PRIVATE_dbDocumentSize","__PRIVATE_sizeMap","nw","iw","__PRIVATE_keyIter","__PRIVATE_nextKey","__PRIVATE_potentialKeyRaw","__PRIVATE_potentialKey","__PRIVATE_immediateChildrenPathLength","__PRIVATE_iterationOptions","__PRIVATE_collectionKey","__PRIVATE_readTimeKey","DbRemoteDocument","collectionReadTimeIndex","__PRIVATE_lastReadTime","__PRIVATE_documentsStore","readTimeIndex","lc","__PRIVATE_documentGlobalStore","DbRemoteDocumentGlobal","__PRIVATE_documentCache","__PRIVATE_trackRemovals","__PRIVATE_previousSize","__PRIVATE_deletedDoc","updateMetadata","__PRIVATE_getResult","__PRIVATE_maybeDocuments","unknownDocument","noDocument","collectionPath","__PRIVATE_MemoryCollectionParentIndex","parentPath","__PRIVATE_existingParents","SchemaConverter","__PRIVATE_simpleDbTransaction","createObjectStore","DbPrimaryClient","__PRIVATE_createPrimaryClientStore","autoIncrement","createIndex","userMutationsKeyPath","unique","__PRIVATE_createMutationQueue","__PRIVATE_createQueryCache","__PRIVATE_createRemoteDocumentCache","deleteObjectStore","__PRIVATE_dropQueryCache","__PRIVATE_globalStore","__PRIVATE_writeEmptyTargetGlobalEntry","__PRIVATE_existingMutations","__PRIVATE_v3MutationsStore","__PRIVATE_writeAll","__PRIVATE_upgradeMutationBatchSchemaAndMigrateData","DbClientMetadata","__PRIVATE_createClientMetadataStore","removeAcknowledgedMutations","__PRIVATE_createDocumentGlobalStore","addDocumentGlobal","ensureSequenceNumbers","createCollectionParentIndex","__PRIVATE_dropRemoteDocumentChangesStore","__PRIVATE_remoteDocumentStore","readTimeIndexPath","collectionReadTimeIndexPath","__PRIVATE_createRemoteDocumentReadTimeIndex","__PRIVATE_byteCount","__PRIVATE_queuesStore","__PRIVATE_queues","lastAcknowledgedBatchId","__PRIVATE_currentSequenceNumber","__PRIVATE_docSentinelKey","__PRIVATE_sentinelKey","__PRIVATE_maybeSentinel","__PRIVATE_writeSentinelKey","DbCollectionParent","__PRIVATE_collectionParentsStore","cache","__PRIVATE_addEntry","__PRIVATE_pathSegments","ownerId","allowTabSynchronization","leaseTimestampMs","localWriteTimeMs","lastListenSequenceNumber","documentTargetsKeyPath","queryTargetsKeyPath","inForeground","V1_STORES","V4_STORES","V6_STORES","ALL_STORES","__PRIVATE_collectionParent","__PRIVATE_parentPaths","__PRIVATE_remoteSerializer","__PRIVATE_dbReadTime","readTime_1","DbNoDocument","readTime_2","DbUnknownDocument","__PRIVATE_dbTimestampKey","DbTimestamp","__PRIVATE_dbTimestamp","__PRIVATE_serializedBaseMutations","__PRIVATE_serializedMutations","__PRIVATE_encodedKeys","__PRIVATE_encodedPaths","__PRIVATE_dbTarget","__PRIVATE_queryProto","__PRIVATE_dbLastLimboFreeTimestamp","__PRIVATE_PRIMARY_LEASE_EXCLUSIVE_ERROR_MSG","__PRIVATE_lruParams","LocalSerializer","__PRIVATE_primaryStateListener","__PRIVATE_primaryState","__PRIVATE_databaseDeletedListener","newVersion","__PRIVATE_clientMetadataStore","__PRIVATE_canActAsPrimary","__PRIVATE_primaryClientStore","__PRIVATE_primaryClient","__PRIVATE_metadataStore","active","__PRIVATE_inactive","__PRIVATE_inactiveClient","__PRIVATE_currentPrimary","__PRIVATE_otherClient","__PRIVATE_otherClientHasBetterNetworkState","__PRIVATE_otherClientHasBetterVisibility","__PRIVATE_otherClientHasSameNetworkState","__PRIVATE_clients","__PRIVATE_activityThresholdMs","__PRIVATE_clientMetadata","__PRIVATE_dbName","__PRIVATE_IndexedDbMutationQueue","__PRIVATE_transactionOperation","__PRIVATE_persistenceTransaction","__PRIVATE_simpleDbMode","__PRIVATE_simpleDbTxn","__PRIVATE_holdsPrimaryLease","__PRIVATE_newPrimary","__PRIVATE_databaseInfo","__PRIVATE_maxAgeMs","visibilityState","__PRIVATE_isZombied","__PRIVATE_ZOMBIED_CLIENTS_KEY_PREFIX","__PRIVATE_docCountPromise","__PRIVATE_docCount","__PRIVATE_orphanedCount","__PRIVATE_inMemoryPins","__PRIVATE_mutationQueuesContainKey","__PRIVATE_changeBuffer","__PRIVATE_documentCount","__PRIVATE_isPinned","__PRIVATE_IndexedDbLruDelegate","__PRIVATE_nextPath","__PRIVATE_nextToReport","__PRIVATE_sentinelRow","__PRIVATE_localDocuments","__PRIVATE_previousResults","__PRIVATE_getLogLevel","__PRIVATE_updatedResults","__PRIVATE_sortedPreviousResults","__PRIVATE_limboFreeSnapshotVersion","__PRIVATE_docAtLimitEdge","__PRIVATE_batchIndex","__PRIVATE_check","__PRIVATE_rawIndex","prefix","__PRIVATE_startPath","__PRIVATE_rowKeyPath","__PRIVATE_references","__PRIVATE_sizer","__PRIVATE_currentSize","__PRIVATE_MemoryRemoteDocumentCache","iterator","__PRIVATE_nextTargetId","__PRIVATE_removals","__PRIVATE_matchingKeys","__PRIVATE_referenceDelegateFactory","__PRIVATE_MemoryPersistence","__PRIVATE_vs","__PRIVATE_MemoryEagerDelegate","__PRIVATE_isReferenced","__PRIVATE_MemoryLruDelegate","__PRIVATE_documentSize","__PRIVATE_orphanedAt","cacheSizeBytes","synchronizeTabs","__PRIVATE_AutoId","__PRIVATE_FirestoreClient","__PRIVATE_persistenceSettings","__PRIVATE_initializationDone","__PRIVATE_persistenceResult","__PRIVATE_initialized","__PRIVATE_maybeLruGc","console","warn","DOMException","settings","nr","Wc","Sw","gw","__PRIVATE_remoteStoreOnlineStateChangedHandler","__PRIVATE_sharedClientStateOnlineStateChangedHandler","terminate","__PRIVATE_AsyncObserver","muted","eventHandler","__PRIVATE_methods","method","__PRIVATE_implementsAnyMethods","__PRIVATE_DEFAULT_HOST","__PRIVATE_DEFAULT_SSL","__PRIVATE_DEFAULT_TIMESTAMPS_IN_SNAPSHOTS","__PRIVATE_DEFAULT_FORCE_LONG_POLLING","CACHE_SIZE_UNLIMITED","__PRIVATE_validateNamedOptionalType","__PRIVATE_objUtils.__PRIVATE_defaulted","__PRIVATE_validateOptionNames","experimentalForceLongPolling","__PRIVATE_FirestoreSettings","__PRIVATE_databaseIdOrApp","app","Firestore","external_1","__PRIVATE_settingsLiteral","__PRIVATE_newSettings","__PRIVATE_makeCredentialsProvider","experimentalTabSynchronization","clearPersistence","e_1","_removeServiceInstance","waitForPendingWrites","arg","__PRIVATE_isPartialObserver","__PRIVATE_asyncObserver","DocumentReference","__PRIVATE_thisDb","__PRIVATE_otherDb","firestore","__PRIVATE_pathString","CollectionReference","WriteBatch","level","log.setLogLevel","__PRIVATE__firestore","__PRIVATE__transaction","documentRef","__PRIVATE_validateReference","DocumentSnapshot","__PRIVATE_validateBetweenNumberOfArgs","__PRIVATE_validateSetOptions","__PRIVATE_convertedValue","merge","mergeFields","__PRIVATE_fieldOrUpdateData","__PRIVATE__key","__PRIVATE__converter","__PRIVATE_currArg","__PRIVATE_internalOptions","__PRIVATE_validateOptionalArgType","complete","__PRIVATE_errHandler","__PRIVATE_internalListener","__PRIVATE_InternalQuery","__PRIVATE_validateGetOptions","__PRIVATE_unlisten","ov","SnapshotMetadata","__PRIVATE__document","__PRIVATE__fromCache","__PRIVATE__hasPendingWrites","__PRIVATE_validateSnapshotOptions","QueryDocumentSnapshot","fromFirestore","__PRIVATE_FieldValueOptions","__PRIVATE__query","opStr","__PRIVATE_validateDefined","__PRIVATE_whereFilterOpEnums","__PRIVATE_validateStringEnum","operator","__PRIVATE_referenceList","directionStr","__PRIVATE_validatePositiveNumber","__PRIVATE_docOrField","__PRIVATE_allFields","components","__PRIVATE_rawValue","__PRIVATE_wrapped","QuerySnapshot","__PRIVATE_firestoreClient","__PRIVATE_documentIdValue","isArray","__PRIVATE_arrayOps","__PRIVATE_disjunctiveOps","__PRIVATE_isArrayOp","__PRIVATE_isDisjunctiveOp","__PRIVATE_existingField","__PRIVATE_conflictingOp","__PRIVATE_inequality","__PRIVATE__originalQuery","__PRIVATE__snapshot","thisArg","__PRIVATE_lastDoc","index_1","oldIndex","newIndex","__PRIVATE_indexTracker","__PRIVATE_resultChangeType","__PRIVATE_changesFromSnapshot","Symbol","property","defineProperty","__PRIVATE_throwDocChangesMethodError","__PRIVATE__path","__PRIVATE_docRef","__PRIVATE_validateOptionalArrayElements","__PRIVATE_validateNamedOptionalPropertyEquals","toFirestore","__PRIVATE_PublicFirestore","__PRIVATE_PublicTransaction","__PRIVATE_PublicWriteBatch","__PRIVATE_PublicDocumentReference","__PRIVATE_PublicDocumentSnapshot","__PRIVATE_PublicQueryDocumentSnapshot","__PRIVATE_PublicQuery","__PRIVATE_PublicQuerySnapshot","__PRIVATE_PublicCollectionReference","__PRIVATE_firestoreNamespace","registerComponent","Component","container","getProvider","setServiceProps","__PRIVATE_shallowCopy","__PRIVATE_StreamBridge","__PRIVATE_RPC_NAME_REST_MAPPING","BatchGetDocuments","Commit","__PRIVATE_X_GOOG_API_CLIENT_VALUE","info","__PRIVATE_header","url","__PRIVATE_xhr","XhrIo","listenOnce","EventType","COMPLETE","getLastErrorCode","ErrorCode","NO_ERROR","json","getResponseJson","TIMEOUT","HTTP_ERROR","getStatus","getResponseText","__PRIVATE_responseError","__PRIVATE_firestoreErrorCode","__PRIVATE_serverError","toLowerCase","getLastError","__PRIVATE_jsonObj","__assign","__PRIVATE_requestString","Content-Type","__PRIVATE_urlParts","__PRIVATE_webchannelTransport","createWebChannelTransport","backgroundChannelTest","httpSessionIdParam","initMessageHeaders","messageUrlParams","sendRawJson","supportsCrossDomainXhr","internalChannelParams","forwardChannelRequestTimeoutMs","isReactNative","isElectron","isIE","isUWP","isBrowserExtension","httpHeadersOverwriteParam","channel","createWebChannel","__PRIVATE_opened","closed","__PRIVATE_streamBridge","Jp","Yp","__PRIVATE_unguardedEventListen","param","WebChannel","OPEN","CLOSE","MESSAGE","__PRIVATE_msgData","__PRIVATE_msgDataOrError","status_2","__PRIVATE_mapCodeFromRpcStatus","__PRIVATE_urlRpcName","__PRIVATE_BrowserPlatform","__PRIVATE_BrowserConnectivityMonitor","__PRIVATE_encoded","raw","__PRIVATE_configureForFirebase","registerVersion","__PRIVATE_registerFirestore"],"mappings":"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"} |