@firebase/firestore 3.7.3-canary.3bd031691 → 3.7.3-canary.734fdcd91

package/dist/firestore/src/local/local_documents_view.d.ts

@@ -121,6 +121,4 @@ export declare class LocalDocumentsView {
     private getDocumentsMatchingDocumentQuery;
     private getDocumentsMatchingCollectionGroupQuery;
     private getDocumentsMatchingCollectionQuery;
-    /** Returns a base document that can be used to apply `overlay`. */
-    private getBaseDocument;
 }

package/dist/firestore/src/model/document.d.ts

@@ -35,6 +35,12 @@ export interface Document {
      * `SnapshotVersion.min()` for documents created by the user.
      */
     readonly readTime: SnapshotVersion;
+    /**
+     * The timestamp at which the document was created. This value increases
+     * monotonically when a document is deleted then recreated. It can also be
+     * compared to `createTime` of other documents and the `readTime` of a query.
+     */
+    readonly createTime: SnapshotVersion;
     /** The underlying data of this document or an empty value if no data exists. */
     readonly data: ObjectValue;
     /** Returns whether local mutations were applied via the mutation queue. */
@@ -85,6 +91,7 @@ export declare class MutableDocument implements Document {
     private documentType;
     version: SnapshotVersion;
     readTime: SnapshotVersion;
+    createTime: SnapshotVersion;
     data: ObjectValue;
     private documentState;
     private constructor();
@@ -97,7 +104,7 @@ export declare class MutableDocument implements Document {
      * Creates a new document that is known to exist with the given data at the
      * given version.
      */
-    static newFoundDocument(documentKey: DocumentKey, version: SnapshotVersion, value: ObjectValue): MutableDocument;
+    static newFoundDocument(documentKey: DocumentKey, version: SnapshotVersion, createTime: SnapshotVersion, value: ObjectValue): MutableDocument;
     /** Creates a new document that is known to not exist at the given version. */
     static newNoDocument(documentKey: DocumentKey, version: SnapshotVersion): MutableDocument;
     /**

package/dist/firestore/test/unit/specs/spec_test_runner.d.ts

@@ -262,6 +262,7 @@ export interface SpecQuery {
 export interface SpecDocument {
     key: string;
     version: TestSnapshotVersion;
+    createTime: TestSnapshotVersion;
     value: JsonObject<unknown> | null;
     options?: DocumentOptions;
 }

package/dist/firestore/test/util/helpers.d.ts

@@ -49,7 +49,7 @@ export declare type TestSnapshotVersion = number;
 export declare function testUserDataReader(useProto3Json?: boolean): UserDataReader;
 export declare function version(v: TestSnapshotVersion): SnapshotVersion;
 export declare function ref(key: string, offset?: number): DocumentReference;
-export declare function doc(keyStr: string, ver: TestSnapshotVersion, jsonOrObjectValue: JsonObject<unknown> | ObjectValue): MutableDocument;
+export declare function doc(keyStr: string, ver: TestSnapshotVersion, jsonOrObjectValue: JsonObject<unknown> | ObjectValue, createTime?: TestSnapshotVersion): MutableDocument;
 export declare function deletedDoc(keyStr: string, ver: TestSnapshotVersion): MutableDocument;
 export declare function unknownDoc(keyStr: string, ver: TestSnapshotVersion): MutableDocument;
 export declare function removedDoc(keyStr: string): MutableDocument;

package/dist/index.esm2017.js

@@ -66,7 +66,7 @@ P.MOCK_USER = new P("mock-user");
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-let v = "9.14.0-canary.3bd031691";
+let v = "9.14.0-canary.734fdcd91";
 
 /**
  * @license
@@ -3828,38 +3828,56 @@ function He(t) {
  * applied, `isValidDocument()` returns false and the document should be removed
  * from all views.
  */ class Ze {
-    constructor(t, e, n, s, i, r) {
-        this.key = t, this.documentType = e, this.version = n, this.readTime = s, this.data = i, 
-        this.documentState = r;
+    constructor(t, e, n, s, i, r, o) {
+        this.key = t, this.documentType = e, this.version = n, this.readTime = s, this.createTime = i, 
+        this.data = r, this.documentState = o;
     }
     /**
      * Creates a document with no known version or data, but which can serve as
      * base document for mutations.
      */    static newInvalidDocument(t) {
-        return new Ze(t, 0 /* DocumentType.INVALID */ , st.min(), st.min(), Ye.empty(), 0 /* DocumentState.SYNCED */);
+        return new Ze(t, 0 /* DocumentType.INVALID */ , 
+        /* version */ st.min(), 
+        /* readTime */ st.min(), 
+        /* createTime */ st.min(), Ye.empty(), 0 /* DocumentState.SYNCED */);
     }
     /**
      * Creates a new document that is known to exist with the given data at the
      * given version.
-     */    static newFoundDocument(t, e, n) {
-        return new Ze(t, 1 /* DocumentType.FOUND_DOCUMENT */ , e, st.min(), n, 0 /* DocumentState.SYNCED */);
+     */    static newFoundDocument(t, e, n, s) {
+        return new Ze(t, 1 /* DocumentType.FOUND_DOCUMENT */ , 
+        /* version */ e, 
+        /* readTime */ st.min(), 
+        /* createTime */ n, s, 0 /* DocumentState.SYNCED */);
     }
     /** Creates a new document that is known to not exist at the given version. */    static newNoDocument(t, e) {
-        return new Ze(t, 2 /* DocumentType.NO_DOCUMENT */ , e, st.min(), Ye.empty(), 0 /* DocumentState.SYNCED */);
+        return new Ze(t, 2 /* DocumentType.NO_DOCUMENT */ , 
+        /* version */ e, 
+        /* readTime */ st.min(), 
+        /* createTime */ st.min(), Ye.empty(), 0 /* DocumentState.SYNCED */);
     }
     /**
      * Creates a new document that is known to exist at the given version but
      * whose data is not known (e.g. a document that was updated without a known
      * base document).
      */    static newUnknownDocument(t, e) {
-        return new Ze(t, 3 /* DocumentType.UNKNOWN_DOCUMENT */ , e, st.min(), Ye.empty(), 2 /* DocumentState.HAS_COMMITTED_MUTATIONS */);
+        return new Ze(t, 3 /* DocumentType.UNKNOWN_DOCUMENT */ , 
+        /* version */ e, 
+        /* readTime */ st.min(), 
+        /* createTime */ st.min(), Ye.empty(), 2 /* DocumentState.HAS_COMMITTED_MUTATIONS */);
     }
     /**
      * Changes the document type to indicate that it exists and that its version
      * and data are known.
      */    convertToFoundDocument(t, e) {
-        return this.version = t, this.documentType = 1 /* DocumentType.FOUND_DOCUMENT */ , 
-        this.data = e, this.documentState = 0 /* DocumentState.SYNCED */ , this;
+        // If a document is switching state from being an invalid or deleted
+        // document to a valid (FOUND_DOCUMENT) document, either due to receiving an
+        // update from Watch or due to applying a local set mutation on top
+        // of a deleted document, our best guess about its createTime would be the
+        // version at which the document transitioned to a FOUND_DOCUMENT.
+        return !this.createTime.isEqual(st.min()) || 2 /* DocumentType.NO_DOCUMENT */ !== this.documentType && 0 /* DocumentType.INVALID */ !== this.documentType || (this.createTime = t), 
+        this.version = t, this.documentType = 1 /* DocumentType.FOUND_DOCUMENT */ , this.data = e, 
+        this.documentState = 0 /* DocumentState.SYNCED */ , this;
     }
     /**
      * Changes the document type to indicate that it doesn't exist at the given
@@ -3912,10 +3930,10 @@ function He(t) {
         return t instanceof Ze && this.key.isEqual(t.key) && this.version.isEqual(t.version) && this.documentType === t.documentType && this.documentState === t.documentState && this.data.isEqual(t.data);
     }
     mutableCopy() {
-        return new Ze(this.key, this.documentType, this.version, this.readTime, this.data.clone(), this.documentState);
+        return new Ze(this.key, this.documentType, this.version, this.readTime, this.createTime, this.data.clone(), this.documentState);
     }
     toString() {
-        return `Document(${this.key}, ${this.version}, ${JSON.stringify(this.data.value)}, {documentType: ${this.documentType}}), {documentState: ${this.documentState}})`;
+        return `Document(${this.key}, ${this.version}, ${JSON.stringify(this.data.value)}, {createTime: ${this.createTime}}), {documentType: ${this.documentType}}), {documentState: ${this.documentState}})`;
     }
 }
 
@@ -5893,23 +5911,23 @@ function Hs(t) {
 }
 
 function Ys(t, e, n) {
-    const s = Qs(t, e.name), i = qs(e.updateTime), r = new Ye({
+    const s = Qs(t, e.name), i = qs(e.updateTime), r = e.createTime ? qs(e.createTime) : st.min(), o = new Ye({
         mapValue: {
             fields: e.fields
         }
-    }), o = Ze.newFoundDocument(s, i, r);
-    return n && o.setHasCommittedMutations(), n ? o.setHasCommittedMutations() : o;
+    }), u = Ze.newFoundDocument(s, i, r, o);
+    return n && u.setHasCommittedMutations(), n ? u.setHasCommittedMutations() : u;
 }
 
 function Xs(t, e) {
     return "found" in e ? function(t, e) {
         M(!!e.found), e.found.name, e.found.updateTime;
-        const n = Qs(t, e.found.name), s = qs(e.found.updateTime), i = new Ye({
+        const n = Qs(t, e.found.name), s = qs(e.found.updateTime), i = e.found.createTime ? qs(e.found.createTime) : st.min(), r = new Ye({
             mapValue: {
                 fields: e.found.fields
             }
         });
-        return Ze.newFoundDocument(n, s, i);
+        return Ze.newFoundDocument(n, s, i, r);
     }(t, e) : "missing" in e ? function(t, e) {
         M(!!e.missing), M(!!e.readTime);
         const n = Qs(t, e.missing), s = qs(e.readTime);
@@ -5945,12 +5963,12 @@ function Zs(t, e) {
         e.documentChange;
         const s = e.documentChange;
         s.document, s.document.name, s.document.updateTime;
-        const i = Qs(t, s.document.name), r = qs(s.document.updateTime), o = new Ye({
+        const i = Qs(t, s.document.name), r = qs(s.document.updateTime), o = s.document.createTime ? qs(s.document.createTime) : st.min(), u = new Ye({
             mapValue: {
                 fields: s.document.fields
             }
-        }), u = Ze.newFoundDocument(i, r, o), c = s.targetIds || [], a = s.removedTargetIds || [];
-        n = new vs(c, a, u.key, u);
+        }), c = Ze.newFoundDocument(i, r, o, u), a = s.targetIds || [], h = s.removedTargetIds || [];
+        n = new vs(a, h, c.key, c);
     } else if ("documentDelete" in e) {
         e.documentDelete;
         const s = e.documentDelete;
@@ -6829,7 +6847,8 @@ function Gi(t, e) {
         return {
             name: Gs(t, e.key),
             fields: e.data.value.mapValue.fields,
-            updateTime: $s(t, e.version.toTimestamp())
+            updateTime: $s(t, e.version.toTimestamp()),
+            createTime: $s(t, e.createTime.toTimestamp())
         };
     }(t.ie, e); else if (e.isNoDocument()) s.noDocument = {
         path: n.path.toArray(),
@@ -9791,7 +9810,7 @@ class yo {
      * state for it.
      */    getDocument(t, e) {
         let n = null;
-        return this.documentOverlayCache.getOverlay(t, e).next((s => (n = s, this.getBaseDocument(t, e, n)))).next((t => (null !== n && Jn(n.mutation, t, Je.empty(), nt.now()), 
+        return this.documentOverlayCache.getOverlay(t, e).next((s => (n = s, this.remoteDocumentCache.getEntry(t, e)))).next((t => (null !== n && Jn(n.mutation, t, Je.empty(), nt.now()), 
         t)));
     }
     /**
@@ -9945,7 +9964,7 @@ class yo {
             // the batch id.
                         let o = -1, u = i;
             return r.next((e => At.forEach(e, ((e, n) => (o < n.largestBatchId && (o = n.largestBatchId), 
-            i.get(e) ? At.resolve() : this.getBaseDocument(t, e, n).next((t => {
+            i.get(e) ? At.resolve() : this.remoteDocumentCache.getEntry(t, e).next((t => {
                 u = u.insert(e, t);
             }))))).next((() => this.populateOverlays(t, e, i))).next((() => this.computeViews(t, u, e, Es()))).next((t => ({
                 batchId: o,
@@ -9996,9 +10015,6 @@ class yo {
             })), n;
         }));
     }
-    /** Returns a base document that can be used to apply `overlay`. */    getBaseDocument(t, e, n) {
-        return null === n || 1 /* MutationType.Patch */ === n.mutation.type ? this.remoteDocumentCache.getEntry(t, e) : At.resolve(Ze.newInvalidDocument(e));
-    }
 }
 
 /**
@@ -20496,9 +20512,9 @@ function lf(t, e) {
         return s = Object.assign({
             useFetchStreams: e
         }, s), r._setSettings(s), r;
-    }), "PUBLIC").setMultipleInstances(!0)), registerVersion(b, "3.7.3-canary.3bd031691", t), 
+    }), "PUBLIC").setMultipleInstances(!0)), registerVersion(b, "3.7.3-canary.734fdcd91", t), 
     // BUILD_TARGET will be replaced by values like esm5, esm2017, cjs5, etc during the compilation
-    registerVersion(b, "3.7.3-canary.3bd031691", "esm2017");
+    registerVersion(b, "3.7.3-canary.734fdcd91", "esm2017");
 }();
 
 export { Pl as AbstractUserDataWriter, Sa as AggregateField, Da as AggregateQuerySnapshot, Ih as Bytes, sh as CACHE_SIZE_UNLIMITED, Ia as CollectionReference, ya as DocumentReference, Dl as DocumentSnapshot, Th as FieldPath, Ah as FieldValue, ih as Firestore, L as FirestoreError, Rh as GeoPoint, nh as LoadBundleTask, pa as Query, ol as QueryCompositeFilterConstraint, nl as QueryConstraint, Cl as QueryDocumentSnapshot, gl as QueryEndAtConstraint, il as QueryFieldFilterConstraint, ll as QueryLimitConstraint, al as QueryOrderByConstraint, xl as QuerySnapshot, _l as QueryStartAtConstraint, Sl as SnapshotMetadata, nt as Timestamp, ef as Transaction, Zl as WriteBatch, Ft as _DatabaseId, ct as _DocumentKey, J as _EmptyAppCheckTokenProvider, K as _EmptyAuthCredentialsProvider, ut as _FieldPath, fa as _cast, F as _debugAssert, Gt as _isBase64Available, N as _logWarn, ca as _validateIsNotUsedTogether, Ql as addDoc, Jl as aggregateQuerySnapshotEqual, cl as and, uf as arrayRemove, of as arrayUnion, fh as clearIndexedDbPersistence, Ta as collection, Ea as collectionGroup, ga as connectFirestoreEmulator, Gl as deleteDoc, sf as deleteField, wh as disableNetwork, Aa as doc, Eh as documentId, ah as enableIndexedDbPersistence, hh as enableMultiTabIndexedDbPersistence, _h as enableNetwork, pl as endAt, yl as endBefore, uh as ensureFirestoreConfigured, zl as executeWrite, Yl as getCountFromServer, Ol as getDoc, Fl as getDocFromCache, $l as getDocFromServer, Bl as getDocs, Ll as getDocsFromCache, ql as getDocsFromServer, oh as getFirestore, cf as increment, rh as initializeFirestore, fl as limit, dl as limitToLast, gh as loadBundle, yh as namedQuery, jl as onSnapshot, Wl as onSnapshotsInSync, ul as or, hl as orderBy, sl as query, ba as queryEqual, Ra as refEqual, nf as runTransaction, rf as serverTimestamp, Ul as setDoc, hf as setIndexConfiguration, D as setLogLevel, kl as snapshotEqual, ml as startAfter, wl as startAt, mh as terminate, Kl as updateDoc, dh as waitForPendingWrites, rl as where, af as writeBatch };