tercul-backend/internal/adapters/graphql/errors.go
google-labs-jules[bot] 9fd2331eb4 feat: Implement production-ready API patterns
This commit introduces a comprehensive set of foundational improvements to make the API more robust, secure, and observable.

The following features have been implemented:

- **Observability Stack:** A new `internal/observability` package has been added, providing structured logging with `zerolog`, Prometheus metrics, and OpenTelemetry tracing. This stack is fully integrated into the application's request pipeline.

- **Centralized Authorization:** A new `internal/app/authz` service has been created to centralize authorization logic. This service is now used by the `user`, `work`, and `comment` services to protect all Create, Update, and Delete operations.

- **Standardized Input Validation:** The previous ad-hoc validation has been replaced with a more robust, struct-tag-based system using the `go-playground/validator` library. This has been applied to all GraphQL input models.

- **Structured Error Handling:** A new set of custom error types has been introduced in the `internal/domain` package. A custom `gqlgen` error presenter has been implemented to map these domain errors to structured GraphQL error responses with specific error codes.

- **`updateUser` Endpoint:** The `updateUser` mutation has been fully implemented as a proof of concept for the new patterns, including support for partial updates and comprehensive authorization checks.

- **Test Refactoring:** The test suite has been significantly improved by decoupling mock repositories from the shared `testutil` package, resolving circular dependency issues and making the tests more maintainable.
2025-10-04 18:16:08 +00:00

49 lines
1.8 KiB
Go

package graphql
import (
"context"
"errors"
"tercul/internal/domain"
"github.com/99designs/gqlgen/graphql"
"github.com/vektah/gqlparser/v2/gqlerror"
)
// NewErrorPresenter creates a custom error presenter for gqlgen.
func NewErrorPresenter() graphql.ErrorPresenterFunc {
return func(ctx context.Context, e error) *gqlerror.Error {
gqlErr := graphql.DefaultErrorPresenter(ctx, e)
// Unwrap the error to find the root cause.
originalErr := errors.Unwrap(e)
if originalErr == nil {
originalErr = e
}
// Check for custom application errors and format them.
switch {
case errors.Is(originalErr, domain.ErrNotFound):
gqlErr.Message = "The requested resource was not found."
gqlErr.Extensions = map[string]interface{}{"code": "NOT_FOUND"}
case errors.Is(originalErr, domain.ErrUnauthorized):
gqlErr.Message = "You must be logged in to perform this action."
gqlErr.Extensions = map[string]interface{}{"code": "UNAUTHENTICATED"}
case errors.Is(originalErr, domain.ErrForbidden):
gqlErr.Message = "You are not authorized to perform this action."
gqlErr.Extensions = map[string]interface{}{"code": "FORBIDDEN"}
case errors.Is(originalErr, domain.ErrValidation):
// Keep the detailed message from the validation error.
gqlErr.Message = originalErr.Error()
gqlErr.Extensions = map[string]interface{}{"code": "VALIDATION_FAILED"}
case errors.Is(originalErr, domain.ErrConflict):
gqlErr.Message = "A conflict occurred with the current state of the resource."
gqlErr.Extensions = map[string]interface{}{"code": "CONFLICT"}
default:
// For all other errors, return a generic message to avoid leaking implementation details.
gqlErr.Message = "An unexpected internal error occurred."
gqlErr.Extensions = map[string]interface{}{"code": "INTERNAL_SERVER_ERROR"}
}
return gqlErr
}
}