mirror of https://github.com/h44z/wg-portal.git
				
				
				
			
		
			
				
	
	
		
			1065 lines
		
	
	
		
			27 KiB
		
	
	
	
		
			Go
		
	
	
	
			
		
		
	
	
			1065 lines
		
	
	
		
			27 KiB
		
	
	
	
		
			Go
		
	
	
	
package adapters
 | 
						|
 | 
						|
import (
 | 
						|
	"context"
 | 
						|
	"errors"
 | 
						|
	"fmt"
 | 
						|
	"log/slog"
 | 
						|
	"os"
 | 
						|
	"path/filepath"
 | 
						|
	"strings"
 | 
						|
	"time"
 | 
						|
 | 
						|
	"github.com/glebarez/sqlite"
 | 
						|
	"gorm.io/driver/mysql"
 | 
						|
	"gorm.io/driver/postgres"
 | 
						|
	"gorm.io/driver/sqlserver"
 | 
						|
	"gorm.io/gorm"
 | 
						|
	"gorm.io/gorm/clause"
 | 
						|
	"gorm.io/gorm/logger"
 | 
						|
	"gorm.io/gorm/utils"
 | 
						|
 | 
						|
	"github.com/h44z/wg-portal/internal/config"
 | 
						|
	"github.com/h44z/wg-portal/internal/domain"
 | 
						|
)
 | 
						|
 | 
						|
// SchemaVersion describes the current database schema version. It must be incremented if a manual migration is needed.
 | 
						|
var SchemaVersion uint64 = 1
 | 
						|
 | 
						|
// SysStat stores the current database schema version and the timestamp when it was applied.
 | 
						|
type SysStat struct {
 | 
						|
	MigratedAt    time.Time `gorm:"column:migrated_at"`
 | 
						|
	SchemaVersion uint64    `gorm:"primaryKey,column:schema_version"`
 | 
						|
}
 | 
						|
 | 
						|
// GormLogger is a custom logger for Gorm, making it use slog
 | 
						|
type GormLogger struct {
 | 
						|
	SlowThreshold           time.Duration
 | 
						|
	SourceField             string
 | 
						|
	IgnoreErrRecordNotFound bool
 | 
						|
	Debug                   bool
 | 
						|
	Silent                  bool
 | 
						|
 | 
						|
	prefix string
 | 
						|
}
 | 
						|
 | 
						|
func NewLogger(slowThreshold time.Duration, debug bool) *GormLogger {
 | 
						|
	return &GormLogger{
 | 
						|
		SlowThreshold:           slowThreshold,
 | 
						|
		Debug:                   debug,
 | 
						|
		IgnoreErrRecordNotFound: true,
 | 
						|
		Silent:                  false,
 | 
						|
		SourceField:             "src",
 | 
						|
		prefix:                  "GORM-SQL: ",
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
func (l *GormLogger) LogMode(level logger.LogLevel) logger.Interface {
 | 
						|
	if level == logger.Silent {
 | 
						|
		l.Silent = true
 | 
						|
	} else {
 | 
						|
		l.Silent = false
 | 
						|
	}
 | 
						|
	return l
 | 
						|
}
 | 
						|
 | 
						|
func (l *GormLogger) Info(ctx context.Context, s string, args ...any) {
 | 
						|
	if l.Silent {
 | 
						|
		return
 | 
						|
	}
 | 
						|
	slog.InfoContext(ctx, l.prefix+s, args...)
 | 
						|
}
 | 
						|
 | 
						|
func (l *GormLogger) Warn(ctx context.Context, s string, args ...any) {
 | 
						|
	if l.Silent {
 | 
						|
		return
 | 
						|
	}
 | 
						|
	slog.WarnContext(ctx, l.prefix+s, args...)
 | 
						|
}
 | 
						|
 | 
						|
func (l *GormLogger) Error(ctx context.Context, s string, args ...any) {
 | 
						|
	if l.Silent {
 | 
						|
		return
 | 
						|
	}
 | 
						|
	slog.ErrorContext(ctx, l.prefix+s, args...)
 | 
						|
}
 | 
						|
 | 
						|
func (l *GormLogger) Trace(ctx context.Context, begin time.Time, fc func() (string, int64), err error) {
 | 
						|
	if l.Silent {
 | 
						|
		return
 | 
						|
	}
 | 
						|
 | 
						|
	elapsed := time.Since(begin)
 | 
						|
	sql, rows := fc()
 | 
						|
 | 
						|
	attrs := []any{
 | 
						|
		"rows", rows,
 | 
						|
		"duration", elapsed,
 | 
						|
	}
 | 
						|
 | 
						|
	if l.SourceField != "" {
 | 
						|
		attrs = append(attrs, l.SourceField, utils.FileWithLineNum())
 | 
						|
	}
 | 
						|
 | 
						|
	if err != nil && !(errors.Is(err, gorm.ErrRecordNotFound) && l.IgnoreErrRecordNotFound) {
 | 
						|
		attrs = append(attrs, "error", err)
 | 
						|
		slog.ErrorContext(ctx, l.prefix+sql, attrs...)
 | 
						|
		return
 | 
						|
	}
 | 
						|
 | 
						|
	if l.SlowThreshold != 0 && elapsed > l.SlowThreshold {
 | 
						|
		slog.WarnContext(ctx, l.prefix+sql, attrs...)
 | 
						|
		return
 | 
						|
	}
 | 
						|
 | 
						|
	if l.Debug {
 | 
						|
		slog.DebugContext(ctx, l.prefix+sql, attrs...)
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
// NewDatabase creates a new database connection and returns a Gorm database instance.
 | 
						|
func NewDatabase(cfg config.DatabaseConfig) (*gorm.DB, error) {
 | 
						|
	var gormDb *gorm.DB
 | 
						|
	var err error
 | 
						|
 | 
						|
	switch cfg.Type {
 | 
						|
	case config.DatabaseMySQL:
 | 
						|
		gormDb, err = gorm.Open(mysql.Open(cfg.DSN), &gorm.Config{
 | 
						|
			Logger: NewLogger(cfg.SlowQueryThreshold, cfg.Debug),
 | 
						|
		})
 | 
						|
		if err != nil {
 | 
						|
			return nil, fmt.Errorf("failed to open MySQL database: %w", err)
 | 
						|
		}
 | 
						|
 | 
						|
		sqlDB, _ := gormDb.DB()
 | 
						|
		sqlDB.SetConnMaxLifetime(time.Minute * 5)
 | 
						|
		sqlDB.SetMaxIdleConns(2)
 | 
						|
		sqlDB.SetMaxOpenConns(10)
 | 
						|
		err = sqlDB.Ping() // This DOES open a connection if necessary. This makes sure the database is accessible
 | 
						|
		if err != nil {
 | 
						|
			return nil, fmt.Errorf("failed to ping MySQL database: %w", err)
 | 
						|
		}
 | 
						|
	case config.DatabaseMsSQL:
 | 
						|
		gormDb, err = gorm.Open(sqlserver.Open(cfg.DSN), &gorm.Config{
 | 
						|
			Logger: NewLogger(cfg.SlowQueryThreshold, cfg.Debug),
 | 
						|
		})
 | 
						|
		if err != nil {
 | 
						|
			return nil, fmt.Errorf("failed to open sqlserver database: %w", err)
 | 
						|
		}
 | 
						|
	case config.DatabasePostgres:
 | 
						|
		gormDb, err = gorm.Open(postgres.Open(cfg.DSN), &gorm.Config{
 | 
						|
			Logger: NewLogger(cfg.SlowQueryThreshold, cfg.Debug),
 | 
						|
		})
 | 
						|
		if err != nil {
 | 
						|
			return nil, fmt.Errorf("failed to open Postgres database: %w", err)
 | 
						|
		}
 | 
						|
	case config.DatabaseSQLite:
 | 
						|
		if _, err = os.Stat(filepath.Dir(cfg.DSN)); os.IsNotExist(err) {
 | 
						|
			if err = os.MkdirAll(filepath.Dir(cfg.DSN), 0700); err != nil {
 | 
						|
				return nil, fmt.Errorf("failed to create database base directory: %w", err)
 | 
						|
			}
 | 
						|
		}
 | 
						|
		gormDb, err = gorm.Open(sqlite.Open(cfg.DSN), &gorm.Config{
 | 
						|
			Logger:                                   NewLogger(cfg.SlowQueryThreshold, cfg.Debug),
 | 
						|
			DisableForeignKeyConstraintWhenMigrating: true,
 | 
						|
		})
 | 
						|
		if err != nil {
 | 
						|
			return nil, fmt.Errorf("failed to open sqlite database: %w", err)
 | 
						|
		}
 | 
						|
		sqlDB, _ := gormDb.DB()
 | 
						|
		sqlDB.SetMaxOpenConns(1)
 | 
						|
	}
 | 
						|
 | 
						|
	return gormDb, nil
 | 
						|
}
 | 
						|
 | 
						|
// SqlRepo is a SQL database repository implementation.
 | 
						|
// Currently, it supports MySQL, SQLite, Microsoft SQL and Postgresql database systems.
 | 
						|
type SqlRepo struct {
 | 
						|
	db *gorm.DB
 | 
						|
}
 | 
						|
 | 
						|
// NewSqlRepository creates a new SqlRepo instance.
 | 
						|
func NewSqlRepository(db *gorm.DB) (*SqlRepo, error) {
 | 
						|
	repo := &SqlRepo{
 | 
						|
		db: db,
 | 
						|
	}
 | 
						|
 | 
						|
	if err := repo.preCheck(); err != nil {
 | 
						|
		return nil, fmt.Errorf("failed to initialize database: %w", err)
 | 
						|
	}
 | 
						|
 | 
						|
	if err := repo.migrate(); err != nil {
 | 
						|
		return nil, fmt.Errorf("failed to initialize database: %w", err)
 | 
						|
	}
 | 
						|
 | 
						|
	return repo, nil
 | 
						|
}
 | 
						|
 | 
						|
func (r *SqlRepo) preCheck() error {
 | 
						|
	// WireGuard Portal v1 database migration table
 | 
						|
	type DatabaseMigrationInfo struct {
 | 
						|
		Version string `gorm:"primaryKey"`
 | 
						|
		Applied time.Time
 | 
						|
	}
 | 
						|
 | 
						|
	// temporarily disable logger as the next request might fail (intentionally)
 | 
						|
	r.db.Logger.LogMode(logger.Silent)
 | 
						|
	defer func() { r.db.Logger.LogMode(logger.Info) }()
 | 
						|
 | 
						|
	lastVersion := DatabaseMigrationInfo{}
 | 
						|
	err := r.db.Order("applied desc, version desc").FirstOrInit(&lastVersion).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil // we probably don't have a V1 database =)
 | 
						|
	}
 | 
						|
 | 
						|
	return fmt.Errorf("detected a WireGuard Portal V1 database (version: %s) - please migrate first",
 | 
						|
		lastVersion.Version)
 | 
						|
}
 | 
						|
 | 
						|
func (r *SqlRepo) migrate() error {
 | 
						|
	slog.Debug("running migration: sys-stat", "result", r.db.AutoMigrate(&SysStat{}))
 | 
						|
	slog.Debug("running migration: user", "result", r.db.AutoMigrate(&domain.User{}))
 | 
						|
	slog.Debug("running migration: interface", "result", r.db.AutoMigrate(&domain.Interface{}))
 | 
						|
	slog.Debug("running migration: peer", "result", r.db.AutoMigrate(&domain.Peer{}))
 | 
						|
	slog.Debug("running migration: peer status", "result", r.db.AutoMigrate(&domain.PeerStatus{}))
 | 
						|
	slog.Debug("running migration: interface status", "result", r.db.AutoMigrate(&domain.InterfaceStatus{}))
 | 
						|
	slog.Debug("running migration: audit data", "result", r.db.AutoMigrate(&domain.AuditEntry{}))
 | 
						|
 | 
						|
	existingSysStat := SysStat{}
 | 
						|
	r.db.Where("schema_version = ?", SchemaVersion).First(&existingSysStat)
 | 
						|
	if existingSysStat.SchemaVersion == 0 {
 | 
						|
		sysStat := SysStat{
 | 
						|
			MigratedAt:    time.Now(),
 | 
						|
			SchemaVersion: SchemaVersion,
 | 
						|
		}
 | 
						|
		if err := r.db.Create(&sysStat).Error; err != nil {
 | 
						|
			return fmt.Errorf("failed to write sysstat entry for schema version %d: %w", SchemaVersion, err)
 | 
						|
		}
 | 
						|
		slog.Debug("sys-stat entry written", "schema_version", SchemaVersion)
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// region interfaces
 | 
						|
 | 
						|
// GetInterface returns the interface with the given id.
 | 
						|
// If no interface is found, an error domain.ErrNotFound is returned.
 | 
						|
func (r *SqlRepo) GetInterface(ctx context.Context, id domain.InterfaceIdentifier) (*domain.Interface, error) {
 | 
						|
	var in domain.Interface
 | 
						|
 | 
						|
	err := r.db.WithContext(ctx).Preload("Addresses").First(&in, id).Error
 | 
						|
 | 
						|
	if err != nil && errors.Is(err, gorm.ErrRecordNotFound) {
 | 
						|
		return nil, domain.ErrNotFound
 | 
						|
	}
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return &in, nil
 | 
						|
}
 | 
						|
 | 
						|
// GetInterfaceAndPeers returns the interface with the given id and all peers associated with it.
 | 
						|
// If no interface is found, an error domain.ErrNotFound is returned.
 | 
						|
func (r *SqlRepo) GetInterfaceAndPeers(ctx context.Context, id domain.InterfaceIdentifier) (
 | 
						|
	*domain.Interface,
 | 
						|
	[]domain.Peer,
 | 
						|
	error,
 | 
						|
) {
 | 
						|
	in, err := r.GetInterface(ctx, id)
 | 
						|
	if err != nil {
 | 
						|
		return nil, nil, fmt.Errorf("failed to load interface: %w", err)
 | 
						|
	}
 | 
						|
 | 
						|
	peers, err := r.GetInterfacePeers(ctx, id)
 | 
						|
	if err != nil {
 | 
						|
		return nil, nil, fmt.Errorf("failed to load peers: %w", err)
 | 
						|
	}
 | 
						|
 | 
						|
	return in, peers, nil
 | 
						|
}
 | 
						|
 | 
						|
// GetPeersStats returns the stats for the given peer ids. The order of the returned stats is not guaranteed.
 | 
						|
func (r *SqlRepo) GetPeersStats(ctx context.Context, ids ...domain.PeerIdentifier) ([]domain.PeerStatus, error) {
 | 
						|
	if len(ids) == 0 {
 | 
						|
		return nil, nil
 | 
						|
	}
 | 
						|
 | 
						|
	var stats []domain.PeerStatus
 | 
						|
 | 
						|
	err := r.db.WithContext(ctx).Where("identifier IN ?", ids).Find(&stats).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return stats, nil
 | 
						|
}
 | 
						|
 | 
						|
// GetAllInterfaces returns all interfaces.
 | 
						|
func (r *SqlRepo) GetAllInterfaces(ctx context.Context) ([]domain.Interface, error) {
 | 
						|
	var interfaces []domain.Interface
 | 
						|
 | 
						|
	err := r.db.WithContext(ctx).Preload("Addresses").Find(&interfaces).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return interfaces, nil
 | 
						|
}
 | 
						|
 | 
						|
// GetInterfaceStats returns the stats for the given interface id.
 | 
						|
// If no stats are found, an error domain.ErrNotFound is returned.
 | 
						|
func (r *SqlRepo) GetInterfaceStats(ctx context.Context, id domain.InterfaceIdentifier) (
 | 
						|
	*domain.InterfaceStatus,
 | 
						|
	error,
 | 
						|
) {
 | 
						|
	if id == "" {
 | 
						|
		return nil, nil
 | 
						|
	}
 | 
						|
 | 
						|
	var stats []domain.InterfaceStatus
 | 
						|
 | 
						|
	err := r.db.WithContext(ctx).Where("identifier = ?", id).Find(&stats).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	if len(stats) == 0 {
 | 
						|
		return nil, domain.ErrNotFound
 | 
						|
	}
 | 
						|
 | 
						|
	stat := stats[0]
 | 
						|
 | 
						|
	return &stat, nil
 | 
						|
}
 | 
						|
 | 
						|
// FindInterfaces returns all interfaces that match the given search string.
 | 
						|
// The search string is matched against the interface identifier and display name.
 | 
						|
func (r *SqlRepo) FindInterfaces(ctx context.Context, search string) ([]domain.Interface, error) {
 | 
						|
	var users []domain.Interface
 | 
						|
 | 
						|
	searchValue := "%" + strings.ToLower(search) + "%"
 | 
						|
	err := r.db.WithContext(ctx).
 | 
						|
		Where("identifier LIKE ?", searchValue).
 | 
						|
		Or("display_name LIKE ?", searchValue).
 | 
						|
		Preload("Addresses").
 | 
						|
		Find(&users).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return users, nil
 | 
						|
}
 | 
						|
 | 
						|
// SaveInterface updates the interface with the given id.
 | 
						|
func (r *SqlRepo) SaveInterface(
 | 
						|
	ctx context.Context,
 | 
						|
	id domain.InterfaceIdentifier,
 | 
						|
	updateFunc func(in *domain.Interface) (*domain.Interface, error),
 | 
						|
) error {
 | 
						|
	userInfo := domain.GetUserInfo(ctx)
 | 
						|
	err := r.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
 | 
						|
		in, err := r.getOrCreateInterface(userInfo, tx, id)
 | 
						|
		if err != nil {
 | 
						|
			return err // return any error will roll back
 | 
						|
		}
 | 
						|
 | 
						|
		in, err = updateFunc(in)
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		err = r.upsertInterface(userInfo, tx, in)
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		// return nil will commit the whole transaction
 | 
						|
		return nil
 | 
						|
	})
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
func (r *SqlRepo) getOrCreateInterface(
 | 
						|
	ui *domain.ContextUserInfo,
 | 
						|
	tx *gorm.DB,
 | 
						|
	id domain.InterfaceIdentifier,
 | 
						|
) (*domain.Interface, error) {
 | 
						|
	var in domain.Interface
 | 
						|
 | 
						|
	// interfaceDefaults will be applied to newly created interface records
 | 
						|
	interfaceDefaults := domain.Interface{
 | 
						|
		BaseModel: domain.BaseModel{
 | 
						|
			CreatedBy: ui.UserId(),
 | 
						|
			UpdatedBy: ui.UserId(),
 | 
						|
			CreatedAt: time.Now(),
 | 
						|
			UpdatedAt: time.Now(),
 | 
						|
		},
 | 
						|
		Identifier: id,
 | 
						|
	}
 | 
						|
 | 
						|
	err := tx.Attrs(interfaceDefaults).FirstOrCreate(&in, id).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return &in, nil
 | 
						|
}
 | 
						|
 | 
						|
func (r *SqlRepo) upsertInterface(ui *domain.ContextUserInfo, tx *gorm.DB, in *domain.Interface) error {
 | 
						|
	in.UpdatedBy = ui.UserId()
 | 
						|
	in.UpdatedAt = time.Now()
 | 
						|
 | 
						|
	err := tx.Save(in).Error
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	err = tx.Model(in).Association("Addresses").Replace(in.Addresses)
 | 
						|
	if err != nil {
 | 
						|
		return fmt.Errorf("failed to update interface addresses: %w", err)
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// DeleteInterface deletes the interface with the given id.
 | 
						|
func (r *SqlRepo) DeleteInterface(ctx context.Context, id domain.InterfaceIdentifier) error {
 | 
						|
	err := r.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
 | 
						|
		err := tx.Where("interface_identifier = ?", id).Delete(&domain.Peer{}).Error
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		err = tx.Delete(&domain.InterfaceStatus{InterfaceId: id}).Error
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		err = tx.Select(clause.Associations).Delete(&domain.Interface{Identifier: id}).Error
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		return nil
 | 
						|
	})
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// GetInterfaceIps returns a map of interface identifiers to their respective IP addresses.
 | 
						|
func (r *SqlRepo) GetInterfaceIps(ctx context.Context) (map[domain.InterfaceIdentifier][]domain.Cidr, error) {
 | 
						|
	var ips []struct {
 | 
						|
		domain.Cidr
 | 
						|
		InterfaceId domain.InterfaceIdentifier `gorm:"column:interface_identifier"`
 | 
						|
	}
 | 
						|
 | 
						|
	err := r.db.WithContext(ctx).
 | 
						|
		Table("interface_addresses").
 | 
						|
		Joins("LEFT JOIN cidrs ON interface_addresses.cidr_cidr = cidrs.cidr").
 | 
						|
		Scan(&ips).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	result := make(map[domain.InterfaceIdentifier][]domain.Cidr)
 | 
						|
	for _, ip := range ips {
 | 
						|
		result[ip.InterfaceId] = append(result[ip.InterfaceId], ip.Cidr)
 | 
						|
	}
 | 
						|
	return result, nil
 | 
						|
}
 | 
						|
 | 
						|
// endregion interfaces
 | 
						|
 | 
						|
// region peers
 | 
						|
 | 
						|
// GetPeer returns the peer with the given id.
 | 
						|
// If no peer is found, an error domain.ErrNotFound is returned.
 | 
						|
func (r *SqlRepo) GetPeer(ctx context.Context, id domain.PeerIdentifier) (*domain.Peer, error) {
 | 
						|
	var peer domain.Peer
 | 
						|
 | 
						|
	err := r.db.WithContext(ctx).Preload("Addresses").First(&peer, id).Error
 | 
						|
 | 
						|
	if err != nil && errors.Is(err, gorm.ErrRecordNotFound) {
 | 
						|
		return nil, domain.ErrNotFound
 | 
						|
	}
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return &peer, nil
 | 
						|
}
 | 
						|
 | 
						|
// GetInterfacePeers returns all peers associated with the given interface id.
 | 
						|
func (r *SqlRepo) GetInterfacePeers(ctx context.Context, id domain.InterfaceIdentifier) ([]domain.Peer, error) {
 | 
						|
	var peers []domain.Peer
 | 
						|
 | 
						|
	err := r.db.WithContext(ctx).Preload("Addresses").Where("interface_identifier = ?", id).Find(&peers).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return peers, nil
 | 
						|
}
 | 
						|
 | 
						|
// FindInterfacePeers returns all peers associated with the given interface id that match the given search string.
 | 
						|
// The search string is matched against the peer identifier, display name and IP address.
 | 
						|
func (r *SqlRepo) FindInterfacePeers(ctx context.Context, id domain.InterfaceIdentifier, search string) (
 | 
						|
	[]domain.Peer,
 | 
						|
	error,
 | 
						|
) {
 | 
						|
	var peers []domain.Peer
 | 
						|
 | 
						|
	searchValue := "%" + strings.ToLower(search) + "%"
 | 
						|
	err := r.db.WithContext(ctx).Where("interface_identifier = ?", id).
 | 
						|
		Where("identifier LIKE ?", searchValue).
 | 
						|
		Or("display_name LIKE ?", searchValue).
 | 
						|
		Or("iface_address_str_v LIKE ?", searchValue).
 | 
						|
		Find(&peers).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return peers, nil
 | 
						|
}
 | 
						|
 | 
						|
// GetUserPeers returns all peers associated with the given user id.
 | 
						|
func (r *SqlRepo) GetUserPeers(ctx context.Context, id domain.UserIdentifier) ([]domain.Peer, error) {
 | 
						|
	var peers []domain.Peer
 | 
						|
 | 
						|
	err := r.db.WithContext(ctx).Preload("Addresses").Where("user_identifier = ?", id).Find(&peers).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return peers, nil
 | 
						|
}
 | 
						|
 | 
						|
// FindUserPeers returns all peers associated with the given user id that match the given search string.
 | 
						|
// The search string is matched against the peer identifier, display name and IP address.
 | 
						|
func (r *SqlRepo) FindUserPeers(ctx context.Context, id domain.UserIdentifier, search string) ([]domain.Peer, error) {
 | 
						|
	var peers []domain.Peer
 | 
						|
 | 
						|
	searchValue := "%" + strings.ToLower(search) + "%"
 | 
						|
	err := r.db.WithContext(ctx).Where("user_identifier = ?", id).
 | 
						|
		Where("identifier LIKE ?", searchValue).
 | 
						|
		Or("display_name LIKE ?", searchValue).
 | 
						|
		Or("iface_address_str_v LIKE ?", searchValue).
 | 
						|
		Find(&peers).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return peers, nil
 | 
						|
}
 | 
						|
 | 
						|
// SavePeer updates the peer with the given id.
 | 
						|
// If no existing peer is found, a new peer is created.
 | 
						|
func (r *SqlRepo) SavePeer(
 | 
						|
	ctx context.Context,
 | 
						|
	id domain.PeerIdentifier,
 | 
						|
	updateFunc func(in *domain.Peer) (*domain.Peer, error),
 | 
						|
) error {
 | 
						|
	userInfo := domain.GetUserInfo(ctx)
 | 
						|
	err := r.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
 | 
						|
		peer, err := r.getOrCreatePeer(userInfo, tx, id)
 | 
						|
		if err != nil {
 | 
						|
			return err // return any error will roll back
 | 
						|
		}
 | 
						|
 | 
						|
		peer, err = updateFunc(peer)
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		err = r.upsertPeer(userInfo, tx, peer)
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		// return nil will commit the whole transaction
 | 
						|
		return nil
 | 
						|
	})
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
func (r *SqlRepo) getOrCreatePeer(ui *domain.ContextUserInfo, tx *gorm.DB, id domain.PeerIdentifier) (
 | 
						|
	*domain.Peer,
 | 
						|
	error,
 | 
						|
) {
 | 
						|
	var peer domain.Peer
 | 
						|
 | 
						|
	// interfaceDefaults will be applied to newly created interface records
 | 
						|
	interfaceDefaults := domain.Peer{
 | 
						|
		BaseModel: domain.BaseModel{
 | 
						|
			CreatedBy: ui.UserId(),
 | 
						|
			UpdatedBy: ui.UserId(),
 | 
						|
			CreatedAt: time.Now(),
 | 
						|
			UpdatedAt: time.Now(),
 | 
						|
		},
 | 
						|
		Identifier: id,
 | 
						|
	}
 | 
						|
 | 
						|
	err := tx.Attrs(interfaceDefaults).FirstOrCreate(&peer, id).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return &peer, nil
 | 
						|
}
 | 
						|
 | 
						|
func (r *SqlRepo) upsertPeer(ui *domain.ContextUserInfo, tx *gorm.DB, peer *domain.Peer) error {
 | 
						|
	peer.UpdatedBy = ui.UserId()
 | 
						|
	peer.UpdatedAt = time.Now()
 | 
						|
 | 
						|
	err := tx.Save(peer).Error
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	err = tx.Model(peer).Association("Addresses").Replace(peer.Interface.Addresses)
 | 
						|
	if err != nil {
 | 
						|
		return fmt.Errorf("failed to update peer addresses: %w", err)
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// DeletePeer deletes the peer with the given id.
 | 
						|
func (r *SqlRepo) DeletePeer(ctx context.Context, id domain.PeerIdentifier) error {
 | 
						|
	err := r.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
 | 
						|
		err := tx.Delete(&domain.PeerStatus{PeerId: id}).Error
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		err = tx.Select(clause.Associations).Delete(&domain.Peer{Identifier: id}).Error
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		return nil
 | 
						|
	})
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// GetPeerIps returns a map of peer identifiers to their respective IP addresses.
 | 
						|
func (r *SqlRepo) GetPeerIps(ctx context.Context) (map[domain.PeerIdentifier][]domain.Cidr, error) {
 | 
						|
	var ips []struct {
 | 
						|
		domain.Cidr
 | 
						|
		PeerId domain.PeerIdentifier `gorm:"column:peer_identifier"`
 | 
						|
	}
 | 
						|
 | 
						|
	err := r.db.WithContext(ctx).
 | 
						|
		Table("peer_addresses").
 | 
						|
		Joins("LEFT JOIN cidrs ON peer_addresses.cidr_cidr = cidrs.cidr").
 | 
						|
		Scan(&ips).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	result := make(map[domain.PeerIdentifier][]domain.Cidr)
 | 
						|
	for _, ip := range ips {
 | 
						|
		result[ip.PeerId] = append(result[ip.PeerId], ip.Cidr)
 | 
						|
	}
 | 
						|
	return result, nil
 | 
						|
}
 | 
						|
 | 
						|
// GetUsedIpsPerSubnet returns a map of subnets to their respective used IP addresses.
 | 
						|
func (r *SqlRepo) GetUsedIpsPerSubnet(ctx context.Context, subnets []domain.Cidr) (
 | 
						|
	map[domain.Cidr][]domain.Cidr,
 | 
						|
	error,
 | 
						|
) {
 | 
						|
	var peerIps []struct {
 | 
						|
		domain.Cidr
 | 
						|
		PeerId domain.PeerIdentifier `gorm:"column:peer_identifier"`
 | 
						|
	}
 | 
						|
 | 
						|
	err := r.db.WithContext(ctx).
 | 
						|
		Table("peer_addresses").
 | 
						|
		Joins("LEFT JOIN cidrs ON peer_addresses.cidr_cidr = cidrs.cidr").
 | 
						|
		Scan(&peerIps).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, fmt.Errorf("failed to fetch peer IP's: %w", err)
 | 
						|
	}
 | 
						|
 | 
						|
	var interfaceIps []struct {
 | 
						|
		domain.Cidr
 | 
						|
		InterfaceId domain.InterfaceIdentifier `gorm:"column:interface_identifier"`
 | 
						|
	}
 | 
						|
 | 
						|
	err = r.db.WithContext(ctx).
 | 
						|
		Table("interface_addresses").
 | 
						|
		Joins("LEFT JOIN cidrs ON interface_addresses.cidr_cidr = cidrs.cidr").
 | 
						|
		Scan(&interfaceIps).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, fmt.Errorf("failed to fetch interface IP's: %w", err)
 | 
						|
	}
 | 
						|
 | 
						|
	result := make(map[domain.Cidr][]domain.Cidr, len(subnets))
 | 
						|
	for _, ip := range interfaceIps {
 | 
						|
		var subnet domain.Cidr // default empty subnet (if no subnet matches, we will add the IP to the empty subnet group)
 | 
						|
		for _, s := range subnets {
 | 
						|
			if s.Contains(ip.Cidr) {
 | 
						|
				subnet = s
 | 
						|
				break
 | 
						|
			}
 | 
						|
		}
 | 
						|
		result[subnet] = append(result[subnet], ip.Cidr)
 | 
						|
	}
 | 
						|
	for _, ip := range peerIps {
 | 
						|
		var subnet domain.Cidr // default empty subnet (if no subnet matches, we will add the IP to the empty subnet group)
 | 
						|
		for _, s := range subnets {
 | 
						|
			if s.Contains(ip.Cidr) {
 | 
						|
				subnet = s
 | 
						|
				break
 | 
						|
			}
 | 
						|
		}
 | 
						|
		result[subnet] = append(result[subnet], ip.Cidr)
 | 
						|
	}
 | 
						|
	return result, nil
 | 
						|
}
 | 
						|
 | 
						|
// endregion peers
 | 
						|
 | 
						|
// region users
 | 
						|
 | 
						|
// GetUser returns the user with the given id.
 | 
						|
// If no user is found, an error domain.ErrNotFound is returned.
 | 
						|
func (r *SqlRepo) GetUser(ctx context.Context, id domain.UserIdentifier) (*domain.User, error) {
 | 
						|
	var user domain.User
 | 
						|
 | 
						|
	err := r.db.WithContext(ctx).First(&user, id).Error
 | 
						|
 | 
						|
	if err != nil && errors.Is(err, gorm.ErrRecordNotFound) {
 | 
						|
		return nil, domain.ErrNotFound
 | 
						|
	}
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return &user, nil
 | 
						|
}
 | 
						|
 | 
						|
// GetUserByEmail returns the user with the given email.
 | 
						|
// If no user is found, an error domain.ErrNotFound is returned.
 | 
						|
// If multiple users are found, an error domain.ErrNotUnique is returned.
 | 
						|
func (r *SqlRepo) GetUserByEmail(ctx context.Context, email string) (*domain.User, error) {
 | 
						|
	var users []domain.User
 | 
						|
 | 
						|
	err := r.db.WithContext(ctx).Where("email = ?", email).Find(&users).Error
 | 
						|
	if err != nil && errors.Is(err, gorm.ErrRecordNotFound) {
 | 
						|
		return nil, domain.ErrNotFound
 | 
						|
	}
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	if len(users) == 0 {
 | 
						|
		return nil, domain.ErrNotFound
 | 
						|
	}
 | 
						|
 | 
						|
	if len(users) > 1 {
 | 
						|
		return nil, fmt.Errorf("found multiple users with email %s: %w", email, domain.ErrNotUnique)
 | 
						|
	}
 | 
						|
 | 
						|
	user := users[0]
 | 
						|
 | 
						|
	return &user, nil
 | 
						|
}
 | 
						|
 | 
						|
// GetAllUsers returns all users.
 | 
						|
func (r *SqlRepo) GetAllUsers(ctx context.Context) ([]domain.User, error) {
 | 
						|
	var users []domain.User
 | 
						|
 | 
						|
	err := r.db.WithContext(ctx).Find(&users).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return users, nil
 | 
						|
}
 | 
						|
 | 
						|
// FindUsers returns all users that match the given search string.
 | 
						|
// The search string is matched against the user identifier, firstname, lastname and email.
 | 
						|
func (r *SqlRepo) FindUsers(ctx context.Context, search string) ([]domain.User, error) {
 | 
						|
	var users []domain.User
 | 
						|
 | 
						|
	searchValue := "%" + strings.ToLower(search) + "%"
 | 
						|
	err := r.db.WithContext(ctx).
 | 
						|
		Where("identifier LIKE ?", searchValue).
 | 
						|
		Or("firstname LIKE ?", searchValue).
 | 
						|
		Or("lastname LIKE ?", searchValue).
 | 
						|
		Or("email LIKE ?", searchValue).
 | 
						|
		Find(&users).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return users, nil
 | 
						|
}
 | 
						|
 | 
						|
// SaveUser updates the user with the given id.
 | 
						|
// If no user is found, a new user is created.
 | 
						|
func (r *SqlRepo) SaveUser(
 | 
						|
	ctx context.Context,
 | 
						|
	id domain.UserIdentifier,
 | 
						|
	updateFunc func(u *domain.User) (*domain.User, error),
 | 
						|
) error {
 | 
						|
	userInfo := domain.GetUserInfo(ctx)
 | 
						|
 | 
						|
	err := r.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
 | 
						|
		user, err := r.getOrCreateUser(userInfo, tx, id)
 | 
						|
		if err != nil {
 | 
						|
			return err // return any error will roll back
 | 
						|
		}
 | 
						|
 | 
						|
		user, err = updateFunc(user)
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		err = r.upsertUser(userInfo, tx, user)
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		// return nil will commit the whole transaction
 | 
						|
		return nil
 | 
						|
	})
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// DeleteUser deletes the user with the given id.
 | 
						|
func (r *SqlRepo) DeleteUser(ctx context.Context, id domain.UserIdentifier) error {
 | 
						|
	err := r.db.WithContext(ctx).Delete(&domain.User{}, id).Error
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
func (r *SqlRepo) getOrCreateUser(ui *domain.ContextUserInfo, tx *gorm.DB, id domain.UserIdentifier) (
 | 
						|
	*domain.User,
 | 
						|
	error,
 | 
						|
) {
 | 
						|
	var user domain.User
 | 
						|
 | 
						|
	// userDefaults will be applied to newly created user records
 | 
						|
	userDefaults := domain.User{
 | 
						|
		BaseModel: domain.BaseModel{
 | 
						|
			CreatedBy: ui.UserId(),
 | 
						|
			UpdatedBy: ui.UserId(),
 | 
						|
			CreatedAt: time.Now(),
 | 
						|
			UpdatedAt: time.Now(),
 | 
						|
		},
 | 
						|
		Identifier: id,
 | 
						|
		Source:     domain.UserSourceDatabase,
 | 
						|
		IsAdmin:    false,
 | 
						|
	}
 | 
						|
 | 
						|
	err := tx.Attrs(userDefaults).FirstOrCreate(&user, id).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return &user, nil
 | 
						|
}
 | 
						|
 | 
						|
func (r *SqlRepo) upsertUser(ui *domain.ContextUserInfo, tx *gorm.DB, user *domain.User) error {
 | 
						|
	user.UpdatedBy = ui.UserId()
 | 
						|
	user.UpdatedAt = time.Now()
 | 
						|
 | 
						|
	err := tx.Save(user).Error
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// endregion users
 | 
						|
 | 
						|
// region statistics
 | 
						|
 | 
						|
// UpdateInterfaceStatus updates the interface status with the given id.
 | 
						|
// If no interface status is found, a new one is created.
 | 
						|
func (r *SqlRepo) UpdateInterfaceStatus(
 | 
						|
	ctx context.Context,
 | 
						|
	id domain.InterfaceIdentifier,
 | 
						|
	updateFunc func(in *domain.InterfaceStatus) (*domain.InterfaceStatus, error),
 | 
						|
) error {
 | 
						|
	err := r.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
 | 
						|
		in, err := r.getOrCreateInterfaceStatus(tx, id)
 | 
						|
		if err != nil {
 | 
						|
			return err // return any error will roll back
 | 
						|
		}
 | 
						|
 | 
						|
		in, err = updateFunc(in)
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		err = r.upsertInterfaceStatus(tx, in)
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		// return nil will commit the whole transaction
 | 
						|
		return nil
 | 
						|
	})
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
func (r *SqlRepo) getOrCreateInterfaceStatus(tx *gorm.DB, id domain.InterfaceIdentifier) (
 | 
						|
	*domain.InterfaceStatus,
 | 
						|
	error,
 | 
						|
) {
 | 
						|
	var in domain.InterfaceStatus
 | 
						|
 | 
						|
	// defaults will be applied to newly created record
 | 
						|
	defaults := domain.InterfaceStatus{
 | 
						|
		InterfaceId: id,
 | 
						|
		UpdatedAt:   time.Now(),
 | 
						|
	}
 | 
						|
 | 
						|
	err := tx.Attrs(defaults).FirstOrCreate(&in, id).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return &in, nil
 | 
						|
}
 | 
						|
 | 
						|
func (r *SqlRepo) upsertInterfaceStatus(tx *gorm.DB, in *domain.InterfaceStatus) error {
 | 
						|
	err := tx.Save(in).Error
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// UpdatePeerStatus updates the peer status with the given id.
 | 
						|
// If no peer status is found, a new one is created.
 | 
						|
func (r *SqlRepo) UpdatePeerStatus(
 | 
						|
	ctx context.Context,
 | 
						|
	id domain.PeerIdentifier,
 | 
						|
	updateFunc func(in *domain.PeerStatus) (*domain.PeerStatus, error),
 | 
						|
) error {
 | 
						|
	err := r.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
 | 
						|
		in, err := r.getOrCreatePeerStatus(tx, id)
 | 
						|
		if err != nil {
 | 
						|
			return err // return any error will roll back
 | 
						|
		}
 | 
						|
 | 
						|
		in, err = updateFunc(in)
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		err = r.upsertPeerStatus(tx, in)
 | 
						|
		if err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
 | 
						|
		// return nil will commit the whole transaction
 | 
						|
		return nil
 | 
						|
	})
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
func (r *SqlRepo) getOrCreatePeerStatus(tx *gorm.DB, id domain.PeerIdentifier) (*domain.PeerStatus, error) {
 | 
						|
	var in domain.PeerStatus
 | 
						|
 | 
						|
	// defaults will be applied to newly created record
 | 
						|
	defaults := domain.PeerStatus{
 | 
						|
		PeerId:    id,
 | 
						|
		UpdatedAt: time.Now(),
 | 
						|
	}
 | 
						|
 | 
						|
	err := tx.Attrs(defaults).FirstOrCreate(&in, id).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return &in, nil
 | 
						|
}
 | 
						|
 | 
						|
func (r *SqlRepo) upsertPeerStatus(tx *gorm.DB, in *domain.PeerStatus) error {
 | 
						|
	err := tx.Save(in).Error
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// DeletePeerStatus deletes the peer status with the given id.
 | 
						|
func (r *SqlRepo) DeletePeerStatus(ctx context.Context, id domain.PeerIdentifier) error {
 | 
						|
	err := r.db.WithContext(ctx).Delete(&domain.PeerStatus{}, id).Error
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// endregion statistics
 | 
						|
 | 
						|
// region audit
 | 
						|
 | 
						|
// SaveAuditEntry saves the given audit entry.
 | 
						|
func (r *SqlRepo) SaveAuditEntry(ctx context.Context, entry *domain.AuditEntry) error {
 | 
						|
	err := r.db.WithContext(ctx).Save(entry).Error
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// GetAllAuditEntries retrieves all audit entries from the database.
 | 
						|
// The entries are ordered by timestamp, with the newest entries first.
 | 
						|
func (r *SqlRepo) GetAllAuditEntries(ctx context.Context) ([]domain.AuditEntry, error) {
 | 
						|
	var entries []domain.AuditEntry
 | 
						|
	err := r.db.WithContext(ctx).Order("created_at desc").Find(&entries).Error
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return entries, nil
 | 
						|
}
 | 
						|
 | 
						|
// endregion audit
 |