shared translations refatored / component core refactored

Author: drma-tech

SD.API/Core/ZeptoMailClient.cs

@@ -185,13 +185,13 @@ public async Task SendOtpEmail(string toEmail, string reference, string? otp, Ca
                                 <h2 class=""email-title"">
                                     Verification Code
                                 </h2>
-                               
+
                                 <p>Use the code below to confirm your {appName} account.</p>
                                 <div style=""text-align:center"">
                                     <div class=""otp"">{otp}</div>
                                 </div>
                                 <p>This code expires in <span style=""color: #ff4081; font-weight: bold;"">10 minutes</span>.</p>
-                                                             
+
                                 <hr class=""email-divider"">
                                 <div class=""email-support"">
                                     Questions? Contact

SD.API/Functions/ExternalFunction.cs

@@ -22,14 +22,18 @@ public async Task<HttpResponseData> External(
     }
 
     [Function("Country")]
-    public async Task<string?> Country([HttpTrigger(AuthorizationLevel.Anonymous, Method.Get, Route = "public/country")] HttpRequestData req, CancellationToken cancellationToken)
+    public async Task<HttpResponseData> Country([HttpTrigger(AuthorizationLevel.Anonymous, Method.Get, Route = "public/country")] HttpRequestData req, CancellationToken cancellationToken)
     {
         var ip = req.GetUserIP(false);
-        if (ip.Empty()) return null;
-        if (ip == "127.0.0.1") return null;
 
         var client = factory.CreateClient("ipinfo");
 
-        return await client.GetStringAsync($"https://ipinfo.io/{ip}/country", cancellationToken);
+        if (ip.NotEmpty() && ip != "127.0.0.1")
+        {
+            var result = await client.GetStringAsync($"https://ipinfo.io/{ip}/country", cancellationToken);
+            return await req.CreateResponse(result, TtlCache.OneMinute, cancellationToken);
+        }
+
+        return await req.CreateResponse(null, TtlCache.OneMinute, cancellationToken);
     }
 }

SD.Shared/Core/CosmosDocument.cs

@@ -25,6 +25,7 @@ protected CosmosDocument(string id)
     [JsonProperty(PropertyName = "_tsCreated")]
     public long? TimestampCreated { get; set; } = DateTimeOffset.UtcNow.ToUnixTimeSeconds();
 
+    [System.Text.Json.Serialization.JsonPropertyName("_ts")]
     [JsonProperty(PropertyName = "_ts")]
     public long TimestampUpdated { get; set; }
 
@@ -40,4 +41,4 @@ public void SetIds(string id)
 
         Id = id;
     }
-}
+}

SD.Shared/Core/EnumLists.cs

@@ -2,15 +2,15 @@
 
 public enum EnumLists
 {
-    [Custom(Name = "ExpectedMovieOfYear", Description = "Discover the most anticipated movies of 2026, featuring upcoming blockbusters, fan favorites, and highly awaited releases hitting theaters and streaming.", ResourceType = typeof(Resources.Translations))]
+    [FieldSettings("ExpectedMovieOfYear", Description = "Discover the most anticipated movies of 2026, featuring upcoming blockbusters, fan favorites, and highly awaited releases hitting theaters and streaming.", ResourceType = typeof(Resources.Translations))]
     ExpectedMovieOf2026 = 8544544,
 
-    [Custom(Name = "AwardsOfTheYear", Description = "Explore films and series that won the year’s top awards. Discover main categories, winners, and celebrated titles recognized by critics and audiences.", ResourceType = typeof(Resources.Translations))]
+    [FieldSettings("AwardsOfTheYear", Description = "Explore films and series that won the year’s top awards. Discover main categories, winners, and celebrated titles recognized by critics and audiences.", ResourceType = typeof(Resources.Translations))]
     AwardsOfTheYear = 8498534,
 
-    [Custom(Name = "EditorsChoiceTitle", Description = "Discover our Editor’s Choice: films and series consistently rated highly across IMDb, TMDb, Metacritic, Rotten Tomatoes, Trakt, FilmAffinity, and Letterboxd.", ResourceType = typeof(Resources.Translations))]
+    [FieldSettings("EditorsChoiceTitle", Description = "Discover our Editor’s Choice: films and series consistently rated highly across IMDb, TMDb, Metacritic, Rotten Tomatoes, Trakt, FilmAffinity, and Letterboxd.", ResourceType = typeof(Resources.Translations))]
     CertifiedStreamingDiscoveryMovies = 8498673,
 
-    [Custom(Name = "EditorsChoiceTitle", Description = "Discover our Editor’s Choice: films and series consistently rated highly across IMDb, TMDb, Metacritic, Rotten Tomatoes, Trakt, FilmAffinity, and Letterboxd.", ResourceType = typeof(Resources.Translations))]
+    [FieldSettings("EditorsChoiceTitle", Description = "Discover our Editor’s Choice: films and series consistently rated highly across IMDb, TMDb, Metacritic, Rotten Tomatoes, Trakt, FilmAffinity, and Letterboxd.", ResourceType = typeof(Resources.Translations))]
     CertifiedStreamingDiscoveryShows = 8498675,
 }

SD.Shared/Core/Helper/AttributeHelper.cs

@@ -1,20 +1,100 @@
-using System.Globalization;
+using System.Collections.Concurrent;
+using System.ComponentModel.DataAnnotations;
+using System.Linq.Expressions;
+using System.Reflection;
+using System.Resources;
 
-namespace SD.Shared.Core.Helper;
-
-public static class AttributeHelper
+namespace SD.Shared.Core.Helper
 {
-    public static DateTime? GetDate(this string? value)
+    public class ClassFieldObject(string name)
+    {
+        public string Name { get; set; } = name;
+        public string? Group { get; set; }
+        public string? Placeholder { get; set; }
+        public string? Description { get; set; }
+    }
+
+    public sealed class EnumFieldObject<T>(string name, T value) : ClassFieldObject(name) where T : Enum
     {
-        if (!string.IsNullOrEmpty(value) && DateTime.TryParse(value, out _))
-            return DateTime.Parse(value, CultureInfo.CurrentCulture);
-        return null;
+        public T Value { get; set; } = value;
     }
 
-    public static string FormatRuntime(this int? runtime)
+    public static class AttributeHelper
     {
-        if (!runtime.HasValue || runtime == 0) return "";
-        var time = TimeSpan.FromMinutes(runtime.Value);
-        return $"{time.Hours}h {time.Minutes}m";
+        private static readonly ConcurrentDictionary<MemberInfo, FieldSettingsAttribute> AttributeCache = new();
+        private static readonly ConcurrentDictionary<Type, ResourceManager> ResourceManagers = new();
+
+        private const string IncompleteTranslationSuffix = " (incomplete translation)";
+
+        public static EnumFieldObject<T> GetFieldSettings<T>(this T value, bool translate = true) where T : Enum
+        {
+            var fieldInfo = value.GetType().GetField(value.ToString()) ?? throw new UnhandledException($"{value} field info is null");
+
+            return fieldInfo.GetFieldSettings(value, translate);
+        }
+
+        public static ClassFieldObject GetFieldSettings<T>(this Expression<Func<T>>? expression, bool translate = true)
+        {
+            if (expression == null) throw new UnhandledException($"{expression} expression is null");
+
+            MemberExpression member = expression.Body switch
+            {
+                MemberExpression m => m,
+                UnaryExpression { Operand: MemberExpression m } => m,
+                _ => throw new ArgumentException("Expression must reference a member.", nameof(expression))
+            };
+
+            return member.Member.GetFieldSettings(translate);
+        }
+
+        private static EnumFieldObject<T> GetFieldSettings<T>(this MemberInfo mi, T value, bool translate = true) where T : Enum
+        {
+            var attr = AttributeCache.GetOrAdd(mi, x => x.GetCustomAttribute<FieldSettingsAttribute>() ?? throw new ValidationException($"Field Settings '{x.Name}' is null"));
+
+            var obj = new EnumFieldObject<T>(attr.Name, value)
+            {
+                Group = attr.Group,
+                Placeholder = attr.Placeholder,
+                Description = attr.Description,
+            };
+
+            ApplyTranslations(obj, attr, translate);
+
+            return obj;
+        }
+
+        private static ClassFieldObject GetFieldSettings(this MemberInfo mi, bool translate = true)
+        {
+            var attr = AttributeCache.GetOrAdd(mi, x => x.GetCustomAttribute<FieldSettingsAttribute>() ?? throw new ValidationException($"Field Settings '{x.Name}' is null"));
+
+            var obj = new ClassFieldObject(attr.Name)
+            {
+                Group = attr.Group,
+                Placeholder = attr.Placeholder,
+                Description = attr.Description,
+            };
+
+            ApplyTranslations(obj, attr, translate);
+
+            return obj;
+        }
+
+        private static void ApplyTranslations(ClassFieldObject obj, FieldSettingsAttribute attr, bool translate)
+        {
+            if (attr.ResourceType != null && translate)
+            {
+                var rm = ResourceManagers.GetOrAdd(attr.ResourceType, t => new ResourceManager(t.FullName!, t.Assembly));
+
+                obj.Name = rm.GetResourceString(attr.Name) ?? throw new InvalidOperationException($"Resource not found for key: {attr.Name}");
+                if (attr.Group.NotEmpty()) obj.Group = rm.GetResourceString(attr.Group);
+                if (attr.Placeholder.NotEmpty()) obj.Placeholder = rm.GetResourceString(attr.Placeholder)?.Replace(@"\n", Environment.NewLine);
+                if (attr.Description.NotEmpty()) obj.Description = rm.GetResourceString(attr.Description);
+            }
+        }
+
+        private static string GetResourceString(this ResourceManager rm, string resourceKey)
+        {
+            return rm.GetString(resourceKey) ?? resourceKey + IncompleteTranslationSuffix;
+        }
     }
 }

SD.Shared/Core/Helper/AttributeSettings.cs

@@ -0,0 +1,11 @@
+namespace SD.Shared.Core.Helper;
+
+[AttributeUsage(AttributeTargets.Field | AttributeTargets.Property)]
+public class FieldSettingsAttribute(string name) : Attribute
+{
+    public string Name { get; set; } = name;
+    public string? Group { get; set; }
+    public string? Placeholder { get; set; }
+    public string? Description { get; set; }
+    public Type? ResourceType { get; set; }
+}

SD.Shared/Core/Helper/ParameterHelper.cs SD.Shared/Core/Helper/ConversionHelper.csSD.Shared/Core/Helper/ParameterHelper.cs renamed to SD.Shared/Core/Helper/ConversionHelper.cs

@@ -3,7 +3,7 @@
 
 namespace SD.Shared.Core.Helper;
 
-public static class ParameterHelper
+public static class ConversionHelper
 {
     private static readonly JsonSerializerOptions IndentedOptions = new() { WriteIndented = true };
 
@@ -46,4 +46,31 @@ public static string ConvertFromBytesToBase64(this byte[] bytes)
     {
         return Convert.ToBase64String(bytes);
     }
-}
+
+    public static string ConvertFromStreamToBase64(this Stream stream)
+    {
+        if (stream.CanSeek) stream.Position = 0;
+
+        using var memoryStream = new MemoryStream();
+
+        stream.CopyTo(memoryStream);
+
+        return Convert.ToBase64String(memoryStream.ToArray());
+    }
+
+    public static async Task<string> ConvertFromStreamToBase64Async(this Stream stream)
+    {
+        if (stream.CanSeek) stream.Position = 0;
+
+        using var memoryStream = new MemoryStream();
+
+        await stream.CopyToAsync(memoryStream);
+
+        return Convert.ToBase64String(memoryStream.ToArray());
+    }
+
+    public static Stream ConvertFromBase64ToStream(this string base64)
+    {
+        return new MemoryStream(Convert.FromBase64String(base64));
+    }
+}

SD.Shared/Core/Helper/CustomAttribute.cs

@@ -2,50 +2,37 @@
 
 public static class EnumHelper
 {
-    public static TEnum[] GetArray<TEnum>() where TEnum : struct, Enum
+    public static T[] GetValues<T>() where T : struct, Enum
     {
-        return Enum.GetValues<TEnum>();
+        return Enum.GetValues<T>();
     }
 
-    public static List<EnumObject<TEnum>> GetList<TEnum>(bool translate = true) where TEnum : struct, Enum
+    public static List<EnumFieldObject<T>> GetList<T>(bool translate = true) where T : struct, Enum
     {
-        var result = new List<EnumObject<TEnum>>();
-        foreach (var val in GetArray<TEnum>())
-        {
-            var attr = val.GetCustomAttribute(translate);
+        var values = GetValues<T>();
+        var result = new List<EnumFieldObject<T>>(values.Length);
 
-            result.Add(new EnumObject<TEnum>(val, attr?.Name, attr?.Description, attr?.Group));
+        foreach (var val in values)
+        {
+            result.Add(val.GetFieldSettings(translate));
         }
+
         return result;
     }
 
-    public static TEnum ParseToEnum<TEnum>(this string? value) where TEnum : struct, Enum
+    public static T ParseToEnum<T>(this string? value, T? fallback = null) where T : struct, Enum
     {
-        if (Enum.TryParse<TEnum>(value, true, out var result) && Enum.IsDefined(result))
+        if (Enum.TryParse<T>(value, true, out var result) && Enum.IsDefined(result))
         {
             return result;
         }
-        else
+        else if (fallback.HasValue)
         {
-            throw new ArgumentException($"Invalid value for enum type {typeof(TEnum).Name}: {value}");
+            return fallback.Value;
         }
-    }
-
-    public static TEnum ParseToEnum<TEnum>(this string? value, TEnum fallback) where TEnum : struct, Enum
-    {
-        if (Enum.TryParse<TEnum>(value, true, out var result) && Enum.IsDefined(result))
+        else
         {
-            return result;
+            throw new ArgumentException($"Invalid value for enum type {typeof(T).Name}: {value}");
         }
-
-        return fallback;
     }
 }
-
-public class EnumObject<TEnum>(TEnum value, string? name, string? description, string? group) where TEnum : struct, Enum
-{
-    public TEnum Value { get; set; } = value;
-    public string? Name { get; set; } = name;
-    public string? Description { get; set; } = description;
-    public string? Group { get; set; } = group;
-}