ratelimit

type Config struct {
	// MaxRequests is the maximum number of requests allowed
	MaxRequests int
	// Window is the time window for rate limiting
	Window time.Duration
	// KeyPrefix is the prefix for Redis keys
	KeyPrefix string
}

type LoginRateLimiter interface {
	// CheckAndRecordAttempt checks if login attempt is allowed and records it
	// Returns: allowed (bool), isLocked (bool), remainingAttempts (int), error
	CheckAndRecordAttempt(ctx context.Context, email string, clientIP string) (bool, bool, int, error)

	// RecordFailedAttempt records a failed login attempt
	RecordFailedAttempt(ctx context.Context, email string, clientIP string) error

	// RecordSuccessfulLogin records a successful login and resets counters
	RecordSuccessfulLogin(ctx context.Context, email string, clientIP string) error

	// IsAccountLocked checks if an account is locked due to too many failed attempts
	IsAccountLocked(ctx context.Context, email string) (bool, time.Duration, error)

	// UnlockAccount manually unlocks an account (admin function)
	UnlockAccount(ctx context.Context, email string) error

	// GetFailedAttempts returns the number of failed attempts for an email
	GetFailedAttempts(ctx context.Context, email string) (int, error)
}

type LoginRateLimiterConfig struct {
	// MaxAttemptsPerIP is the maximum login attempts per IP in the window
	MaxAttemptsPerIP int
	// IPWindow is the time window for IP-based rate limiting
	IPWindow time.Duration

	// MaxFailedAttemptsPerAccount is the maximum failed attempts before account lockout
	MaxFailedAttemptsPerAccount int
	// AccountLockoutDuration is how long to lock an account after too many failures
	AccountLockoutDuration time.Duration

	// KeyPrefix is the prefix for Redis keys
	KeyPrefix string
}

type RateLimiter interface {
	// Allow checks if a request should be allowed based on the key
	// Returns true if allowed, false if rate limit exceeded
	Allow(ctx context.Context, key string) (bool, error)

	// AllowN checks if N requests should be allowed
	AllowN(ctx context.Context, key string, n int) (bool, error)

	// Reset resets the rate limit for a key
	Reset(ctx context.Context, key string) error

	// GetRemaining returns the number of remaining requests
	GetRemaining(ctx context.Context, key string) (int, error)
}