core

type RefreshTokenData struct {
	UserData any       `json:"user_data"`
	Expiry   time.Time `json:"expiry"`
	Created  time.Time `json:"created"`
}

type Token struct {
	AccessToken  string `json:"access_token"`
	TokenType    string `json:"token_type"`
	RefreshToken string `json:"refresh_token,omitempty"`
	ExpiresAt    int64  `json:"expires_at"`
	CreatedAt    int64  `json:"created_at"`
}

type TokenStore interface {
	// Set stores a refresh token with associated user data and expiration
	// Returns an error if the operation fails
	Set(ctx context.Context, token string, userData any, expiry time.Time) error

	// Get retrieves user data associated with a refresh token
	// Returns ErrRefreshTokenNotFound if token doesn't exist or is expired
	Get(ctx context.Context, token string) (any, error)

	// Delete removes a refresh token from storage
	// Returns an error if the operation fails, but should not error if token doesn't exist
	Delete(ctx context.Context, token string) error

	// Cleanup removes expired tokens (optional, for cleanup routines)
	// Returns the number of tokens cleaned up and any error encountered
	Cleanup(ctx context.Context) (int, error)

	// Count returns the total number of active refresh tokens
	// Useful for monitoring and debugging
	Count(ctx context.Context) (int, error)
}