feat: Get/Create/Update a user

Author: Antaris

.gitignore

@@ -442,4 +442,5 @@ $RECYCLE.BIN/
 !.vscode/extensions.json
 
 ## Ingenium Defaults
-artefacts/*
+artefacts/*
+**/appsettings.env.json

Build

@@ -55,7 +55,11 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tests", "tests", "{89340FB5
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SailthruSDK.Tests", "tests\SailthruSDK.Tests\SailthruSDK.Tests.csproj", "{2E0DE426-D135-4710-80B5-173338D364C6}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SailthruSDK.Extensions.DependencyInjection", "libs\SailthruSDK.Extensions.DependencyInjection\SailthruSDK.Extensions.DependencyInjection.csproj", "{806DCE4B-D0BD-4AA5-B8BC-502B69ABFAF3}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SailthruSDK.Extensions.DependencyInjection", "libs\SailthruSDK.Extensions.DependencyInjection\SailthruSDK.Extensions.DependencyInjection.csproj", "{806DCE4B-D0BD-4AA5-B8BC-502B69ABFAF3}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "samples", "samples", "{0876C34F-5AAD-405F-9303-90145D7744CF}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SailthruSDK.Samples.Console", "samples\SailthruSDK.Samples.Console\SailthruSDK.Samples.Console.csproj", "{5CEF974B-EAA0-4DB2-9812-C8EFB74ACC96}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
@@ -83,6 +87,10 @@ Global
 		{806DCE4B-D0BD-4AA5-B8BC-502B69ABFAF3}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{806DCE4B-D0BD-4AA5-B8BC-502B69ABFAF3}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{806DCE4B-D0BD-4AA5-B8BC-502B69ABFAF3}.Release|Any CPU.Build.0 = Release|Any CPU
+		{5CEF974B-EAA0-4DB2-9812-C8EFB74ACC96}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{5CEF974B-EAA0-4DB2-9812-C8EFB74ACC96}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{5CEF974B-EAA0-4DB2-9812-C8EFB74ACC96}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{5CEF974B-EAA0-4DB2-9812-C8EFB74ACC96}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -95,6 +103,7 @@ Global
 		{562C63D3-F1F8-4929-B856-1463283DFC93} = {3E233261-9EBB-4F79-B840-BD73052C8428}
 		{2E0DE426-D135-4710-80B5-173338D364C6} = {89340FB5-E457-4182-A510-7F1D8DD97371}
 		{806DCE4B-D0BD-4AA5-B8BC-502B69ABFAF3} = {3E233261-9EBB-4F79-B840-BD73052C8428}
+		{5CEF974B-EAA0-4DB2-9812-C8EFB74ACC96} = {0876C34F-5AAD-405F-9303-90145D7744CF}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {B7D62062-4558-4545-9EE0-3A9B24CFD70D}

SailthruSDK.sln

@@ -2,6 +2,8 @@
 
 	<PropertyGroup>
 		<TargetFramework>netstandard2.0</TargetFramework>
+		<GeneratePackageOnBuild>True</GeneratePackageOnBuild>
+		<Version>0.1.0</Version>
 	</PropertyGroup>
 
 	<ItemGroup>

libs/SailthruSDK.Extensions.DependencyInjection/SailthruSDK.Extensions.DependencyInjection.csproj

@@ -23,7 +23,7 @@ public static class ServiceCollectionExtensions
 		/// <param name="configure">The configure delegate.</param>
 		/// <returns>The services collection.</returns>
 		public static IServiceCollection AddSailthru(
-			IServiceCollection services,
+			this IServiceCollection services,
 			Action<SailthruSettings> configure)
 		{
 			Ensure.IsNotNull(services, nameof(services));
@@ -43,13 +43,13 @@ public static IServiceCollection AddSailthru(
 		/// <param name="settings">The Sailthru settings.</param>
 		/// <returns>The services collection.</returns>
 		public static IServiceCollection AddSailthru(
-			IServiceCollection services,
+			this IServiceCollection services,
 			SailthruSettings settings)
 		{
 			Ensure.IsNotNull(services, nameof(services));
 			Ensure.IsNotNull(settings, nameof(settings));
 
-			services.AddSingleton(Options.Create(settings));
+			services.AddSingleton(settings.AsOptions());
 
 			AddCoreServices(services);
 
@@ -60,16 +60,16 @@ public static IServiceCollection AddSailthru(
 		/// Adds Sailthru services to the given services collection.
 		/// </summary>
 		/// <param name="services">The services collection.</param>
-		/// <param name="configurationSection">The configuration section.</param>
+		/// <param name="configuration">The configuration.</param>
 		/// <returns>The services collection.</returns>
 		public static IServiceCollection AddSailthru(
-			IServiceCollection services,
-			IConfigurationSection configurationSection)
+			this IServiceCollection services,
+			IConfiguration configuration)
 		{
 			Ensure.IsNotNull(services, nameof(services));
-			Ensure.IsNotNull(configurationSection, nameof(configurationSection));
+			Ensure.IsNotNull(configuration, nameof(configuration));
 
-			services.Configure<SailthruSettings>(configurationSection);
+			services.Configure<SailthruSettings>(configuration.GetSection(SailthruSettings.ConfigurationSection));
 
 			AddCoreServices(services);
 

libs/SailthruSDK.Extensions.DependencyInjection/ServiceCollectionExtensions.cs

@@ -0,0 +1,15 @@
+namespace SailthruSDK.Converters
+{
+using System.Text.Json;
+	using System.Text.Json.Serialization;
+
+	/// <summary>
+	/// Provides a base implementation fo a converter.
+	/// </summary>
+	/// <typeparam name="T">The model type.</typeparam>
+	internal abstract class ConverterBase<T> : JsonConverter<T>
+	{
+		protected string GetName(string name, JsonSerializerOptions options)
+			=> options.PropertyNamingPolicy!.ConvertName(name);
+	}
+}

libs/SailthruSDK/Converters/ConverterBase.cs

@@ -0,0 +1,100 @@
+namespace SailthruSDK.Converters
+{
+	using System;
+	using System.Globalization;
+	using System.Text.Json;
+
+	/// <summary>
+	/// Provides conversion of <see cref="DateTimeOffset"/> values using the format used by Sailthru.
+	/// </summary>
+	internal class NullableDateTimeOffsetConverter : ConverterBase<DateTimeOffset?>
+	{
+		const string DateTimeFormat = "ddd, dd MMM yyyy HH:mm:ss";
+		const string TimeZoneFormat = "hhmm";
+
+		/// <inheritdoc />
+		public override DateTimeOffset? Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
+		{
+			string? value = reader.GetString();
+			if (value is { Length: > 0 })
+			{
+				string suffix = value.Substring(value.Length - 5, 5).Trim();
+				value = value.Substring(0, value.Length - 5).Trim();
+
+				bool isNegative = suffix.StartsWith("-");
+				suffix = suffix.TrimStart('-', '+');
+
+				if (TimeSpan.TryParseExact(suffix, TimeZoneFormat, CultureInfo.InvariantCulture, out var timeZone))
+				{
+					if (isNegative)
+					{
+						timeZone = -timeZone;
+					}
+				}
+				else
+				{
+					return default;
+				}
+
+				if (DateTime.TryParseExact(value, DateTimeFormat, CultureInfo.InvariantCulture, DateTimeStyles.AssumeUniversal, out var dateTime))
+				{
+					return new DateTimeOffset(dateTime, timeZone);
+				}
+
+				return default;
+			}
+
+			return default;
+		}
+
+		/// <inheritdoc />
+		public override void Write(Utf8JsonWriter writer, DateTimeOffset? value, JsonSerializerOptions options) { }
+	}
+
+	/// <summary>
+	/// Provides conversion of <see cref="DateTimeOffset"/> values using the format used by Sailthru.
+	/// </summary>
+	internal class DateTimeOffsetConverter : ConverterBase<DateTimeOffset>
+	{
+		const string DateTimeFormat = "ddd, dd MMM yyyy HH:mm:ss";
+		const string TimeZoneFormat = "hhmm";
+
+		/// <inheritdoc />
+		public override DateTimeOffset Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
+		{
+			string? value = reader.GetString();
+			if (value is { Length: > 0 })
+			{
+				string suffix = value.Substring(value.Length - 5, 5).Trim();
+				value = value.Substring(0, value.Length - 5).Trim();
+
+				bool isNegative = suffix.StartsWith("-");
+				suffix = suffix.TrimStart('-', '+');
+
+				if (TimeSpan.TryParseExact(suffix, TimeZoneFormat, CultureInfo.InvariantCulture, out var timeZone))
+				{
+					if (isNegative)
+					{
+						timeZone = -timeZone;
+					}
+				}
+				else
+				{
+					return default;
+				}
+
+				if (DateTime.TryParseExact(value, DateTimeFormat, CultureInfo.InvariantCulture, DateTimeStyles.AssumeUniversal, out var dateTime))
+				{
+					return new DateTimeOffset(dateTime, timeZone);
+				}
+
+				return default;
+			}
+
+			return default;
+		}
+
+		/// <inheritdoc />
+		public override void Write(Utf8JsonWriter writer, DateTimeOffset value, JsonSerializerOptions options) { }
+	}
+}

libs/SailthruSDK/Converters/DateTimeOffsetConverter.cs

@@ -0,0 +1,62 @@
+namespace SailthruSDK.Converters
+{
+	using System;
+	using System.Collections.Generic;
+	using System.Linq;
+	using System.Text.Json;
+	using System.Text.Json.Serialization;
+
+	/// <summary>
+	/// Deserializes a <see cref="Map{TValue}"/> type.
+	/// </summary>
+	/// <typeparam name="T">The element type.</typeparam>
+	internal class MapConverter<T> : ConverterBase<Map<T>>
+	{
+		public override Map<T>? Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
+		{
+			var map = new Map<T>();
+			var source = JsonSerializer.Deserialize<Dictionary<string, T>>(ref reader, options);
+			if (source is { Count: >0 })
+			{
+				foreach (var pair in source)
+				{
+					map.Add(pair.Key, pair.Value);
+				}
+			}
+
+			return map;
+		}
+
+		public override void Write(Utf8JsonWriter writer, Map<T> value, JsonSerializerOptions options)
+		{
+			if (value is null)
+			{
+				writer.WriteNullValue();
+			}
+			else
+			{
+				writer.WriteStartObject();
+				var converter = options.GetConverter(typeof(T)) as JsonConverter<T>;
+
+				if (value.Count > 0)
+				{
+					foreach (var pair in value.OrderBy(p => p.Key, StringComparer.Ordinal))
+					{
+						writer.WritePropertyName(GetName(pair.Key, options));
+
+						if (converter is null)
+						{
+							JsonSerializer.Serialize(writer, pair.Value, options);
+						}
+						else
+						{
+							converter.Write(writer, pair.Value, options);
+						}
+					}
+				}
+
+				writer.WriteEndObject();
+			}
+		}
+	}
+}

libs/SailthruSDK/Converters/MapConverter.cs

@@ -0,0 +1,45 @@
+namespace SailthruSDK.Converters
+{
+	using System;
+	using System.Text.Json;
+
+	/// <summary>
+	/// Represents a converter for handling nullable enum values.
+	/// </summary>
+	/// <typeparam name="TEnum">The enum type.</typeparam>
+	internal class NullableEnumConverter<TEnum> : ConverterBase<TEnum?>
+		where TEnum : struct
+	{
+		/// <inheritdoc />
+		public override TEnum? Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
+		{
+			string? value = reader.GetString();
+			if (value is { Length: > 0 })
+			{
+				if (Enum.TryParse<TEnum>(value, true, out var enumValue))
+				{
+					return enumValue;
+				}
+
+				return default;
+			}
+			else
+			{
+				return default;
+			}
+		}
+
+		/// <inheritdoc />
+		public override void Write(Utf8JsonWriter writer, TEnum? value, JsonSerializerOptions options)
+		{
+			if (value.HasValue)
+			{
+				writer.WriteStringValue(value.Value.ToString());
+			}
+			else
+			{
+				writer.WriteNullValue();
+			}
+		}
+	}
+}

libs/SailthruSDK/Converters/NullableEnumConverter.cs

@@ -0,0 +1,49 @@
+namespace SailthruSDK.Converters
+{
+	using System;
+	using System.Text.Json;
+	using System.Text.Json.Serialization;
+
+	/// <summary>
+	/// Serializes a <see cref="OneOf{TFirst, TSecond}"/> type.
+	/// </summary>
+	/// <typeparam name="TFirst">The first type.</typeparam>
+	/// <typeparam name="TSecond">The second type.</typeparam>
+	internal class OneOfConverter<TFirst, TSecond> : ConverterBase<OneOf<TFirst, TSecond>>
+	{
+		public override OneOf<TFirst, TSecond> Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
+			=> default;
+
+		public override void Write(Utf8JsonWriter writer, OneOf<TFirst, TSecond> value, JsonSerializerOptions options)
+		{
+			if (value.HasValue)
+			{
+				if (value.IsFirst)
+				{
+					Write(writer, value.First, options);
+				}
+				else
+				{
+					Write(writer, value.Second, options);
+				}
+			}
+			else
+			{
+				writer.WriteNullValue();
+			}
+		}
+
+		static void Write<TValue>(Utf8JsonWriter writer, TValue value, JsonSerializerOptions options)
+		{
+			var converter = options.GetConverter(typeof(TValue)) as JsonConverter<TValue>;
+			if (converter is not null)
+			{
+				converter.Write(writer, value, options);
+			}
+			else
+			{
+				JsonSerializer.Serialize(writer, value, options);
+			}
+		}
+	}
+}