chore(repo): merge master into v10.0.0

[xsahil03x]

Summary

Brings master's perf / security / CI work into the v10 design-refresh branch.

Master is 17 commits ahead of v10.0.0 — this PR carries them into v10 so the upcoming v10 release ships with the latest LLC perf rewrites, the in-flight queryChannels dedup, the jose security floor, and the relaxed URL detection. On top of those, this PR ports the same perf approach into v10's design-refresh code (single-message fast path in _mergeMessagesIntoExisting, Jiffy removal from message-list predicates), rewrites the date formatter as a clock-driven extension, and overhauls the message-list pagination / scroll / highlight plumbing.

What landed

LLC (stream_chat)

• Client.queryDrafts now forwards filter (fix(llc): forward filter param in Client.queryDrafts #2647).
• Client.queryChannels coalesces concurrent identical queries via the new InFlightCache<K, V> (fix(llc, core): coalesce queryChannels on flaky-network reconnects #2652).
• list_extensions.dart added — IterableMergeX.merge (keyed-map merge, unsorted output) plus SortedListX.mergeSorted (two-pointer merge requiring a sorted receiver). Duplicate-keyed inputs tolerated (chore(llc): tolerate duplicate-keyed inputs in SortedListX.merge #2660). v10's IterableMergeExtension callers route through merge; the perf paths use mergeSorted. Renaming SortedListX.merge (added in 9.24.0) → mergeSorted is breaking for any direct caller of the former.
• Channel._mergeMessagesIntoExisting gains a single-message fast path (lastIndexWhere + sortedUpsertAt) — skips the full keyed merge for the steady-state new-message case.
• ChannelClientState._checkExpiredAttachmentMessages removed (perf(llc): faster channel state ingest #2653); v10's StreamImageCDN.cacheKey already keeps the image cache valid across signed-URL rotations.
• ChannelClientState.updateChannelState now identity-short-circuits when updatedState.messages is null or the same reference, so downstream .distinct() listeners can skip rebuilds.
• Reaction listeners dispatch via _findMessage (parentId-aware) while keeping v10's addMyReaction / deleteMyReaction semantics.
• jose floor bumped to 0.3.5+1 for CVE-2026-34240 (fix(llc): bump jose floor to 0.3.5+1 for CVE-2026-34240 #2658).

stream_chat_flutter_core

• BetterStreamBuilder correctness fixes: mounted guard, error reporting via FlutterError.reportError, identity-equal emission gating (perf(repo): cut StreamMessageListView UI-thread work under flood load #2651).
• MessageListCore caches its messagesStream / _initialMessages as fields instead of recomputing in build() (perf(repo): cut StreamMessageListView UI-thread work under flood load #2651). defaultMessageFilter takes an optional currentUserId.
• StreamChatCore debounces connectivity events to 3 s (fix(llc, core): coalesce queryChannels on flaky-network reconnects #2652).

stream_chat_flutter

Date formatting

• date_formatter.dart rewritten — replaces Jiffy predicates with a DateTimeComparisonUtils extension (isToday, isYesterday, isWithinLastMinute, isWithinLastWeek, isInSameYear, single isSame(unit:) entry point with a DateTimeUnit enum). Uses package:clock for testable time. Cuts ~1.5s on the trace per the latest DevTools profile.
• formatRecentDateTime output reworked to a five-state cascade matching the Figma design: Just now / Today at H:mm / Yesterday at H:mm / Weekday at H:mm / MMM do at H:mm.

Message-list view internals

• mlv_utils.dart: _isGroupBoundary, _resolveSpacingRules, and computeStackPosition drop Jiffy in favor of the new extension.
• scrollable_positioned_list/: master version taken in full. Bounded _keyToIndexMap, isScrolling / isScrollingListenable, itemKeyBuilder anchor preservation, fit-anchor fallback in UnboundedRenderViewport, sensible defaults on scrollTo (perf(repo): cut StreamMessageListView UI-thread work under flood load #2651).
• tld.dart removed (chore(ui): drop the bundled IANA TLD list #2654); StreamMessageComposer relaxed its URL regex from [a-z]{2,4} to [a-z]{2,} and dropped the isValidTLD filter at both call sites.
• StreamMessageListView and separated_reorderable_list_view: v10's design-refresh version retained on top of the perf changes.

Scroll, highlight, pagination plumbing

• _moveToAndHighlight renamed to _scrollToMessage and tightened: messageId is required (was nullable), dropped the unused messages / initialScrollIndex / scrollTo parameters, added alignment (default 0.5) and highlight (default true) knobs, guards on controller.isAttached before scrolling. In thread mode, bails when the target reply isn't loaded (no thread-around-reply loader is exposed today — matches Android/RN; iOS/SwiftUI have loadPageAroundReplyId and remain the proper-fix template).
• Initial-highlight selection discriminates channel vs thread — threads read _ThreadHighlightScope only, the channel reads streamChannel.initialMessageId only. Previously the channel-scoped id leaked into thread mode and could mis-route _scrollToMessage into the channel pagination path. Matches Android's parentMessageId-discriminated focus and SwiftUI's per-VM highlight environment. _ThreadHighlightScope.of switched to dependOnInheritedWidgetOfExactType for O(1) lookup.
• Pagination LoadingIndicator reworked: StatefulWidget that caches the queryTopMessages / queryBottomMessages stream (matches MessageListCore's pattern — the getters on StreamChannelState return a fresh BehaviorSubject view per access), reads StreamChannel.of(context) instead of taking it as a prop, drops the unused streamTheme / isThreadConversation fields. In-flight spinner uses StreamLoadingSpinner and the existing widget.builders.paginationLoadingIndicator override; the error tile is a tappable StreamScrollViewLoadMoreError.list that retries via _paginateData. Initial-load defaultErrorBuilder upgraded from plain Text to StreamScrollViewErrorWidget with retry → streamChannel.reloadChannel(). _paginateData drops its unused channel parameter.
• Inner ScrollablePositionedList.separated gets a stable Key('mlv-${cid}-${parentId}') — same-channel/same-thread rebuilds keep the SPL's scroll position and item-position cache; channel swap or thread enter/leave forces a clean remount.
• MessageListView default builders switched from if (X != null) return X!(...) to if (X case final builder?) return builder(...), dropping the bang-assertions.

Other

• Committed two previously-untracked generated part files (stream_chat_theme.g.theme.dart, thread_list_tile_theme.g.theme.dart) — CI analyze couldn't compile without them.
• Suppressed a deprecation on SizeTransition.axisAlignment — its replacement alignment was added after Flutter 3.41, beyond the SDK floor (3.38.1).
• Added auto_scroll_test.dart and stream_chat_theme_test.dart (10 tests covering message-list scroll behavior and theme ancestor lookup).

sample_app

• Completed the Sentry → Firebase Crashlytics migration (chore(samples): replace Sentry with Firebase Crashlytics #2665) on v10's redesigned sample app: removed sentry_flutter from pubspec.yaml and swapped the Sentry.captureException call in auth_controller.dart for FirebaseCrashlytics.instance.recordError(error, stack, reason: record.message). main.dart was already on Crashlytics; the log handler in auth_controller was the last sentry consumer.

CI / repo

• Path/draft gating job (gate) added to legacy_version_analyze, check_db_entities, and stream_flutter_workflow (ci(repo): centralize path/draft gating in a per-workflow gate job #2669).
• Flutter 3.44 fixes (chore(repo): fix ci issues for flutter 3.44 #2667), pana / build cleanups (chore(repo): Fix build and pana reports #2656), local-setup CI fixes (ci(repo): Resolve local setup related issues #2650).
• SPM disabled at the CI level instead of via pubspec flag (fix(ci): disable SPM at CI level instead of via pubspec flag #2675, chore(samples): disable Swift Package Manager for sample_app #2672).
• melos.yaml: kept v10's higher floors; added firebase_crashlytics (chore(samples): replace Sentry with Firebase Crashlytics #2665); dropped sentry_flutter.
• release-pr skill added (chore(repo): add release-pr skill #2657).
• Reformatted eight files to match Dart 3.12's dart format output. Dart 3.10 had a bug (dart-lang/dart_style#1785) that left a stray \n ; on enum declarations with parameters when trailing_commas: preserve is set; CI's Dart 3.12 (Flutter 3.44) correctly collapses them.

Docs / tests

• docs_screenshots/voice_recording_test.dart: replaced StreamChatThemeData().copyWith(...) with the factory constructor — the generator-emitted copyWith returns the base ThemeExtension<StreamChatThemeData> type, which isn't assignable to a StreamChatThemeData? parameter.

Notes / follow-ups

• sample_app/: v10's redesigned sample app retained as a unit (gradle, manifest, main.dart, pbxproj — auto-merge would have left it inconsistent with v10's app.dart / pubspec). chore(samples): replace Sentry with Firebase Crashlytics #2665's Sentry → Crashlytics work is now fully ported (see above).
• mark_read_test.dart: dropped a dead when(() => channel.on(any(), any(), any(), any())) stub that leaked any() matchers into the next setUp (since MockChannel.on() is a concrete override, not a mocktail stub).
• Locale: formatRecentDateTime hardcodes English 'at' separator — needs a dateAtTimeText({date, time}) Translations method for locale support. Tracked.
• Deferred perf: StreamTimestamp / StreamDateDivider still call Jiffy (~684ms / 11.8% in the latest profile) — should move to a cached intl.DateFormat.
• Goldens: 49 pixel-diff failures in reactions / polls / avatars / icons remain — pre-existing Flutter-SDK rendering drift, unrelated to this PR. Regenerate with melos run update:goldens if needed.
• Channel.query() truncate-on-reload: after a loadChannelAtMessage(Y) jump, calling reloadChannel() merges the latest 30 with the around-Y window instead of replacing — older messages (including the one that contained the quoted tap) end up unreachable without paginating back. Fix needs to land in v9 first (same LLC code), then port to v10. Tracked.
• Thread-around-reply loader: _scrollToMessage bails in thread mode when the target reply isn't loaded. Backend supports id_around on GET /messages/{parent_id}/replies and the LLC already exposes it via Channel.getReplies(parentId, options: PaginationParams(idAround: ...)); iOS UIKit (MessageController.loadPageAroundReplyId) and SwiftUI wire it through, Android and React Native do not. Wire a loadPageAroundReplyId-style helper into StreamChannel / the thread controller as a follow-up.

Test plan

• dart test packages/stream_chat — 1381/1381 pass
• flutter test packages/stream_chat_flutter_core — 239/239 pass
• flutter test packages/stream_chat_flutter — touched-area tests all pass (date_formatter_test, message_list_view_test, mark_read_test, auto_scroll_test, timestamp_test, stream_chat_test, stream_channel_test)
• CI: analyze, format, test, build (android) green
• CI: build (ios) — Sentry/Crashlytics archive failure was the prior blocker; should clear now that sentry_flutter is gone (first run since the migration)
• Manual: sample_app boots against v10 on at least one platform

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 9faee784-7411-4cf8-9e44-c8f4e69d471b

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/merge-peformance-improvements-into-v10

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[codecov]

Codecov Report

❌ Patch coverage is 87.51625% with 96 lines in your changes missing coverage. Please review.
⚠️ Please upload report for BASE (v10.0.0@29fc127). Learn more about missing BASE report.

Files with missing lines	Patch %	Lines
...r/lib/src/message_list_view/message_list_view.dart	55.55%	56 Missing ⚠️
...r/lib/src/message_list_view/loading_indicator.dart	68.18%	7 Missing ⚠️
...m_chat_flutter_core/lib/src/message_list_core.dart	92.22%	7 Missing ⚠️
...t_view/stream_message_list_view_configuration.dart	0.00%	6 Missing ⚠️
packages/stream_chat/lib/src/client/channel.dart	91.93%	5 Missing ⚠️
...crollable_positioned_list/src/positioned_list.dart	97.67%	4 Missing ⚠️
...at_flutter_core/lib/src/better_stream_builder.dart	85.18%	4 Missing ⚠️
packages/stream_chat/lib/src/client/client.dart	57.14%	3 Missing ⚠️
...ositioned_list/src/scrollable_positioned_list.dart	96.47%	3 Missing ⚠️
...lib/src/message_input/stream_message_composer.dart	50.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             v10.0.0    #2682   +/-   ##
==========================================
  Coverage           ?   66.98%           
==========================================
  Files              ?      407           
  Lines              ?    24365           
  Branches           ?        0           
==========================================
  Hits               ?    16320           
  Misses             ?     8045           
  Partials           ?        0           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.