@riverpod
class ChatController extends _$ChatController {
  @override
  Future<ChatState> build(String chatId) async {
    // cleanup registered in build() — not dispose()
    ref.onDispose(() => _subscription?.cancel());
    final repo = ref.watch(chatRepositoryProvider);
    return repo.getChatState(chatId);
  }

  Future<void> sendMessage(String content) async {
    state = const AsyncLoading();
    state = await AsyncValue.guard(
      () => _send(content),
    );
  }
}

// lib/core/error/failure_base.dart
abstract class Failure {
  const Failure(this.message);
  final String message;
}

// Sealed sub-hierarchies — exhaustive switch
sealed class DomainFailure extends Failure { ... }
final class DomainNotFoundFailure    extends DomainFailure { ... }
final class DomainPermissionFailure  extends DomainFailure { ... }
final class DomainInputFailure       extends DomainFailure { ... }

sealed class StorageFailure   extends Failure { ... }
sealed class NetworkFailure   extends Failure { ... }  // network_failures.dart
sealed class AuthFailure      extends Failure { ... }  // auth_failures.dart
sealed class ChatFailure      extends Failure { ... }  // chat_failures.dart
sealed class CallFailure      extends Failure { ... }  // call_failures.dart

// UI — Dart 3 exhaustive switch (compile-time safe)
switch (failure) {
  DomainNotFoundFailure()   => showNotFound(),
  DomainPermissionFailure() => showAccessDenied(),
  NetworkFailure()          => showRetry(),
  AuthFailure()             => navigateToLogin(),
  _                         => showGenericError(),
};

// 80+ type-safe deep-link routes
// 12 route group files (part files)
// typed_routes_auth / chat / calls / settings...

// Navigation — אין String paths, אין typos
const SplashRoute().go(context);
MatchDetailRoute(matchId: '123').push(context);
ChatRoute(
  roomId: RoomId('abc'),
  $extra: chatArgs,
).go(context);

// Deep links — Universal Links + App Links
// sportchat://match/123/analysis
// sportchat://voice-room/789
// sportchat://profile/{userId}
// sportchat://predictions/{matchId}

@freezed
class Match with _$Match {
  const factory Match({
    required String id,
    required String homeTeam,
    required String awayTeam,
    required DateTime kickoff,
    @Default(MatchStatus.upcoming)
    MatchStatus status,
    // computed field — excluded from JSON
    @JsonKey(includeFromJson: false)
    String? computedLabel,
  }) = _Match;

  factory Match.fromJson(Map<String, dynamic> json)
      => _$MatchFromJson(json);
}