mirror of
https://github.com/Mezeporta/Erupe.git
synced 2026-03-21 23:22:34 +01:00
7ff26f4980
Introduces incremental API improvements for custom launcher support (mhf-iel, stratic-dev's Rust launcher): - Standardize all error responses to JSON envelopes with error/message - Add Bearer token auth middleware for v2 routes (legacy body-token preserved) - Add `returning` (>90d inactive) and `courses` fields to auth response - Add /v2/ route prefix with HTTP method enforcement - Add GET /v2/server/status for MezFes, featured weapon, and event status - Add APIEventRepo for read-only event data access Closes #44
74 lines
3.2 KiB
Go
74 lines
3.2 KiB
Go
package api
|
|
|
|
import (
|
|
"context"
|
|
"time"
|
|
)
|
|
|
|
// Repository interfaces decouple API server business logic from concrete
|
|
// PostgreSQL implementations, enabling mock/stub injection for unit tests.
|
|
|
|
// APIUserRepo defines the contract for user-related data access.
|
|
type APIUserRepo interface {
|
|
// Register creates a new user and returns their ID and rights.
|
|
Register(ctx context.Context, username, passwordHash string, returnExpires time.Time) (id uint32, rights uint32, err error)
|
|
// GetCredentials returns the user's ID, password hash, and rights.
|
|
GetCredentials(ctx context.Context, username string) (id uint32, passwordHash string, rights uint32, err error)
|
|
// GetLastLogin returns the user's last login time.
|
|
GetLastLogin(uid uint32) (time.Time, error)
|
|
// GetReturnExpiry returns the user's return expiry time.
|
|
GetReturnExpiry(uid uint32) (time.Time, error)
|
|
// UpdateReturnExpiry sets the user's return expiry time.
|
|
UpdateReturnExpiry(uid uint32, expiry time.Time) error
|
|
// UpdateLastLogin sets the user's last login time.
|
|
UpdateLastLogin(uid uint32, loginTime time.Time) error
|
|
}
|
|
|
|
// APICharacterRepo defines the contract for character-related data access.
|
|
type APICharacterRepo interface {
|
|
// GetNewCharacter returns an existing new (unfinished) character for a user.
|
|
GetNewCharacter(ctx context.Context, userID uint32) (Character, error)
|
|
// CountForUser returns the total number of characters for a user.
|
|
CountForUser(ctx context.Context, userID uint32) (int, error)
|
|
// Create inserts a new character and returns it.
|
|
Create(ctx context.Context, userID uint32, lastLogin uint32) (Character, error)
|
|
// IsNew returns whether a character is a new (unfinished) character.
|
|
IsNew(charID uint32) (bool, error)
|
|
// HardDelete permanently removes a character.
|
|
HardDelete(charID uint32) error
|
|
// SoftDelete marks a character as deleted.
|
|
SoftDelete(charID uint32) error
|
|
// GetForUser returns all finalized (non-deleted) characters for a user.
|
|
GetForUser(ctx context.Context, userID uint32) ([]Character, error)
|
|
// ExportSave returns the full character row as a map.
|
|
ExportSave(ctx context.Context, userID, charID uint32) (map[string]interface{}, error)
|
|
}
|
|
|
|
// APIEventRepo defines the contract for read-only event data access.
|
|
type APIEventRepo interface {
|
|
// GetFeatureWeapon returns the feature weapon entry for the given week start time.
|
|
GetFeatureWeapon(ctx context.Context, startTime time.Time) (*FeatureWeaponRow, error)
|
|
// GetActiveEvents returns all events of the given type.
|
|
GetActiveEvents(ctx context.Context, eventType string) ([]EventRow, error)
|
|
}
|
|
|
|
// FeatureWeaponRow holds a single feature_weapon table row.
|
|
type FeatureWeaponRow struct {
|
|
StartTime time.Time `db:"start_time"`
|
|
ActiveFeatures uint32 `db:"featured"`
|
|
}
|
|
|
|
// EventRow holds a single events table row with epoch start time.
|
|
type EventRow struct {
|
|
ID int `db:"id"`
|
|
StartTime int64 `db:"start_time"`
|
|
}
|
|
|
|
// APISessionRepo defines the contract for session/token data access.
|
|
type APISessionRepo interface {
|
|
// CreateToken inserts a new sign session and returns its ID and token.
|
|
CreateToken(ctx context.Context, uid uint32, token string) (tokenID uint32, err error)
|
|
// GetUserIDByToken returns the user ID for a given session token.
|
|
GetUserIDByToken(ctx context.Context, token string) (uint32, error)
|
|
}
|