token

type Claims struct {
	jwt.RegisteredClaims

	UserID     string                 `json:"user_id"`
	Username   string                 `json:"username,omitempty"`
	Role       string                 `json:"role,omitempty"`
	Email      string                 `json:"email,omitempty"`
	SessionID  string                 `json:"session_id,omitempty"`
	DeviceInfo string                 `json:"device_info,omitempty"`
	IPAddress  string                 `json:"ip_address,omitempty"`
	TokenType  string                 `json:"token_type,omitempty"`
	CustomData map[string]interface{} `json:"custom_data,omitempty"`
}

type JWTConfig struct {
	SecretKey            []byte
	Issuer               string
	AccessTokenDuration  time.Duration
	RefreshTokenDuration time.Duration
	SecurityLevel        security.Level
}

type JWTManager struct {
	// contains filtered or unexported fields
}

type MemorySessionStore struct {
	// contains filtered or unexported fields
}

type Session struct {
	// ID es el identificador único de la sesión (generado criptográficamente).
	ID string

	// UserID es el identificador del usuario propietario de la sesión.
	UserID string

	// Username es el nombre de usuario (opcional, para logging/auditoría).
	Username string

	// IPAddress es la IP desde donde se creó la sesión.
	IPAddress string

	// UserAgent es el User-Agent del navegador/cliente.
	UserAgent string

	// DeviceInfo contiene información adicional del dispositivo (opcional).
	DeviceInfo string

	// CreatedAt es el momento en que se creó la sesión.
	CreatedAt time.Time

	// LastActivityAt es el momento de la última actividad del usuario.
	// Se actualiza en cada validación exitosa para implementar idle timeout.
	LastActivityAt time.Time

	// ExpiresAt es el momento de expiración absoluta de la sesión.
	// Después de este tiempo, la sesión es inválida sin importar la actividad.
	ExpiresAt time.Time

	// IdleTimeout es el tiempo máximo de inactividad permitido.
	// Si pasa más tiempo que esto desde LastActivityAt, la sesión expira.
	IdleTimeout time.Duration

	// IsValid indica si la sesión está activa (no ha sido revocada).
	IsValid bool

	// RevokedAt es el momento en que la sesión fue revocada (si aplica).
	// Si es zero, la sesión no ha sido revocada.
	RevokedAt time.Time

	// RevokeReason indica la razón de la revocación (opcional, para auditoría).
	RevokeReason string
}

type SessionConfig struct {
	// SessionTimeout es el tiempo máximo absoluto de vida de una sesión.
	// Si es 0, se usa el valor predeterminado del nivel de seguridad.
	SessionTimeout time.Duration

	// IdleTimeout es el tiempo máximo de inactividad permitido.
	// Si es 0, se usa el valor predeterminado del nivel de seguridad.
	IdleTimeout time.Duration

	// MaxConcurrentSessions es el número máximo de sesiones activas por usuario.
	// Si es 0, se usa el valor predeterminado del nivel de seguridad.
	// Cuando se supera este límite, las sesiones más antiguas se revocan.
	MaxConcurrentSessions int

	// SecurityLevel define el nivel de seguridad para usar valores predeterminados.
	// Si no se especifica, se usa LevelMedium.
	SecurityLevel security.Level

	// Store es el almacenamiento de sesiones a utilizar.
	// Si es nil, se usa MemorySessionStore (solo para desarrollo/testing).
	Store SessionStore
}

type SessionInfo struct {
	UserID     string
	Username   string
	IPAddress  string
	UserAgent  string
	DeviceInfo string
}

type SessionManager struct {
	// contains filtered or unexported fields
}

type SessionStore interface {
	// Save guarda una sesión en el almacenamiento.
	Save(session *Session) error

	// Get recupera una sesión por su ID.
	// Retorna ErrSessionNotFound si no existe.
	Get(sessionID string) (*Session, error)

	// GetByUserID recupera todas las sesiones activas de un usuario.
	GetByUserID(userID string) ([]*Session, error)

	// Delete elimina una sesión del almacenamiento.
	Delete(sessionID string) error

	// DeleteByUserID elimina todas las sesiones de un usuario.
	DeleteByUserID(userID string) error

	// CleanExpired elimina todas las sesiones expiradas del almacenamiento.
	// Útil para tareas de mantenimiento periódico.
	CleanExpired() (int, error)
}