Merge branch 'main' of https://dev.azure.com/bitdevelopment/bIT.bITdevKit/_git/bIT.bITdevKit

Author: vp

docs/features-pipelines.md

@@ -189,7 +189,7 @@ flowchart TD
     A[Developer] --> B{How to define pipeline?}
     B -->|Reusable feature workflow| C[PipelineDefinition<TContext>]
     B -->|Programmatic definition| D[PipelineDefinitionBuilder<TContext>]
-    B -->|Small local workflow| E[services.AddPipelines().WithPipeline(...)]
+    B -->|Small local workflow| E[services.AddPipelines.WithPipeline]
 
     C --> F[Register packaged pipeline]
     D --> G[Build IPipelineDefinition]

docs/features-storage-files.md

@@ -10,6 +10,12 @@ Managing file storage presents challenges due to inconsistent APIs across storag
 
 The `FileStorage` feature addresses these through the `IFileStorageProvider` interface for abstracting file operations, a fluent DI setup with `AddFileStorage`, and the `Result` pattern for error handling and messaging. It supports progress reporting via `IProgress<FileProgress>` and metadata management with `FileMetadata`. The feature is designed to be extensible, allowing developers to implement custom providers or extend functionality with behaviors. Additionally, it supports notifications for real-time monitoring (used by `FileMonitoring`) through the `SupportsNotifications` property. Besides the existing `WriteFileAsync` push model, the abstraction also supports `OpenWriteFileAsync` for scenarios where callers want to stream bytes directly into the destination.
 
+Available providers included:
+- Local Files (e.g., `C:\data\file.txt` or `/var/data/file.txt`)
+- Network Shares (e.g., Windows UNC paths)
+- Azure Files 
+- Azure Blob Storage 
+
 ### Architecture
 
 The `FileStorage` subsystem is built around the `IFileStorageProvider` interface, which defines core file operations. Providers like `LocalFileStorageProvider`, `InMemoryFileStorageProvider`, and others implement this interface. The `IFileStorageFactory` resolves providers by name, and extensions like `FileStorageProviderCompressionExtensions` and `FileStorageProviderCrossExtensions` add advanced functionality such as compression and cross-provider operations. Behaviors can be applied to providers to add cross-cutting concerns like logging or retry logic.

src/Common.Utilities/Validation/ValidationCodeGenAttributes.cs

@@ -10,43 +10,32 @@ namespace BridgingIT.DevKit.Common;
 /// <summary>
 /// Provides the optional error message shared by source-generated validation attributes.
 /// </summary>
-public abstract class ValidationCodeGenAttribute : Attribute
+/// <remarks>
+/// Initializes a new instance of the <see cref="ValidationCodeGenAttribute"/> class.
+/// </remarks>
+/// <param name="message">The optional custom validation message.</param>
+public abstract class ValidationCodeGenAttribute(string message = null) : Attribute
 {
-    /// <summary>
-    /// Initializes a new instance of the <see cref="ValidationCodeGenAttribute"/> class.
-    /// </summary>
-    /// <param name="message">The optional custom validation message.</param>
-    protected ValidationCodeGenAttribute(string message = null)
-    {
-        this.Message = message;
-    }
-
     /// <summary>
     /// Gets the optional custom validation message.
     /// </summary>
-    public string Message { get; }
+    public string Message { get; } = message;
 }
 
 /// <summary>
 /// Provides a shared string-backed comparison value for source-generated validation attributes.
 /// </summary>
-public abstract class SingleValueValidationCodeGenAttribute : ValidationCodeGenAttribute
+/// <remarks>
+/// Initializes a new instance of the <see cref="SingleValueValidationCodeGenAttribute"/> class.
+/// </remarks>
+/// <param name="value">The invariant string comparison value.</param>
+/// <param name="message">The optional custom validation message.</param>
+public abstract class SingleValueValidationCodeGenAttribute(string value, string message = null) : ValidationCodeGenAttribute(message)
 {
-    /// <summary>
-    /// Initializes a new instance of the <see cref="SingleValueValidationCodeGenAttribute"/> class.
-    /// </summary>
-    /// <param name="value">The invariant string comparison value.</param>
-    /// <param name="message">The optional custom validation message.</param>
-    protected SingleValueValidationCodeGenAttribute(string value, string message = null)
-        : base(message)
-    {
-        this.Value = value;
-    }
-
     /// <summary>
     /// Gets the invariant string comparison value.
     /// </summary>
-    public string Value { get; }
+    public string Value { get; } = value;
 
     /// <summary>
     /// Formats a numeric attribute argument using invariant culture.
@@ -183,21 +172,15 @@ public sealed class ValidateMinLengthAttribute : ValidationCodeGenAttribute
     /// Initializes a new instance of the <see cref="ValidateMinLengthAttribute"/> class.
     /// </summary>
     /// <param name="length">The inclusive minimum length.</param>
-    public ValidateMinLengthAttribute(int length)
-    {
-        this.Length = length;
-    }
+    public ValidateMinLengthAttribute(int length) => this.Length = length;
 
     /// <summary>
     /// Initializes a new instance of the <see cref="ValidateMinLengthAttribute"/> class.
     /// </summary>
     /// <param name="length">The inclusive minimum length.</param>
     /// <param name="message">The optional custom validation message.</param>
     public ValidateMinLengthAttribute(int length, string message)
-        : base(message)
-    {
-        this.Length = length;
-    }
+        : base(message) => this.Length = length;
 
     /// <summary>
     /// Gets the inclusive minimum length.
@@ -215,21 +198,15 @@ public sealed class ValidateMaxLengthAttribute : ValidationCodeGenAttribute
     /// Initializes a new instance of the <see cref="ValidateMaxLengthAttribute"/> class.
     /// </summary>
     /// <param name="length">The inclusive maximum length.</param>
-    public ValidateMaxLengthAttribute(int length)
-    {
-        this.Length = length;
-    }
+    public ValidateMaxLengthAttribute(int length) => this.Length = length;
 
     /// <summary>
     /// Initializes a new instance of the <see cref="ValidateMaxLengthAttribute"/> class.
     /// </summary>
     /// <param name="length">The inclusive maximum length.</param>
     /// <param name="message">The optional custom validation message.</param>
     public ValidateMaxLengthAttribute(int length, string message)
-        : base(message)
-    {
-        this.Length = length;
-    }
+        : base(message) => this.Length = length;
 
     /// <summary>
     /// Gets the inclusive maximum length.
@@ -587,16 +564,10 @@ public ValidateEmailAttribute(string message) : base(message) { }
 [AttributeUsage(AttributeTargets.Property, Inherited = false, AllowMultiple = false)]
 public sealed class ValidateMatchesAttribute : ValidationCodeGenAttribute
 {
-    public ValidateMatchesAttribute(string pattern)
-    {
-        this.Pattern = pattern;
-    }
+    public ValidateMatchesAttribute(string pattern) => this.Pattern = pattern;
 
     public ValidateMatchesAttribute(string pattern, string message)
-        : base(message)
-    {
-        this.Pattern = pattern;
-    }
+        : base(message) => this.Pattern = pattern;
 
     /// <summary>
     /// Gets the regex pattern.

src/Domain/Model/AggregateRootId.cs

@@ -7,7 +7,6 @@ namespace BridgingIT.DevKit.Domain.Model;
 
 using System.Diagnostics;
 
-
 [DebuggerDisplay("{Value}")]
 public abstract class AggregateRootId<TId> : EntityId<TId> // TODO: this is obsolete with the new codegen TypedIds, remove in future (DinnerFiesta depends on it for now)
 {