import '../../../core/api_gateway.dart'; /// Optional numeric facts are present only when finite, integral and nonnegative. int? taskNumber(JsonMap shell, String field) { final value = shell[field]; if (value is! num || !value.isFinite || value < 0 || value > 8640000000000000 || value != value.roundToDouble()) { return null; } return value.toInt(); } DateTime? taskInstant(JsonMap shell, String field) { final millis = taskNumber(shell, field); return millis == null || millis == 0 ? null : DateTime.fromMillisecondsSinceEpoch(millis, isUtc: true).toLocal(); } String? taskText(JsonMap shell, String field) { final value = shell[field]; return value is String && value.trim().isNotEmpty ? value.trim() : null; } /// A clock ahead of this device is not a negative runtime. Duration? taskElapsed(JsonMap shell, DateTime now) { final start = taskInstant(shell, 'started_at'); if (start == null || start.isAfter(now)) return null; return now.difference(start); } String taskDuration(Duration elapsed) { if (elapsed.inDays > 0) return '${elapsed.inDays}d ${elapsed.inHours % 24}h'; if (elapsed.inHours > 0) { return '${elapsed.inHours}h ${elapsed.inMinutes % 60}m'; } if (elapsed.inMinutes > 0) { return '${elapsed.inMinutes}m ${elapsed.inSeconds % 60}s'; } return '${elapsed.inSeconds}s'; }