Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

demo code #5578

Closed
wants to merge 7 commits into from
Closed

demo code #5578

wants to merge 7 commits into from

Conversation

milaGGL
Copy link
Contributor

@milaGGL milaGGL commented Nov 28, 2023

No description provided.

Copy link
Contributor

github-actions bot commented Nov 28, 2023

Javadoc Changes:
--- /Users/runner/diff/original/firebase-kotlindoc/android/client/firebase-firestore/_toc.yaml	2024-01-04 15:12:53.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/android/client/firebase-firestore/_toc.yaml	2024-01-04 15:10:36.000000000 +0000
@@ -92,6 +92,10 @@
       path: "/docs/reference/android/com/google/firebase/firestore/QuerySnapshot.html"
     - title: "SetOptions"
       path: "/docs/reference/android/com/google/firebase/firestore/SetOptions.html"
+    - title: "SnapshotListenOptions"
+      path: "/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html"
+    - title: "SnapshotListenOptions.Builder"
+      path: "/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html"
     - title: "SnapshotMetadata"
       path: "/docs/reference/android/com/google/firebase/firestore/SnapshotMetadata.html"
     - title: "Transaction"
@@ -114,6 +118,8 @@
       path: "/docs/reference/android/com/google/firebase/firestore/DocumentSnapshot.ServerTimestampBehavior.html"
     - title: "FirebaseFirestoreException.Code"
       path: "/docs/reference/android/com/google/firebase/firestore/FirebaseFirestoreException.Code.html"
+    - title: "ListenSource"
+      path: "/docs/reference/android/com/google/firebase/firestore/ListenSource.html"
     - title: "LoadBundleTaskProgress.TaskState"
       path: "/docs/reference/android/com/google/firebase/firestore/LoadBundleTaskProgress.TaskState.html"
     - title: "MetadataChanges"
--- /Users/runner/diff/original/firebase-kotlindoc/android/com/google/firebase/firestore/CollectionReference.html	2024-01-04 15:12:53.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/android/com/google/firebase/firestore/CollectionReference.html	2024-01-04 15:10:36.000000000 +0000
@@ -167,6 +167,12 @@
                     <tr>
                       <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></code></td>
                       <td>
+                        <div><code><a href="/docs/reference/android/com/google/firebase/firestore/Query.html#addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a>&nbsp;options,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/android/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;&nbsp;listener<br>)</code></div>
+                      </td>
+                    </tr>
+                    <tr>
+                      <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></code></td>
+                      <td>
                         <div><code><a href="/docs/reference/android/com/google/firebase/firestore/Query.html#addSnapshotListener(android.app.Activity,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>&nbsp;activity,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/android/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;&nbsp;listener<br>)</code></div>
                         <p>Starts listening to this query with the given options, using an Activity-scoped listener.</p>
                       </td>
--- /Users/runner/diff/original/firebase-kotlindoc/android/com/google/firebase/firestore/DocumentReference.html	2024-01-04 15:12:54.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/android/com/google/firebase/firestore/DocumentReference.html	2024-01-04 15:10:36.000000000 +0000
@@ -78,6 +78,12 @@
           <tr>
             <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></code></td>
             <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html#addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a>&nbsp;options,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/android/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;&nbsp;listener<br>)</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></code></td>
+            <td>
               <div><code><a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html#addSnapshotListener(android.app.Activity,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>&nbsp;activity,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/android/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;&nbsp;listener<br>)</code></div>
               <p>Starts listening to the document referenced by this <code>DocumentReference</code> with the given options using an Activity-scoped listener.</p>
             </td>
@@ -223,7 +229,7 @@
           <tr>
             <td><code>final @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;</code></td>
             <td>
-              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges<br>)</code></div>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;source<br>)</code></div>
               <p>Starts listening to the document referenced by this <code>DocumentReference</code> with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
             </td>
           </tr>
@@ -454,6 +460,10 @@
           </table>
         </div>
       </div>
+      <div class="api-item"><a name="addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions, com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)"></a><a name="addSnapshotListener-com.google.firebase.firestore.SnapshotListenOptions-com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;-"></a><a name="addsnapshotlistener"></a>
+        <h3 class="api-name" id="addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)">addSnapshotListener</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html#addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a>&nbsp;options,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/android/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;&nbsp;listener<br>)</pre>
+      </div>
       <div class="api-item"><a name="addSnapshotListener(android.app.Activity, com.google.firebase.firestore.MetadataChanges, com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)"></a><a name="addSnapshotListener-android.app.Activity-com.google.firebase.firestore.MetadataChanges-com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;-"></a><a name="addsnapshotlistener"></a>
         <h3 class="api-name" id="addSnapshotListener(android.app.Activity,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)">addSnapshotListener</h3>
         <pre class="api-signature no-pretty-print">public&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html#addSnapshotListener(android.app.Activity,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>&nbsp;activity,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/android/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;&nbsp;listener<br>)</pre>
@@ -1143,9 +1153,9 @@
           </table>
         </div>
       </div>
-      <div class="api-item"><a name="-com.google.firebase.firestore.DocumentReference-.snapshots-com.google.firebase.firestore.MetadataChanges-"></a><a name="snapshots"></a>
-        <h3 class="api-name" id="(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges)">FirestoreKt.snapshots</h3>
-        <pre class="api-signature no-pretty-print">public&nbsp;final&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges<br>)</pre>
+      <div class="api-item"><a name="(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges, com.google.firebase.firestore.ListenSource)"></a><a name="-com.google.firebase.firestore.DocumentReference-.snapshots-com.google.firebase.firestore.MetadataChanges-com.google.firebase.firestore.ListenSource-"></a><a name="snapshots"></a>
+        <h3 class="api-name" id="(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">FirestoreKt.snapshots</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;final&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;source<br>)</pre>
         <p>Starts listening to the document referenced by this <code>DocumentReference</code> with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
         <ul>
           <li>
--- /Users/runner/diff/original/firebase-kotlindoc/android/com/google/firebase/firestore/FirestoreKt.html	2024-01-04 15:12:54.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/android/com/google/firebase/firestore/FirestoreKt.html	2024-01-04 15:10:36.000000000 +0000
@@ -142,14 +142,14 @@
           <tr>
             <td><code>static&nbsp;final @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;</code></td>
             <td>
-              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges<br>)</code></div>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;source<br>)</code></div>
               <p>Starts listening to the document referenced by this <code>DocumentReference</code> with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
             </td>
           </tr>
           <tr>
             <td><code>static&nbsp;final @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;</code></td>
             <td>
-              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/Query.html">Query</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges<br>)</code></div>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/Query.html">Query</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;source<br>)</code></div>
               <p>Starts listening to this query with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
             </td>
           </tr>
@@ -510,9 +510,9 @@
         <h3 class="api-name" id="persistentCacheSettings(kotlin.Function1)">persistentCacheSettings</h3>
         <pre class="api-signature no-pretty-print">public&nbsp;static&nbsp;final&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/PersistentCacheSettings.html">PersistentCacheSettings</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html#persistentCacheSettings(kotlin.Function1)">persistentCacheSettings</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-extension-function-type/index.html">ExtensionFunctionType</a> @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> Function1&lt;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/PersistentCacheSettings.Builder.html">PersistentCacheSettings.Builder</a>,&nbsp;<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html">Unit</a>&gt;&nbsp;init<br>)</pre>
       </div>
-      <div class="api-item"><a name="-com.google.firebase.firestore.DocumentReference-.snapshots-com.google.firebase.firestore.MetadataChanges-"></a><a name="snapshots"></a>
-        <h3 class="api-name" id="(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges)">FirestoreKt.snapshots</h3>
-        <pre class="api-signature no-pretty-print">public&nbsp;static&nbsp;final&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges<br>)</pre>
+      <div class="api-item"><a name="(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges, com.google.firebase.firestore.ListenSource)"></a><a name="-com.google.firebase.firestore.DocumentReference-.snapshots-com.google.firebase.firestore.MetadataChanges-com.google.firebase.firestore.ListenSource-"></a><a name="snapshots"></a>
+        <h3 class="api-name" id="(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">FirestoreKt.snapshots</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;static&nbsp;final&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;source<br>)</pre>
         <p>Starts listening to the document referenced by this <code>DocumentReference</code> with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
         <ul>
           <li>
@@ -544,9 +544,9 @@
           </table>
         </div>
       </div>
-      <div class="api-item"><a name="-com.google.firebase.firestore.Query-.snapshots-com.google.firebase.firestore.MetadataChanges-"></a><a name="snapshots"></a>
-        <h3 class="api-name" id="(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges)">FirestoreKt.snapshots</h3>
-        <pre class="api-signature no-pretty-print">public&nbsp;static&nbsp;final&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/Query.html">Query</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges<br>)</pre>
+      <div class="api-item"><a name="(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges, com.google.firebase.firestore.ListenSource)"></a><a name="-com.google.firebase.firestore.Query-.snapshots-com.google.firebase.firestore.MetadataChanges-com.google.firebase.firestore.ListenSource-"></a><a name="snapshots"></a>
+        <h3 class="api-name" id="(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">FirestoreKt.snapshots</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;static&nbsp;final&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/Query.html">Query</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;source<br>)</pre>
         <p>Starts listening to this query with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
         <ul>
           <li>
--- /Users/runner/diff/original/firebase-kotlindoc/android/com/google/firebase/firestore/ListenSource.html	1970-01-01 00:00:00.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/android/com/google/firebase/firestore/ListenSource.html	2024-01-04 15:10:36.000000000 +0000
@@ -0,0 +1,156 @@
+<html devsite="true">
+  <head>
+    <title>ListenSource</title>
+{% setvar book_path %}/_book.yaml{% endsetvar %}
+{% include "docs/reference/android/_reference-head-tags.html" %}
+  </head>
+  <body>
+    <div id="metadata-info-block"></div>
+    <h1>ListenSource</h1>
+    <p>
+      <pre>public enum <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a></pre>
+    </p>
+    <hr>
+    <h2>Summary</h2>
+    <div class="devsite-table-wrapper">
+      <table class="responsive">
+        <colgroup>
+          <col width="40%">
+          <col>
+        </colgroup>
+        <thead>
+          <tr>
+            <th colspan="100%"><h3>Enum Values</h3></th>
+          </tr>
+        </thead>
+        <tbody class="list">
+          <tr>
+            <td><code><a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html#CACHE">CACHE</a></code></td>
+            <td></td>
+          </tr>
+          <tr>
+            <td><code><a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html#DEFAULT">DEFAULT</a></code></td>
+            <td></td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="devsite-table-wrapper">
+      <table class="responsive">
+        <colgroup>
+          <col width="40%">
+          <col>
+        </colgroup>
+        <thead>
+          <tr>
+            <th colspan="100%"><h3>Public methods</h3></th>
+          </tr>
+        </thead>
+        <tbody class="list">
+          <tr>
+            <td><code>static <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html#valueOf(java.lang.String)">valueOf</a>(<a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a>&nbsp;name)</code></div>
+              <p>Returns the enum constant of this type with the specified name.</p>
+            </td>
+          </tr>
+          <tr>
+            <td><code>static ListenSource[]</code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html#values()">values</a>()</code></div>
+              <p>Returns an array containing the constants of this enum type, in the order they're declared.</p>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="list">
+      <h2>Enum Values</h2>
+      <div class="api-item">
+        <h3 class="api-name" id="CACHE">CACHE</h3>
+        <pre class="api-signature no-pretty-print"><a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html#CACHE">ListenSource.CACHE</a></pre>
+      </div>
+      <div class="api-item">
+        <h3 class="api-name" id="DEFAULT">DEFAULT</h3>
+        <pre class="api-signature no-pretty-print"><a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html#DEFAULT">ListenSource.DEFAULT</a></pre>
+      </div>
+    </div>
+    <div class="list">
+      <h2>Public methods</h2>
+      <div class="api-item"><a name="valueOf-java.lang.String-"></a><a name="valueof"></a>
+        <h3 class="api-name" id="valueOf(java.lang.String)">valueOf</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;static&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html#valueOf(java.lang.String)">valueOf</a>(<a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a>&nbsp;name)</pre>
+        <p>Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)</p>
+        <div class="devsite-table-wrapper">
+          <table class="responsive">
+            <colgroup>
+              <col width="40%">
+              <col>
+            </colgroup>
+            <thead>
+              <tr>
+                <th colspan="100%">Returns</th>
+              </tr>
+            </thead>
+            <tbody class="list">
+              <tr>
+                <td><code><a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a></code></td>
+                <td>
+                  <p>the enum constant with the specified name</p>
+                </td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+        <div class="devsite-table-wrapper">
+          <table class="responsive">
+            <colgroup>
+              <col width="40%">
+              <col>
+            </colgroup>
+            <thead>
+              <tr>
+                <th colspan="100%">Throws</th>
+              </tr>
+            </thead>
+            <tbody class="list">
+              <tr>
+                <td><code><a href="https://developer.android.com/reference/kotlin/java/lang/IllegalArgumentException.html">java.lang.IllegalArgumentException</a>&nbsp;java.lang.IllegalArgumentException</code></td>
+                <td>
+                  <p>if this enum type has no constant with the specified name</p>
+                </td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+      </div>
+      <div class="api-item"><a name="values--"></a><a name="values"></a>
+        <h3 class="api-name" id="values()">values</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;static&nbsp;ListenSource[]&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html#values()">values</a>()</pre>
+        <p>Returns an array containing the constants of this enum type, in the order they're declared. This method may be used to iterate over the constants.</p>
+        <div class="devsite-table-wrapper">
+          <table class="responsive">
+            <colgroup>
+              <col width="40%">
+              <col>
+            </colgroup>
+            <thead>
+              <tr>
+                <th colspan="100%">Returns</th>
+              </tr>
+            </thead>
+            <tbody class="list">
+              <tr>
+                <td><code>ListenSource[]</code></td>
+                <td>
+                  <p>an array containing the constants of this enum type, in the order they're declared</p>
+                </td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>
+
--- /Users/runner/diff/original/firebase-kotlindoc/android/com/google/firebase/firestore/Query.html	2024-01-04 15:12:53.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/android/com/google/firebase/firestore/Query.html	2024-01-04 15:10:36.000000000 +0000
@@ -121,6 +121,12 @@
           <tr>
             <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></code></td>
             <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/Query.html#addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a>&nbsp;options,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/android/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;&nbsp;listener<br>)</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></code></td>
+            <td>
               <div><code><a href="/docs/reference/android/com/google/firebase/firestore/Query.html#addSnapshotListener(android.app.Activity,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>&nbsp;activity,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/android/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;&nbsp;listener<br>)</code></div>
               <p>Starts listening to this query with the given options, using an Activity-scoped listener.</p>
             </td>
@@ -456,7 +462,7 @@
           <tr>
             <td><code>final @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;</code></td>
             <td>
-              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/Query.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/Query.html">Query</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges<br>)</code></div>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/Query.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/Query.html">Query</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;source<br>)</code></div>
               <p>Starts listening to this query with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
             </td>
           </tr>
@@ -687,6 +693,10 @@
           </table>
         </div>
       </div>
+      <div class="api-item"><a name="addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions, com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)"></a><a name="addSnapshotListener-com.google.firebase.firestore.SnapshotListenOptions-com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;-"></a><a name="addsnapshotlistener"></a>
+        <h3 class="api-name" id="addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/Query.html#addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a>&nbsp;options,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/android/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;&nbsp;listener<br>)</pre>
+      </div>
       <div class="api-item"><a name="addSnapshotListener(android.app.Activity, com.google.firebase.firestore.MetadataChanges, com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)"></a><a name="addSnapshotListener-android.app.Activity-com.google.firebase.firestore.MetadataChanges-com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;-"></a><a name="addsnapshotlistener"></a>
         <h3 class="api-name" id="addSnapshotListener(android.app.Activity,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</h3>
         <pre class="api-signature no-pretty-print">public&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/Query.html#addSnapshotListener(android.app.Activity,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>&nbsp;activity,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/android/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;&nbsp;listener<br>)</pre>
@@ -2825,9 +2835,9 @@
           </table>
         </div>
       </div>
-      <div class="api-item"><a name="-com.google.firebase.firestore.Query-.snapshots-com.google.firebase.firestore.MetadataChanges-"></a><a name="snapshots"></a>
-        <h3 class="api-name" id="(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges)">FirestoreKt.snapshots</h3>
-        <pre class="api-signature no-pretty-print">public&nbsp;final&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/Query.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/Query.html">Query</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges<br>)</pre>
+      <div class="api-item"><a name="(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges, com.google.firebase.firestore.ListenSource)"></a><a name="-com.google.firebase.firestore.Query-.snapshots-com.google.firebase.firestore.MetadataChanges-com.google.firebase.firestore.ListenSource-"></a><a name="snapshots"></a>
+        <h3 class="api-name" id="(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">FirestoreKt.snapshots</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;final&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/FirestoreKt.html">FirestoreKt</a>.<a href="/docs/reference/android/com/google/firebase/firestore/Query.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/Query.html">Query</a>&nbsp;receiver,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges,<br>&nbsp;&nbsp;&nbsp;&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;source<br>)</pre>
         <p>Starts listening to this query with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
         <ul>
           <li>
--- /Users/runner/diff/original/firebase-kotlindoc/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html	1970-01-01 00:00:00.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html	2024-01-04 15:10:36.000000000 +0000
@@ -0,0 +1,112 @@
+<html devsite="true">
+  <head>
+    <title>SnapshotListenOptions.Builder</title>
+{% setvar book_path %}/_book.yaml{% endsetvar %}
+{% include "docs/reference/android/_reference-head-tags.html" %}
+  </head>
+  <body>
+    <div id="metadata-info-block"></div>
+    <h1>SnapshotListenOptions.Builder</h1>
+    <p>
+      <pre>public class <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></pre>
+    </p>
+    <hr>
+    <h2>Summary</h2>
+    <div class="devsite-table-wrapper">
+      <table class="responsive">
+        <colgroup>
+          <col width="40%">
+          <col>
+        </colgroup>
+        <thead>
+          <tr>
+            <th colspan="100%"><h3>Public constructors</h3></th>
+          </tr>
+        </thead>
+        <tbody class="list">
+          <tr>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#Builder()">Builder</a>()</code></div>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="devsite-table-wrapper">
+      <table class="responsive">
+        <colgroup>
+          <col width="40%">
+          <col>
+        </colgroup>
+        <thead>
+          <tr>
+            <th colspan="100%"><h3>Public methods</h3></th>
+          </tr>
+        </thead>
+        <tbody class="list">
+          <tr>
+            <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#build()">build</a>()</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setActivity(android.app.Activity)">setActivity</a>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>&nbsp;activity)</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setExecutor(java.util.concurrent.Executor)">setExecutor</a>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/util/concurrent/Executor.html">Executor</a>&nbsp;executor)</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setMetadataChanges(com.google.firebase.firestore.MetadataChanges)">setMetadataChanges</a>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges)</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setSource(com.google.firebase.firestore.ListenSource)">setSource</a>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;source)</code></div>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="list">
+      <h2>Public constructors</h2>
+      <div class="api-item"><a name="Builder--"></a><a name="builder"></a>
+        <h3 class="api-name" id="Builder()">Builder</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#Builder()">Builder</a>()</pre>
+      </div>
+    </div>
+    <div class="list">
+      <h2>Public methods</h2>
+      <div class="api-item"><a name="build--"></a><a name="build"></a>
+        <h3 class="api-name" id="build()">build</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#build()">build</a>()</pre>
+      </div>
+      <div class="api-item"><a name="setActivity-android.app.Activity-"></a><a name="setactivity"></a>
+        <h3 class="api-name" id="setActivity(android.app.Activity)">setActivity</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setActivity(android.app.Activity)">setActivity</a>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>&nbsp;activity)</pre>
+      </div>
+      <div class="api-item"><a name="setExecutor-java.util.concurrent.Executor-"></a><a name="setexecutor"></a>
+        <h3 class="api-name" id="setExecutor(java.util.concurrent.Executor)">setExecutor</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setExecutor(java.util.concurrent.Executor)">setExecutor</a>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/util/concurrent/Executor.html">Executor</a>&nbsp;executor)</pre>
+      </div>
+      <div class="api-item"><a name="setMetadataChanges-com.google.firebase.firestore.MetadataChanges-"></a><a name="setmetadatachanges"></a>
+        <h3 class="api-name" id="setMetadataChanges(com.google.firebase.firestore.MetadataChanges)">setMetadataChanges</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setMetadataChanges(com.google.firebase.firestore.MetadataChanges)">setMetadataChanges</a>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;metadataChanges)</pre>
+      </div>
+      <div class="api-item"><a name="setSource-com.google.firebase.firestore.ListenSource-"></a><a name="setsource"></a>
+        <h3 class="api-name" id="setSource(com.google.firebase.firestore.ListenSource)">setSource</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setSource(com.google.firebase.firestore.ListenSource)">setSource</a>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;source)</pre>
+      </div>
+    </div>
+  </body>
+</html>
+
--- /Users/runner/diff/original/firebase-kotlindoc/android/com/google/firebase/firestore/SnapshotListenOptions.html	1970-01-01 00:00:00.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/android/com/google/firebase/firestore/SnapshotListenOptions.html	2024-01-04 15:10:36.000000000 +0000
@@ -0,0 +1,181 @@
+<html devsite="true">
+  <head>
+    <title>SnapshotListenOptions</title>
+{% setvar book_path %}/_book.yaml{% endsetvar %}
+{% include "docs/reference/android/_reference-head-tags.html" %}
+  </head>
+  <body>
+    <div id="metadata-info-block"></div>
+    <h1>SnapshotListenOptions</h1>
+    <p>
+      <pre>public class <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a></pre>
+    </p>
+    <hr>
+    <h2>Summary</h2>
+    <div class="devsite-table-wrapper">
+      <table class="responsive">
+        <colgroup>
+          <col width="40%">
+          <col>
+        </colgroup>
+        <thead>
+          <tr>
+            <th colspan="100%"><h3>Nested types</h3></th>
+          </tr>
+        </thead>
+        <tbody class="list">
+          <tr>
+            <td>
+              <div><code>public class <a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></code></div>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="devsite-table-wrapper">
+      <table class="responsive">
+        <colgroup>
+          <col width="40%">
+          <col>
+        </colgroup>
+        <thead>
+          <tr>
+            <th colspan="100%"><h3>Public fields</h3></th>
+          </tr>
+        </thead>
+        <tbody class="list">
+          <tr>
+            <td><code>final <a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#activity()">activity</a></code></div>
+              <p>The activity to scope the listener to.</p>
+            </td>
+          </tr>
+          <tr>
+            <td><code>final <a href="https://developer.android.com/reference/kotlin/java/util/concurrent/Executor.html">Executor</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#executor()">executor</a></code></div>
+              <p>The executor to use to call the listener.</p>
+            </td>
+          </tr>
+          <tr>
+            <td><code>final <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#metadataChanges()">metadataChanges</a></code></div>
+              <p>Indicates whether metadata-only changes should trigger snapshot events.</p>
+            </td>
+          </tr>
+          <tr>
+            <td><code>final <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#source()">source</a></code></div>
+              <p>Indicates the source that we listen to.</p>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="devsite-table-wrapper">
+      <table class="responsive">
+        <colgroup>
+          <col width="40%">
+          <col>
+        </colgroup>
+        <thead>
+          <tr>
+            <th colspan="100%"><h3>Public methods</h3></th>
+          </tr>
+        </thead>
+        <tbody class="list">
+          <tr>
+            <td><code>boolean</code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#equals(java.lang.Object)">equals</a>(<a href="https://developer.android.com/reference/kotlin/java/lang/Object.html">Object</a>&nbsp;o)</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/Nullable.html">Nullable</a> <a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#getActivity()">getActivity</a>()</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/util/concurrent/Executor.html">Executor</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#getExecutor()">getExecutor</a>()</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#getMetadataChanges()">getMetadataChanges</a>()</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#getSource()">getSource</a>()</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code><a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#toString()">toString</a>()</code></div>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="list">
+      <h2>Public fields</h2>
+      <div class="api-item"><a name="getActivity()"></a><a name="setActivity()"></a><a name="getActivity--"></a><a name="setActivity--"></a>
+        <h3 class="api-name" id="activity()">activity</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;final&nbsp;<a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#activity()">activity</a></pre>
+        <p>The activity to scope the listener to.</p>
+      </div>
+      <div class="api-item"><a name="getExecutor()"></a><a name="setExecutor()"></a><a name="getExecutor--"></a><a name="setExecutor--"></a>
+        <h3 class="api-name" id="executor()">executor</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;final&nbsp;<a href="https://developer.android.com/reference/kotlin/java/util/concurrent/Executor.html">Executor</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#executor()">executor</a></pre>
+        <p>The executor to use to call the listener.</p>
+      </div>
+      <div class="api-item"><a name="getMetadataChanges()"></a><a name="setMetadataChanges()"></a><a name="getMetadataChanges--"></a><a name="setMetadataChanges--"></a>
+        <h3 class="api-name" id="metadataChanges()">metadataChanges</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;final&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#metadataChanges()">metadataChanges</a></pre>
+        <p>Indicates whether metadata-only changes should trigger snapshot events.</p>
+      </div>
+      <div class="api-item"><a name="getSource()"></a><a name="setSource()"></a><a name="getSource--"></a><a name="setSource--"></a>
+        <h3 class="api-name" id="source()">source</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;final&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#source()">source</a></pre>
+        <p>Indicates the source that we listen to.</p>
+      </div>
+    </div>
+    <div class="list">
+      <h2>Public methods</h2>
+      <div class="api-item"><a name="equals-java.lang.Object-"></a><a name="equals"></a>
+        <h3 class="api-name" id="equals(java.lang.Object)">equals</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;boolean&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#equals(java.lang.Object)">equals</a>(<a href="https://developer.android.com/reference/kotlin/java/lang/Object.html">Object</a>&nbsp;o)</pre>
+      </div>
+      <div class="api-item"><a name="getActivity--"></a><a name="getactivity"></a>
+        <h3 class="api-name" id="getActivity()">getActivity</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/Nullable.html">Nullable</a> <a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#getActivity()">getActivity</a>()</pre>
+      </div>
+      <div class="api-item"><a name="getExecutor--"></a><a name="getexecutor"></a>
+        <h3 class="api-name" id="getExecutor()">getExecutor</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/util/concurrent/Executor.html">Executor</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#getExecutor()">getExecutor</a>()</pre>
+      </div>
+      <div class="api-item"><a name="getMetadataChanges--"></a><a name="getmetadatachanges"></a>
+        <h3 class="api-name" id="getMetadataChanges()">getMetadataChanges</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#getMetadataChanges()">getMetadataChanges</a>()</pre>
+      </div>
+      <div class="api-item"><a name="getSource--"></a><a name="getsource"></a>
+        <h3 class="api-name" id="getSource()">getSource</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#getSource()">getSource</a>()</pre>
+      </div>
+      <div class="api-item"><a name="toString--"></a><a name="tostring"></a>
+        <h3 class="api-name" id="toString()">toString</h3>
+        <pre class="api-signature no-pretty-print">public&nbsp;<a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a>&nbsp;<a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html#toString()">toString</a>()</pre>
+      </div>
+    </div>
+  </body>
+</html>
+
--- /Users/runner/diff/original/firebase-kotlindoc/android/com/google/firebase/firestore/package-summary.html	2024-01-04 15:12:53.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/android/com/google/firebase/firestore/package-summary.html	2024-01-04 15:10:36.000000000 +0000
@@ -312,6 +312,14 @@
             </td>
           </tr>
           <tr>
+            <td><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a></code></td>
+            <td></td>
+          </tr>
+          <tr>
+            <td><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></code></td>
+            <td></td>
+          </tr>
+          <tr>
             <td><code><a href="/docs/reference/android/com/google/firebase/firestore/SnapshotMetadata.html">SnapshotMetadata</a></code></td>
             <td>
               <p>Metadata about a snapshot, describing the state of the snapshot.</p>
@@ -377,6 +385,10 @@
             </td>
           </tr>
           <tr>
+            <td><code><a href="/docs/reference/android/com/google/firebase/firestore/ListenSource.html">ListenSource</a></code></td>
+            <td></td>
+          </tr>
+          <tr>
             <td><code><a href="/docs/reference/android/com/google/firebase/firestore/LoadBundleTaskProgress.TaskState.html">LoadBundleTaskProgress.TaskState</a></code></td>
             <td>
               <p>Represents the state of bundle loading tasks.</p>
--- /Users/runner/diff/original/firebase-kotlindoc/kotlin/client/firebase-firestore/_toc.yaml	2024-01-04 15:12:53.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/kotlin/client/firebase-firestore/_toc.yaml	2024-01-04 15:10:36.000000000 +0000
@@ -90,6 +90,10 @@
       path: "/docs/reference/kotlin/com/google/firebase/firestore/QuerySnapshot.html"
     - title: "SetOptions"
       path: "/docs/reference/kotlin/com/google/firebase/firestore/SetOptions.html"
+    - title: "SnapshotListenOptions"
+      path: "/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html"
+    - title: "SnapshotListenOptions.Builder"
+      path: "/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html"
     - title: "SnapshotMetadata"
       path: "/docs/reference/kotlin/com/google/firebase/firestore/SnapshotMetadata.html"
     - title: "Transaction"
@@ -112,6 +116,8 @@
       path: "/docs/reference/kotlin/com/google/firebase/firestore/DocumentSnapshot.ServerTimestampBehavior.html"
     - title: "FirebaseFirestoreException.Code"
       path: "/docs/reference/kotlin/com/google/firebase/firestore/FirebaseFirestoreException.Code.html"
+    - title: "ListenSource"
+      path: "/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html"
     - title: "LoadBundleTaskProgress.TaskState"
       path: "/docs/reference/kotlin/com/google/firebase/firestore/LoadBundleTaskProgress.TaskState.html"
     - title: "MetadataChanges"
--- /Users/runner/diff/original/firebase-kotlindoc/kotlin/com/google/firebase/firestore/CollectionReference.html	2024-01-04 15:12:53.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/kotlin/com/google/firebase/firestore/CollectionReference.html	2024-01-04 15:10:36.000000000 +0000
@@ -136,6 +136,12 @@
                     <tr>
                       <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></code></td>
                       <td>
+                        <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html#addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;options:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;listener:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>!&gt;<br>)</code></div>
+                      </td>
+                    </tr>
+                    <tr>
+                      <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></code></td>
+                      <td>
                         <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html#addSnapshotListener(android.app.Activity,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;activity:&nbsp;<a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;listener:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>!&gt;<br>)</code></div>
                         <p>Starts listening to this query with the given options, using an Activity-scoped listener.</p>
                       </td>
--- /Users/runner/diff/original/firebase-kotlindoc/kotlin/com/google/firebase/firestore/DocumentReference.html	2024-01-04 15:12:53.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/kotlin/com/google/firebase/firestore/DocumentReference.html	2024-01-04 15:10:36.000000000 +0000
@@ -57,6 +57,12 @@
           <tr>
             <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></code></td>
             <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html#addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;options:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;listener:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>!&gt;<br>)</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></code></td>
+            <td>
               <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html#addSnapshotListener(android.app.Activity,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;activity:&nbsp;<a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;listener:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>!&gt;<br>)</code></div>
               <p>Starts listening to the document referenced by this <code>DocumentReference</code> with the given options using an Activity-scoped listener.</p>
             </td>
@@ -216,7 +222,7 @@
           <tr>
             <td><code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;</code></td>
             <td>
-              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>)</code></div>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;source:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a><br>)</code></div>
               <p>Starts listening to the document referenced by this <code>DocumentReference</code> with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
             </td>
           </tr>
@@ -440,6 +446,10 @@
           </table>
         </div>
       </div>
+      <div class="api-item"><a name="addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions, com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)"></a><a name="addSnapshotListener-com.google.firebase.firestore.SnapshotListenOptions-com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;-"></a><a name="addsnapshotlistener"></a>
+        <h3 class="api-name" id="addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)">addSnapshotListener</h3>
+        <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html#addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;options:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;listener:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>!&gt;<br>):&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></pre>
+      </div>
       <div class="api-item"><a name="addSnapshotListener(android.app.Activity, com.google.firebase.firestore.MetadataChanges, com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)"></a><a name="addSnapshotListener-android.app.Activity-com.google.firebase.firestore.MetadataChanges-com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;-"></a><a name="addsnapshotlistener"></a>
         <h3 class="api-name" id="addSnapshotListener(android.app.Activity,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)">addSnapshotListener</h3>
         <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html#addSnapshotListener(android.app.Activity,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.DocumentSnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;activity:&nbsp;<a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;listener:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>!&gt;<br>):&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></pre>
@@ -1131,9 +1141,9 @@
           </table>
         </div>
       </div>
-      <div class="api-item"><a name="-com.google.firebase.firestore.DocumentReference-.snapshots-com.google.firebase.firestore.MetadataChanges-"></a><a name="snapshots"></a>
-        <h3 class="api-name" id="(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</h3>
-        <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a> = MetadataChanges.EXCLUDE<br>):&nbsp;<a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;</pre>
+      <div class="api-item"><a name="(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges, com.google.firebase.firestore.ListenSource)"></a><a name="-com.google.firebase.firestore.DocumentReference-.snapshots-com.google.firebase.firestore.MetadataChanges-com.google.firebase.firestore.ListenSource-"></a><a name="snapshots"></a>
+        <h3 class="api-name" id="(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</h3>
+        <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a> = MetadataChanges.EXCLUDE,<br>&nbsp;&nbsp;&nbsp;&nbsp;source:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a> = ListenSource.DEFAULT<br>):&nbsp;<a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;</pre>
         <p>Starts listening to the document referenced by this <code>DocumentReference</code> with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
         <ul>
           <li>
--- /Users/runner/diff/original/firebase-kotlindoc/kotlin/com/google/firebase/firestore/ListenSource.html	1970-01-01 00:00:00.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/kotlin/com/google/firebase/firestore/ListenSource.html	2024-01-04 15:10:36.000000000 +0000
@@ -0,0 +1,156 @@
+<html devsite="true">
+  <head>
+    <title>ListenSource</title>
+{% setvar book_path %}/_book.yaml{% endsetvar %}
+{% include "docs/reference/kotlin/_reference-head-tags.html" %}
+  </head>
+  <body>
+    <div id="metadata-info-block"></div>
+    <h1>ListenSource</h1>
+    <p>
+      <pre>enum <a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a></pre>
+    </p>
+    <hr>
+    <h2>Summary</h2>
+    <div class="devsite-table-wrapper">
+      <table class="responsive">
+        <colgroup>
+          <col width="40%">
+          <col>
+        </colgroup>
+        <thead>
+          <tr>
+            <th colspan="100%"><h3>Enum Values</h3></th>
+          </tr>
+        </thead>
+        <tbody class="list">
+          <tr>
+            <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html#CACHE">CACHE</a></code></td>
+            <td></td>
+          </tr>
+          <tr>
+            <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html#DEFAULT">DEFAULT</a></code></td>
+            <td></td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="devsite-table-wrapper">
+      <table class="responsive">
+        <colgroup>
+          <col width="40%">
+          <col>
+        </colgroup>
+        <thead>
+          <tr>
+            <th colspan="100%"><h3>Public functions</h3></th>
+          </tr>
+        </thead>
+        <tbody class="list">
+          <tr>
+            <td><code>java-static <a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a>!</code></td>
+            <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html#valueOf(java.lang.String)">valueOf</a>(name:&nbsp;<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>!)</code></div>
+              <p>Returns the enum constant of this type with the specified name.</p>
+            </td>
+          </tr>
+          <tr>
+            <td><code>java-static <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html">Array</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a>!&gt;!</code></td>
+            <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html#values()">values</a>()</code></div>
+              <p>Returns an array containing the constants of this enum type, in the order they're declared.</p>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="list">
+      <h2>Enum Values</h2>
+      <div class="api-item">
+        <h3 class="api-name" id="CACHE">CACHE</h3>
+        <pre class="api-signature no-pretty-print">val&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html#CACHE">ListenSource.CACHE</a>:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a></pre>
+      </div>
+      <div class="api-item">
+        <h3 class="api-name" id="DEFAULT">DEFAULT</h3>
+        <pre class="api-signature no-pretty-print">val&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html#DEFAULT">ListenSource.DEFAULT</a>:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a></pre>
+      </div>
+    </div>
+    <div class="list">
+      <h2>Public functions</h2>
+      <div class="api-item"><a name="valueOf-java.lang.String-"></a><a name="valueof"></a>
+        <h3 class="api-name" id="valueOf(java.lang.String)">valueOf</h3>
+        <pre class="api-signature no-pretty-print">java-static&nbsp;fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html#valueOf(java.lang.String)">valueOf</a>(name:&nbsp;<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>!):&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a>!</pre>
+        <p>Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)</p>
+        <div class="devsite-table-wrapper">
+          <table class="responsive">
+            <colgroup>
+              <col width="40%">
+              <col>
+            </colgroup>
+            <thead>
+              <tr>
+                <th colspan="100%">Returns</th>
+              </tr>
+            </thead>
+            <tbody class="list">
+              <tr>
+                <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a>!</code></td>
+                <td>
+                  <p>the enum constant with the specified name</p>
+                </td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+        <div class="devsite-table-wrapper">
+          <table class="responsive">
+            <colgroup>
+              <col width="40%">
+              <col>
+            </colgroup>
+            <thead>
+              <tr>
+                <th colspan="100%">Throws</th>
+              </tr>
+            </thead>
+            <tbody class="list">
+              <tr>
+                <td><code>java.lang.IllegalArgumentException:&nbsp;<a href="https://developer.android.com/reference/kotlin/java/lang/IllegalArgumentException.html">java.lang.IllegalArgumentException</a></code></td>
+                <td>
+                  <p>if this enum type has no constant with the specified name</p>
+                </td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+      </div>
+      <div class="api-item"><a name="values--"></a><a name="values"></a>
+        <h3 class="api-name" id="values()">values</h3>
+        <pre class="api-signature no-pretty-print">java-static&nbsp;fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html#values()">values</a>():&nbsp;<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html">Array</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a>!&gt;!</pre>
+        <p>Returns an array containing the constants of this enum type, in the order they're declared. This method may be used to iterate over the constants.</p>
+        <div class="devsite-table-wrapper">
+          <table class="responsive">
+            <colgroup>
+              <col width="40%">
+              <col>
+            </colgroup>
+            <thead>
+              <tr>
+                <th colspan="100%">Returns</th>
+              </tr>
+            </thead>
+            <tbody class="list">
+              <tr>
+                <td><code><a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html">Array</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a>!&gt;!</code></td>
+                <td>
+                  <p>an array containing the constants of this enum type, in the order they're declared</p>
+                </td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>
+
--- /Users/runner/diff/original/firebase-kotlindoc/kotlin/com/google/firebase/firestore/Query.html	2024-01-04 15:12:53.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/kotlin/com/google/firebase/firestore/Query.html	2024-01-04 15:10:36.000000000 +0000
@@ -100,6 +100,12 @@
           <tr>
             <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></code></td>
             <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html#addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;options:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;listener:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>!&gt;<br>)</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></code></td>
+            <td>
               <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html#addSnapshotListener(android.app.Activity,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;activity:&nbsp;<a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;listener:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>!&gt;<br>)</code></div>
               <p>Starts listening to this query with the given options, using an Activity-scoped listener.</p>
             </td>
@@ -449,7 +455,7 @@
           <tr>
             <td><code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;</code></td>
             <td>
-              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html">Query</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>)</code></div>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html">Query</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>,&nbsp;source:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a>)</code></div>
               <p>Starts listening to this query with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
             </td>
           </tr>
@@ -673,6 +679,10 @@
           </table>
         </div>
       </div>
+      <div class="api-item"><a name="addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions, com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)"></a><a name="addSnapshotListener-com.google.firebase.firestore.SnapshotListenOptions-com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;-"></a><a name="addsnapshotlistener"></a>
+        <h3 class="api-name" id="addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</h3>
+        <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html#addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;options:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;listener:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>!&gt;<br>):&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></pre>
+      </div>
       <div class="api-item"><a name="addSnapshotListener(android.app.Activity, com.google.firebase.firestore.MetadataChanges, com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)"></a><a name="addSnapshotListener-android.app.Activity-com.google.firebase.firestore.MetadataChanges-com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;-"></a><a name="addsnapshotlistener"></a>
         <h3 class="api-name" id="addSnapshotListener(android.app.Activity,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</h3>
         <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html#addSnapshotListener(android.app.Activity,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.EventListener&lt;com.google.firebase.firestore.QuerySnapshot&gt;)">addSnapshotListener</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;activity:&nbsp;<a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;listener:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/EventListener.html">EventListener</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>!&gt;<br>):&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenerRegistration.html">ListenerRegistration</a></pre>
@@ -2813,9 +2823,9 @@
           </table>
         </div>
       </div>
-      <div class="api-item"><a name="-com.google.firebase.firestore.Query-.snapshots-com.google.firebase.firestore.MetadataChanges-"></a><a name="snapshots"></a>
-        <h3 class="api-name" id="(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</h3>
-        <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html">Query</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a> = MetadataChanges.EXCLUDE<br>):&nbsp;<a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;</pre>
+      <div class="api-item"><a name="(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges, com.google.firebase.firestore.ListenSource)"></a><a name="-com.google.firebase.firestore.Query-.snapshots-com.google.firebase.firestore.MetadataChanges-com.google.firebase.firestore.ListenSource-"></a><a name="snapshots"></a>
+        <h3 class="api-name" id="(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</h3>
+        <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html">Query</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a> = MetadataChanges.EXCLUDE,<br>&nbsp;&nbsp;&nbsp;&nbsp;source:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a> = ListenSource.DEFAULT<br>):&nbsp;<a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;</pre>
         <p>Starts listening to this query with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
         <ul>
           <li>
--- /Users/runner/diff/original/firebase-kotlindoc/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html	1970-01-01 00:00:00.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html	2024-01-04 15:10:36.000000000 +0000
@@ -0,0 +1,112 @@
+<html devsite="true">
+  <head>
+    <title>SnapshotListenOptions.Builder</title>
+{% setvar book_path %}/_book.yaml{% endsetvar %}
+{% include "docs/reference/kotlin/_reference-head-tags.html" %}
+  </head>
+  <body>
+    <div id="metadata-info-block"></div>
+    <h1>SnapshotListenOptions.Builder</h1>
+    <p>
+      <pre>class <a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></pre>
+    </p>
+    <hr>
+    <h2>Summary</h2>
+    <div class="devsite-table-wrapper">
+      <table class="responsive">
+        <colgroup>
+          <col width="40%">
+          <col>
+        </colgroup>
+        <thead>
+          <tr>
+            <th colspan="100%"><h3>Public constructors</h3></th>
+          </tr>
+        </thead>
+        <tbody class="list">
+          <tr>
+            <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#Builder()">Builder</a>()</code></div>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="devsite-table-wrapper">
+      <table class="responsive">
+        <colgroup>
+          <col width="40%">
+          <col>
+        </colgroup>
+        <thead>
+          <tr>
+            <th colspan="100%"><h3>Public functions</h3></th>
+          </tr>
+        </thead>
+        <tbody class="list">
+          <tr>
+            <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#build()">build</a>()</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setActivity(android.app.Activity)">setActivity</a>(activity:&nbsp;<a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>)</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setExecutor(java.util.concurrent.Executor)">setExecutor</a>(executor:&nbsp;<a href="https://developer.android.com/reference/kotlin/java/util/concurrent/Executor.html">Executor</a>)</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setMetadataChanges(com.google.firebase.firestore.MetadataChanges)">setMetadataChanges</a>(metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>)</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setSource(com.google.firebase.firestore.ListenSource)">setSource</a>(source:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a>)</code></div>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="list">
+      <h2>Public constructors</h2>
+      <div class="api-item"><a name="Builder--"></a><a name="builder"></a>
+        <h3 class="api-name" id="Builder()">Builder</h3>
+        <pre class="api-signature no-pretty-print"><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#Builder()">Builder</a>()</pre>
+      </div>
+    </div>
+    <div class="list">
+      <h2>Public functions</h2>
+      <div class="api-item"><a name="build--"></a><a name="build"></a>
+        <h3 class="api-name" id="build()">build</h3>
+        <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#build()">build</a>():&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a></pre>
+      </div>
+      <div class="api-item"><a name="setActivity-android.app.Activity-"></a><a name="setactivity"></a>
+        <h3 class="api-name" id="setActivity(android.app.Activity)">setActivity</h3>
+        <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setActivity(android.app.Activity)">setActivity</a>(activity:&nbsp;<a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>):&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></pre>
+      </div>
+      <div class="api-item"><a name="setExecutor-java.util.concurrent.Executor-"></a><a name="setexecutor"></a>
+        <h3 class="api-name" id="setExecutor(java.util.concurrent.Executor)">setExecutor</h3>
+        <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setExecutor(java.util.concurrent.Executor)">setExecutor</a>(executor:&nbsp;<a href="https://developer.android.com/reference/kotlin/java/util/concurrent/Executor.html">Executor</a>):&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></pre>
+      </div>
+      <div class="api-item"><a name="setMetadataChanges-com.google.firebase.firestore.MetadataChanges-"></a><a name="setmetadatachanges"></a>
+        <h3 class="api-name" id="setMetadataChanges(com.google.firebase.firestore.MetadataChanges)">setMetadataChanges</h3>
+        <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setMetadataChanges(com.google.firebase.firestore.MetadataChanges)">setMetadataChanges</a>(metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>):&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></pre>
+      </div>
+      <div class="api-item"><a name="setSource-com.google.firebase.firestore.ListenSource-"></a><a name="setsource"></a>
+        <h3 class="api-name" id="setSource(com.google.firebase.firestore.ListenSource)">setSource</h3>
+        <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html#setSource(com.google.firebase.firestore.ListenSource)">setSource</a>(source:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a>):&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></pre>
+      </div>
+    </div>
+  </body>
+</html>
+
--- /Users/runner/diff/original/firebase-kotlindoc/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html	1970-01-01 00:00:00.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html	2024-01-04 15:10:36.000000000 +0000
@@ -0,0 +1,141 @@
+<html devsite="true">
+  <head>
+    <title>SnapshotListenOptions</title>
+{% setvar book_path %}/_book.yaml{% endsetvar %}
+{% include "docs/reference/kotlin/_reference-head-tags.html" %}
+  </head>
+  <body>
+    <div id="metadata-info-block"></div>
+    <h1>SnapshotListenOptions</h1>
+    <p>
+      <pre>class <a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a></pre>
+    </p>
+    <hr>
+    <h2>Summary</h2>
+    <div class="devsite-table-wrapper">
+      <table class="responsive">
+        <colgroup>
+          <col width="40%">
+          <col>
+        </colgroup>
+        <thead>
+          <tr>
+            <th colspan="100%"><h3>Nested types</h3></th>
+          </tr>
+        </thead>
+        <tbody class="list">
+          <tr>
+            <td>
+              <div><code>class <a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></code></div>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="devsite-table-wrapper">
+      <table class="responsive">
+        <colgroup>
+          <col width="40%">
+          <col>
+        </colgroup>
+        <thead>
+          <tr>
+            <th colspan="100%"><h3>Public functions</h3></th>
+          </tr>
+        </thead>
+        <tbody class="list">
+          <tr>
+            <td><code><a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html">Boolean</a></code></td>
+            <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html#equals(java.lang.Object)">equals</a>(o:&nbsp;<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html">Any</a>!)</code></div>
+            </td>
+          </tr>
+          <tr>
+            <td><code><a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>!</code></td>
+            <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html#toString()">toString</a>()</code></div>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="devsite-table-wrapper">
+      <table class="responsive">
+        <colgroup>
+          <col width="40%">
+          <col>
+        </colgroup>
+        <thead>
+          <tr>
+            <th colspan="100%"><h3>Public properties</h3></th>
+          </tr>
+        </thead>
+        <tbody class="list">
+          <tr>
+            <td><code><a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>!</code></td>
+            <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html#activity()">activity</a></code></div>
+              <p>The activity to scope the listener to.</p>
+            </td>
+          </tr>
+          <tr>
+            <td><code><a href="https://developer.android.com/reference/kotlin/java/util/concurrent/Executor.html">Executor</a>!</code></td>
+            <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html#executor()">executor</a></code></div>
+              <p>The executor to use to call the listener.</p>
+            </td>
+          </tr>
+          <tr>
+            <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>!</code></td>
+            <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html#metadataChanges()">metadataChanges</a></code></div>
+              <p>Indicates whether metadata-only changes should trigger snapshot events.</p>
+            </td>
+          </tr>
+          <tr>
+            <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a>!</code></td>
+            <td>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html#source()">source</a></code></div>
+              <p>Indicates the source that we listen to.</p>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="list">
+      <h2>Public functions</h2>
+      <div class="api-item"><a name="equals-java.lang.Object-"></a><a name="equals"></a>
+        <h3 class="api-name" id="equals(java.lang.Object)">equals</h3>
+        <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html#equals(java.lang.Object)">equals</a>(o:&nbsp;<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html">Any</a>!):&nbsp;<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html">Boolean</a></pre>
+      </div>
+      <div class="api-item"><a name="toString--"></a><a name="tostring"></a>
+        <h3 class="api-name" id="toString()">toString</h3>
+        <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html#toString()">toString</a>():&nbsp;<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>!</pre>
+      </div>
+    </div>
+    <div class="list">
+      <h2>Public properties</h2>
+      <div class="api-item"><a name="getActivity()"></a><a name="setActivity()"></a><a name="getActivity--"></a><a name="setActivity--"></a>
+        <h3 class="api-name" id="activity()">activity</h3>
+        <pre class="api-signature no-pretty-print">val&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html#activity()">activity</a>:&nbsp;<a href="https://developer.android.com/reference/kotlin/android/app/Activity.html">Activity</a>!</pre>
+        <p>The activity to scope the listener to.</p>
+      </div>
+      <div class="api-item"><a name="getExecutor()"></a><a name="setExecutor()"></a><a name="getExecutor--"></a><a name="setExecutor--"></a>
+        <h3 class="api-name" id="executor()">executor</h3>
+        <pre class="api-signature no-pretty-print">val&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html#executor()">executor</a>:&nbsp;<a href="https://developer.android.com/reference/kotlin/java/util/concurrent/Executor.html">Executor</a>!</pre>
+        <p>The executor to use to call the listener.</p>
+      </div>
+      <div class="api-item"><a name="getMetadataChanges()"></a><a name="setMetadataChanges()"></a><a name="getMetadataChanges--"></a><a name="setMetadataChanges--"></a>
+        <h3 class="api-name" id="metadataChanges()">metadataChanges</h3>
+        <pre class="api-signature no-pretty-print">val&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html#metadataChanges()">metadataChanges</a>:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>!</pre>
+        <p>Indicates whether metadata-only changes should trigger snapshot events.</p>
+      </div>
+      <div class="api-item"><a name="getSource()"></a><a name="setSource()"></a><a name="getSource--"></a><a name="setSource--"></a>
+        <h3 class="api-name" id="source()">source</h3>
+        <pre class="api-signature no-pretty-print">val&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html#source()">source</a>:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a>!</pre>
+        <p>Indicates the source that we listen to.</p>
+      </div>
+    </div>
+  </body>
+</html>
+
--- /Users/runner/diff/original/firebase-kotlindoc/kotlin/com/google/firebase/firestore/package-summary.html	2024-01-04 15:12:53.000000000 +0000
+++ /Users/runner/diff/modified/firebase-kotlindoc/kotlin/com/google/firebase/firestore/package-summary.html	2024-01-04 15:10:36.000000000 +0000
@@ -261,6 +261,14 @@
             </td>
           </tr>
           <tr>
+            <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.html">SnapshotListenOptions</a></code></td>
+            <td></td>
+          </tr>
+          <tr>
+            <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotListenOptions.Builder.html">SnapshotListenOptions.Builder</a></code></td>
+            <td></td>
+          </tr>
+          <tr>
             <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/SnapshotMetadata.html">SnapshotMetadata</a></code></td>
             <td>
               <p>Metadata about a snapshot, describing the state of the snapshot.</p>
@@ -390,6 +398,10 @@
             </td>
           </tr>
           <tr>
+            <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a></code></td>
+            <td></td>
+          </tr>
+          <tr>
             <td><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/LoadBundleTaskProgress.TaskState.html">LoadBundleTaskProgress.TaskState</a></code></td>
             <td>
               <p>Represents the state of bundle loading tasks.</p>
@@ -532,14 +544,14 @@
           <tr>
             <td><code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;</code></td>
             <td>
-              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/package-summary.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>)</code></div>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/package-summary.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;source:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a><br>)</code></div>
               <p>Starts listening to the document referenced by this <code>DocumentReference</code> with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
             </td>
           </tr>
           <tr>
             <td><code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;</code></td>
             <td>
-              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html">Query</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/package-summary.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>)</code></div>
+              <div><code><a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html">Query</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/package-summary.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a>,&nbsp;source:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a>)</code></div>
               <p>Starts listening to this query with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
             </td>
           </tr>
@@ -910,9 +922,9 @@
         </table>
       </div>
     </div>
-    <div class="api-item"><a name="-com.google.firebase.firestore.DocumentReference-.snapshots-com.google.firebase.firestore.MetadataChanges-"></a><a name="snapshots"></a>
-      <h3 class="api-name" id="(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</h3>
-      <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/package-summary.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a> = MetadataChanges.EXCLUDE<br>):&nbsp;<a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;</pre>
+    <div class="api-item"><a name="(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges, com.google.firebase.firestore.ListenSource)"></a><a name="-com.google.firebase.firestore.DocumentReference-.snapshots-com.google.firebase.firestore.MetadataChanges-com.google.firebase.firestore.ListenSource-"></a><a name="snapshots"></a>
+      <h3 class="api-name" id="(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</h3>
+      <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentReference.html">DocumentReference</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/package-summary.html#(com.google.firebase.firestore.DocumentReference).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a> = MetadataChanges.EXCLUDE,<br>&nbsp;&nbsp;&nbsp;&nbsp;source:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a> = ListenSource.DEFAULT<br>):&nbsp;<a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/DocumentSnapshot.html">DocumentSnapshot</a>&gt;</pre>
       <p>Starts listening to the document referenced by this <code>DocumentReference</code> with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
       <ul>
         <li>
@@ -944,9 +956,9 @@
         </table>
       </div>
     </div>
-    <div class="api-item"><a name="-com.google.firebase.firestore.Query-.snapshots-com.google.firebase.firestore.MetadataChanges-"></a><a name="snapshots"></a>
-      <h3 class="api-name" id="(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</h3>
-      <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html">Query</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/package-summary.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a> = MetadataChanges.EXCLUDE<br>):&nbsp;<a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;</pre>
+    <div class="api-item"><a name="(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges, com.google.firebase.firestore.ListenSource)"></a><a name="-com.google.firebase.firestore.Query-.snapshots-com.google.firebase.firestore.MetadataChanges-com.google.firebase.firestore.ListenSource-"></a><a name="snapshots"></a>
+      <h3 class="api-name" id="(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</h3>
+      <pre class="api-signature no-pretty-print">fun&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/Query.html">Query</a>.<a href="/docs/reference/kotlin/com/google/firebase/firestore/package-summary.html#(com.google.firebase.firestore.Query).snapshots(com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource)">snapshots</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;metadataChanges:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/MetadataChanges.html">MetadataChanges</a> = MetadataChanges.EXCLUDE,<br>&nbsp;&nbsp;&nbsp;&nbsp;source:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/firestore/ListenSource.html">ListenSource</a> = ListenSource.DEFAULT<br>):&nbsp;<a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a>&lt;<a href="/docs/reference/kotlin/com/google/firebase/firestore/QuerySnapshot.html">QuerySnapshot</a>&gt;</pre>
       <p>Starts listening to this query with the given options and emits its values via a <code><a href="https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html">Flow</a></code>.</p>
       <ul>
         <li>

@google-oss-bot
Copy link
Contributor

1 Warning
⚠️ Did you forget to add a changelog entry? (Add the 'no-changelog' label to the PR to silence this warning.)

Generated by 🚫 Danger

@google-oss-bot
Copy link
Contributor

The public api surface has changed for the subproject firebase-firestore:
error: Added method com.google.firebase.firestore.DocumentReference.addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.DocumentSnapshot>) [AddedMethod]
error: Added method com.google.firebase.firestore.DocumentReference.addSnapshotListener(android.app.Activity,com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.DocumentSnapshot>) [AddedMethod]
error: Added method com.google.firebase.firestore.DocumentReference.addSnapshotListener(java.util.concurrent.Executor,com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.DocumentSnapshot>) [AddedMethod]
error: Added class com.google.firebase.firestore.ListenSource [AddedClass]
error: Added method com.google.firebase.firestore.Query.addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.QuerySnapshot>) [AddedMethod]
error: Added method com.google.firebase.firestore.Query.addSnapshotListener(android.app.Activity,com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.QuerySnapshot>) [AddedMethod]
error: Added method com.google.firebase.firestore.Query.addSnapshotListener(java.util.concurrent.Executor,com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.QuerySnapshot>) [AddedMethod]
error: Added class com.google.firebase.firestore.SnapshotListenOptions [AddedClass]

Please update the api.txt files for the subprojects being affected by this change by running ./gradlew ${subproject}:generateApiTxtFile. Also perform a major/minor bump accordingly.

@google-oss-bot
Copy link
Contributor

google-oss-bot commented Nov 28, 2023

@google-oss-bot
Copy link
Contributor

The public api surface has changed for the subproject firebase-firestore:
error: Added method com.google.firebase.firestore.DocumentReference.addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.DocumentSnapshot>) [AddedMethod]
error: Added method com.google.firebase.firestore.DocumentReference.addSnapshotListener(android.app.Activity,com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.DocumentSnapshot>) [AddedMethod]
error: Added method com.google.firebase.firestore.DocumentReference.addSnapshotListener(java.util.concurrent.Executor,com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.DocumentSnapshot>) [AddedMethod]
error: Added class com.google.firebase.firestore.ListenSource [AddedClass]
error: Added method com.google.firebase.firestore.Query.addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.QuerySnapshot>) [AddedMethod]
error: Added method com.google.firebase.firestore.Query.addSnapshotListener(android.app.Activity,com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.QuerySnapshot>) [AddedMethod]
error: Added method com.google.firebase.firestore.Query.addSnapshotListener(java.util.concurrent.Executor,com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.QuerySnapshot>) [AddedMethod]
error: Added class com.google.firebase.firestore.SnapshotListenOptions [AddedClass]

Please update the api.txt files for the subprojects being affected by this change by running ./gradlew ${subproject}:generateApiTxtFile. Also perform a major/minor bump accordingly.

Copy link
Contributor

github-actions bot commented Nov 28, 2023

Unit Test Results

0 files   -      948  0 suites   - 948   0s ⏱️ - 31m 48s
0 tests  -   5 178  0 ✔️  -   5 157  0 💤  - 21  0 ±0 
0 runs   - 10 441  0 ✔️  - 10 399  0 💤  - 42  0 ±0 

Results for commit c8e5bef. ± Comparison against base commit a16c647.

♻️ This comment has been updated with latest results.

@google-oss-bot
Copy link
Contributor

google-oss-bot commented Nov 28, 2023

Size Report 1

Affected Products

  • firebase-firestore

    TypeBase (a16c647)Merge (73087ca)Diff
    aar1.41 MB1.41 MB+4.30 kB (+0.3%)
    apk (release)11.4 MB11.4 MB+3.42 kB (+0.0%)

Test Logs

  1. https://storage.googleapis.com/firebase-sdk-metric-reports/5kakFVYJMM.html

@google-oss-bot
Copy link
Contributor

google-oss-bot commented Nov 28, 2023

Startup Time Report 1

Note: Layout is sometimes suboptimal due to limited formatting support on GitHub. Please check this report on GCS.

Notes

Startup Times

  • fire-fst

    DeviceStatisticsDistributions
    oriole-32
    Percentilea16c64773087caDiffSignificant (?)
    p10464 ±229 μs361 ±162 μs-103 μs (-22.1%)NO
    p25481 ±229 μs378 ±163 μs-104 μs (-21.6%)NO
    p50527 ±222 μs411 ±162 μs-116 μs (-22.0%)NO
    p75614 ±202 μs507 ±159 μs-107 μs (-17.5%)NO
    p90744 ±248 μs593 ±183 μs-151 μs (-20.3%)NO

    20 test runs in comparison
    CommitTest Runs
    a16c647
    • 2024-01-03_22:58:10.344184_OQny
    • 2024-01-03_22:58:10.344220_KuXL
    • 2024-01-03_22:58:10.344232_bDuX
    • 2024-01-03_22:58:10.344246_xltg
    • 2024-01-03_22:58:10.344254_QSWU
    • 2024-01-03_22:58:10.344261_INuD
    • 2024-01-03_22:58:10.344269_EIto
    • 2024-01-03_22:58:10.344276_nDff
    • 2024-01-03_22:58:10.344283_bQSM
    • 2024-01-03_22:58:10.344290_NMNs
    73087ca
    • 2024-01-04_15:15:30.349207_ilin
    • 2024-01-04_15:15:30.349244_ZkzG
    • 2024-01-04_15:15:30.349256_aRta
    • 2024-01-04_15:15:30.349265_xFLT
    • 2024-01-04_15:15:30.349272_vfQF
    • 2024-01-04_15:15:30.349279_JcmB
    • 2024-01-04_15:15:30.349287_IBXk
    • 2024-01-04_15:15:30.349294_Ijsz
    • 2024-01-04_15:15:30.349306_TKnF
    • 2024-01-04_15:15:30.349313_NFdS
    redfin-30
    Percentilea16c64773087caDiffSignificant (?)
    p10601 ±39 μs623 ±56 μs+21.9 μs (+3.6%)NO
    p25619 ±43 μs642 ±61 μs+23.0 μs (+3.7%)NO
    p50661 ±62 μs674 ±69 μs+12.9 μs (+2.0%)NO
    p75750 ±180 μs716 ±74 μs-34.2 μs (-4.6%)NO
    p90814 ±188 μs786 ±101 μs-28.0 μs (-3.4%)NO

    20 test runs in comparison
    CommitTest Runs
    a16c647
    • 2024-01-03_22:58:10.344184_OQny
    • 2024-01-03_22:58:10.344220_KuXL
    • 2024-01-03_22:58:10.344232_bDuX
    • 2024-01-03_22:58:10.344246_xltg
    • 2024-01-03_22:58:10.344254_QSWU
    • 2024-01-03_22:58:10.344261_INuD
    • 2024-01-03_22:58:10.344269_EIto
    • 2024-01-03_22:58:10.344276_nDff
    • 2024-01-03_22:58:10.344283_bQSM
    • 2024-01-03_22:58:10.344290_NMNs
    73087ca
    • 2024-01-04_15:15:30.349207_ilin
    • 2024-01-04_15:15:30.349244_ZkzG
    • 2024-01-04_15:15:30.349256_aRta
    • 2024-01-04_15:15:30.349265_xFLT
    • 2024-01-04_15:15:30.349272_vfQF
    • 2024-01-04_15:15:30.349279_JcmB
    • 2024-01-04_15:15:30.349287_IBXk
    • 2024-01-04_15:15:30.349294_Ijsz
    • 2024-01-04_15:15:30.349306_TKnF
    • 2024-01-04_15:15:30.349313_NFdS
  • timeToInitialDisplay

    DeviceStatisticsDistributions
    oriole-32
    Percentilea16c64773087caDiffSignificant (?)
    p10203 ±3 ms207 ±3 ms+3.67 ms (+1.8%)NO
    p25209 ±4 ms213 ±3 ms+4.36 ms (+2.1%)NO
    p50216 ±4 ms221 ±3 ms+5.34 ms (+2.5%)NO
    p75224 ±3 ms230 ±3 ms+6.13 ms (+2.7%)NO
    p90232 ±5 ms245 ±11 ms+12.8 ms (+5.5%)NO

    20 test runs in comparison
    CommitTest Runs
    a16c647
    • 2024-01-03_22:58:10.344184_OQny
    • 2024-01-03_22:58:10.344220_KuXL
    • 2024-01-03_22:58:10.344232_bDuX
    • 2024-01-03_22:58:10.344246_xltg
    • 2024-01-03_22:58:10.344254_QSWU
    • 2024-01-03_22:58:10.344261_INuD
    • 2024-01-03_22:58:10.344269_EIto
    • 2024-01-03_22:58:10.344276_nDff
    • 2024-01-03_22:58:10.344283_bQSM
    • 2024-01-03_22:58:10.344290_NMNs
    73087ca
    • 2024-01-04_15:15:30.349207_ilin
    • 2024-01-04_15:15:30.349244_ZkzG
    • 2024-01-04_15:15:30.349256_aRta
    • 2024-01-04_15:15:30.349265_xFLT
    • 2024-01-04_15:15:30.349272_vfQF
    • 2024-01-04_15:15:30.349279_JcmB
    • 2024-01-04_15:15:30.349287_IBXk
    • 2024-01-04_15:15:30.349294_Ijsz
    • 2024-01-04_15:15:30.349306_TKnF
    • 2024-01-04_15:15:30.349313_NFdS
    redfin-30
    Percentilea16c64773087caDiffSignificant (?)
    p10247 ±3 ms275 ±12 ms+27.6 ms (+11.2%)NO
    p25254 ±4 ms282 ±14 ms+28.2 ms (+11.1%)NO
    p50261 ±4 ms290 ±14 ms+29.4 ms (+11.3%)NO
    p75269 ±4 ms300 ±14 ms+30.4 ms (+11.3%)NO
    p90279 ±6 ms314 ±15 ms+35.0 ms (+12.6%)NO

    20 test runs in comparison
    CommitTest Runs
    a16c647
    • 2024-01-03_22:58:10.344184_OQny
    • 2024-01-03_22:58:10.344220_KuXL
    • 2024-01-03_22:58:10.344232_bDuX
    • 2024-01-03_22:58:10.344246_xltg
    • 2024-01-03_22:58:10.344254_QSWU
    • 2024-01-03_22:58:10.344261_INuD
    • 2024-01-03_22:58:10.344269_EIto
    • 2024-01-03_22:58:10.344276_nDff
    • 2024-01-03_22:58:10.344283_bQSM
    • 2024-01-03_22:58:10.344290_NMNs
    73087ca
    • 2024-01-04_15:15:30.349207_ilin
    • 2024-01-04_15:15:30.349244_ZkzG
    • 2024-01-04_15:15:30.349256_aRta
    • 2024-01-04_15:15:30.349265_xFLT
    • 2024-01-04_15:15:30.349272_vfQF
    • 2024-01-04_15:15:30.349279_JcmB
    • 2024-01-04_15:15:30.349287_IBXk
    • 2024-01-04_15:15:30.349294_Ijsz
    • 2024-01-04_15:15:30.349306_TKnF
    • 2024-01-04_15:15:30.349313_NFdS

  1. https://storage.googleapis.com/firebase-sdk-metric-reports/FYZy56TjGE/index.html

@google-oss-bot
Copy link
Contributor

The public api surface has changed for the subproject firebase-firestore:
error: Added method com.google.firebase.firestore.DocumentReference.addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.DocumentSnapshot>) [AddedMethod]
error: Added class com.google.firebase.firestore.ListenSource [AddedClass]
error: Added method com.google.firebase.firestore.Query.addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.QuerySnapshot>) [AddedMethod]
error: Added class com.google.firebase.firestore.SnapshotListenOptions [AddedClass]

Please update the api.txt files for the subprojects being affected by this change by running ./gradlew ${subproject}:generateApiTxtFile. Also perform a major/minor bump accordingly.

1 similar comment
@google-oss-bot
Copy link
Contributor

The public api surface has changed for the subproject firebase-firestore:
error: Added method com.google.firebase.firestore.DocumentReference.addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.DocumentSnapshot>) [AddedMethod]
error: Added class com.google.firebase.firestore.ListenSource [AddedClass]
error: Added method com.google.firebase.firestore.Query.addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.QuerySnapshot>) [AddedMethod]
error: Added class com.google.firebase.firestore.SnapshotListenOptions [AddedClass]

Please update the api.txt files for the subprojects being affected by this change by running ./gradlew ${subproject}:generateApiTxtFile. Also perform a major/minor bump accordingly.

@google-oss-bot
Copy link
Contributor

The public api surface has changed for the subproject firebase-firestore:
error: Added method com.google.firebase.firestore.DocumentReference.addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.DocumentSnapshot>) [AddedMethod]
error: Added class com.google.firebase.firestore.ListenSource [AddedClass]
error: Added method com.google.firebase.firestore.Query.addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.QuerySnapshot>) [AddedMethod]
error: Added class com.google.firebase.firestore.SnapshotListenOptions [AddedClass]

Please update the api.txt files for the subprojects being affected by this change by running ./gradlew ${subproject}:generateApiTxtFile. Also perform a major/minor bump accordingly.

@google-oss-bot
Copy link
Contributor

The public api surface has changed for the subproject firebase-firestore:
error: Added method com.google.firebase.firestore.DocumentReference.addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.DocumentSnapshot>) [AddedMethod]
error: Removed method com.google.firebase.firestore.FirestoreKt.snapshots(com.google.firebase.firestore.DocumentReference,com.google.firebase.firestore.MetadataChanges) [RemovedMethod]
error: Removed method com.google.firebase.firestore.FirestoreKt.snapshots(com.google.firebase.firestore.Query,com.google.firebase.firestore.MetadataChanges) [RemovedMethod]
error: Added method com.google.firebase.firestore.FirestoreKt.snapshots(com.google.firebase.firestore.DocumentReference,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource) [AddedMethod]
error: Added method com.google.firebase.firestore.FirestoreKt.snapshots(com.google.firebase.firestore.Query,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource) [AddedMethod]
error: Added class com.google.firebase.firestore.ListenSource [AddedClass]
error: Added method com.google.firebase.firestore.Query.addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.QuerySnapshot>) [AddedMethod]
error: Added class com.google.firebase.firestore.SnapshotListenOptions [AddedClass]

Please update the api.txt files for the subprojects being affected by this change by running ./gradlew ${subproject}:generateApiTxtFile. Also perform a major/minor bump accordingly.

@google-oss-bot
Copy link
Contributor

The public api surface has changed for the subproject firebase-firestore:
error: Added method com.google.firebase.firestore.DocumentReference.addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.DocumentSnapshot>) [AddedMethod]
error: Removed method com.google.firebase.firestore.FirestoreKt.snapshots(com.google.firebase.firestore.DocumentReference,com.google.firebase.firestore.MetadataChanges) [RemovedMethod]
error: Removed method com.google.firebase.firestore.FirestoreKt.snapshots(com.google.firebase.firestore.Query,com.google.firebase.firestore.MetadataChanges) [RemovedMethod]
error: Added method com.google.firebase.firestore.FirestoreKt.snapshots(com.google.firebase.firestore.DocumentReference,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource) [AddedMethod]
error: Added method com.google.firebase.firestore.FirestoreKt.snapshots(com.google.firebase.firestore.Query,com.google.firebase.firestore.MetadataChanges,com.google.firebase.firestore.ListenSource) [AddedMethod]
error: Added class com.google.firebase.firestore.ListenSource [AddedClass]
error: Added method com.google.firebase.firestore.Query.addSnapshotListener(com.google.firebase.firestore.SnapshotListenOptions,com.google.firebase.firestore.EventListener<com.google.firebase.firestore.QuerySnapshot>) [AddedMethod]
error: Added class com.google.firebase.firestore.SnapshotListenOptions [AddedClass]

Please update the api.txt files for the subprojects being affected by this change by running ./gradlew ${subproject}:generateApiTxtFile. Also perform a major/minor bump accordingly.

@milaGGL milaGGL closed this Feb 21, 2024
@firebase firebase locked and limited conversation to collaborators Mar 23, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants