deps

type DefaultServices struct{}

type Deps struct {
	Cfg    config.File
	Logger *slog.Logger
	Svc    Services
}

type Services interface {
	// LoginGETHandler returns a gin.HandlerFunc to handle GET requests for the login endpoint and display the login page.
	LoginGETHandler() gin.HandlerFunc

	// LoginPOSTHandler processes POST requests for user login, including authentication and session management logic.
	LoginPOSTHandler() gin.HandlerFunc

	// DeviceGETHandler returns a gin.HandlerFunc to handle GET requests for device-based login or authentication workflows.
	DeviceGETHandler() gin.HandlerFunc

	// DevicePOSTHandler processes POST requests for device-based login or authentication, handling validation and security logic.
	DevicePOSTHandler() gin.HandlerFunc

	// ConsentGETHandler returns a gin.HandlerFunc to handle GET requests for user consent, rendering the consent page or details.
	ConsentGETHandler() gin.HandlerFunc

	// ConsentPOSTHandler handles POST requests for the consent endpoint, managing user consent submissions in ongoing sessions.
	ConsentPOSTHandler() gin.HandlerFunc

	// LogoutGETHandler handles GET requests for user logout functionality, orchestrating necessary session termination processes.
	LogoutGETHandler() gin.HandlerFunc

	// LogoutPOSTHandler handles POST requests for user logout by terminating the active session and cleaning up related resources.
	LogoutPOSTHandler() gin.HandlerFunc

	// NotifyGETHandler provides a handler function for the Notify GET endpoint, commonly used for serving notifications.
	NotifyGETHandler() gin.HandlerFunc

	// LoginGET2FAHandler handles GET requests for initiating the two-factor authentication (2FA) login process.
	LoginGET2FAHandler() gin.HandlerFunc

	// LoginPOST2FAHandler handles the POST requests for Two-Factor Authentication during the login process.
	LoginPOST2FAHandler() gin.HandlerFunc

	// Register2FAHomeHandler handles the registration process for two-factor authentication home setup.
	Register2FAHomeHandler() gin.HandlerFunc

	// RegisterTotpGETHandler returns a gin.HandlerFunc for handling GET requests to initiate TOTP registration.
	RegisterTotpGETHandler() gin.HandlerFunc

	// RegisterTotpPOSTHandler handles HTTP POST requests for registering a TOTP device and returns a gin.HandlerFunc.
	RegisterTotpPOSTHandler() gin.HandlerFunc

	// BeginRegistration initializes the user registration process and returns a gin.HandlerFunc to handle the request.
	BeginRegistration() gin.HandlerFunc

	// FinishRegistration finalizes the registration process after the initial setup, validating and storing user details.
	FinishRegistration() gin.HandlerFunc
}