interfaces

type APICredentials interface {
	GetID() string
	GetUserID() string
	GetAPIKey() string
	GetAPISecret() string
	GetStatus() string
	GetExpiresAt() time.Time
	GetLastUsedAt() *time.Time
}

type APIKeyRepository interface {
	Create(ctx context.Context, data map[string]any) (APICredentials, error)
	FindByKey(ctx context.Context, apiKey string) (APICredentials, error)
	FindByUser(ctx context.Context, userID string) ([]APICredentials, error)
	UpdateLastUsed(ctx context.Context, creds APICredentials) error
	Revoke(ctx context.Context, id string) error
}

type AuthHandler interface {
	RegisterRoutes(router *gin.RouterGroup, socialSignupHandler gin.HandlerFunc)
	RegisterSocialSignupRoutes(router *gin.RouterGroup, handler gin.HandlerFunc)
	InitiateSocialLogin(c *gin.Context)
	SocialSignup(next gin.HandlerFunc) gin.HandlerFunc
	Login(c *gin.Context)
	Logout(c *gin.Context)
	RefreshToken(c *gin.Context)
}

type AuthMiddleware interface {
	JWT() gin.HandlerFunc
	Optional() gin.HandlerFunc
	APIKey() gin.HandlerFunc
	RequireAuth() gin.HandlerFunc
	RequireRole(role string) gin.HandlerFunc
	RequirePermission(resource, action string) gin.HandlerFunc
}

type GoogleSignin interface {
	Exchange(ctx context.Context, code string) (*pkg.GoogleUser, error)
	VerifyGoogleIDToken(ctx context.Context, tokenString string) (*pkg.GoogleUser, error)
	GetAuthURL(state string) string
}

type JWKSProvider interface {
	JWKS() (map[string]any, error)
}

type PasswordHandler interface {
	RegisterRoutes(router *gin.RouterGroup)
	RequestPasswordReset(c *gin.Context)
	VerifyPasswordReset(c *gin.Context)
	ChangePassword(c *gin.Context)
}

type PasswordHasher interface {
	Hash(password string) (string, error)
	Verify(password, hash string) error
}

type SocialAccount interface {
	GetID() string
	GetUser() User
	GetUserID() string
	GetProvider() string
	GetProviderUserID() string
	GetMetadata() map[string]any
}

type SocialAccountRepository interface {
	Create(ctx context.Context, data *models.SocialAccount) (*models.SocialAccount, error)
	DeleteByUserID(ctx context.Context, userID string) error
	FindByProvider(ctx context.Context, provider authTypes.AuthProvider, providerUserID string) (*models.SocialAccount, error)
	FindByUserID(ctx context.Context, userID string) (*models.SocialAccount, error)
}

type TokenIssuer interface {
	IssueToken(user User) (*responses.TokenResponse, error)
	ValidateToken(token string) (map[string]any, error)
	RevokeToken(token string) error
	RefreshToken(refreshToken string) (*responses.TokenResponse, error)
}

type User interface {
	GetID() uuid.UUID
	GetUsername() string
	GetEmail() string
	GetPhoneNumber() string
	GetPasswordHash() string
	GetRole() string
	IsActive() bool
	GetLastLoginAt() *time.Time
	GetMetadata() map[string]any
	GetEmailVerified() bool
	GetEmailVerifiedAt() *types.DateTime
	GetPasswordResetToken() *string
	GetPasswordResetAt() *time.Time
	SetPasswordResetToken(token *string)
	SetPasswordResetAt(at *time.Time)
	SetPassword(password string)
}

type UserRepository interface {
	Create(ctx context.Context, data map[string]any) (User, error)
	FindByID(ctx context.Context, id uuid.UUID) (User, error)
	FindByEmail(ctx context.Context, email string) (User, error)
	FindByUsername(ctx context.Context, username string) (User, error)
	FindByPhoneNumber(ctx context.Context, phone string) (User, error)
	FindByIdentifier(ctx context.Context, identifier string) (User, error)
	FindByResetToken(ctx context.Context, token string) (User, error)
	UpdateLastLogin(ctx context.Context, user User) error
	ChangePassword(ctx context.Context, user User, newPasswordHash string) error
	Update(ctx context.Context, user User, updates map[string]any) error
}

type UserRepositoryFactory interface {
	NewUser() User
	GetTableName() string
	GetSchema() any
}