docs: auth docs

apperror/error.go

@@ -18,4 +18,8 @@ var (
 	InternalError         = &AppError{"internal-server-error", http.StatusInternalServerError}
 	BadRequest            = &AppError{"bad-request", http.StatusBadRequest}
 	InvalidEventId        = &AppError{"invalid-event-id", http.StatusNotFound}
+	InvalidToken          = &AppError{"invalid-token", http.StatusUnauthorized}
+	InvalidEmail          = &AppError{"invalid-email", http.StatusNotFound}
+	DuplicateEmail        = &AppError{"duplicate-email", http.StatusConflict}
+	Unauthorized          = &AppError{"unauthorized", http.StatusUnauthorized}
 )

cfgldr/cfgldr.go

@@ -8,6 +8,7 @@ type Config struct {
 	DatabaseConfig DatabaseConfig
 	AppConfig      AppConfig
 	RedisConfig    RedisConfig
+	OAuth2Config   OAuth2Config
 }
 
 type DatabaseConfig struct {
@@ -25,8 +26,15 @@ type RedisConfig struct {
 	Password string `mapstructure:"PASSWORD"`
 }
 
+type OAuth2Config struct {
+	RedirectURL  string   `mapstructure:"REDIRECT_URL"`
+	ClientID     string   `mapstructure:"CLIENT_ID"`
+	ClientSecret string   `mapstructure:"CLIENT_SECRET"`
+	Scopes       []string `mapstructure:"SCOPES"`
+	Endpoint     string   `mapstructure:"ENDPOINT"`
+}
+
 func LoadConfig() (*Config, error) {
-
 	dbCfgLdr := viper.New()
 	dbCfgLdr.SetEnvPrefix("DB")
 	dbCfgLdr.AutomaticEnv()
@@ -54,10 +62,20 @@ func LoadConfig() (*Config, error) {
 		return nil, err
 	}
 
+	oauth2CfgLdr := viper.New()
+	oauth2CfgLdr.SetEnvPrefix("OAUTH2")
+	oauth2CfgLdr.AutomaticEnv()
+	oauth2CfgLdr.AllowEmptyEnv(false)
+	oauth2Config := OAuth2Config{}
+	if err := oauth2CfgLdr.Unmarshal(&oauth2Config); err != nil {
+		return nil, err
+	}
+
 	return &Config{
 		DatabaseConfig: dbConfig,
 		AppConfig:      appConfig,
 		RedisConfig:    redisConfig,
+		OAuth2Config:   oauth2Config,
 	}, nil
 }
 

cmd/main.go

@@ -9,14 +9,14 @@ import (
 	ginSwagger "github.com/swaggo/gin-swagger"
 )
 
-//	@title						OPH-66 Backend API
-//	@version					1.0
-//	@description				Documentation outlines the specifications and endpoints for the OPH-66 Backend API. 
-//	@Schemes					http https
-//	@securityDefinitions.apikey	Bearer
-//	@in							header
-//	@name						Authorization
-//	@description				Type "Bearer" followed by a space and JWT token.
+// @title                      OPH-66 Backend API
+// @version                    1.0
+// @description                Documentation outlines the specifications and endpoints for the OPH-66 Backend API.
+// @Schemes                    http https
+// @securityDefinitions.apikey Bearer
+// @in                         header
+// @name                       Authorization
+// @description                Type "Bearer" followed by a space and JWT token.
 func main() {
 	container, err := di.Init()
 	if err != nil {
@@ -34,10 +34,14 @@ func main() {
 	r.GET("/live", container.FeatureflagHandler.GetLivestreamInfo)
 	r.GET("/events", container.EventHandler.GetAllEvents)
 	r.GET("/events/:eventId", container.EventHandler.GetEventById)
+	r.POST("/auth/register", container.AuthHandler.Register)
+	r.GET("/auth/me", container.AuthHandler.GetProfile)
+	r.GET("/auth/login", container.AuthHandler.GoogleLogin)
+	r.GET("/auth/callback", container.AuthHandler.GoogleCallback)
 
 	if container.Config.AppConfig.Env == "development" {
 		r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))
-	}	
+	}
 	if err := r.Run(fmt.Sprintf(":%v", container.Config.AppConfig.Port)); err != nil {
 		container.Logger.Fatal("unable to start server")
 	}

di/wire.go

@@ -8,6 +8,7 @@ import (
 	"github.com/isd-sgcu/oph66-backend/cache"
 	"github.com/isd-sgcu/oph66-backend/cfgldr"
 	"github.com/isd-sgcu/oph66-backend/database"
+	auth "github.com/isd-sgcu/oph66-backend/internal/auth"
 	event "github.com/isd-sgcu/oph66-backend/internal/event"
 	featureflag "github.com/isd-sgcu/oph66-backend/internal/feature_flag"
 	healthcheck "github.com/isd-sgcu/oph66-backend/internal/health_check"
@@ -19,15 +20,17 @@ type Container struct {
 	EventHandler       event.Handler
 	HcHandler          healthcheck.Handler
 	FeatureflagHandler featureflag.Handler
+	AuthHandler        auth.Handler
 	Config             *cfgldr.Config
 	Logger             *zap.Logger
 }
 
-func newContainer(eventHandler event.Handler, hcHandler healthcheck.Handler, featureflagHandler featureflag.Handler, config *cfgldr.Config, logger *zap.Logger) Container {
+func newContainer(eventHandler event.Handler, hcHandler healthcheck.Handler, featureflagHandler featureflag.Handler, authHandler auth.Handler, config *cfgldr.Config, logger *zap.Logger) Container {
 	return Container{
 		eventHandler,
 		hcHandler,
 		featureflagHandler,
+		authHandler,
 		config,
 		logger,
 	}
@@ -48,6 +51,9 @@ func Init() (Container, error) {
 		featureflag.NewCache,
 		featureflag.NewService,
 		featureflag.NewRepository,
+		auth.NewHandler,
+		auth.NewService,
+		auth.NewRepository,
 		logger.InitLogger,
 	)