=== Summary: 675 files | 7 generated | 484 fresh | 4605 untracked | 4268 adopted | 355 marked | 466 validated-ok | 2+0 stale (sig+body) | 0 skipped | 0 failed | elapsed 11:08:11.442 (40091.44s) ===

2026-06-28 02:50:05 -07:00
parent a19fb90902
commit 586f02a2ca
654 changed files with 5260 additions and 0 deletions
@@ -4,4 +4,5 @@
 /// Represents errors that occur during API request processing, wrapping a descriptive message.
 /// </summary>
 /// <param name="message">The message that describes the error.</param>
+/// <!-- aidoc:v1 sig=fff099b -->
 public class ApiRequestException(string message) : Exception($"Api request exception: {message}");
@@ -6,12 +6,14 @@ namespace adas_core.Application.Exceptions;
 /// Represents an exception that is thrown when a bad or invalid request is received.
 /// It serves as a specialized error type derived from the base <see cref="Exception"/> class for signaling client-side request failures.
 /// </summary>
+/// <!-- aidoc:v1 sig=aec5b9f -->
 public class BadRequestException : Exception
 {
    /// <summary>
    /// Initializes a new instance of the <see cref="BadRequestException"/> class with a specified error message.
    /// </summary>
    /// <param name="message">The error message defined in <see cref="HttpEnum.ErrorMessage"/> that describes the reason for the exception.</param>
+    /// <!-- aidoc:v1 sig=2324fae body=4448e1d -->
    public BadRequestException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
    {
    }
@@ -20,6 +22,7 @@ public class BadRequestException : Exception
    /// Initializes a new instance of the <see cref="BadRequestException"/> class with a specified error message.
    /// </summary>
    /// <param name="message">The error message that describes the reason for the exception.</param>
+    /// <!-- aidoc:v1 sig=3d6c688 body=4448e1d -->
    public BadRequestException(string message) : base(message)
    {
    }
@@ -5,12 +5,14 @@ namespace adas_core.Application.Exceptions;
 /// <summary>
 /// Represents an exception that is thrown when a conflict is encountered, such as a resource state mismatch or a duplicate entry.
 /// </summary>
+/// <!-- aidoc:v1 sig=5cdb505 -->
 public class ConflictException : Exception
 {
    /// <summary>
    /// Initializes a new instance of the <see cref="ConflictException"/> class with a specified error message.
    /// </summary>
    /// <param name="message">The error message that describes the conflict.</param>
+    /// <!-- aidoc:v1 sig=d19960d body=4448e1d -->
    public ConflictException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
    {
    }
@@ -19,6 +21,7 @@ public class ConflictException : Exception
    /// Initializes a new instance of the <see cref="ConflictException"/> class with a specified error message.
    /// </summary>
    /// <param name="message">The message that describes the error.</param>
+    /// <!-- aidoc:v1 sig=6025bd5 body=4448e1d -->
    public ConflictException(string message) : base(message)
    {
    }
@@ -8,12 +8,14 @@ namespace adas_core.Application.Exceptions;
 /// <remarks>
 /// This exception extends the base <see cref="Exception"/> class to provide a domain-specific error type for argument validation failures.
 /// </remarks>
+/// <!-- aidoc:v1 sig=434a4a5 -->
 public class CustomArgumentException : Exception
 {
    /// <summary>
    /// Initializes a new instance of the <see cref="CustomArgumentException"/> class with the specified error message.
    /// </summary>
    /// <param name="message">The error message from the <see cref="HttpEnum.ErrorMessage"/> enumeration.</param>
+    /// <!-- aidoc:v1 sig=9c6bb9a body=4448e1d -->
    public CustomArgumentException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
    {
    }
@@ -22,6 +24,7 @@ public class CustomArgumentException : Exception
    /// Initializes a new instance of the <see cref="CustomArgumentException"/> class with a specified error message.
    /// </summary>
    /// <param name="message">The error message that describes the reason for the exception.</param>
+    /// <!-- aidoc:v1 sig=cee336d body=4448e1d -->
    public CustomArgumentException(string message) : base(message)
    {
    }
@@ -8,12 +8,14 @@ namespace adas_core.Application.Exceptions;
 /// <remarks>
 /// This exception is intended to signal that a requested action violates access rules or restrictions, allowing callers to handle forbidden scenarios distinctly from other error conditions.
 /// </remarks>
+/// <!-- aidoc:v1 sig=2024892 -->
 public class ForbbidenException : Exception
 {
    /// <summary>
    /// Initializes a new instance of the <see cref="ForbbidenException"/> class with a specified error message from the <see cref="HttpEnum.ErrorMessage"/> enumeration.
    /// </summary>
    /// <param name="message">The <see cref="HttpEnum.ErrorMessage"/> enumeration value whose integer representation is used as the exception message.</param>
+    /// <!-- aidoc:v1 sig=75787d6 body=4448e1d -->
    public ForbbidenException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
    {
    }
@@ -22,6 +24,7 @@ public class ForbbidenException : Exception
    /// Initializes a new instance of the <see cref="ForbbidenException"/> class with a specified error message.
    /// </summary>
    /// <param name="message">The message that describes the error.</param>
+    /// <!-- aidoc:v1 sig=545f359 body=4448e1d -->
    public ForbbidenException(string message) : base(message)
    {
    }
@@ -5,12 +5,15 @@ namespace adas_core.Application.Exceptions;
 /// <summary>
 /// Represents the exception that is thrown when data is encountered in a format that is not valid or expected.
 /// </summary>
+/// <!-- aidoc:v1 sig=e46b8ff -->
 public class InvalidFormatException : Exception
 {
    /// <summary>
    /// Initializes a new instance of the <see cref="InvalidFormatException"/> class with a specified error message.
    /// </summary>
    /// <param name="message">The error message that describes the reason for the exception.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "The parameter is of type HttpEnum.ErrorMessage (an enum), not an error message string. It is documented as 'The error message that describes the reason for the exception', which mischaracterizes its role." -->
    public InvalidFormatException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
    {
    }
@@ -19,6 +22,7 @@ public class InvalidFormatException : Exception
    /// Initializes a new instance of the <see cref="InvalidFormatException"/> class with a specified error message.
    /// </summary>
    /// <param name="message">The error message that describes the reason for the exception.</param>
+    /// <!-- aidoc:v1 sig=8a27f52 body=4448e1d -->
    public InvalidFormatException(string message) : base(message)
    {
    }
@@ -5,11 +5,13 @@ namespace adas_core.Application.Exceptions;
 /// <summary>
 /// Represents an exception that is thrown when a requested resource or item cannot be found.
 /// </summary>
+/// <!-- aidoc:v1 sig=f498fe7 -->
 public class NotFoundException : Exception
 {
    /// <summary>
    /// Initializes a new instance of the <see cref="NotFoundException"/> class.
    /// </summary>
+    /// <!-- aidoc:v1 sig=b8adfe9 body=4448e1d -->
    public NotFoundException()
    {
    }
@@ -18,6 +20,7 @@ public class NotFoundException : Exception
    /// Initializes a new instance of the <see cref="NotFoundException"/> class with a specified error message.
    /// </summary>
    /// <param name="message">The message that describes the error.</param>
+    /// <!-- aidoc:v1 sig=0fdd1b4 body=4448e1d -->
    public NotFoundException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
    {
    }
@@ -26,6 +29,7 @@ public class NotFoundException : Exception
    /// Initializes a new instance of the <see cref="NotFoundException"/> class with a specified error message.
    /// </summary>
    /// <param name="message">The message that describes the error.</param>
+    /// <!-- aidoc:v1 sig=63e1946 body=4448e1d -->
    public NotFoundException(string message) : base(message)
    {
    }    
@@ -4,4 +4,5 @@
 /// Represents an exception that is thrown when a token-related error occurs.
 /// </summary>
 /// <param name="message">The message that describes the error.</param>
+/// <!-- aidoc:v1 sig=d6b0f80 -->
 public class TokenException(string message) : Exception(message);
@@ -5,12 +5,14 @@ namespace adas_core.Application.Exceptions;
 /// <summary>
 /// Exception thrown when a user lacks authorization to perform an operation.
 /// </summary>
+/// <!-- aidoc:v1 sig=c33e8e4 -->
 public class UnauthorizedException : Exception
 {
    /// <summary>
    /// Initializes a new instance of the <see cref="UnauthorizedException"/> class.
    /// </summary>
    /// <param name="message">The error message associated with the exception.</param>
+    /// <!-- aidoc:v1 sig=0488051 body=4448e1d -->
    public UnauthorizedException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
    {
    }
@@ -19,6 +21,7 @@ public class UnauthorizedException : Exception
    /// Initializes a new instance of the <see cref="UnauthorizedException"/> class.
    /// </summary>
    /// <param name="message">The message that describes the error.</param>
+    /// <!-- aidoc:v1 sig=f0581f2 body=4448e1d -->
    public UnauthorizedException(string message) : base(message)
    {
    }
@@ -8,12 +8,14 @@ namespace adas_core.Application.Exceptions;
 /// <remarks>
 /// This exception is typically used to signal that a request or entity was understood but could not be processed, similar to the semantics of an HTTP 422 (Unprocessable Entity) response.
 /// </remarks>
+/// <!-- aidoc:v1 sig=70bdc1a -->
 public class UnprocessableEntityException : Exception
 {
    /// <summary>
    /// Initializes a new instance of the <see cref="UnprocessableEntityException"/> class with a specified error message enum.
    /// </summary>
    /// <param name="message">The error message enum containing the error code.</param>
+    /// <!-- aidoc:v1 sig=c2da948 body=4448e1d -->
    public UnprocessableEntityException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
    {
    }
@@ -22,6 +24,7 @@ public class UnprocessableEntityException : Exception
    /// Initializes a new instance of the <see cref="UnprocessableEntityException"/> class with a specified error message.
    /// </summary>
    /// <param name="message">The message that describes the error.</param>
+    /// <!-- aidoc:v1 sig=cc0f943 body=4448e1d -->
    public UnprocessableEntityException(string message) : base(message)
    {
    }