feat: updating not found exception to give more information

packages/_flutterfire_internals/lib/src/exception.dart

@@ -46,8 +46,19 @@ FirebaseException platformExceptionToFirebaseException(
   String message = platformException.message ?? '';
 
   if (details != null) {
+    print('platformException.code: ${platformException.code}');
+    print('platformException.details: ${platformException.details}');
+    print('platformException.message: ${platformException.message}');
+
     code = (details['code'] as String?) ?? code;
-    message = (details['message'] as String?) ?? message;
+
+    if ((code?.compareTo('not-found') == 0) && message.contains('NOT_FOUND:')) {
+      /// For not-found exceptions, return the Firestore provided reason and
+      /// document path rather than generic error message.
+      message = message.split('NOT_FOUND:').last.trim();
+    } else {
+      message = (details['message'] as String?) ?? message;
+    }
   }
 
   return FirebaseException(

packages/cloud_firestore/cloud_firestore/example/integration_test/document_reference_e2e.dart

@@ -525,6 +525,19 @@ void runDocumentReferenceTests() {
               isA<FirebaseException>()
                   .having((e) => e.code, 'code', 'not-found'),
             );
+
+            // https://github.com/firebase/flutterfire/pull/12813
+            // Use platformException.message, which is more detailed, rather than the
+            // platformException.details['message'] which is the generic:
+            // 'Some requested document was not found'
+            expect(
+              e,
+              isA<FirebaseException>().having(
+                (e) => e.message,
+                'message',
+                isNot(contains('Some requested document was not found')),
+              ),
+            );
           }
         },
       );