Adding the TooManyRequests error type

src/Errors/Error.cs

@@ -123,6 +123,18 @@ public static Error Forbidden(
         Dictionary<string, object>? metadata = null) =>
         new(code, description, ErrorType.Forbidden, metadata);
 
+    /// <summary>
+    /// Creates an <see cref="Error"/> of type <see cref="ErrorType.TooManyRequests"/> from a code and description.
+    /// </summary>
+    /// <param name="code">The unique error code.</param>
+    /// <param name="description">The error description.</param>
+    /// <param name="metadata">A dictionary which provides optional space for information.</param>
+    public static Error TooManyRequests(
+        string code = "General.TooManyRequests",
+        string description = "A 'Too Many Requests' error has occurred.",
+        Dictionary<string, object>? metadata = null) =>
+        new(code, description, ErrorType.TooManyRequests, metadata);
+
     /// <summary>
     /// Creates an <see cref="Error"/> with the given numeric <paramref name="type"/>,
     /// <paramref name="code"/>, and <paramref name="description"/>.

src/Errors/ErrorType.cs

@@ -12,4 +12,5 @@ public enum ErrorType
     NotFound,
     Unauthorized,
     Forbidden,
+    TooManyRequests,
 }

tests/Errors/ErrorTests.cs

@@ -83,6 +83,16 @@ public void CreateError_WhenForbiddenError_ShouldHaveErrorTypeForbidden()
         ValidateError(error, expectedErrorType: ErrorType.Forbidden);
     }
 
+    [Fact]
+    public void CreateError_WhenTooManyRequestsError_ShouldHaveErrorTypeTooManyRequests()
+    {
+        // Act
+        Error error = Error.TooManyRequests(ErrorCode, ErrorDescription, Dictionary);
+
+        // Assert
+        ValidateError(error, expectedErrorType: ErrorType.TooManyRequests);
+    }
+
     [Fact]
     public void CreateError_WhenCustomType_ShouldHaveCustomErrorType()
     {