Merge pull request #50 from PandaTechAM/development

Logging enhancement, RegexBox merge + nuget updates

Author: HaikAsatryan

Readme.md

@@ -26,6 +26,7 @@ This package currently supports:
 - **SignalR Extensions** for adding simple SignalR or distributed SignalR backed with Redis.
 - **OpenTelemetry**: Metrics, traces, and logs with Prometheus support.
 - **Health Checks**: Startup validation and endpoints for monitoring.
+- **ValidationHelper**: A collection of regex-based validators for common data formats.
 - Various **Extensions and Utilities**, including enumerable, string, dictionary and queryable extensions.
 
 ## Prerequisites
@@ -315,11 +316,12 @@ builder.AddSerilog(
 );
 ```
 
->- **Asynchronous Sinks (asyncSinks: true):** Recommended for very high-traffic environments (e.g., 1000+ requests per
-  second per pod) where performance is critical and the possibility of losing a small amount of log data (e.g., on
-  sudden process termination) is acceptable. <br><br>
->- **Synchronous Sinks (asyncSinks: false):** Recommended if you can handle up to ~1000 requests per second per pod and must
-  retain every log entry without fail. This might incur slightly more overhead but ensures maximum reliability.
+> - **Asynchronous Sinks (asyncSinks: true):** Recommended for very high-traffic environments (e.g., 1000+ requests per
+    second per pod) where performance is critical and the possibility of losing a small amount of log data (e.g., on
+    sudden process termination) is acceptable. <br><br>
+>- **Synchronous Sinks (asyncSinks: false):** Recommended if you can handle up to ~1000 requests per second per pod and
+   must
+   retain every log entry without fail. This might incur slightly more overhead but ensures maximum reliability.
 
 Configure minimal Serilog settings in your environment JSON files as needed, for example in
 `appsettings.{Environment}.json`:
@@ -651,6 +653,68 @@ app.MapHealthCheckEndpoints(); // Map health check routes
 app.Run();
 ```
 
+## ValidationHelper
+
+The `ValidationHelper` class is a highly performant and robust C# class designed to simplify complex regex validations
+for
+various data formats. With 100% test coverage and a focus on security through a 50ms regex execution timeout, it's an
+ideal solution for applications requiring reliable and efficient data validation.
+
+```csharp
+using Pandatech.RegexBox;
+
+// URI validation
+bool isValidUri = ValidationHelper.IsUri("http://example.com", allowNonSecure: false);
+
+// US Social Security Number validation
+bool isValidSsnUs = ValidationHelper.IsUsSocialSecurityNumber("123-45-6789");
+
+// Email validation
+bool isValidEmail = ValidationHelper.IsEmail("[email protected]");
+
+// Username validation
+bool isValidUsername = ValidationHelper.IsUsername("user123");
+
+// Armenian Social Security Number validation
+bool isValidSsnAm = ValidationHelper.IsArmeniaSocialSecurityNumber("12345678912");
+
+//ArmenianIDCard validation
+bool isValidArmenianIdCard = ValidationHelper.IsArmeniaIdCard("AN1234567");
+
+// Armenian Passport validation
+bool isValidArmenianPassport = ValidationHelper.IsArmeniaPassport("AN1234567");
+
+// Armenian Tax code validation
+bool isValidArmenianTaxCode = ValidationHelper.IsArmeniaTaxCode("12345678");
+
+// Panda Formatted Phone Number validation
+bool isValidPhoneNumber = ValidationHelper.IsPandaFormattedPhoneNumber("(374)94810553");
+
+// Armenian State Registration Number validation
+bool isValidArmenianStateRegistrationNumber = ValidationHelper.IsArmeniaStateRegistryNumber("123.456.78");
+
+// Panda formatted phone number validation
+
+bool isValidPandaFormattedPhoneNumber = ValidationHelper.IsPandaFormattedPhoneNumber("(374)94810553");
+
+// Guid validation
+bool isValidGuid = ValidationHelper.IsGuid("12345678-1234-1234-1234-123456789012");
+
+// IPv4 validation
+bool isValidIpv4 = ValidationHelper.IsIPv4("192.168.1.1");
+
+// IPv6 validation
+bool isValidIpv6 = ValidationHelper.IsIPv6("2001:0db8:85a3:0000:0000:8a2e:0370:7334");
+
+// Any IP validation
+bool isValidIp = ValidationHelper.IsIpAddress("192.168.1.1");
+
+// Json validation
+bool isValidJson = ValidationHelper.IsJson("{\"name\":\"John\", \"age\":30}");
+
+// and many more...
+```
+
 ## Additional Extensions and NuGet Packages
 
 This package includes various extensions and utilities to aid development:
@@ -671,7 +735,6 @@ This package includes various extensions and utilities to aid development:
 
 - **Pandatech.Crypto:** Provides cryptographic utilities.
 - **Pandatech.FluentMinimalApiMapper:** Simplifies mapping in minimal APIs.
-- **Pandatech.RegexBox:** A collection of useful regular expressions.
 - **Pandatech.ResponseCrafter:** A utility for crafting consistent API responses.
 - **Pandatech.DistributedCache:** A distributed cache provider for Redis.
 - **Pandatech.FileExporter:** A utility for exporting files.

SharedKernel.Demo/MessageHub.cs

@@ -0,0 +1,18 @@
+using Microsoft.AspNetCore.SignalR;
+using ResponseCrafter.ExceptionHandlers.SignalR;
+
+namespace SharedKernel.Demo;
+
+public class MessageHub : Hub
+{
+   public async Task SendMessage(SendMessageRequest message)
+   {
+      await Clients.All.SendAsync("ReceiveMessage", "Thanks for the message that I have received");
+   }
+}
+
+public class SendMessageRequest : IHubArgument
+{
+   public required string InvocationId { get; set; }
+   public required string Message { get; set; }
+}

Shared.Kernel.Demo/Program.cs SharedKernel.Demo/Program.csShared.Kernel.Demo/Program.cs renamed to SharedKernel.Demo/Program.cs

@@ -5,6 +5,7 @@
 using SharedKernel.Demo2;
 using ResponseCrafter.Enums;
 using ResponseCrafter.Extensions;
+using SharedKernel.Demo;
 using SharedKernel.Extensions;
 using SharedKernel.Helpers;
 using SharedKernel.Logging;
@@ -78,6 +79,8 @@
       return response;
    });
 
+app.MapHub<MessageHub>("/hub");
+
 app.LogStartSuccess();
 app.Run();
 

…rnel.Demo/Properties/launchSettings.json …rnel.Demo/Properties/launchSettings.jsonShared.Kernel.Demo/Properties/launchSettings.json renamed to SharedKernel.Demo/Properties/launchSettings.json Shared.Kernel.Demo/Properties/launchSettings.json renamed to SharedKernel.Demo/Properties/launchSettings.json

@@ -7,7 +7,7 @@
     </PropertyGroup>
 
     <ItemGroup>
-        <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.4" />
+        <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.5" />
     </ItemGroup>
 
     <ItemGroup>

…ed.Kernel.Demo/Shared.Kernel.Demo.csproj …aredKernel.Demo/SharedKernel.Demo.csprojShared.Kernel.Demo/Shared.Kernel.Demo.csproj renamed to SharedKernel.Demo/SharedKernel.Demo.csproj Shared.Kernel.Demo/Shared.Kernel.Demo.csproj renamed to SharedKernel.Demo/SharedKernel.Demo.csproj

@@ -17,7 +17,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 		.editorconfig = .editorconfig
 	EndProjectSection
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Shared.Kernel.Demo", "Shared.Kernel.Demo\Shared.Kernel.Demo.csproj", "{1CD76A30-4A74-4F54-AC0C-AEDD92408553}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SharedKernel.Demo", "SharedKernel.Demo\SharedKernel.Demo.csproj", "{1CD76A30-4A74-4F54-AC0C-AEDD92408553}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution

…Kernel.Demo/appsettings.Development.json …Kernel.Demo/appsettings.Development.jsonShared.Kernel.Demo/appsettings.Development.json renamed to SharedKernel.Demo/appsettings.Development.json Shared.Kernel.Demo/appsettings.Development.json renamed to SharedKernel.Demo/appsettings.Development.json

@@ -1,7 +1,7 @@
 using Microsoft.AspNetCore.Builder;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Hosting;
-using RegexBox;
+using SharedKernel.Helpers;
 
 namespace SharedKernel.Extensions;
 
@@ -56,7 +56,7 @@ private static string[] SplitOrigins(this string input)
          result[i] = result[i]
             .Trim();
 
-         if (PandaValidator.IsUri(result[i], false))
+         if (ValidationHelper.IsUri(result[i], false))
          {
             continue;
          }

Shared.Kernel.Demo/appsettings.json SharedKernel.Demo/appsettings.jsonShared.Kernel.Demo/appsettings.json renamed to SharedKernel.Demo/appsettings.json

@@ -2,6 +2,8 @@
 using Microsoft.AspNetCore.SignalR;
 using Microsoft.Extensions.DependencyInjection;
 using ResponseCrafter.ExceptionHandlers.SignalR;
+using Serilog;
+using Serilog.Events;
 using SharedKernel.Logging;
 using StackExchange.Redis;
 
@@ -35,8 +37,12 @@ private static ISignalRServerBuilder AddSignalRWithFiltersAndMessagePack(this We
       return builder.Services
                     .AddSignalR(o =>
                     {
+                       if (Log.Logger.IsEnabled(LogEventLevel.Information))
+                       {
+                          o.AddFilter<SignalRLoggingHubFilter>();
+                       }
+
                        o.AddFilter<SignalRExceptionFilter>();
-                       o.AddFilter<SignalRLoggingHubFilter>();
                     })
                     .AddMessagePackProtocol();
    }