Add toJSON() support for Firestore classes

.changeset/clean-meals-double.md

@@ -0,0 +1,8 @@
+---
+'@firebase/app-compat': patch
+'@firebase/app': patch
+'@firebase/app-types': patch
+'@firebase/firestore': patch
+---
+
+Firestore classes like DocumentReference and Query can now be serialized to JSON (#4258)

packages-exp/app-compat/src/firebaseApp.ts

@@ -134,6 +134,14 @@ export class FirebaseAppImpl implements FirebaseApp {
   _addOrOverwriteComponent(component: Component): void {
     _addOrOverwriteComponent(this.app, component);
   }
+
+  toJSON(): object {
+    return {
+      name: this.name,
+      automaticDataCollectionEnabled: this.automaticDataCollectionEnabled,
+      options: this.options
+    };
+  }
 }
 
 // TODO: investigate why the following needs to be commented out

packages/app/src/firebaseApp.ts

@@ -163,6 +163,14 @@ export class FirebaseAppImpl implements FirebaseApp {
     this.container.addOrOverwriteComponent(component);
   }
 
+  toJSON(): object {
+    return {
+      name: this.name,
+      automaticDataCollectionEnabled: this.automaticDataCollectionEnabled,
+      options: this.options
+    };
+  }
+
   /**
    * This function will throw an Error if the App has already been deleted -
    * use before performing API actions on the App.

packages/app/src/lite/firebaseAppLite.ts

@@ -141,4 +141,12 @@ export class FirebaseAppLiteImpl implements FirebaseApp {
       throw ERROR_FACTORY.create(AppError.APP_DELETED, { appName: this.name_ });
     }
   }
+
+  toJSON(): object {
+    return {
+      name: this.name,
+      automaticDataCollectionEnabled: this.automaticDataCollectionEnabled,
+      options: this.options
+    };
+  }
 }

packages/app/test/firebaseApp.test.ts

@@ -336,6 +336,11 @@ function firebaseAppTests(
       expect(() => firebase.app('toString')).throws(/'toString'.*created/i);
     });
 
+    it('JSON.stringify() does not throw', () => {
+      const app = firebase.initializeApp({}, 'new-app');
+      JSON.stringify(app);
+    });
+
     describe('Check for bad app names', () => {
       const tests = ['', 123, false, null];
       for (const data of tests) {

packages/firestore/src/exp/snapshot.ts

@@ -214,9 +214,9 @@ export interface DocumentChange<T = DocumentData> {
  * access will return 'undefined'. You can use the `exists()` method to
  * explicitly verify a document's existence.
  */
-export class DocumentSnapshot<T = DocumentData> extends LiteDocumentSnapshot<
-  T
-> {
+export class DocumentSnapshot<
+  T = DocumentData
+> extends LiteDocumentSnapshot<T> {
   private readonly _firestoreImpl: FirebaseFirestore;
 
   /**
@@ -329,9 +329,9 @@ export class DocumentSnapshot<T = DocumentData> extends LiteDocumentSnapshot<
  * `exists` property will always be true and `data()` will never return
  * 'undefined'.
  */
-export class QueryDocumentSnapshot<T = DocumentData> extends DocumentSnapshot<
-  T
-> {
+export class QueryDocumentSnapshot<
+  T = DocumentData
+> extends DocumentSnapshot<T> {
   /**
    * Retrieves all fields in the document as an `Object`.
    *

packages/firestore/src/lite/database.ts

@@ -134,6 +134,14 @@ export class FirebaseFirestore implements FirestoreService {
     return this._terminateTask;
   }
 
+  toJSON(): object {
+    return {
+      app: this._app,
+      databaseId: this._databaseId,
+      settings: this._settings
+    };
+  }
+
   /**
    * Terminates all components used by this client. Subclasses can override
    * this method to clean up their own dependencies, but must also call this

packages/firestore/src/lite/snapshot.ts

@@ -212,9 +212,9 @@ export class DocumentSnapshot<T = DocumentData> {
  * `exists` property will always be true and `data()` will never return
  * 'undefined'.
  */
-export class QueryDocumentSnapshot<T = DocumentData> extends DocumentSnapshot<
-  T
-> {
+export class QueryDocumentSnapshot<
+  T = DocumentData
+> extends DocumentSnapshot<T> {
   /**
    * Retrieves all fields in the document as an `Object`.
    *

packages/firestore/test/integration/api/query.test.ts

@@ -155,9 +155,7 @@ apiDescribe('Queries', (persistence: boolean) => {
         .onSnapshot(storeLimitEvent.storeEvent);
 
       // Setup mirroring `limitToLast` query
-      const storeLimitToLastEvent = new EventsAccumulator<
-        firestore.QuerySnapshot
-      >();
+      const storeLimitToLastEvent = new EventsAccumulator<firestore.QuerySnapshot>();
       let limitToLastUnlisten = collection
         .orderBy('sort', 'desc')
         .limitToLast(2)

packages/firestore/test/integration/api/type.test.ts

@@ -53,9 +53,7 @@ apiDescribe('Firestore', (persistence: boolean) => {
       docSnapshot = querySnapshot.docs[0];
       expect(docSnapshot.data()).to.deep.equal(data);
 
-      const eventsAccumulator = new EventsAccumulator<
-        firestore.QuerySnapshot
-      >();
+      const eventsAccumulator = new EventsAccumulator<firestore.QuerySnapshot>();
       const unlisten = collection.onSnapshot(eventsAccumulator.storeEvent);
       querySnapshot = await eventsAccumulator.awaitEvent();
       docSnapshot = querySnapshot.docs[0];

packages/firestore/test/unit/api/database.test.ts

@@ -32,6 +32,10 @@ describe('CollectionReference', () => {
     expectEqual(collectionReference('foo'), collectionReference('foo'));
     expectNotEqual(collectionReference('foo'), collectionReference('bar'));
   });
+
+  it('JSON.stringify() does not throw', () => {
+    JSON.stringify(collectionReference('foo'));
+  });
 });
 
 describe('DocumentReference', () => {
@@ -42,6 +46,10 @@ describe('DocumentReference', () => {
       documentReference('rooms/bar')
     );
   });
+
+  it('JSON.stringify() does not throw', () => {
+    JSON.stringify(documentReference('foo/bar'));
+  });
 });
 
 describe('DocumentSnapshot', () => {
@@ -72,13 +80,21 @@ describe('DocumentSnapshot', () => {
       documentSnapshot('rooms/bar', { a: 1 }, false)
     );
   });
+
+  it('JSON.stringify() does not throw', () => {
+    JSON.stringify(documentSnapshot('foo/bar', { a: 1 }, true));
+  });
 });
 
 describe('Query', () => {
   it('support equality checking with isEqual()', () => {
     expectEqual(query('foo'), query('foo'));
     expectNotEqual(query('foo'), query('bar'));
   });
+
+  it('JSON.stringify() does not throw', () => {
+    JSON.stringify(query('foo'));
+  });
 });
 
 describe('QuerySnapshot', () => {
@@ -123,6 +139,12 @@ describe('QuerySnapshot', () => {
       querySnapshot('foo', {}, { a: { a: 1 } }, keys('foo/a'), false, true)
     );
   });
+
+  it('JSON.stringify() does not throw', () => {
+    JSON.stringify(
+      querySnapshot('foo', {}, { a: { a: 1 } }, keys(), false, false)
+    );
+  });
 });
 
 describe('SnapshotMetadata', () => {

packages/firestore/test/unit/specs/spec_builder.ts

@@ -1047,9 +1047,9 @@ export class SpecBuilder {
       return {
         key: SpecBuilder.keyToSpec(doc.key),
         version: doc.version.toMicroseconds(),
-        value: userDataWriter.convertValue(doc.toProto()) as JsonObject<
-          unknown
-        >,
+        value: userDataWriter.convertValue(
+          doc.toProto()
+        ) as JsonObject<unknown>,
         options: {
           hasLocalMutations: doc.hasLocalMutations,
           hasCommittedMutations: doc.hasCommittedMutations