shared

type BotReason struct {
	Pattern string `json:"pattern"` // the matched bot-page pattern (e.g. "sitemap.xml")
	Path    string `json:"path"`    // sample visitor paths
	Hits    int    `json:"hits"`    // how many times this pattern was hit
}

type BotReasonDisplay struct {
	Pattern string   `json:"pattern"`
	Hits    int      `json:"hits"`
	Paths   []string `json:"paths"`
}

type BotRecord struct {
	IP      string      `json:"ip"`
	AddedAt string      `json:"added_at"` // "YYYY-MM-DD HH:MM:SS" UTC
	Source  string      `json:"source"`   // "identified" or "manual"
	Reasons []BotReason `json:"reasons"`
}

type Breadcrumb struct {
	Name string
	URL  string
}

type ControllerOptions struct {
	// Store is the statsstore instance used for all visitor queries.
	Store statsstore.StoreInterface

	// Layout renders the full HTML page. Required.
	Layout LayoutInterface

	// HomeURL is the URL for the admin home page (e.g. "/admin").
	HomeURL string

	// WebsiteUrl is the public site URL.
	WebsiteUrl string

	// BaseURL is the base URL for the stats admin (e.g. "/admin/stats").
	// Replaces the old internal/links dependency.
	BaseURL string

	// CountryNameByIso2 maps an ISO2 code to a human-readable country name.
	// Optional; when nil, raw ISO2 codes are displayed.
	CountryNameByIso2 func(iso2Code string) (string, error)

	// AuthUserID returns the authenticated user ID from the request, or ""
	// when unauthenticated. When nil, auth checks are skipped.
	AuthUserID func(r *http.Request) string

	// FlashError renders a flash error message and returns the redirect
	// response body. When nil, controllers fall back to http.Redirect.
	FlashError func(w http.ResponseWriter, r *http.Request, message string, redirectURL string, delaySeconds int) string

	// Logger is used for internal logging. Defaults to slog.Default().
	Logger *slog.Logger
}

type CountEntry struct {
	Label string
	Count int64
}

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

type FakeLayout struct {
	Title      string
	Body       string
	Scripts    []string
	ScriptURLs []string
	Styles     []string
	StyleURLs  []string
}

type LayoutInterface interface {
	SetTitle(title string)
	SetScriptURLs(scripts []string)
	SetScripts(scripts []string)
	SetStyleURLs(styles []string)
	SetStyles(styles []string)
	SetBody(string)
	// SetCountryNameByIso2 provides country lookup helpers used by the admin UI.
	SetCountryNameByIso2(func(iso2Code string) (string, error))
	Render(w http.ResponseWriter, r *http.Request) string
}

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

type PeriodBounds struct {
	From  string // inclusive, "YYYY-MM-DD HH:MM:SS"
	To    string // inclusive
	Label string
}

type VisitorLike interface {
	GetPath() string
	GetCountry() string
	GetUserBrowser() string
	GetUserOs() string
	GetUserDeviceType() string
	GetIpAddress() string
	GetFingerprint() string
	GetCreatedAt() string
	GetBot() string
	GetThreat() string
}