sharee.bike-App/SharedBusinessLogic/Model/Bikes/BikeInfoNS/DriveNS/BatteryNS/Battery.cs

using Serilog;

namespace ShareeBike.Model.Bikes.BikeInfoNS.DriveNS.BatteryNS
{
	/// <summary>
	/// Holds the state of a chargeable battery.
	/// </summary>
	public class Battery : IBattery
	{
		private Battery() { }

		/// <summary>
		/// Gets the current charging level of the battery in percent, double.NaN if unknown.
		/// </summary>
		public double CurrentChargePercent { get; private set; } = double.NaN;

		/// <summary>
		/// Gets the current charging level of the battery in bars, null if unknown.
		/// </summary>
		public int? CurrentChargeBars { get; private set; } = null;

		/// <summary>
		/// Gets the maximum charging level of the battery in bars, null if unknown.
		/// </summary>
		public int? MaxChargeBars { get; private set; } = null;

		/// <summary>
		/// Gets whether backend is aware of battery charging level.
		/// </summary>
		public bool? IsBackendAccessible { get; private set; } = null;

		/// <summary>
		/// Gets whether to display battery level or not.
		/// </summary>
		public bool? IsHidden { get; private set; } = null;

		public class Builder
		{
			/// <summary>
			/// Holds the current charging level of the battery in bars.
			/// </summary>
			public int? CurrentChargeBars { get; set; } = null;

			/// <summary>
			/// Holds the maximum charging level of the battery in bars.
			/// </summary>
			public int? MaxChargeBars { get; set; } = null;

			/// <summary>
			/// Holds the current charging level of the battery in percent.
			/// </summary>
			public double CurrentChargePercent { get; set; } = double.NaN;

			/// <summary>
			/// Holds whether backend is aware of battery charging level.
			/// </summary>
			public bool? IsBackendAccessible { get; set; } = null;

			/// <summary>
			/// Holds whether to display battery level or not.
			/// </summary>
			public bool? IsHidden { get; set; } = null;

			public Battery Build()
			{
				if (!double.IsNaN(CurrentChargePercent)
					&& (CurrentChargePercent < 0 || 100 < CurrentChargePercent))
				{
					// Invalid filling level detected
					CurrentChargePercent = double.NaN;
				}

				if (CurrentChargeBars < 0)
				{
					// Current value of bars must never be smaller zero.
					CurrentChargeBars = null;
				}

				if (MaxChargeBars < 0)
				{
					// Max value of bars must never be smaller zero.
					MaxChargeBars = null;
				}

				if (CurrentChargeBars != null
					&& MaxChargeBars == null)
				{
					// If current charge bars is set, max charge must be set as well.
					Log.ForContext<Battery>().Error($"Current bars value can not be set to {CurrentChargeBars} if max bars is not set.");
					CurrentChargeBars = null;
				}

				if (CurrentChargeBars != null
					&& MaxChargeBars != null
					&& CurrentChargeBars > MaxChargeBars)
				{
					// If current charge bars must never be larger than max charge bars.
					Log.ForContext<Battery>().Error($"Invalid current bars value {CurrentChargeBars} detected. Value must never be larger than max value bars {MaxChargeBars}.");
					CurrentChargeBars = null;
				}

				return new Battery
				{
					CurrentChargeBars = CurrentChargeBars,
					MaxChargeBars = MaxChargeBars,
					CurrentChargePercent = CurrentChargePercent,
					IsBackendAccessible = IsBackendAccessible,
					IsHidden = IsHidden
				};
			}
		}
	}
}