api

Documentation

Index

• Variables
• func LoginRateLimitMiddleware(limiter *RateLimiter) gin.HandlerFunc
• type RateLimiter
  • func NewRateLimiter(limit int, window time.Duration) *RateLimiter
  • func (rl *RateLimiter) Allow(ip string) bool
• type ReleaseAsset
• type ReleasesResponse
• type Server
  • func NewServer(db *storage.DB, mon *monitor.Service, distFS fs.FS) *Server
  • func (s *Server) Run(addr string) error
• type SystemInfoResponse
• type UpdateCheckResponse

Variables

var (
	Version   = "dev"
	Commit    = "unknown"
	BuildDate = "unknown"
)

Version information (set via ldflags)

Functions

func LoginRateLimitMiddleware

func LoginRateLimitMiddleware(limiter *RateLimiter) gin.HandlerFunc

LoginRateLimitMiddleware returns a Gin middleware that rate limits login attempts Limit: 5 attempts per IP per minute

Types

type RateLimiter

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

RateLimiter implements a simple in-memory rate limiter based on IP address Uses a sliding window approach with automatic cleanup

func NewRateLimiter

func NewRateLimiter(limit int, window time.Duration) *RateLimiter

NewRateLimiter creates a new rate limiter limit: maximum number of attempts allowed window: time window for the limit (e.g., 1 minute)

func (*RateLimiter) Allow

func (rl *RateLimiter) Allow(ip string) bool

Allow checks if a request from the given IP should be allowed Returns true if within rate limit, false if exceeded

type ReleaseAsset

type ReleaseAsset struct {
	Name        string `json:"name"`
	DownloadURL string `json:"download_url"`
	Size        int64  `json:"size"`
}

ReleaseAsset represents a downloadable release asset

type ReleasesResponse

type ReleasesResponse struct {
	TagName     string         `json:"tag_name"`
	PublishedAt string         `json:"published_at"`
	Assets      []ReleaseAsset `json:"assets"`
}

ReleasesResponse represents the latest release info with assets

type Server

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

func NewServer

func NewServer(db *storage.DB, mon *monitor.Service, distFS fs.FS) *Server

func (*Server) Run

func (s *Server) Run(addr string) error

type SystemInfoResponse

type SystemInfoResponse struct {
	Version   string `json:"version"`
	Commit    string `json:"commit"`
	BuildDate string `json:"build_date"`
	GoVersion string `json:"go_version"`
	OS        string `json:"os"`
	Arch      string `json:"arch"`
}

SystemInfoResponse represents system information

type UpdateCheckResponse

type UpdateCheckResponse struct {
	HasUpdate      bool   `json:"has_update"`
	CurrentVersion string `json:"current_version"`
	LatestVersion  string `json:"latest_version,omitempty"`
	ReleaseNotes   string `json:"release_notes,omitempty"`
	ReleaseURL     string `json:"release_url,omitempty"`
	PublishedAt    string `json:"published_at,omitempty"`
}

UpdateCheckResponse represents the update check result