fix: Improves subscription status handling

Improves the handling of subscription statuses by introducing a dedicated enum and mapping logic.

This change decouples the status property from the underlying string representation and provides a more robust and maintainable way to represent and process subscription states, including handling cases where the status might not directly map to a known enum value.

Author: Antaris

libs/HyperGuestSDK/Api/Pdm/Subscriptions/Subscription.cs

@@ -82,16 +82,39 @@ public SubscriptionStatus Status
 public class SubscriptionSummary
 {
 	/// <summary>
-	/// Gets or sets the status of the subscription.
+	/// Gets or sets the status.
 	/// </summary>
 	[JsonPropertyName("status")]
-	public SubscriptionStatus Status { get; set; }
+	public string? StatusValue { get; set; }
 
 	/// <summary>
 	/// Gets or sets the subscription ID.
 	/// </summary>
 	[JsonPropertyName("subscriptionId")]
 	public required string SubscriptionId { get; set; }
+
+	#region Presentational
+	/// <summary>
+	/// Gets the status as a <see cref="SubscriptionStatus"/> enum value.
+	/// </summary>
+	public SubscriptionStatus Status
+	{
+		get
+		{
+			if (Enum.TryParse<SubscriptionStatus>(StatusValue, true, out var status))
+			{
+				return status;
+			}
+
+			if (string.Equals("already exists", StatusValue, StringComparison.OrdinalIgnoreCase))
+			{
+				return SubscriptionStatus.Duplicate;
+			}
+
+			return SubscriptionStatus.Unknown;
+		}
+	}
+	#endregion
 }
 
 /// <summary>

libs/HyperGuestSDK/Api/Pdm/Subscriptions/SubscriptionOperations.cs

@@ -136,7 +136,7 @@ public async Task<HyperGuestResponse<Subscription>> GetSubscriptionAsync(string
 		var request = new HyperGuestRequest(
 			HyperGuestService.Pdm,
 			HttpMethod.Get,
-			path + $"/{subscriptionId}/getSubscription");
+			path + $"/{subscriptionId}/getSubscriptionDetails");
 
 		return await client.FetchAsync<Subscription>(request, cancellationToken)
 			.ConfigureAwait(false);