@firebase/firestore 3.4.4-canary.2dd99ae2d → 3.4.4-canary.3e9f3e253
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/firestore/src/api/credentials.d.ts +1 -0
- package/dist/firestore/src/api/snapshot.d.ts +1 -2
- package/dist/firestore/src/core/target.d.ts +8 -4
- package/dist/firestore/src/lite-api/query.d.ts +2 -2
- package/dist/firestore/src/local/document_overlay_cache.d.ts +72 -0
- package/dist/firestore/src/local/index_manager.d.ts +52 -0
- package/dist/firestore/src/local/indexeddb_document_overlay_cache.d.ts +45 -0
- package/dist/firestore/src/local/indexeddb_index_manager.d.ts +21 -2
- package/dist/firestore/src/local/indexeddb_persistence.d.ts +6 -4
- package/dist/firestore/src/local/indexeddb_remote_document_cache.d.ts +2 -8
- package/dist/firestore/src/local/indexeddb_schema.d.ts +193 -7
- package/dist/firestore/src/local/local_documents_view.d.ts +0 -1
- package/dist/firestore/src/local/local_serializer.d.ts +18 -2
- package/dist/firestore/src/local/memory_document_overlay_cache.d.ts +37 -0
- package/dist/firestore/src/local/memory_index_manager.d.ts +11 -0
- package/dist/firestore/src/local/memory_persistence.d.ts +6 -2
- package/dist/firestore/src/local/memory_remote_document_cache.d.ts +1 -3
- package/dist/firestore/src/local/persistence.d.ts +8 -2
- package/dist/firestore/src/local/remote_document_cache.d.ts +7 -9
- package/dist/firestore/src/local/simple_db.d.ts +1 -0
- package/dist/firestore/src/model/document_key.d.ts +4 -0
- package/dist/firestore/src/model/field_index.d.ts +2 -2
- package/dist/firestore/src/model/overlay.d.ts +32 -0
- package/dist/firestore/src/model/target_index_matcher.d.ts +70 -0
- package/dist/firestore/test/unit/local/counting_query_engine.d.ts +3 -3
- package/dist/firestore/test/unit/local/document_overlay_cache.test.d.ts +1 -0
- package/dist/firestore/test/unit/local/persistence_test_helpers.d.ts +1 -0
- package/dist/firestore/test/unit/local/test_document_overlay_cache.d.ts +38 -0
- package/dist/firestore/test/unit/local/test_index_manager.d.ts +11 -0
- package/dist/firestore/test/unit/local/test_remote_document_cache.d.ts +4 -2
- package/dist/firestore/test/unit/local/test_remote_document_change_buffer.d.ts +1 -1
- package/dist/firestore/test/unit/model/target_index_matcher.test.d.ts +17 -0
- package/dist/firestore/test/util/helpers.d.ts +1 -1
- package/dist/index.d.ts +1 -2
- package/dist/index.esm2017.js +3864 -3349
- package/dist/index.esm2017.js.map +1 -1
- package/dist/index.esm5.js +3879 -3455
- package/dist/index.esm5.js.map +1 -1
- package/dist/index.node.cjs.js +878 -221
- package/dist/index.node.cjs.js.map +1 -1
- package/dist/index.node.mjs +878 -221
- package/dist/index.node.mjs.map +1 -1
- package/dist/index.rn.js +3973 -3458
- package/dist/index.rn.js.map +1 -1
- package/dist/internal.d.ts +252 -14
- package/dist/lite/firestore/src/api/credentials.d.ts +1 -0
- package/dist/lite/firestore/src/api/snapshot.d.ts +1 -2
- package/dist/lite/firestore/src/core/target.d.ts +8 -4
- package/dist/lite/firestore/src/lite-api/query.d.ts +2 -2
- package/dist/lite/firestore/src/local/document_overlay_cache.d.ts +72 -0
- package/dist/lite/firestore/src/local/index_manager.d.ts +52 -0
- package/dist/lite/firestore/src/local/indexeddb_document_overlay_cache.d.ts +45 -0
- package/dist/lite/firestore/src/local/indexeddb_index_manager.d.ts +21 -2
- package/dist/lite/firestore/src/local/indexeddb_persistence.d.ts +6 -4
- package/dist/lite/firestore/src/local/indexeddb_remote_document_cache.d.ts +2 -8
- package/dist/lite/firestore/src/local/indexeddb_schema.d.ts +193 -7
- package/dist/lite/firestore/src/local/local_documents_view.d.ts +0 -1
- package/dist/lite/firestore/src/local/local_serializer.d.ts +18 -2
- package/dist/lite/firestore/src/local/memory_document_overlay_cache.d.ts +37 -0
- package/dist/lite/firestore/src/local/memory_index_manager.d.ts +11 -0
- package/dist/lite/firestore/src/local/memory_persistence.d.ts +6 -2
- package/dist/lite/firestore/src/local/memory_remote_document_cache.d.ts +1 -3
- package/dist/lite/firestore/src/local/persistence.d.ts +8 -2
- package/dist/lite/firestore/src/local/remote_document_cache.d.ts +7 -9
- package/dist/lite/firestore/src/local/simple_db.d.ts +1 -0
- package/dist/lite/firestore/src/model/document_key.d.ts +4 -0
- package/dist/lite/firestore/src/model/field_index.d.ts +2 -2
- package/dist/lite/firestore/src/model/overlay.d.ts +32 -0
- package/dist/lite/firestore/src/model/target_index_matcher.d.ts +70 -0
- package/dist/lite/firestore/test/unit/local/counting_query_engine.d.ts +3 -3
- package/dist/lite/firestore/test/unit/local/document_overlay_cache.test.d.ts +1 -0
- package/dist/lite/firestore/test/unit/local/persistence_test_helpers.d.ts +1 -0
- package/dist/lite/firestore/test/unit/local/test_document_overlay_cache.d.ts +38 -0
- package/dist/lite/firestore/test/unit/local/test_index_manager.d.ts +11 -0
- package/dist/lite/firestore/test/unit/local/test_remote_document_cache.d.ts +4 -2
- package/dist/lite/firestore/test/unit/local/test_remote_document_change_buffer.d.ts +1 -1
- package/dist/lite/firestore/test/unit/model/target_index_matcher.test.d.ts +17 -0
- package/dist/lite/firestore/test/util/helpers.d.ts +1 -1
- package/dist/lite/index.browser.esm2017.js +1152 -1143
- package/dist/lite/index.browser.esm2017.js.map +1 -1
- package/dist/lite/index.browser.esm5.js +348 -341
- package/dist/lite/index.browser.esm5.js.map +1 -1
- package/dist/lite/index.node.cjs.js +44 -29
- package/dist/lite/index.node.cjs.js.map +1 -1
- package/dist/lite/index.node.mjs +44 -29
- package/dist/lite/index.node.mjs.map +1 -1
- package/dist/lite/index.rn.esm2017.js +1180 -1171
- package/dist/lite/index.rn.esm2017.js.map +1 -1
- package/dist/lite/internal.d.ts +6 -2
- package/dist/lite/packages/firestore/dist/lite/index.browser.esm2017.d.ts +121 -121
- package/dist/lite/packages/firestore/src/api/credentials.d.ts +1 -0
- package/dist/lite/packages/firestore/src/api/snapshot.d.ts +1 -2
- package/dist/lite/packages/firestore/src/core/target.d.ts +8 -4
- package/dist/lite/packages/firestore/src/lite-api/query.d.ts +2 -2
- package/dist/lite/packages/firestore/src/local/document_overlay_cache.d.ts +72 -0
- package/dist/lite/packages/firestore/src/local/index_manager.d.ts +52 -0
- package/dist/lite/packages/firestore/src/local/indexeddb_document_overlay_cache.d.ts +45 -0
- package/dist/lite/packages/firestore/src/local/indexeddb_index_manager.d.ts +21 -2
- package/dist/lite/packages/firestore/src/local/indexeddb_persistence.d.ts +6 -4
- package/dist/lite/packages/firestore/src/local/indexeddb_remote_document_cache.d.ts +2 -8
- package/dist/lite/packages/firestore/src/local/indexeddb_schema.d.ts +193 -7
- package/dist/lite/packages/firestore/src/local/local_documents_view.d.ts +0 -1
- package/dist/lite/packages/firestore/src/local/local_serializer.d.ts +18 -2
- package/dist/lite/packages/firestore/src/local/memory_document_overlay_cache.d.ts +37 -0
- package/dist/lite/packages/firestore/src/local/memory_index_manager.d.ts +11 -0
- package/dist/lite/packages/firestore/src/local/memory_persistence.d.ts +6 -2
- package/dist/lite/packages/firestore/src/local/memory_remote_document_cache.d.ts +1 -3
- package/dist/lite/packages/firestore/src/local/persistence.d.ts +8 -2
- package/dist/lite/packages/firestore/src/local/remote_document_cache.d.ts +7 -9
- package/dist/lite/packages/firestore/src/local/simple_db.d.ts +1 -0
- package/dist/lite/packages/firestore/src/model/document_key.d.ts +4 -0
- package/dist/lite/packages/firestore/src/model/field_index.d.ts +2 -2
- package/dist/lite/packages/firestore/src/model/overlay.d.ts +32 -0
- package/dist/lite/packages/firestore/src/model/target_index_matcher.d.ts +70 -0
- package/dist/lite/packages/firestore/test/unit/local/counting_query_engine.d.ts +3 -3
- package/dist/lite/packages/firestore/test/unit/local/document_overlay_cache.test.d.ts +1 -0
- package/dist/lite/packages/firestore/test/unit/local/persistence_test_helpers.d.ts +1 -0
- package/dist/lite/packages/firestore/test/unit/local/test_document_overlay_cache.d.ts +38 -0
- package/dist/lite/packages/firestore/test/unit/local/test_index_manager.d.ts +11 -0
- package/dist/lite/packages/firestore/test/unit/local/test_remote_document_cache.d.ts +4 -2
- package/dist/lite/packages/firestore/test/unit/local/test_remote_document_change_buffer.d.ts +1 -1
- package/dist/lite/packages/firestore/test/unit/model/target_index_matcher.test.d.ts +17 -0
- package/dist/lite/packages/firestore/test/util/helpers.d.ts +1 -1
- package/dist/lite/private.d.ts +2 -2
- package/dist/packages/firestore/dist/index.esm2017.d.ts +181 -179
- package/dist/packages/firestore/src/api/credentials.d.ts +1 -0
- package/dist/packages/firestore/src/api/snapshot.d.ts +1 -2
- package/dist/packages/firestore/src/core/target.d.ts +8 -4
- package/dist/packages/firestore/src/lite-api/query.d.ts +2 -2
- package/dist/packages/firestore/src/local/document_overlay_cache.d.ts +72 -0
- package/dist/packages/firestore/src/local/index_manager.d.ts +52 -0
- package/dist/packages/firestore/src/local/indexeddb_document_overlay_cache.d.ts +45 -0
- package/dist/packages/firestore/src/local/indexeddb_index_manager.d.ts +21 -2
- package/dist/packages/firestore/src/local/indexeddb_persistence.d.ts +6 -4
- package/dist/packages/firestore/src/local/indexeddb_remote_document_cache.d.ts +2 -8
- package/dist/packages/firestore/src/local/indexeddb_schema.d.ts +193 -7
- package/dist/packages/firestore/src/local/local_documents_view.d.ts +0 -1
- package/dist/packages/firestore/src/local/local_serializer.d.ts +18 -2
- package/dist/packages/firestore/src/local/memory_document_overlay_cache.d.ts +37 -0
- package/dist/packages/firestore/src/local/memory_index_manager.d.ts +11 -0
- package/dist/packages/firestore/src/local/memory_persistence.d.ts +6 -2
- package/dist/packages/firestore/src/local/memory_remote_document_cache.d.ts +1 -3
- package/dist/packages/firestore/src/local/persistence.d.ts +8 -2
- package/dist/packages/firestore/src/local/remote_document_cache.d.ts +7 -9
- package/dist/packages/firestore/src/local/simple_db.d.ts +1 -0
- package/dist/packages/firestore/src/model/document_key.d.ts +4 -0
- package/dist/packages/firestore/src/model/field_index.d.ts +2 -2
- package/dist/packages/firestore/src/model/overlay.d.ts +32 -0
- package/dist/packages/firestore/src/model/target_index_matcher.d.ts +70 -0
- package/dist/packages/firestore/test/unit/local/counting_query_engine.d.ts +3 -3
- package/dist/packages/firestore/test/unit/local/document_overlay_cache.test.d.ts +1 -0
- package/dist/packages/firestore/test/unit/local/persistence_test_helpers.d.ts +1 -0
- package/dist/packages/firestore/test/unit/local/test_document_overlay_cache.d.ts +38 -0
- package/dist/packages/firestore/test/unit/local/test_index_manager.d.ts +11 -0
- package/dist/packages/firestore/test/unit/local/test_remote_document_cache.d.ts +4 -2
- package/dist/packages/firestore/test/unit/local/test_remote_document_change_buffer.d.ts +1 -1
- package/dist/packages/firestore/test/unit/model/target_index_matcher.test.d.ts +17 -0
- package/dist/packages/firestore/test/util/helpers.d.ts +1 -1
- package/dist/private.d.ts +248 -14
- package/package.json +9 -9
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Copyright 2022 Google LLC
|
|
4
|
+
*
|
|
5
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
6
|
+
* you may not use this file except in compliance with the License.
|
|
7
|
+
* You may obtain a copy of the License at
|
|
8
|
+
*
|
|
9
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
|
10
|
+
*
|
|
11
|
+
* Unless required by applicable law or agreed to in writing, software
|
|
12
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
13
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
14
|
+
* See the License for the specific language governing permissions and
|
|
15
|
+
* limitations under the License.
|
|
16
|
+
*/
|
|
17
|
+
import { DocumentKeySet } from '../model/collections';
|
|
18
|
+
import { DocumentKey } from '../model/document_key';
|
|
19
|
+
import { Mutation } from '../model/mutation';
|
|
20
|
+
import { Overlay } from '../model/overlay';
|
|
21
|
+
import { ResourcePath } from '../model/path';
|
|
22
|
+
import { DocumentOverlayCache } from './document_overlay_cache';
|
|
23
|
+
import { PersistencePromise } from './persistence_promise';
|
|
24
|
+
import { PersistenceTransaction } from './persistence_transaction';
|
|
25
|
+
/**
|
|
26
|
+
* An in-memory implementation of DocumentOverlayCache.
|
|
27
|
+
*/
|
|
28
|
+
export declare class MemoryDocumentOverlayCache implements DocumentOverlayCache {
|
|
29
|
+
private overlays;
|
|
30
|
+
private overlayByBatchId;
|
|
31
|
+
getOverlay(transaction: PersistenceTransaction, key: DocumentKey): PersistencePromise<Overlay | null>;
|
|
32
|
+
saveOverlays(transaction: PersistenceTransaction, largestBatchId: number, overlays: Map<DocumentKey, Mutation>): PersistencePromise<void>;
|
|
33
|
+
removeOverlaysForBatchId(transaction: PersistenceTransaction, documentKeys: DocumentKeySet, batchId: number): PersistencePromise<void>;
|
|
34
|
+
getOverlaysForCollection(transaction: PersistenceTransaction, collection: ResourcePath, sinceBatchId: number): PersistencePromise<Map<DocumentKey, Overlay>>;
|
|
35
|
+
getOverlaysForCollectionGroup(transaction: PersistenceTransaction, collectionGroup: string, sinceBatchId: number, count: number): PersistencePromise<Map<DocumentKey, Overlay>>;
|
|
36
|
+
private saveOverlay;
|
|
37
|
+
}
|
|
@@ -14,6 +14,9 @@
|
|
|
14
14
|
* See the License for the specific language governing permissions and
|
|
15
15
|
* limitations under the License.
|
|
16
16
|
*/
|
|
17
|
+
import { Target } from '../core/target';
|
|
18
|
+
import { DocumentKeySet, DocumentMap } from '../model/collections';
|
|
19
|
+
import { FieldIndex, IndexOffset } from '../model/field_index';
|
|
17
20
|
import { ResourcePath } from '../model/path';
|
|
18
21
|
import { IndexManager } from './index_manager';
|
|
19
22
|
import { PersistencePromise } from './persistence_promise';
|
|
@@ -25,6 +28,14 @@ export declare class MemoryIndexManager implements IndexManager {
|
|
|
25
28
|
private collectionParentIndex;
|
|
26
29
|
addToCollectionParentIndex(transaction: PersistenceTransaction, collectionPath: ResourcePath): PersistencePromise<void>;
|
|
27
30
|
getCollectionParents(transaction: PersistenceTransaction, collectionId: string): PersistencePromise<ResourcePath[]>;
|
|
31
|
+
addFieldIndex(transaction: PersistenceTransaction, index: FieldIndex): PersistencePromise<void>;
|
|
32
|
+
deleteFieldIndex(transaction: PersistenceTransaction, index: FieldIndex): PersistencePromise<void>;
|
|
33
|
+
getDocumentsMatchingTarget(transaction: PersistenceTransaction, fieldIndex: FieldIndex, target: Target): PersistencePromise<DocumentKeySet>;
|
|
34
|
+
getFieldIndex(transaction: PersistenceTransaction, target: Target): PersistencePromise<FieldIndex | null>;
|
|
35
|
+
getFieldIndexes(transaction: PersistenceTransaction, collectionGroup?: string): PersistencePromise<FieldIndex[]>;
|
|
36
|
+
getNextCollectionGroupToUpdate(transaction: PersistenceTransaction): PersistencePromise<string | null>;
|
|
37
|
+
updateCollectionGroup(transaction: PersistenceTransaction, collectionGroup: string, offset: IndexOffset): PersistencePromise<void>;
|
|
38
|
+
updateIndexEntries(transaction: PersistenceTransaction, documents: DocumentMap): PersistencePromise<void>;
|
|
28
39
|
}
|
|
29
40
|
/**
|
|
30
41
|
* Internal implementation of the collection-parent index exposed by MemoryIndexManager.
|
|
@@ -19,6 +19,8 @@ import { ListenSequenceNumber, TargetId } from '../core/types';
|
|
|
19
19
|
import { Document } from '../model/document';
|
|
20
20
|
import { DocumentKey } from '../model/document_key';
|
|
21
21
|
import { JsonProtoSerializer } from '../remote/serializer';
|
|
22
|
+
import { DocumentOverlayCache } from './document_overlay_cache';
|
|
23
|
+
import { IndexManager } from './index_manager';
|
|
22
24
|
import { ActiveTargets, LruDelegate, LruGarbageCollector, LruParams } from './lru_garbage_collector';
|
|
23
25
|
import { MemoryBundleCache } from './memory_bundle_cache';
|
|
24
26
|
import { MemoryIndexManager } from './memory_index_manager';
|
|
@@ -43,6 +45,7 @@ export declare class MemoryPersistence implements Persistence {
|
|
|
43
45
|
*/
|
|
44
46
|
private readonly indexManager;
|
|
45
47
|
private mutationQueues;
|
|
48
|
+
private overlays;
|
|
46
49
|
private readonly remoteDocumentCache;
|
|
47
50
|
private readonly targetCache;
|
|
48
51
|
private readonly bundleCache;
|
|
@@ -62,8 +65,9 @@ export declare class MemoryPersistence implements Persistence {
|
|
|
62
65
|
get started(): boolean;
|
|
63
66
|
setDatabaseDeletedListener(): void;
|
|
64
67
|
setNetworkEnabled(): void;
|
|
65
|
-
getIndexManager(): MemoryIndexManager;
|
|
66
|
-
|
|
68
|
+
getIndexManager(user: User): MemoryIndexManager;
|
|
69
|
+
getDocumentOverlayCache(user: User): DocumentOverlayCache;
|
|
70
|
+
getMutationQueue(user: User, indexManager: IndexManager): MutationQueue;
|
|
67
71
|
getTargetCache(): MemoryTargetCache;
|
|
68
72
|
getRemoteDocumentCache(): MemoryRemoteDocumentCache;
|
|
69
73
|
getBundleCache(): MemoryBundleCache;
|
|
@@ -16,7 +16,6 @@
|
|
|
16
16
|
*/
|
|
17
17
|
import { Document } from '../model/document';
|
|
18
18
|
import { DocumentKey } from '../model/document_key';
|
|
19
|
-
import { IndexManager } from './index_manager';
|
|
20
19
|
import { PersistencePromise } from './persistence_promise';
|
|
21
20
|
import { PersistenceTransaction } from './persistence_transaction';
|
|
22
21
|
import { RemoteDocumentCache } from './remote_document_cache';
|
|
@@ -27,9 +26,8 @@ export interface MemoryRemoteDocumentCache extends RemoteDocumentCache {
|
|
|
27
26
|
/**
|
|
28
27
|
* Creates a new memory-only RemoteDocumentCache.
|
|
29
28
|
*
|
|
30
|
-
* @param indexManager - A class that manages collection group indices.
|
|
31
29
|
* @param sizer - Used to assess the size of a document. For eager GC, this is
|
|
32
30
|
* expected to just return 0 to avoid unnecessarily doing the work of
|
|
33
31
|
* calculating the size.
|
|
34
32
|
*/
|
|
35
|
-
export declare function newMemoryRemoteDocumentCache(
|
|
33
|
+
export declare function newMemoryRemoteDocumentCache(sizer: DocumentSizer): MemoryRemoteDocumentCache;
|
|
@@ -18,6 +18,7 @@ import { User } from '../auth/user';
|
|
|
18
18
|
import { TargetId } from '../core/types';
|
|
19
19
|
import { DocumentKey } from '../model/document_key';
|
|
20
20
|
import { BundleCache } from './bundle_cache';
|
|
21
|
+
import { DocumentOverlayCache } from './document_overlay_cache';
|
|
21
22
|
import { IndexManager } from './index_manager';
|
|
22
23
|
import { LocalStore } from './local_store';
|
|
23
24
|
import { MutationQueue } from './mutation_queue';
|
|
@@ -140,7 +141,7 @@ export interface Persistence {
|
|
|
140
141
|
* extent possible (e.g. in the case of uid switching from
|
|
141
142
|
* sally=>jack=>sally, sally's mutation queue will be preserved).
|
|
142
143
|
*/
|
|
143
|
-
getMutationQueue(user: User): MutationQueue;
|
|
144
|
+
getMutationQueue(user: User, indexManager: IndexManager): MutationQueue;
|
|
144
145
|
/**
|
|
145
146
|
* Returns a TargetCache representing the persisted cache of targets.
|
|
146
147
|
*
|
|
@@ -173,7 +174,12 @@ export interface Persistence {
|
|
|
173
174
|
* this is called. In particular, the memory-backed implementation does this
|
|
174
175
|
* to emulate the persisted implementation to the extent possible.
|
|
175
176
|
*/
|
|
176
|
-
getIndexManager(): IndexManager;
|
|
177
|
+
getIndexManager(user: User): IndexManager;
|
|
178
|
+
/**
|
|
179
|
+
* Returns a DocumentOverlayCache representing the documents that are mutated
|
|
180
|
+
* locally.
|
|
181
|
+
*/
|
|
182
|
+
getDocumentOverlayCache(user: User): DocumentOverlayCache;
|
|
177
183
|
/**
|
|
178
184
|
* Performs an operation inside a persistence transaction. Any reads or writes
|
|
179
185
|
* against persistence must be performed within a transaction. Writes will be
|
|
@@ -14,11 +14,12 @@
|
|
|
14
14
|
* See the License for the specific language governing permissions and
|
|
15
15
|
* limitations under the License.
|
|
16
16
|
*/
|
|
17
|
-
import { Query } from '../core/query';
|
|
18
17
|
import { SnapshotVersion } from '../core/snapshot_version';
|
|
19
18
|
import { DocumentKeySet, MutableDocumentMap } from '../model/collections';
|
|
20
19
|
import { MutableDocument } from '../model/document';
|
|
21
20
|
import { DocumentKey } from '../model/document_key';
|
|
21
|
+
import { ResourcePath } from '../model/path';
|
|
22
|
+
import { IndexManager } from './index_manager';
|
|
22
23
|
import { PersistencePromise } from './persistence_promise';
|
|
23
24
|
import { PersistenceTransaction } from './persistence_transaction';
|
|
24
25
|
import { RemoteDocumentChangeBuffer } from './remote_document_change_buffer';
|
|
@@ -30,6 +31,8 @@ import { RemoteDocumentChangeBuffer } from './remote_document_change_buffer';
|
|
|
30
31
|
* documents that are known to not exist.
|
|
31
32
|
*/
|
|
32
33
|
export interface RemoteDocumentCache {
|
|
34
|
+
/** Sets the index manager to use for managing the collectionGroup index. */
|
|
35
|
+
setIndexManager(indexManager: IndexManager): void;
|
|
33
36
|
/**
|
|
34
37
|
* Looks up an entry in the cache.
|
|
35
38
|
*
|
|
@@ -47,19 +50,14 @@ export interface RemoteDocumentCache {
|
|
|
47
50
|
*/
|
|
48
51
|
getEntries(transaction: PersistenceTransaction, documentKeys: DocumentKeySet): PersistencePromise<MutableDocumentMap>;
|
|
49
52
|
/**
|
|
50
|
-
*
|
|
53
|
+
* Returns the documents from the provided collection.
|
|
51
54
|
*
|
|
52
|
-
*
|
|
53
|
-
* should be re-filtered by the consumer before presenting them to the user.
|
|
54
|
-
*
|
|
55
|
-
* Cached NoDocument entries have no bearing on query results.
|
|
56
|
-
*
|
|
57
|
-
* @param query - The query to match documents against.
|
|
55
|
+
* @param collection - The collection to read.
|
|
58
56
|
* @param sinceReadTime - If not set to SnapshotVersion.min(), return only
|
|
59
57
|
* documents that have been read since this snapshot version (exclusive).
|
|
60
58
|
* @returns The set of matching documents.
|
|
61
59
|
*/
|
|
62
|
-
|
|
60
|
+
getAll(transaction: PersistenceTransaction, collection: ResourcePath, sinceReadTime: SnapshotVersion): PersistencePromise<MutableDocumentMap>;
|
|
63
61
|
/**
|
|
64
62
|
* Provides access to add or update the contents of the cache. The buffer
|
|
65
63
|
* handles proper size accounting for the change.
|
|
@@ -36,6 +36,7 @@ export declare class SimpleDbTransaction {
|
|
|
36
36
|
constructor(action: string, transaction: IDBTransaction);
|
|
37
37
|
get completionPromise(): Promise<void>;
|
|
38
38
|
abort(error?: Error): void;
|
|
39
|
+
maybeCommit(): void;
|
|
39
40
|
/**
|
|
40
41
|
* Returns a SimpleDbStore<KeyType, ValueType> for the specified store. All
|
|
41
42
|
* operations performed on the SimpleDbStore happen within the context of this
|
|
@@ -26,6 +26,10 @@ export declare class DocumentKey {
|
|
|
26
26
|
static empty(): DocumentKey;
|
|
27
27
|
/** Returns true if the document is in the specified collectionId. */
|
|
28
28
|
hasCollectionId(collectionId: string): boolean;
|
|
29
|
+
/** Returns the collection group (i.e. the name of the parent collection) for this key. */
|
|
30
|
+
getCollectionGroup(): string;
|
|
31
|
+
/** Returns the fully qualified path to the parent collection. */
|
|
32
|
+
getCollectionPath(): ResourcePath;
|
|
29
33
|
isEqual(other: DocumentKey | null): boolean;
|
|
30
34
|
toString(): string;
|
|
31
35
|
static comparator(k1: DocumentKey, k2: DocumentKey): number;
|
|
@@ -43,7 +43,7 @@ export declare class FieldIndex {
|
|
|
43
43
|
/** The collection ID this index applies to. */
|
|
44
44
|
readonly collectionGroup: string;
|
|
45
45
|
/** The field segments for this index. */
|
|
46
|
-
readonly
|
|
46
|
+
readonly fields: IndexSegment[];
|
|
47
47
|
/** Shows how up-to-date the index is for the current user. */
|
|
48
48
|
readonly indexState: IndexState;
|
|
49
49
|
/** An ID for an index that has not yet been added to persistence. */
|
|
@@ -57,7 +57,7 @@ export declare class FieldIndex {
|
|
|
57
57
|
/** The collection ID this index applies to. */
|
|
58
58
|
collectionGroup: string,
|
|
59
59
|
/** The field segments for this index. */
|
|
60
|
-
|
|
60
|
+
fields: IndexSegment[],
|
|
61
61
|
/** Shows how up-to-date the index is for the current user. */
|
|
62
62
|
indexState: IndexState);
|
|
63
63
|
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Copyright 2022 Google LLC
|
|
4
|
+
*
|
|
5
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
6
|
+
* you may not use this file except in compliance with the License.
|
|
7
|
+
* You may obtain a copy of the License at
|
|
8
|
+
*
|
|
9
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
|
10
|
+
*
|
|
11
|
+
* Unless required by applicable law or agreed to in writing, software
|
|
12
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
13
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
14
|
+
* See the License for the specific language governing permissions and
|
|
15
|
+
* limitations under the License.
|
|
16
|
+
*/
|
|
17
|
+
import { DocumentKey } from './document_key';
|
|
18
|
+
import { Mutation } from './mutation';
|
|
19
|
+
/**
|
|
20
|
+
* Representation of an overlay computed by Firestore.
|
|
21
|
+
*
|
|
22
|
+
* Holds information about a mutation and the largest batch id in Firestore when
|
|
23
|
+
* the mutation was created.
|
|
24
|
+
*/
|
|
25
|
+
export declare class Overlay {
|
|
26
|
+
readonly largestBatchId: number;
|
|
27
|
+
readonly mutation: Mutation;
|
|
28
|
+
constructor(largestBatchId: number, mutation: Mutation);
|
|
29
|
+
getKey(): DocumentKey;
|
|
30
|
+
isEqual(other: Overlay | null): boolean;
|
|
31
|
+
toString(): string;
|
|
32
|
+
}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Copyright 2022 Google LLC
|
|
4
|
+
*
|
|
5
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
6
|
+
* you may not use this file except in compliance with the License.
|
|
7
|
+
* You may obtain a copy of the License at
|
|
8
|
+
*
|
|
9
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
|
10
|
+
*
|
|
11
|
+
* Unless required by applicable law or agreed to in writing, software
|
|
12
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
13
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
14
|
+
* See the License for the specific language governing permissions and
|
|
15
|
+
* limitations under the License.
|
|
16
|
+
*/
|
|
17
|
+
import { Target } from '../core/target';
|
|
18
|
+
import { FieldIndex } from './field_index';
|
|
19
|
+
/**
|
|
20
|
+
* A light query planner for Firestore.
|
|
21
|
+
*
|
|
22
|
+
* This class matches a `FieldIndex` against a Firestore Query `Target`. It
|
|
23
|
+
* determines whether a given index can be used to serve the specified target.
|
|
24
|
+
*
|
|
25
|
+
* The following table showcases some possible index configurations:
|
|
26
|
+
*
|
|
27
|
+
* Query | Index
|
|
28
|
+
* -----------------------------------------------------------------------------
|
|
29
|
+
* where('a', '==', 'a').where('b', '==', 'b') | a ASC, b DESC
|
|
30
|
+
* where('a', '==', 'a').where('b', '==', 'b') | a ASC
|
|
31
|
+
* where('a', '==', 'a').where('b', '==', 'b') | b DESC
|
|
32
|
+
* where('a', '>=', 'a').orderBy('a') | a ASC
|
|
33
|
+
* where('a', '>=', 'a').orderBy('a', 'desc') | a DESC
|
|
34
|
+
* where('a', '>=', 'a').orderBy('a').orderBy('b') | a ASC, b ASC
|
|
35
|
+
* where('a', '>=', 'a').orderBy('a').orderBy('b') | a ASC
|
|
36
|
+
* where('a', 'array-contains', 'a').orderBy('b') | a CONTAINS, b ASCENDING
|
|
37
|
+
* where('a', 'array-contains', 'a').orderBy('b') | a CONTAINS
|
|
38
|
+
*/
|
|
39
|
+
export declare class TargetIndexMatcher {
|
|
40
|
+
private readonly collectionId;
|
|
41
|
+
private readonly inequalityFilter?;
|
|
42
|
+
private readonly equalityFilters;
|
|
43
|
+
private readonly orderBys;
|
|
44
|
+
constructor(target: Target);
|
|
45
|
+
/**
|
|
46
|
+
* Returns whether the index can be used to serve the TargetIndexMatcher's
|
|
47
|
+
* target.
|
|
48
|
+
*
|
|
49
|
+
* An index is considered capable of serving the target when:
|
|
50
|
+
* - The target uses all index segments for its filters and orderBy clauses.
|
|
51
|
+
* The target can have additional filter and orderBy clauses, but not
|
|
52
|
+
* fewer.
|
|
53
|
+
* - If an ArrayContains/ArrayContainsAnyfilter is used, the index must also
|
|
54
|
+
* have a corresponding `CONTAINS` segment.
|
|
55
|
+
* - All directional index segments can be mapped to the target as a series of
|
|
56
|
+
* equality filters, a single inequality filter and a series of orderBy
|
|
57
|
+
* clauses.
|
|
58
|
+
* - The segments that represent the equality filters may appear out of order.
|
|
59
|
+
* - The optional segment for the inequality filter must appear after all
|
|
60
|
+
* equality segments.
|
|
61
|
+
* - The segments that represent that orderBy clause of the target must appear
|
|
62
|
+
* in order after all equality and inequality segments. Single orderBy
|
|
63
|
+
* clauses cannot be skipped, but a continuous orderBy suffix may be
|
|
64
|
+
* omitted.
|
|
65
|
+
*/
|
|
66
|
+
servedByIndex(index: FieldIndex): boolean;
|
|
67
|
+
private hasMatchingEqualityFilter;
|
|
68
|
+
private matchesFilter;
|
|
69
|
+
private matchesOrderBy;
|
|
70
|
+
}
|
|
@@ -31,7 +31,7 @@ export declare class CountingQueryEngine extends QueryEngine {
|
|
|
31
31
|
* `getAllMutationBatchesAffectingQuery()` API (since the last call to
|
|
32
32
|
* `resetCounts()`)
|
|
33
33
|
*/
|
|
34
|
-
|
|
34
|
+
mutationsReadByCollection: number;
|
|
35
35
|
/**
|
|
36
36
|
* The number of mutations returned by the MutationQueue's
|
|
37
37
|
* `getAllMutationBatchesAffectingDocumentKey()` and
|
|
@@ -41,9 +41,9 @@ export declare class CountingQueryEngine extends QueryEngine {
|
|
|
41
41
|
mutationsReadByKey: number;
|
|
42
42
|
/**
|
|
43
43
|
* The number of documents returned by the RemoteDocumentCache's
|
|
44
|
-
* `
|
|
44
|
+
* `getAll()` API (since the last call to `resetCounts()`)
|
|
45
45
|
*/
|
|
46
|
-
|
|
46
|
+
documentsReadByCollection: number;
|
|
47
47
|
/**
|
|
48
48
|
* The number of documents returned by the RemoteDocumentCache's `getEntry()`
|
|
49
49
|
* and `getEntries()` APIs (since the last call to `resetCounts()`)
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -54,6 +54,7 @@ export declare function testIndexedDbPersistence(options?: {
|
|
|
54
54
|
dontPurgeData?: boolean;
|
|
55
55
|
synchronizeTabs?: boolean;
|
|
56
56
|
queue?: AsyncQueue;
|
|
57
|
+
schemaVersion?: number;
|
|
57
58
|
}, lruParams?: LruParams): Promise<IndexedDbPersistence>;
|
|
58
59
|
/** Creates and starts a MemoryPersistence instance for testing. */
|
|
59
60
|
export declare function testMemoryEagerPersistence(): Promise<MemoryPersistence>;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Copyright 2022 Google LLC
|
|
4
|
+
*
|
|
5
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
6
|
+
* you may not use this file except in compliance with the License.
|
|
7
|
+
* You may obtain a copy of the License at
|
|
8
|
+
*
|
|
9
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
|
10
|
+
*
|
|
11
|
+
* Unless required by applicable law or agreed to in writing, software
|
|
12
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
13
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
14
|
+
* See the License for the specific language governing permissions and
|
|
15
|
+
* limitations under the License.
|
|
16
|
+
*/
|
|
17
|
+
import { DocumentOverlayCache } from '../../../src/local/document_overlay_cache';
|
|
18
|
+
import { Persistence } from '../../../src/local/persistence';
|
|
19
|
+
import { DocumentKeySet } from '../../../src/model/collections';
|
|
20
|
+
import { DocumentKey } from '../../../src/model/document_key';
|
|
21
|
+
import { Mutation } from '../../../src/model/mutation';
|
|
22
|
+
import { Overlay } from '../../../src/model/overlay';
|
|
23
|
+
import { ResourcePath } from '../../../src/model/path';
|
|
24
|
+
/**
|
|
25
|
+
* A wrapper around a DocumentOverlayCache that automatically creates a
|
|
26
|
+
* transaction around every operation to reduce test boilerplate.
|
|
27
|
+
*/
|
|
28
|
+
export declare class TestDocumentOverlayCache {
|
|
29
|
+
private persistence;
|
|
30
|
+
private cache;
|
|
31
|
+
constructor(persistence: Persistence, cache: DocumentOverlayCache);
|
|
32
|
+
saveOverlays(largestBatch: number, data: Map<DocumentKey, Mutation>): Promise<void>;
|
|
33
|
+
getOverlay(key: DocumentKey): Promise<Overlay | null>;
|
|
34
|
+
getOverlayMutation(docKey: string): Promise<Mutation | null>;
|
|
35
|
+
getOverlaysForCollection(path: ResourcePath, sinceBatchId: number): Promise<Map<DocumentKey, Overlay>>;
|
|
36
|
+
getOverlaysForCollectionGroup(collectionGroup: string, sinceBatchId: number, count: number): Promise<Map<DocumentKey, Overlay>>;
|
|
37
|
+
removeOverlaysForBatchId(documentKeys: DocumentKeySet, batchId: number): Promise<void>;
|
|
38
|
+
}
|
|
@@ -14,8 +14,11 @@
|
|
|
14
14
|
* See the License for the specific language governing permissions and
|
|
15
15
|
* limitations under the License.
|
|
16
16
|
*/
|
|
17
|
+
import { Target } from '../../../src/core/target';
|
|
17
18
|
import { IndexManager } from '../../../src/local/index_manager';
|
|
18
19
|
import { Persistence } from '../../../src/local/persistence';
|
|
20
|
+
import { DocumentKeySet, DocumentMap } from '../../../src/model/collections';
|
|
21
|
+
import { FieldIndex, IndexOffset } from '../../../src/model/field_index';
|
|
19
22
|
import { ResourcePath } from '../../../src/model/path';
|
|
20
23
|
/**
|
|
21
24
|
* A wrapper around IndexManager that automatically creates a
|
|
@@ -27,4 +30,12 @@ export declare class TestIndexManager {
|
|
|
27
30
|
constructor(persistence: Persistence, indexManager: IndexManager);
|
|
28
31
|
addToCollectionParentIndex(collectionPath: ResourcePath): Promise<void>;
|
|
29
32
|
getCollectionParents(collectionId: string): Promise<ResourcePath[]>;
|
|
33
|
+
addFieldIndex(index: FieldIndex): Promise<void>;
|
|
34
|
+
deleteFieldIndex(index: FieldIndex): Promise<void>;
|
|
35
|
+
getFieldIndexes(collectionGroup?: string): Promise<FieldIndex[]>;
|
|
36
|
+
getFieldIndex(target: Target): Promise<FieldIndex | null>;
|
|
37
|
+
getDocumentsMatchingTarget(fieldIndex: FieldIndex, target: Target): Promise<DocumentKeySet>;
|
|
38
|
+
getNextCollectionGroupToUpdate(): Promise<string | null>;
|
|
39
|
+
updateCollectionGroup(collectionGroup: string, offset: IndexOffset): Promise<void>;
|
|
40
|
+
updateIndexEntries(documents: DocumentMap): Promise<void>;
|
|
30
41
|
}
|
|
@@ -14,13 +14,14 @@
|
|
|
14
14
|
* See the License for the specific language governing permissions and
|
|
15
15
|
* limitations under the License.
|
|
16
16
|
*/
|
|
17
|
-
import { Query } from '../../../src/core/query';
|
|
18
17
|
import { SnapshotVersion } from '../../../src/core/snapshot_version';
|
|
18
|
+
import { IndexManager } from '../../../src/local/index_manager';
|
|
19
19
|
import { Persistence } from '../../../src/local/persistence';
|
|
20
20
|
import { RemoteDocumentChangeBuffer } from '../../../src/local/remote_document_change_buffer';
|
|
21
21
|
import { DocumentKeySet, MutableDocumentMap } from '../../../src/model/collections';
|
|
22
22
|
import { MutableDocument } from '../../../src/model/document';
|
|
23
23
|
import { DocumentKey } from '../../../src/model/document_key';
|
|
24
|
+
import { ResourcePath } from '../../../src/model/path';
|
|
24
25
|
/**
|
|
25
26
|
* A wrapper around a RemoteDocumentCache that automatically creates a
|
|
26
27
|
* transaction around every operation to reduce test boilerplate.
|
|
@@ -29,6 +30,7 @@ export declare class TestRemoteDocumentCache {
|
|
|
29
30
|
private readonly persistence;
|
|
30
31
|
private readonly cache;
|
|
31
32
|
constructor(persistence: Persistence);
|
|
33
|
+
setIndexManager(indexManager: IndexManager): void;
|
|
32
34
|
/**
|
|
33
35
|
* Reads all of the documents first so we can safely add them and keep the size calculation in
|
|
34
36
|
* sync.
|
|
@@ -42,7 +44,7 @@ export declare class TestRemoteDocumentCache {
|
|
|
42
44
|
removeEntry(documentKey: DocumentKey, version?: SnapshotVersion): Promise<void>;
|
|
43
45
|
getEntry(documentKey: DocumentKey): Promise<MutableDocument>;
|
|
44
46
|
getEntries(documentKeys: DocumentKeySet): Promise<MutableDocumentMap>;
|
|
45
|
-
|
|
47
|
+
getAll(collection: ResourcePath, sinceReadTime: SnapshotVersion): Promise<MutableDocumentMap>;
|
|
46
48
|
getNewDocumentChanges(sinceReadTime: SnapshotVersion): Promise<{
|
|
47
49
|
changedDocs: MutableDocumentMap;
|
|
48
50
|
readTime: SnapshotVersion;
|
|
@@ -28,7 +28,7 @@ export declare class TestRemoteDocumentChangeBuffer {
|
|
|
28
28
|
buffer: RemoteDocumentChangeBuffer;
|
|
29
29
|
constructor(persistence: Persistence, buffer: RemoteDocumentChangeBuffer);
|
|
30
30
|
addEntry(document: MutableDocument, readTime: SnapshotVersion): void;
|
|
31
|
-
removeEntry(key: DocumentKey): void;
|
|
31
|
+
removeEntry(key: DocumentKey, readTime: SnapshotVersion): void;
|
|
32
32
|
getEntry(documentKey: DocumentKey): Promise<MutableDocument>;
|
|
33
33
|
apply(): Promise<void>;
|
|
34
34
|
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Copyright 2022 Google LLC
|
|
4
|
+
*
|
|
5
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
6
|
+
* you may not use this file except in compliance with the License.
|
|
7
|
+
* You may obtain a copy of the License at
|
|
8
|
+
*
|
|
9
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
|
10
|
+
*
|
|
11
|
+
* Unless required by applicable law or agreed to in writing, software
|
|
12
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
13
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
14
|
+
* See the License for the specific language governing permissions and
|
|
15
|
+
* limitations under the License.
|
|
16
|
+
*/
|
|
17
|
+
export {};
|
|
@@ -71,7 +71,7 @@ export declare function setMutation(keyStr: string, json: JsonObject<unknown>):
|
|
|
71
71
|
export declare function patchMutation(keyStr: string, json: JsonObject<unknown>, precondition?: Precondition): PatchMutation;
|
|
72
72
|
export declare function deleteMutation(keyStr: string): DeleteMutation;
|
|
73
73
|
export declare function mutationResult(testVersion: TestSnapshotVersion): MutationResult;
|
|
74
|
-
export declare function bound(values: unknown[],
|
|
74
|
+
export declare function bound(values: unknown[], inclusive: boolean): Bound;
|
|
75
75
|
export declare function query(resourcePath: string, ...constraints: Array<OrderBy | Filter>): Query;
|
|
76
76
|
export declare function targetData(targetId: TargetId, queryPurpose: TargetPurpose, path: string): TargetData;
|
|
77
77
|
export declare function noChangeEvent(targetId: number, snapshotVersion: number, resumeToken?: ByteString): RemoteEvent;
|
package/dist/index.d.ts
CHANGED
|
@@ -413,8 +413,7 @@ export declare class DocumentSnapshot<T = DocumentData> {
|
|
|
413
413
|
readonly metadata: SnapshotMetadata;
|
|
414
414
|
protected constructor();
|
|
415
415
|
/**
|
|
416
|
-
*
|
|
417
|
-
* exists. True if the document exists.
|
|
416
|
+
* Returns whether or not the data exists. True if the document exists.
|
|
418
417
|
*/
|
|
419
418
|
exists(): this is QueryDocumentSnapshot<T>;
|
|
420
419
|
/**
|