// Copyright (c) Microsoft Corporation.
// Licensed under the MIT License.

using System.Text.Json.Serialization;

namespace Microsoft.Teams.Apps.Schema.Entities;


/// <summary>
/// Extension methods for Activity to handle client info.
/// </summary>
public static class ActivityClientInfoExtensions
{
    /// <summary>
    /// Adds client information to the activity's entity collection.
    /// </summary>
    /// <param name="activity">The activity to add client information to. Cannot be null.</param>
    /// <param name="platform">The platform identifier (e.g., "web", "desktop", "mobile").</param>
    /// <param name="country">The country code (e.g., "US", "GB").</param>
    /// <param name="timeZone">The time zone identifier (e.g., "America/New_York").</param>
    /// <param name="locale">The locale identifier (e.g., "en-US", "fr-FR").</param>
    /// <returns>The created ClientInfoEntity that was added to the activity.</returns>
    public static ClientInfoEntity AddClientInfo(this TeamsActivity activity, string platform, string country, string timeZone, string locale)
    {
        ArgumentNullException.ThrowIfNull(activity);

        ClientInfoEntity clientInfo = new(platform, country, timeZone, locale);
        activity.Entities ??= [];
        activity.Entities.Add(clientInfo);
        return clientInfo;
    }

    /// <summary>
    /// Retrieves the client information entity from the activity's entity collection.
    /// </summary>
    /// <param name="activity">The activity to extract client information from. Cannot be null.</param>
    /// <returns>The ClientInfoEntity if found in the activity's entities; otherwise, null.</returns>
    public static ClientInfoEntity? GetClientInfo(this TeamsActivity activity)
    {
        ArgumentNullException.ThrowIfNull(activity);
        if (activity.Entities == null)
        {
            return null;
        }
        ClientInfoEntity? clientInfo = activity.Entities.FirstOrDefault(e => e is ClientInfoEntity) as ClientInfoEntity;

        return clientInfo;
    }
}

/// <summary>
/// Client info entity.
/// </summary>
public class ClientInfoEntity : Entity
{
    /// <summary>
    /// Creates a new instance of <see cref="ClientInfoEntity"/>.
    /// </summary>
    public ClientInfoEntity() : base("clientInfo")
    {
    }


    /// <summary>
    /// Initializes a new instance of the <see cref="ClientInfoEntity"/> class with specified client information.
    /// </summary>
    /// <param name="platform">The platform identifier (e.g., "web", "desktop", "mobile").</param>
    /// <param name="country">The country code (e.g., "US", "GB").</param>
    /// <param name="timezone">The time zone identifier (e.g., "America/New_York").</param>
    /// <param name="locale">The locale identifier (e.g., "en-US", "fr-FR").</param>
    public ClientInfoEntity(string platform, string country, string timezone, string locale) : base("clientInfo")
    {
        Locale = locale;
        Country = country;
        Platform = platform;
        Timezone = timezone;
    }

    /// <summary>
    /// Gets or sets the locale information.
    /// </summary>
    [JsonPropertyName("locale")]
    public string? Locale
    {
        get => base.Properties.TryGetValue("locale", out object? value) ? value?.ToString() : null;
        set => base.Properties["locale"] = value;
    }

    /// <summary>
    /// Gets or sets the country information.
    /// </summary>
    [JsonPropertyName("country")]
    public string? Country
    {
        get => base.Properties.TryGetValue("country", out object? value) ? value?.ToString() : null;
        set => base.Properties["country"] = value;
    }

    /// <summary>
    /// Gets or sets the platform information.
    /// </summary>
    [JsonPropertyName("platform")]
    public string? Platform
    {
        get => base.Properties.TryGetValue("platform", out object? value) ? value?.ToString() : null;
        set => base.Properties["platform"] = value;
    }

    /// <summary>
    /// Gets or sets the timezone information.
    /// </summary>
    [JsonPropertyName("timezone")]
    public string? Timezone
    {
        get => base.Properties.TryGetValue("timezone", out object? value) ? value?.ToString() : null;
        set => base.Properties["timezone"] = value;
    }
}
