feat: Added missing API

Added a few new entities such as `DocumentChange`, `QueryDocumentSnapshot` etc.
`QuerySnapshot` now supports `docChanges()` API.
Added missing `doc()` method for the Web API (Firestore).
Getting `docs()` on a QuerySnapshot is now lazy loaded.
Added missing properties 'path' and 'ref' for DocumentSnapshot and DocumentReference.
Refactored out some redundant code.

Author: larssn

src/app/firestore/index.ts

@@ -1,19 +1,24 @@
 import * as firebase from "../../firebase";
+// import * as firebaseSdk from 'firebase/app';
 
-export module firestore {
-  export class Firestore {
+export namespace firestore {
+  export class Firestore /*implements firebaseSdk.firestore.Firestore*/ {
     collection(collectionPath: string): firebase.firestore.CollectionReference {
       return firebase.firestore.collection(collectionPath);
     }
 
+    doc(path: string): firebase.firestore.DocumentReference {
+      return firebase.firestore.docRef(path);
+    }
+
     FieldValue(): firebase.firestore.FieldValue {
       return <any>{
         type: undefined,
         value: undefined,
         serverTimestamp: () => "SERVER_TIMESTAMP",
         arrayUnion: (fields: Array<any>) => new firebase.firestore.FieldValue("ARRAY_UNION", fields),
         arrayRemove: (fields: Array<any>) => new firebase.firestore.FieldValue("ARRAY_REMOVE", fields)
-      }
+      };
     }
 
     GeoPoint(latitude: number, longitude: number): firebase.firestore.GeoPoint {

src/firebase-common.ts

@@ -8,8 +8,10 @@ import * as mlkit from "./mlkit";
 
 // note that this implementation is overridden for iOS
 export class FieldValue {
-  constructor(public type: firestore.FieldValueType, public value: any) {
-  };
+  constructor(
+    public type: firestore.FieldValueType,
+    public value: any,
+  ) { }
 
   serverTimestamp = () => "SERVER_TIMESTAMP";
   arrayUnion = (fields: Array<any>) => new FieldValue("ARRAY_UNION", fields);
@@ -204,19 +206,16 @@ export const firebase: any = {
 export abstract class DocumentSnapshot implements firestore.DocumentSnapshot {
   public data: () => firestore.DocumentData;
 
-  constructor(public id: string, public exists: boolean, documentData: firestore.DocumentData) {
+  constructor(
+    public id: string,
+    public exists: boolean,
+    documentData: firestore.DocumentData,
+    public ref: firestore.DocumentReference,
+  ) {
     this.data = () => exists ? documentData : undefined;
   }
 }
 
 export function isDocumentReference(object: any): object is firestore.DocumentReference {
   return object && object.discriminator === "docRef";
 }
-
-export class QuerySnapshot implements firestore.QuerySnapshot {
-  public docSnapshots: firestore.DocumentSnapshot[];
-
-  forEach(callback: (result: firestore.DocumentSnapshot) => void, thisArg?: any): void {
-    this.docSnapshots.map(snapshot => callback(snapshot));
-  }
-}