@firebase/firestore 3.4.3-canary.e80d18d65 → 3.4.4-canary.2dd99ae2d

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.
Files changed (88) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/dist/firestore/src/api/{query.d.ts → filter.d.ts} +0 -0
  3. package/dist/firestore/src/api.d.ts +1 -1
  4. package/dist/firestore/src/core/database_info.d.ts +1 -0
  5. package/dist/firestore/src/core/firestore_client.d.ts +2 -0
  6. package/dist/firestore/src/core/target.d.ts +26 -1
  7. package/dist/firestore/src/local/local_serializer.d.ts +1 -1
  8. package/dist/firestore/src/local/remote_document_change_buffer.d.ts +3 -12
  9. package/dist/firestore/src/model/document.d.ts +7 -0
  10. package/dist/firestore/src/model/document_key.d.ts +1 -0
  11. package/dist/firestore/src/model/field_index.d.ts +87 -7
  12. package/dist/firestore/src/model/values.d.ts +7 -0
  13. package/dist/firestore/test/unit/local/test_remote_document_cache.d.ts +1 -1
  14. package/dist/firestore/test/unit/model/field_index.test.d.ts +17 -0
  15. package/dist/firestore/test/unit/model/target.test.d.ts +17 -0
  16. package/dist/firestore/test/util/helpers.d.ts +8 -2
  17. package/dist/index.esm2017.js +3317 -3218
  18. package/dist/index.esm2017.js.map +1 -1
  19. package/dist/index.esm5.js +3685 -3620
  20. package/dist/index.esm5.js.map +1 -1
  21. package/dist/index.node.cjs.js +309 -152
  22. package/dist/index.node.cjs.js.map +1 -1
  23. package/dist/index.node.mjs +309 -152
  24. package/dist/index.node.mjs.map +1 -1
  25. package/dist/index.rn.js +3316 -3259
  26. package/dist/index.rn.js.map +1 -1
  27. package/dist/internal.d.ts +14 -12
  28. package/dist/lite/firestore/src/api/{query.d.ts → filter.d.ts} +0 -0
  29. package/dist/lite/firestore/src/api.d.ts +1 -1
  30. package/dist/lite/firestore/src/core/database_info.d.ts +1 -0
  31. package/dist/lite/firestore/src/core/firestore_client.d.ts +2 -0
  32. package/dist/lite/firestore/src/core/target.d.ts +26 -1
  33. package/dist/lite/firestore/src/local/local_serializer.d.ts +1 -1
  34. package/dist/lite/firestore/src/local/remote_document_change_buffer.d.ts +3 -12
  35. package/dist/lite/firestore/src/model/document.d.ts +7 -0
  36. package/dist/lite/firestore/src/model/document_key.d.ts +1 -0
  37. package/dist/lite/firestore/src/model/field_index.d.ts +87 -7
  38. package/dist/lite/firestore/src/model/values.d.ts +7 -0
  39. package/dist/lite/firestore/test/unit/local/test_remote_document_cache.d.ts +1 -1
  40. package/dist/lite/firestore/test/unit/model/field_index.test.d.ts +17 -0
  41. package/dist/lite/firestore/test/unit/model/target.test.d.ts +17 -0
  42. package/dist/lite/firestore/test/util/helpers.d.ts +8 -2
  43. package/dist/lite/index.browser.esm2017.js +20 -9
  44. package/dist/lite/index.browser.esm2017.js.map +1 -1
  45. package/dist/lite/index.browser.esm5.js +88 -81
  46. package/dist/lite/index.browser.esm5.js.map +1 -1
  47. package/dist/lite/index.node.cjs.js +20 -8
  48. package/dist/lite/index.node.cjs.js.map +1 -1
  49. package/dist/lite/index.node.mjs +20 -8
  50. package/dist/lite/index.node.mjs.map +1 -1
  51. package/dist/lite/index.rn.esm2017.js +20 -9
  52. package/dist/lite/index.rn.esm2017.js.map +1 -1
  53. package/dist/lite/internal.d.ts +9 -0
  54. package/dist/lite/packages/firestore/dist/lite/index.browser.esm2017.d.ts +1 -0
  55. package/dist/lite/packages/firestore/src/api/{query.d.ts → filter.d.ts} +0 -0
  56. package/dist/lite/packages/firestore/src/api.d.ts +1 -1
  57. package/dist/lite/packages/firestore/src/core/database_info.d.ts +1 -0
  58. package/dist/lite/packages/firestore/src/core/firestore_client.d.ts +2 -0
  59. package/dist/lite/packages/firestore/src/core/target.d.ts +26 -1
  60. package/dist/lite/packages/firestore/src/local/local_serializer.d.ts +1 -1
  61. package/dist/lite/packages/firestore/src/local/remote_document_change_buffer.d.ts +3 -12
  62. package/dist/lite/packages/firestore/src/model/document.d.ts +7 -0
  63. package/dist/lite/packages/firestore/src/model/document_key.d.ts +1 -0
  64. package/dist/lite/packages/firestore/src/model/field_index.d.ts +87 -7
  65. package/dist/lite/packages/firestore/src/model/values.d.ts +7 -0
  66. package/dist/lite/packages/firestore/test/unit/local/test_remote_document_cache.d.ts +1 -1
  67. package/dist/lite/packages/firestore/test/unit/model/field_index.test.d.ts +17 -0
  68. package/dist/lite/packages/firestore/test/unit/model/target.test.d.ts +17 -0
  69. package/dist/lite/packages/firestore/test/util/helpers.d.ts +8 -2
  70. package/dist/lite/private.d.ts +7 -0
  71. package/dist/packages/firestore/dist/index.esm2017.d.ts +183 -181
  72. package/dist/packages/firestore/src/api/{query.d.ts → filter.d.ts} +0 -0
  73. package/dist/packages/firestore/src/api.d.ts +1 -1
  74. package/dist/packages/firestore/src/core/database_info.d.ts +1 -0
  75. package/dist/packages/firestore/src/core/firestore_client.d.ts +2 -0
  76. package/dist/packages/firestore/src/core/target.d.ts +26 -1
  77. package/dist/packages/firestore/src/local/local_serializer.d.ts +1 -1
  78. package/dist/packages/firestore/src/local/remote_document_change_buffer.d.ts +3 -12
  79. package/dist/packages/firestore/src/model/document.d.ts +7 -0
  80. package/dist/packages/firestore/src/model/document_key.d.ts +1 -0
  81. package/dist/packages/firestore/src/model/field_index.d.ts +87 -7
  82. package/dist/packages/firestore/src/model/values.d.ts +7 -0
  83. package/dist/packages/firestore/test/unit/local/test_remote_document_cache.d.ts +1 -1
  84. package/dist/packages/firestore/test/unit/model/field_index.test.d.ts +17 -0
  85. package/dist/packages/firestore/test/unit/model/target.test.d.ts +17 -0
  86. package/dist/packages/firestore/test/util/helpers.d.ts +8 -2
  87. package/dist/private.d.ts +12 -12
  88. package/package.json +10 -10
@@ -20,7 +20,7 @@ export { LoadBundleTask, LoadBundleTaskProgress, TaskState } from './api/bundle'
20
20
  export { FirestoreSettings, PersistenceSettings } from './api/settings';
21
21
  export { DocumentChange, DocumentSnapshot, QueryDocumentSnapshot, QuerySnapshot, snapshotEqual, SnapshotOptions, FirestoreDataConverter, DocumentChangeType, SnapshotMetadata } from './api/snapshot';
22
22
  export { DocumentReference, CollectionReference, Query, doc, collection, collectionGroup, SetOptions, DocumentData, UpdateData, WithFieldValue, PartialWithFieldValue, refEqual, queryEqual } from './api/reference';
23
- export { endAt, endBefore, startAt, startAfter, limit, limitToLast, where, orderBy, query, QueryConstraint, QueryConstraintType, OrderByDirection, WhereFilterOp } from './api/query';
23
+ export { endAt, endBefore, startAt, startAfter, limit, limitToLast, where, orderBy, query, QueryConstraint, QueryConstraintType, OrderByDirection, WhereFilterOp } from './api/filter';
24
24
  export { Unsubscribe, SnapshotListenOptions } from './api/reference_impl';
25
25
  export { runTransaction, Transaction } from './api/transaction';
26
26
  export { getDoc, getDocFromCache, getDocFromServer, getDocs, getDocsFromCache, getDocsFromServer, onSnapshot, onSnapshotsInSync, setDoc, updateDoc, deleteDoc, addDoc, executeWrite } from './api/reference_impl';
@@ -50,6 +50,7 @@ export declare class DatabaseId {
50
50
  readonly projectId: string;
51
51
  readonly database: string;
52
52
  constructor(projectId: string, database?: string);
53
+ static empty(): DatabaseId;
53
54
  get isDefaultDatabase(): boolean;
54
55
  isEqual(other: {}): boolean;
55
56
  }
@@ -53,6 +53,7 @@ export declare class FirestoreClient {
53
53
  private user;
54
54
  private readonly clientId;
55
55
  private authCredentialListener;
56
+ private appCheckCredentialListener;
56
57
  offlineComponents?: OfflineComponentProvider;
57
58
  onlineComponents?: OnlineComponentProvider;
58
59
  constructor(authCredentials: CredentialsProvider<User>, appCheckCredentials: CredentialsProvider<string>,
@@ -67,6 +68,7 @@ export declare class FirestoreClient {
67
68
  asyncQueue: AsyncQueue, databaseInfo: DatabaseInfo);
68
69
  getConfiguration(): Promise<ComponentConfiguration>;
69
70
  setCredentialChangeListener(listener: (user: User) => Promise<void>): void;
71
+ setAppCheckTokenChangeListener(listener: (appCheckToken: string, user: User) => Promise<void>): void;
70
72
  /**
71
73
  * Checks that the client has not been terminated. Ensures that other methods on
72
74
  * this class cannot be called after the client is terminated.
@@ -15,6 +15,7 @@
15
15
  * limitations under the License.
16
16
  */
17
17
  import { Document } from '../model/document';
18
+ import { FieldIndex } from '../model/field_index';
18
19
  import { FieldPath, ResourcePath } from '../model/path';
19
20
  import { Value as ProtoValue } from '../protos/firestore_proto_api';
20
21
  /**
@@ -56,7 +57,31 @@ export declare function newTarget(path: ResourcePath, collectionGroup?: string |
56
57
  export declare function canonifyTarget(target: Target): string;
57
58
  export declare function stringifyTarget(target: Target): string;
58
59
  export declare function targetEquals(left: Target, right: Target): boolean;
59
- export declare function isDocumentTarget(target: Target): boolean;
60
+ export declare function targetIsDocumentTarget(target: Target): boolean;
61
+ /** Returns the field filters that target the given field path. */
62
+ export declare function targetGetFieldFiltersForPath(target: Target, path: FieldPath): FieldFilter[];
63
+ /**
64
+ * Returns the values that are used in ARRAY_CONTAINS or ARRAY_CONTAINS_ANY
65
+ * filters. Returns `null` if there are no such filters.
66
+ */
67
+ export declare function targetGetArrayValues(target: Target, fieldIndex: FieldIndex): ProtoValue[] | null;
68
+ /**
69
+ * Returns the list of values that are used in != or NOT_IN filters. Returns
70
+ * `null` if there are no such filters.
71
+ */
72
+ export declare function targetGetNotInValues(target: Target, fieldIndex: FieldIndex): ProtoValue[] | null;
73
+ /**
74
+ * Returns a lower bound of field values that can be used as a starting point to
75
+ * scan the index defined by `fieldIndex`. Returns `null` if no lower bound
76
+ * exists.
77
+ */
78
+ export declare function targetGetLowerBound(target: Target, fieldIndex: FieldIndex): Bound | null;
79
+ /**
80
+ * Returns an upper bound of field values that can be used as an ending point
81
+ * when scanning the index defined by `fieldIndex`. Returns `null` if no
82
+ * upper bound exists.
83
+ */
84
+ export declare function targetGetUpperBound(target: Target, fieldIndex: FieldIndex): Bound | null;
60
85
  export declare abstract class Filter {
61
86
  abstract matches(doc: Document): boolean;
62
87
  }
@@ -31,7 +31,7 @@ export declare class LocalSerializer {
31
31
  /** Decodes a remote document from storage locally to a Document. */
32
32
  export declare function fromDbRemoteDocument(localSerializer: LocalSerializer, remoteDoc: DbRemoteDocument): MutableDocument;
33
33
  /** Encodes a document for storage locally. */
34
- export declare function toDbRemoteDocument(localSerializer: LocalSerializer, document: MutableDocument, readTime: SnapshotVersion): DbRemoteDocument;
34
+ export declare function toDbRemoteDocument(localSerializer: LocalSerializer, document: MutableDocument): DbRemoteDocument;
35
35
  export declare function toDbTimestampKey(snapshotVersion: SnapshotVersion): DbTimestampKey;
36
36
  export declare function fromDbTimestampKey(dbTimestampKey: DbTimestampKey): SnapshotVersion;
37
37
  /** Encodes a batch of mutations into a DbMutationBatch for local storage. */
@@ -21,13 +21,6 @@ import { DocumentKey } from '../model/document_key';
21
21
  import { ObjectMap } from '../util/obj_map';
22
22
  import { PersistencePromise } from './persistence_promise';
23
23
  import { PersistenceTransaction } from './persistence_transaction';
24
- /**
25
- * Represents a document change to be applied to remote document cache.
26
- */
27
- interface RemoteDocumentChange {
28
- readonly document: MutableDocument;
29
- readonly readTime: SnapshotVersion | null;
30
- }
31
24
  /**
32
25
  * An in-memory buffer of entries to be written to a RemoteDocumentCache.
33
26
  * It can be used to batch up a set of changes to be written to the cache, but
@@ -43,26 +36,25 @@ interface RemoteDocumentChange {
43
36
  * porting this class as part of that implementation work.
44
37
  */
45
38
  export declare abstract class RemoteDocumentChangeBuffer {
46
- protected changes: ObjectMap<DocumentKey, RemoteDocumentChange>;
39
+ protected changes: ObjectMap<DocumentKey, MutableDocument>;
47
40
  private changesApplied;
48
41
  protected abstract getFromCache(transaction: PersistenceTransaction, documentKey: DocumentKey): PersistencePromise<MutableDocument>;
49
42
  protected abstract getAllFromCache(transaction: PersistenceTransaction, documentKeys: DocumentKeySet): PersistencePromise<MutableDocumentMap>;
50
43
  protected abstract applyChanges(transaction: PersistenceTransaction): PersistencePromise<void>;
51
- protected getReadTime(key: DocumentKey): SnapshotVersion;
52
44
  /**
53
45
  * Buffers a `RemoteDocumentCache.addEntry()` call.
54
46
  *
55
47
  * You can only modify documents that have already been retrieved via
56
48
  * `getEntry()/getEntries()` (enforced via IndexedDbs `apply()`).
57
49
  */
58
- addEntry(document: MutableDocument, readTime: SnapshotVersion): void;
50
+ addEntry(document: MutableDocument): void;
59
51
  /**
60
52
  * Buffers a `RemoteDocumentCache.removeEntry()` call.
61
53
  *
62
54
  * You can only remove documents that have already been retrieved via
63
55
  * `getEntry()/getEntries()` (enforced via IndexedDbs `apply()`).
64
56
  */
65
- removeEntry(key: DocumentKey, readTime?: SnapshotVersion | null): void;
57
+ removeEntry(key: DocumentKey, readTime: SnapshotVersion): void;
66
58
  /**
67
59
  * Looks up an entry in the cache. The buffered changes will first be checked,
68
60
  * and if no buffered change applies, this will forward to
@@ -94,4 +86,3 @@ export declare abstract class RemoteDocumentChangeBuffer {
94
86
  /** Helper to assert this.changes is not null */
95
87
  protected assertNotApplied(): void;
96
88
  }
97
- export {};
@@ -30,6 +30,11 @@ export interface Document {
30
30
  * document was guaranteed to not exist.
31
31
  */
32
32
  readonly version: SnapshotVersion;
33
+ /**
34
+ * The timestamp at which this document was read from the remote server. Uses
35
+ * `SnapshotVersion.min()` for documents created by the user.
36
+ */
37
+ readonly readTime: SnapshotVersion;
33
38
  /** The underlying data of this document or an empty value if no data exists. */
34
39
  readonly data: ObjectValue;
35
40
  /** Returns whether local mutations were applied via the mutation queue. */
@@ -79,6 +84,7 @@ export declare class MutableDocument implements Document {
79
84
  readonly key: DocumentKey;
80
85
  private documentType;
81
86
  version: SnapshotVersion;
87
+ readTime: SnapshotVersion;
82
88
  data: ObjectValue;
83
89
  private documentState;
84
90
  private constructor();
@@ -118,6 +124,7 @@ export declare class MutableDocument implements Document {
118
124
  convertToUnknownDocument(version: SnapshotVersion): MutableDocument;
119
125
  setHasCommittedMutations(): MutableDocument;
120
126
  setHasLocalMutations(): MutableDocument;
127
+ setReadTime(readTime: SnapshotVersion): MutableDocument;
121
128
  get hasLocalMutations(): boolean;
122
129
  get hasCommittedMutations(): boolean;
123
130
  get hasPendingWrites(): boolean;
@@ -23,6 +23,7 @@ export declare class DocumentKey {
23
23
  constructor(path: ResourcePath);
24
24
  static fromPath(path: string): DocumentKey;
25
25
  static fromName(name: string): DocumentKey;
26
+ static empty(): DocumentKey;
26
27
  /** Returns true if the document is in the specified collectionId. */
27
28
  hasCollectionId(collectionId: string): boolean;
28
29
  isEqual(other: DocumentKey | null): boolean;
@@ -14,7 +14,15 @@
14
14
  * See the License for the specific language governing permissions and
15
15
  * limitations under the License.
16
16
  */
17
+ import { SnapshotVersion } from '../core/snapshot_version';
18
+ import { Document } from './document';
19
+ import { DocumentKey } from './document_key';
17
20
  import { FieldPath } from './path';
21
+ /**
22
+ * The initial sequence number for each index. Gets updated during index
23
+ * backfill.
24
+ */
25
+ export declare const INITIAL_SEQUENCE_NUMBER = 0;
18
26
  /**
19
27
  * An index definition for field indexes in Firestore.
20
28
  *
@@ -35,9 +43,11 @@ export declare class FieldIndex {
35
43
  /** The collection ID this index applies to. */
36
44
  readonly collectionGroup: string;
37
45
  /** The field segments for this index. */
38
- readonly segments: Segment[];
46
+ readonly segments: IndexSegment[];
47
+ /** Shows how up-to-date the index is for the current user. */
48
+ readonly indexState: IndexState;
39
49
  /** An ID for an index that has not yet been added to persistence. */
40
- static UNKNOWN_ID: -1;
50
+ static UNKNOWN_ID: number;
41
51
  constructor(
42
52
  /**
43
53
  * The index ID. Returns -1 if the index ID is not available (e.g. the index
@@ -47,10 +57,21 @@ export declare class FieldIndex {
47
57
  /** The collection ID this index applies to. */
48
58
  collectionGroup: string,
49
59
  /** The field segments for this index. */
50
- segments: Segment[]);
60
+ segments: IndexSegment[],
61
+ /** Shows how up-to-date the index is for the current user. */
62
+ indexState: IndexState);
51
63
  }
64
+ /** Returns the ArrayContains/ArrayContainsAny segment for this index. */
65
+ export declare function fieldIndexGetArraySegment(fieldIndex: FieldIndex): IndexSegment | undefined;
66
+ /** Returns all directional (ascending/descending) segments for this index. */
67
+ export declare function fieldIndexGetDirectionalSegments(fieldIndex: FieldIndex): IndexSegment[];
68
+ /**
69
+ * Compares indexes by collection group and segments. Ignores update time and
70
+ * index ID.
71
+ */
72
+ export declare function fieldIndexSemanticComparator(left: FieldIndex, right: FieldIndex): number;
52
73
  /** The type of the index, e.g. for which type of query it can be used. */
53
- export declare const enum Kind {
74
+ export declare const enum IndexKind {
54
75
  /**
55
76
  * Ordered index. Can be used for <, <=, ==, >=, >, !=, IN and NOT IN queries.
56
77
  */
@@ -63,14 +84,73 @@ export declare const enum Kind {
63
84
  CONTAINS = 2
64
85
  }
65
86
  /** An index component consisting of field path and index type. */
66
- export declare class Segment {
87
+ export declare class IndexSegment {
67
88
  /** The field path of the component. */
68
89
  readonly fieldPath: FieldPath;
69
90
  /** The fields sorting order. */
70
- readonly kind: Kind;
91
+ readonly kind: IndexKind;
71
92
  constructor(
72
93
  /** The field path of the component. */
73
94
  fieldPath: FieldPath,
74
95
  /** The fields sorting order. */
75
- kind: Kind);
96
+ kind: IndexKind);
97
+ }
98
+ /**
99
+ * Stores the "high water mark" that indicates how updated the Index is for the
100
+ * current user.
101
+ */
102
+ export declare class IndexState {
103
+ /**
104
+ * Indicates when the index was last updated (relative to other indexes).
105
+ */
106
+ readonly sequenceNumber: number;
107
+ /** The the latest indexed read time, document and batch id. */
108
+ readonly offset: IndexOffset;
109
+ constructor(
110
+ /**
111
+ * Indicates when the index was last updated (relative to other indexes).
112
+ */
113
+ sequenceNumber: number,
114
+ /** The the latest indexed read time, document and batch id. */
115
+ offset: IndexOffset);
116
+ /** The state of an index that has not yet been backfilled. */
117
+ static empty(): IndexState;
118
+ }
119
+ /**
120
+ * Creates an offset that matches all documents with a read time higher than
121
+ * `readTime`.
122
+ */
123
+ export declare function newIndexOffsetSuccessorFromReadTime(readTime: SnapshotVersion, largestBatchId: number): IndexOffset;
124
+ /** Creates a new offset based on the provided document. */
125
+ export declare function newIndexOffsetFromDocument(document: Document): IndexOffset;
126
+ /**
127
+ * Stores the latest read time, document and batch ID that were processed for an
128
+ * index.
129
+ */
130
+ export declare class IndexOffset {
131
+ /**
132
+ * The latest read time version that has been indexed by Firestore for this
133
+ * field index.
134
+ */
135
+ readonly readTime: SnapshotVersion;
136
+ /**
137
+ * The key of the last document that was indexed for this query. Use
138
+ * `DocumentKey.empty()` if no document has been indexed.
139
+ */
140
+ readonly documentKey: DocumentKey;
141
+ readonly largestBatchId: number;
142
+ constructor(
143
+ /**
144
+ * The latest read time version that has been indexed by Firestore for this
145
+ * field index.
146
+ */
147
+ readTime: SnapshotVersion,
148
+ /**
149
+ * The key of the last document that was indexed for this query. Use
150
+ * `DocumentKey.empty()` if no document has been indexed.
151
+ */
152
+ documentKey: DocumentKey, largestBatchId: number);
153
+ /** The state of an index that has not yet been backfilled. */
154
+ static min(): IndexOffset;
76
155
  }
156
+ export declare function indexOffsetComparator(left: IndexOffset, right: IndexOffset): number;
@@ -19,6 +19,7 @@ import { ArrayValue, MapValue, Value } from '../protos/firestore_proto_api';
19
19
  import { DocumentKey } from './document_key';
20
20
  import { TypeOrder } from './type_order';
21
21
  export declare const MAX_VALUE: Value;
22
+ export declare const MIN_VALUE: Value;
22
23
  /** Extracts the backend's type order for the provided value. */
23
24
  export declare function typeOrder(value: Value): TypeOrder;
24
25
  /** Tests `left` and `right` for equality based on the backend semantics. */
@@ -76,3 +77,9 @@ export declare function isMapValue(value?: Value | null): value is {
76
77
  export declare function deepClone(source: Value): Value;
77
78
  /** Returns true if the Value represents the canonical {@link #MAX_VALUE} . */
78
79
  export declare function isMaxValue(value: Value): boolean;
80
+ /** Returns the lowest value for the given value type (inclusive). */
81
+ export declare function valuesGetLowerBound(value: Value): Value;
82
+ /** Returns the largest value for the given value type (exclusive). */
83
+ export declare function valuesGetUpperBound(value: Value): Value;
84
+ export declare function valuesMax(left: Value | undefined, right: Value | undefined): Value | undefined;
85
+ export declare function valuesMin(left: Value | undefined, right: Value | undefined): Value | undefined;
@@ -33,7 +33,7 @@ export declare class TestRemoteDocumentCache {
33
33
  * Reads all of the documents first so we can safely add them and keep the size calculation in
34
34
  * sync.
35
35
  */
36
- addEntries(documents: MutableDocument[], readTime: SnapshotVersion): Promise<void>;
36
+ addEntries(documents: MutableDocument[]): Promise<void>;
37
37
  /**
38
38
  * Adds a single document using the document's version as its read time.
39
39
  * Reads the document first to track the document size internally.
@@ -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 {};
@@ -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 {};
@@ -14,7 +14,7 @@
14
14
  * See the License for the specific language governing permissions and
15
15
  * limitations under the License.
16
16
  */
17
- import { Bytes, DocumentReference, OrderByDirection } from '../../src';
17
+ import { Bytes, DocumentReference } from '../../src';
18
18
  import { BundledDocuments } from '../../src/core/bundle';
19
19
  import { DatabaseId } from '../../src/core/database_info';
20
20
  import { Query } from '../../src/core/query';
@@ -30,6 +30,7 @@ import { Document, MutableDocument } from '../../src/model/document';
30
30
  import { DocumentComparator } from '../../src/model/document_comparator';
31
31
  import { DocumentKey } from '../../src/model/document_key';
32
32
  import { DocumentSet } from '../../src/model/document_set';
33
+ import { FieldIndex, IndexKind, IndexOffset } from '../../src/model/field_index';
33
34
  import { FieldMask } from '../../src/model/field_mask';
34
35
  import { DeleteMutation, MutationResult, PatchMutation, Precondition, SetMutation } from '../../src/model/mutation';
35
36
  import { JsonObject, ObjectValue } from '../../src/model/object_value';
@@ -58,6 +59,11 @@ export declare function key(path: string): DocumentKey;
58
59
  export declare function keys(...documents: Array<Document | string>): DocumentKeySet;
59
60
  export declare function path(path: string, offset?: number): ResourcePath;
60
61
  export declare function field(path: string): FieldPath;
62
+ export declare function fieldIndex(collectionGroup: string, options?: {
63
+ id?: number;
64
+ fields?: Array<[field: string, kind: IndexKind]>;
65
+ offset?: IndexOffset;
66
+ }): FieldIndex;
61
67
  export declare function mask(...paths: string[]): FieldMask;
62
68
  export declare function blob(...bytes: number[]): Bytes;
63
69
  export declare function filter(path: string, op: string, value: unknown): FieldFilter;
@@ -65,7 +71,7 @@ export declare function setMutation(keyStr: string, json: JsonObject<unknown>):
65
71
  export declare function patchMutation(keyStr: string, json: JsonObject<unknown>, precondition?: Precondition): PatchMutation;
66
72
  export declare function deleteMutation(keyStr: string): DeleteMutation;
67
73
  export declare function mutationResult(testVersion: TestSnapshotVersion): MutationResult;
68
- export declare function bound(values: Array<[string, {}, OrderByDirection]>, before: boolean): Bound;
74
+ export declare function bound(values: unknown[], before: boolean): Bound;
69
75
  export declare function query(resourcePath: string, ...constraints: Array<OrderBy | Filter>): Query;
70
76
  export declare function targetData(targetId: TargetId, queryPurpose: TargetPurpose, path: string): TargetData;
71
77
  export declare function noChangeEvent(targetId: number, snapshotVersion: number, resumeToken?: ByteString): RemoteEvent;
package/dist/private.d.ts CHANGED
@@ -757,6 +757,11 @@ declare interface Document_2 {
757
757
  * document was guaranteed to not exist.
758
758
  */
759
759
  readonly version: SnapshotVersion;
760
+ /**
761
+ * The timestamp at which this document was read from the remote server. Uses
762
+ * `SnapshotVersion.min()` for documents created by the user.
763
+ */
764
+ readonly readTime: SnapshotVersion;
760
765
  /** The underlying data of this document or an empty value if no data exists. */
761
766
  readonly data: ObjectValue;
762
767
  /** Returns whether local mutations were applied via the mutation queue. */
@@ -1352,6 +1357,7 @@ declare class FirestoreClient {
1352
1357
  private user;
1353
1358
  private readonly clientId;
1354
1359
  private authCredentialListener;
1360
+ private appCheckCredentialListener;
1355
1361
  offlineComponents?: OfflineComponentProvider;
1356
1362
  onlineComponents?: OnlineComponentProvider;
1357
1363
  constructor(authCredentials: CredentialsProvider<User>, appCheckCredentials: CredentialsProvider<string>,
@@ -1366,6 +1372,7 @@ declare class FirestoreClient {
1366
1372
  asyncQueue: AsyncQueue, databaseInfo: DatabaseInfo);
1367
1373
  getConfiguration(): Promise<ComponentConfiguration>;
1368
1374
  setCredentialChangeListener(listener: (user: User) => Promise<void>): void;
1375
+ setAppCheckTokenChangeListener(listener: (appCheckToken: string, user: User) => Promise<void>): void;
1369
1376
  /**
1370
1377
  * Checks that the client has not been terminated. Ensures that other methods on
1371
1378
  * this class cannot be called after the client is terminated.
@@ -2423,6 +2430,7 @@ declare class MutableDocument implements Document_2 {
2423
2430
  readonly key: _DocumentKey;
2424
2431
  private documentType;
2425
2432
  version: SnapshotVersion;
2433
+ readTime: SnapshotVersion;
2426
2434
  data: ObjectValue;
2427
2435
  private documentState;
2428
2436
  private constructor();
@@ -2462,6 +2470,7 @@ declare class MutableDocument implements Document_2 {
2462
2470
  convertToUnknownDocument(version: SnapshotVersion): MutableDocument;
2463
2471
  setHasCommittedMutations(): MutableDocument;
2464
2472
  setHasLocalMutations(): MutableDocument;
2473
+ setReadTime(readTime: SnapshotVersion): MutableDocument;
2465
2474
  get hasLocalMutations(): boolean;
2466
2475
  get hasCommittedMutations(): boolean;
2467
2476
  get hasPendingWrites(): boolean;
@@ -3778,14 +3787,6 @@ declare interface RemoteDocumentCache {
3778
3787
  getSize(transaction: PersistenceTransaction): PersistencePromise<number>;
3779
3788
  }
3780
3789
 
3781
- /**
3782
- * Represents a document change to be applied to remote document cache.
3783
- */
3784
- declare interface RemoteDocumentChange {
3785
- readonly document: MutableDocument;
3786
- readonly readTime: SnapshotVersion | null;
3787
- }
3788
-
3789
3790
  /**
3790
3791
  * An in-memory buffer of entries to be written to a RemoteDocumentCache.
3791
3792
  * It can be used to batch up a set of changes to be written to the cache, but
@@ -3801,26 +3802,25 @@ declare interface RemoteDocumentChange {
3801
3802
  * porting this class as part of that implementation work.
3802
3803
  */
3803
3804
  declare abstract class RemoteDocumentChangeBuffer {
3804
- protected changes: ObjectMap<_DocumentKey, RemoteDocumentChange>;
3805
+ protected changes: ObjectMap<_DocumentKey, MutableDocument>;
3805
3806
  private changesApplied;
3806
3807
  protected abstract getFromCache(transaction: PersistenceTransaction, documentKey: _DocumentKey): PersistencePromise<MutableDocument>;
3807
3808
  protected abstract getAllFromCache(transaction: PersistenceTransaction, documentKeys: DocumentKeySet): PersistencePromise<MutableDocumentMap>;
3808
3809
  protected abstract applyChanges(transaction: PersistenceTransaction): PersistencePromise<void>;
3809
- protected getReadTime(key: _DocumentKey): SnapshotVersion;
3810
3810
  /**
3811
3811
  * Buffers a `RemoteDocumentCache.addEntry()` call.
3812
3812
  *
3813
3813
  * You can only modify documents that have already been retrieved via
3814
3814
  * `getEntry()/getEntries()` (enforced via IndexedDbs `apply()`).
3815
3815
  */
3816
- addEntry(document: MutableDocument, readTime: SnapshotVersion): void;
3816
+ addEntry(document: MutableDocument): void;
3817
3817
  /**
3818
3818
  * Buffers a `RemoteDocumentCache.removeEntry()` call.
3819
3819
  *
3820
3820
  * You can only remove documents that have already been retrieved via
3821
3821
  * `getEntry()/getEntries()` (enforced via IndexedDbs `apply()`).
3822
3822
  */
3823
- removeEntry(key: _DocumentKey, readTime?: SnapshotVersion | null): void;
3823
+ removeEntry(key: _DocumentKey, readTime: SnapshotVersion): void;
3824
3824
  /**
3825
3825
  * Looks up an entry in the cache. The buffered changes will first be checked,
3826
3826
  * and if no buffered change applies, this will forward to
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@firebase/firestore",
3
- "version": "3.4.3-canary.e80d18d65",
3
+ "version": "3.4.4-canary.2dd99ae2d",
4
4
  "engines": {
5
5
  "node": ">=10.10.0"
6
6
  },
@@ -77,22 +77,22 @@
77
77
  "lite/package.json"
78
78
  ],
79
79
  "dependencies": {
80
- "@firebase/component": "0.5.10-canary.e80d18d65",
81
- "@firebase/logger": "0.3.2-canary.e80d18d65",
82
- "@firebase/util": "1.4.3-canary.e80d18d65",
83
- "@firebase/webchannel-wrapper": "0.6.1-canary.e80d18d65",
80
+ "@firebase/component": "0.5.10-canary.2dd99ae2d",
81
+ "@firebase/logger": "0.3.2-canary.2dd99ae2d",
82
+ "@firebase/util": "1.4.3-canary.2dd99ae2d",
83
+ "@firebase/webchannel-wrapper": "0.6.1-canary.2dd99ae2d",
84
84
  "@grpc/grpc-js": "^1.3.2",
85
85
  "@grpc/proto-loader": "^0.6.0",
86
- "node-fetch": "2.6.5",
86
+ "node-fetch": "2.6.7",
87
87
  "tslib": "^2.1.0"
88
88
  },
89
89
  "peerDependencies": {
90
- "@firebase/app": "0.7.14-canary.e80d18d65"
90
+ "@firebase/app": "0.7.15-canary.2dd99ae2d"
91
91
  },
92
92
  "devDependencies": {
93
- "@firebase/app": "0.7.14-canary.e80d18d65",
94
- "@firebase/app-compat": "0.1.15-canary.e80d18d65",
95
- "@firebase/auth": "0.19.6-canary.e80d18d65",
93
+ "@firebase/app": "0.7.15-canary.2dd99ae2d",
94
+ "@firebase/app-compat": "0.1.16-canary.2dd99ae2d",
95
+ "@firebase/auth": "0.19.7-canary.2dd99ae2d",
96
96
  "@rollup/plugin-alias": "3.1.5",
97
97
  "@rollup/plugin-json": "4.1.0",
98
98
  "@types/eslint": "7.28.0",