JsonConverters

Converters.cs

namespace TempStick;

public class BooleanConverter : JsonConverter<bool>
{
    public override bool Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        if (reader.TokenType == JsonTokenType.String)
        {
            return string.Equals(reader.GetString(), "1", StringComparison.OrdinalIgnoreCase);
        }
        return reader.TryGetInt32(out var value) && value == 1;
    }

    public override void Write(Utf8JsonWriter writer, bool value, JsonSerializerOptions options)
    {
        // NOTE: This assumes that a string 1/0 will work. TempStick API sometimes has defaults as int but then when changed they suddenly are strings
        writer.WriteStringValue(value ? "1" : "0");
    }
}

public class DayOfWeekConverter : JsonConverter<DayOfWeek>
{
    public override DayOfWeek Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        var valueAsString = reader.GetString();
        if (int.TryParse(valueAsString, out int value))
        {
            return (DayOfWeek)(value - 1);
        }
        throw new JsonException($"Invalid value '{valueAsString}' for {nameof(DayOfWeek)}.");
    }

    public override void Write(Utf8JsonWriter writer, DayOfWeek value, JsonSerializerOptions options)
    {
        writer.WriteStringValue(((int)value + 1).ToString());
    }
}

example.md

Having this pattern allows the response that will likely be something like:

{
  "use_timezone_offset":"1",
  "is_subuser": 0
  "weekday_for_reports": "3"
}

To be better serialized so a client could use:

apiResponse.UseTimeZoneOffset = true;
apiResponse.IsSubuser = false;
apiResponse.WeekdayForReports = DayOfWeek.Tuesday;