Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

core

package

Go to main page

Versions in this module

v0

v0.20.0

Mar 15, 2026

Changes in this version

+ type AuditStore interface

+ CreateAuditLog func(log *models.AuditLog) error

+ CreateAuditLogBatch func(logs []*models.AuditLog) error

+ DeleteOldAuditLogs func(olderThan time.Time) (int64, error)

+ GetAuditLogStats func(startTime, endTime time.Time) (types.AuditLogStats, error)

+ GetAuditLogsPaginated func(params types.PaginationParams, filters types.AuditLogFilters) ([]models.AuditLog, types.PaginationResult, error)

+ type AuthorizationCodeStore interface

+ CreateAuthorizationCode func(code *models.AuthorizationCode) error

+ GetAuthorizationCodeByHash func(hash string) (*models.AuthorizationCode, error)

+ MarkAuthorizationCodeUsed func(id uint) error

+ type CleanupStore interface

+ DeleteExpiredDeviceCodes func() error

+ DeleteExpiredTokens func() error

+ type ClientReader interface

+ CountActiveTokensByClientID func(clientID string) (int64, error)

+ CountClientsByStatus func(status string) (int64, error)

+ GetClient func(clientID string) (*models.OAuthApplication, error)

+ GetClientByIntID func(id int64) (*models.OAuthApplication, error)

+ GetClientsByIDs func(clientIDs []string) (map[string]*models.OAuthApplication, error)

+ ListClientsByUserID func(userID string, params types.PaginationParams) ([]models.OAuthApplication, types.PaginationResult, error)

+ ListClientsPaginated func(params types.PaginationParams) ([]models.OAuthApplication, types.PaginationResult, error)

+ type ClientWriter interface

+ CreateClient func(client *models.OAuthApplication) error

+ DeleteClient func(clientID string) error

+ UpdateClient func(client *models.OAuthApplication) error

+ type DeviceCodeStore interface

+ CreateDeviceCode func(dc *models.DeviceCode) error

+ DeleteDeviceCodeByID func(id int64) error

+ GetDeviceCodeByUserCode func(userCode string) (*models.DeviceCode, error)

+ GetDeviceCodesByID func(deviceCodeID string) ([]*models.DeviceCode, error)

+ UpdateDeviceCode func(dc *models.DeviceCode) error

+ type Infrastructure interface

+ Close func(ctx context.Context) error

+ Health func() error

+ type OAuthConnectionStore interface

+ CreateOAuthConnection func(conn *models.OAuthConnection) error

+ DeleteOAuthConnection func(id string) error

+ GetOAuthConnection func(provider, providerUserID string) (*models.OAuthConnection, error)

+ GetOAuthConnectionByUserAndProvider func(userID, provider string) (*models.OAuthConnection, error)

+ GetOAuthConnectionsByUserID func(userID string) ([]models.OAuthConnection, error)

+ UpdateOAuthConnection func(conn *models.OAuthConnection) error

+ type Store interface

+ type TokenReader interface

+ GetAccessTokenByHash func(hash string) (*models.AccessToken, error)

+ GetAccessTokenByID func(tokenID string) (*models.AccessToken, error)

+ GetTokensByCategoryAndStatus func(userID, category, status string) ([]models.AccessToken, error)

+ GetTokensByUserID func(userID string) ([]models.AccessToken, error)

+ GetTokensByUserIDPaginated func(userID string, params types.PaginationParams) ([]models.AccessToken, types.PaginationResult, error)

+ type TokenWriter interface

+ CreateAccessToken func(token *models.AccessToken) error

+ RevokeAllActiveTokensByClientID func(clientID string) (int64, error)

+ RevokeToken func(tokenID string) error

+ RevokeTokenFamily func(familyID string) (int64, error)

+ RevokeTokensByAuthorizationID func(authorizationID uint) error

+ RevokeTokensByClientID func(clientID string) error

+ RevokeTokensByUserID func(userID string) error

+ UpdateTokenLastUsedAt func(tokenID string, t time.Time) error

+ UpdateTokenStatus func(tokenID, status string) error

+ type Transactor interface

+ RunInTransaction func(fn func(tx Store) error) error

+ type UserAuthorizationStore interface

+ GetClientAuthorizations func(clientID string) ([]models.UserAuthorization, error)

+ GetUserAuthorization func(userID string, applicationID int64) (*models.UserAuthorization, error)

+ GetUserAuthorizationByUUID func(authUUID, userID string) (*models.UserAuthorization, error)

+ ListUserAuthorizations func(userID string) ([]models.UserAuthorization, error)

+ RevokeAllUserAuthorizationsByClientID func(clientID string) error

+ RevokeUserAuthorization func(authUUID, userID string) (*models.UserAuthorization, error)

+ UpsertUserAuthorization func(auth *models.UserAuthorization) error

+ type UserReader interface

+ GetUserByEmail func(email string) (*models.User, error)

+ GetUserByExternalID func(externalID, authSource string) (*models.User, error)

+ GetUserByID func(id string) (*models.User, error)

+ GetUserByUsername func(username string) (*models.User, error)

+ GetUsersByIDs func(userIDs []string) (map[string]*models.User, error)

+ type UserWriter interface

+ CreateUser func(user *models.User) error

+ DeleteUser func(id string) error

+ UpdateUser func(user *models.User) error

+ UpsertExternalUser func(username, externalID, authSource, email, fullName string) (*models.User, error)

v0.19.0

Mar 11, 2026

v0.18.0

Mar 8, 2026

v0.17.0

Mar 6, 2026

v0.16.0

Mar 4, 2026

v0.15.0

Mar 1, 2026

Changes in this version

+ type AuthProvider interface

+ Authenticate func(ctx context.Context, username, password string) (*AuthResult, error)

+ Name func() string

+ type AuthResult struct

+ Email string

+ ExternalID string

+ FullName string

+ Success bool

+ Username string

+ type Cache interface

+ Close func() error

+ Delete func(ctx context.Context, key string) error

+ Get func(ctx context.Context, key string) (T, error)

+ GetWithFetch func(ctx context.Context, key string, ttl time.Duration, ...) (T, error)

+ Health func(ctx context.Context) error

+ MGet func(ctx context.Context, keys []string) (map[string]T, error)

+ MSet func(ctx context.Context, values map[string]T, ttl time.Duration) error

+ Set func(ctx context.Context, key string, value T, ttl time.Duration) error

+ type IDTokenParams struct

+ AtHash string

+ Audience string

+ AuthTime time.Time

+ Email string

+ EmailVerified bool

+ Expiry time.Duration

+ Issuer string

+ Name string

+ Nonce string

+ Picture string

+ PreferredUsername string

+ Subject string

+ UpdatedAt *time.Time

+ type IDTokenProvider interface

+ GenerateIDToken func(params IDTokenParams) (string, error)

+ type MetricsStore interface

+ CountActiveTokensByCategory func(category string) (int64, error)

+ CountPendingDeviceCodes func() (int64, error)

+ CountTotalDeviceCodes func() (int64, error)

+ type Recorder interface

+ RecordAuthAttempt func(method string, success bool, duration time.Duration)

+ RecordDatabaseQueryError func(operation string)

+ RecordExternalAPICall func(provider string, duration time.Duration)

+ RecordLogin func(authSource string, success bool)

+ RecordLogout func(sessionDuration time.Duration)

+ RecordOAuthCallback func(provider string, success bool)

+ RecordOAuthDeviceCodeAuthorized func(authorizationTime time.Duration)

+ RecordOAuthDeviceCodeGenerated func(success bool)

+ RecordOAuthDeviceCodeValidation func(result string)

+ RecordSessionExpired func(reason string, duration time.Duration)

+ RecordSessionInvalidated func(reason string)

+ RecordTokenIssued func(tokenType, grantType string, generationTime time.Duration, provider string)

+ RecordTokenRefresh func(success bool)

+ RecordTokenRevoked func(tokenType, reason string)

+ RecordTokenValidation func(result string, duration time.Duration, provider string)

+ SetActiveDeviceCodesCount func(total, pending int)

+ SetActiveSessionsCount func(count int)

+ SetActiveTokensCount func(tokenType string, count int)

+ type TokenProvider interface

+ GenerateClientCredentialsToken func(ctx context.Context, userID, clientID, scopes string) (*TokenResult, error)

+ GenerateRefreshToken func(ctx context.Context, userID, clientID, scopes string) (*TokenResult, error)

+ GenerateToken func(ctx context.Context, userID, clientID, scopes string) (*TokenResult, error)

+ Name func() string

+ RefreshAccessToken func(ctx context.Context, refreshToken string, enableRotation bool) (*TokenRefreshResult, error)

+ ValidateToken func(ctx context.Context, tokenString string) (*TokenValidationResult, error)

+ type TokenRefreshResult struct

+ AccessToken *TokenResult

+ RefreshToken *TokenResult

+ Success bool

+ type TokenResult struct

+ Claims map[string]any

+ ExpiresAt time.Time

+ Success bool

+ TokenString string

+ TokenType string

+ type TokenValidationResult struct

+ Claims map[string]any

+ ClientID string

+ ExpiresAt time.Time

+ Scopes string

+ UserID string

+ Valid bool