Files
oott/frontend/lib/widgets/scanner_status_card.dart
T
rzuasti 48d73fb207 Consolidate frontend scanner, pagination, and tick-timer duplication
Collapse the five scanner status models into two shared shapes,
ActiveScannerStatus and PassiveScannerStatus, mirroring the backend's
active/passive vocabulary. Replace the five near-identical per-scanner
detail card files with a single scanner_status_cards.dart (two shared
resolvers plus a config list), and rebuild the combined home card to
iterate a list of scanners with two shape resolvers instead of five
copy-pasted resolve methods.

Extract two reusable mixins:
- PeriodicRebuild: the shared once-a-second "rebuild to refresh elapsed
  text" timer used by the scanner cards and the stale indicator.
- PaginatedListState: the shared pagination state, page-size/page-count
  getters, cancel-token-aware fetch orchestration, and disposal used by
  the device and notification lists.

No behaviour change; ~900 lines removed. Tests and analyzer pass.
2026-06-05 21:57:58 -04:00

148 lines
4.5 KiB
Dart

import 'package:dio/dio.dart';
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
import '../utils/backend_reachability.dart';
import '../utils/periodic_rebuild.dart';
import '../utils/polled_value.dart';
import 'polled_stale_indicator.dart';
typedef ScannerStatus = ({Color color, String label, List<String> sublabels});
typedef ScannerStatusResolver<T> =
ScannerStatus Function(
BuildContext context,
T value,
double elapsedSeconds,
);
/// Generic card that polls a scanner status endpoint and renders the result
/// using the provided [resolver]. The per-scanner detail cards are configured
/// over this widget in `scanner_status_cards.dart`.
class ScannerStatusCard<T> extends StatefulWidget {
const ScannerStatusCard({
super.key,
required this.title,
required this.fetch,
required this.resolver,
});
final String title;
final Future<T> Function({CancelToken? cancelToken}) fetch;
final ScannerStatusResolver<T> resolver;
@override
State<ScannerStatusCard<T>> createState() => _ScannerStatusCardState<T>();
}
class _ScannerStatusCardState<T> extends State<ScannerStatusCard<T>>
with PeriodicRebuild<ScannerStatusCard<T>> {
late final PolledValue<T> _polled;
@override
void initState() {
super.initState();
_polled = PolledValue<T>(
fetch: widget.fetch,
pollInterval: const Duration(seconds: 5),
staleErrorAfter: const Duration(seconds: 30),
);
startRebuildTicker();
}
@override
void dispose() {
_polled.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return ListenableBuilder(
listenable: Listenable.merge([_polled, BackendReachability.instance]),
builder: (context, _) {
final freshness = effectiveFreshness(_polled);
if (freshness == PolledFreshness.initialLoading) {
return const Card(
child: Padding(
padding: EdgeInsets.all(16),
child: Center(child: CircularProgressIndicator()),
),
);
}
final status = _resolveStatus(context, freshness);
final isStale = freshness == PolledFreshness.stale;
final theme = Theme.of(context);
return Card(
clipBehavior: Clip.antiAlias,
child: InkWell(
onTap: () => context.go('/status'),
child: Padding(
padding: const EdgeInsets.all(16),
child: Row(
children: [
Icon(Icons.circle, color: status.color, size: 14),
const SizedBox(width: 12),
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Row(
children: [
Text(
widget.title,
style: theme.textTheme.titleMedium,
),
if (isStale) ...[
const SizedBox(width: 6),
PolledStaleIndicator(polled: _polled),
],
],
),
const SizedBox(height: 2),
Text(status.label, style: theme.textTheme.bodyMedium),
for (final sublabel in status.sublabels) ...[
const SizedBox(height: 2),
Text(
sublabel,
style: theme.textTheme.bodySmall?.copyWith(
color: theme.colorScheme.outline,
),
),
],
],
),
),
],
),
),
),
);
},
);
}
ScannerStatus _resolveStatus(
BuildContext context,
PolledFreshness freshness,
) {
if (freshness == PolledFreshness.error) {
return (
color: Theme.of(context).colorScheme.error,
label: 'Error',
sublabels: [
_polled.lastErrorMessage ??
'Unable to reach the server. Check the logs for details.',
],
);
}
final elapsed = DateTime.now()
.difference(_polled.lastSuccessAt!)
.inSeconds
.toDouble();
return widget.resolver(context, _polled.value as T, elapsed);
}
}