fix(core): truncate channel state before reloading the latest messages

`StreamChannel.reloadChannel` was leaving the previously loaded window in
place and merging the latest page on top of it via `channel.query`. After
a `loadChannelAtMessage(...)` jump, that left the around-message window
glued to the freshly loaded latest 30 — older messages from before the
reload were still in `channel.state.messages`, and the "scroll to bottom"
FAB landed the user on a state that didn't match a fresh open of the
channel.

Truncate the existing state before the `_queryAtMessage()` call so a
reload behaves like the initial open.

Adds two tests:
- `truncates the existing window before querying the latest messages`
- `queries with no around-anchor (loads the latest page)`

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: xsahil03x

packages/stream_chat_flutter_core/CHANGELOG.md

@@ -1,3 +1,10 @@
+## Upcoming
+
+🐞 Fixed
+
+- Fixed `StreamChannel.reloadChannel` merging the latest page on top of the previously loaded
+  window instead of replacing it. The reload now matches a fresh open of the channel.
+
 ## 9.24.0
 
 ✅ Added

packages/stream_chat_flutter_core/lib/src/stream_channel.dart

@@ -776,8 +776,11 @@ class StreamChannelState extends State<StreamChannel> {
     });
   }
 
-  /// Reloads the channel with latest message
-  Future<void> reloadChannel() => _queryAtMessage();
+  /// Reloads the channel with latest messages, replacing the loaded window.
+  Future<void> reloadChannel() {
+    channel.state?.truncate();
+    return _queryAtMessage();
+  }
 
   Future<void> _maybeInitChannel() async {
     // If the channel doesn't have an CID yet, it hasn't been created on the

packages/stream_chat_flutter_core/test/stream_channel_test.dart

@@ -908,4 +908,82 @@ void main() {
       },
     );
   });
+
+  group('reloadChannel', () {
+    final mockChannel = MockChannel();
+    tearDownAll(mockChannel.dispose);
+
+    setUp(() {
+      when(() => mockChannel.cid).thenReturn('test:channel');
+      when(() => mockChannel.state.messages).thenReturn([]);
+      when(() => mockChannel.state.isUpToDate).thenReturn(true);
+      when(() => mockChannel.state.unreadCount).thenReturn(0);
+      when(() => mockChannel.state.truncate()).thenAnswer((_) {});
+      when(
+        () => mockChannel.query(
+          preferOffline: any(named: 'preferOffline'),
+          messagesPagination: any(named: 'messagesPagination'),
+        ),
+      ).thenAnswer((_) async => const ChannelState());
+    });
+
+    tearDown(() => reset(mockChannel));
+
+    Future<StreamChannelState> _pumpStreamChannel(WidgetTester tester) async {
+      StreamChannelState? channelState;
+      await tester.pumpWidget(
+        MaterialApp(
+          home: Scaffold(
+            body: StreamChannel(
+              channel: mockChannel,
+              child: Builder(
+                builder: (context) {
+                  channelState = StreamChannel.of(context);
+                  return const Text('Channel Content');
+                },
+              ),
+            ),
+          ),
+        ),
+      );
+      await tester.pumpAndSettle();
+      return channelState!;
+    }
+
+    testWidgets(
+      'truncates the existing window before querying the latest messages',
+      (tester) async {
+        final streamChannel = await _pumpStreamChannel(tester);
+
+        await streamChannel.reloadChannel();
+
+        verifyInOrder([
+          () => mockChannel.state.truncate(),
+          () => mockChannel.query(
+                preferOffline: any(named: 'preferOffline'),
+                messagesPagination: any(named: 'messagesPagination'),
+              ),
+        ]);
+      },
+    );
+
+    testWidgets(
+      'queries with no around-anchor (loads the latest page)',
+      (tester) async {
+        final streamChannel = await _pumpStreamChannel(tester);
+
+        await streamChannel.reloadChannel();
+
+        final captured = verify(
+          () => mockChannel.query(
+            preferOffline: any(named: 'preferOffline'),
+            messagesPagination: captureAny(named: 'messagesPagination'),
+          ),
+        ).captured.single as PaginationParams;
+
+        expect(captured.idAround, isNull);
+        expect(captured.createdAtAround, isNull);
+      },
+    );
+  });
 }