fix: Support message_id flow for purchases

Author: Antaris

build.cmd

@@ -1,8 +1,10 @@
 @echo off
 
 set target=%1
+set verbostity=%2
 if "%target%" == "" set target=Default
+if "%verbostity%" == "" set verbostity=Minimal
 
 cd build\apps\build
 
-dotnet run --target %target%
+dotnet run --target %target% --verbostity %verbostity%

libs/SailthruSDK/Purchase/SailthruPurchaseExtensions.cs

@@ -13,11 +13,12 @@ public static async Task<SailthruResponse> UpsertPurchaseAsync(
 			string email,
 			PurchaseItem[] items,
 			bool incomplete = false,
+			string? messageId = default,
 			CancellationToken cancellationToken = default)
 		{
 			Ensure.IsNotNull(client, nameof(client));
 
-			var model = new UpsertPurchaseRequest(email, items, incomplete);
+			var model = new UpsertPurchaseRequest(email, items, incomplete, messageId);
 			var request = new SailthruRequest<UpsertPurchaseRequest>(
 				HttpMethod.Post,
 				SailthruEndpoints.Purchase,

libs/SailthruSDK/Purchase/UpsertPurchaseRequest.cs

@@ -16,14 +16,17 @@ public class UpsertPurchaseRequest
 		/// <param name="email">The user email address</param>
 		/// <param name="items">The set of items.</param>
 		/// <param name="incomplete">Specifies whether the purchase is incomplete (e.g. an active cart, not an order)</param>
+		/// <param name="messageId">The message ID representing the email campaign. This is usually stored in the sailthru_bid cookie.</param>
 		public UpsertPurchaseRequest(
 			string email,
 			PurchaseItem[] items,
-			bool incomplete = false)
+			bool incomplete = false,
+			string? messageId = default)
 		{
 			Email = Ensure.IsNotNullOrEmpty(email, nameof(email));
 			Items = Ensure.IsNotNull(items, nameof(items));
 			Incomplete = incomplete;
+			MessageId = messageId;
 		}
 
 		/// <summary>
@@ -41,6 +44,11 @@ public UpsertPurchaseRequest(
 		/// </summary>
 		public PurchaseItem[] Items { get; }
 
+		/// <summary>
+		/// Gets the message campaign ID. This is usually stored in the sailthru_bid cookie.
+		/// </summary>
+		public string? MessageId { get; }
+
 		internal class Convereter : ConverterBase<UpsertPurchaseRequest>
 		{
 			/// <inhertdoc />
@@ -62,6 +70,7 @@ public override void Write(Utf8JsonWriter writer, UpsertPurchaseRequest value, J
 
 					writer.WriteStringProperty("email", value.Email, options);
 					writer.WriteBooleanProperty("incomplete", value.Incomplete, options);
+					writer.WriteStringProperty("message_id", value.MessageId ?? "", options);
 
 					writer.WritePropertyName("items");
 					writer.WriteStartArray();

samples/SailthruSDK.Samples.Console/Program.cs

@@ -36,34 +36,24 @@ static async Task Main()
 			//);
 
 			//var user = await client.UpsertUserAsync(
-			//	"[email protected]",
-			//	optOutEmailStatus: OptOutStatus.All,
+			//	"[email protected]",
 			//	keys: new Map<string>
 			//	{
 			//		[SailthruUserKeyType.Email] = "[email protected]"
 			//	},
 			//	keyConflict: KeyConflict.Merge,
-			//	fields: new SailthruUserFields
+			//	cookies: new Map<string>
 			//	{
-			//		Activity = true,
-			//		Engagement = true,
-			//		Device = true,
-			//		Keys = true,
-			//		Lists = true,
-			//		Lifetime = true,
-			//		OptOutStatus = true,
-			//		PurchaseIncomplete = 10,
-			//		Purchases = 10,
-			//		SmartLists = true,
-			//		Vars = true
+			//		["sailthru_bid"] = "28309054.31001"
 			//	});
 
 			var response = await client.UpsertPurchaseAsync(
-				"me+spaseekers@matthewabbott.dev",
+				"me+sailthru@matthewabbott.dev",
 				new[] {
 					new PurchaseItem("MonetaryVoucher-50", "£50.00 - Voucher", 5000, 1, "https://www.spaseekers.com/spa-vouchers?value=50.00")
 				},
-				incomplete: false
+				incomplete: false,
+				messageId: "28309054.31001"
 				);
 		}