feat(error-handling): add error modification capability

Introduce the From function to allow modification of CustomError
instances with provided options. This enhances flexibility in error
handling by enabling dynamic updates to error attributes.

- Implement From function in customerror.go
- Add tests for From function in customerror_test.go

customerror.go

@@ -675,6 +675,19 @@ func To(err error) (*CustomError, bool) {
 	return cE, true
 }
 
+// From modifies the error with the given options.
+func From(err error, opts ...Option) error {
+	if cE, ok := To(err); ok {
+		for _, opt := range opts {
+			opt(cE)
+		}
+
+		return cE
+	}
+
+	return err
+}
+
 // IsHTTPStatus checks if the error is a `CustomError` with the
 // specified HTTP status code.
 func IsHTTPStatus(err error, statusCode int) bool {

customerror_test.go

@@ -439,3 +439,26 @@ func Test_CustomError_String(t *testing.T) {
 
 	assert.Equal(t, expected, s.String())
 }
+
+func Test_From(t *testing.T) {
+	// Helper function that receives a "throw" custom error and return it as an
+	// error.
+	throwIt := func(err error) error {
+		return err
+	}
+
+	// Create a custom error that will be modified later.
+	cE := New("An error occurred", WithErrorCode("E1010"), WithStatusCode(http.StatusBadRequest))
+
+	// Simulate throwing it.
+	err := throwIt(cE)
+
+	// Ensure the message.
+	assert.Equal(t, "E1010: An error occurred", cE.Error())
+
+	// Modify the error.
+	newErr := From(err, WithErrorCode("E1011"))
+
+	// Ensure changes are applied.
+	assert.Equal(t, "E1011: An error occurred", newErr.Error())
+}