handler

type APIKeyFormData struct {
	APIKey       *store.ApiKey
	Permissions  []string
	Errors       map[string]string
	FormValues   map[string]string
	IsEdit       bool
	GeneratedKey string // Only set after creation to show the key once
}

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

type APIKeysListData struct {
	APIKeys    []store.ApiKey
	TotalKeys  int64
	Pagination AdminPagination
}

type ActivityItem struct {
	ID        int64
	Level     string // info, warning, error
	Category  string // auth, page, user, config, system, cache
	Message   string
	UserName  string
	UserEmail string
	CreatedAt string
	TimeAgo   string
}

type AddFieldRequest struct {
	Type        string `json:"type"`
	Name        string `json:"name"`
	Label       string `json:"label"`
	Placeholder string `json:"placeholder"`
	HelpText    string `json:"help_text"`
	Options     string `json:"options"`
	Validation  string `json:"validation"`
	IsRequired  bool   `json:"is_required"`
}

type AddItemRequest struct {
	Title    string `json:"title"`
	URL      string `json:"url"`
	Target   string `json:"target"`
	PageID   *int64 `json:"page_id"`
	ParentID *int64 `json:"parent_id"`
	CSSClass string `json:"css_class"`
}

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

type AdminPagination struct {
	CurrentPage int
	TotalPages  int
	TotalItems  int64
	PerPage     int
	HasFirst    bool
	HasPrev     bool
	HasNext     bool
	HasLast     bool
	FirstPage   int
	PrevPage    int
	NextPage    int
	LastPage    int
	Pages       []AdminPaginationPage
	BaseURL     string
	QueryString string
}

type AdminPaginationPage struct {
	Number     int
	URL        string
	IsCurrent  bool
	IsEllipsis bool
}

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

type AuthorView struct {
	ID     int64
	Name   string
	Email  string
	Avatar string
	Bio    string
}

type BaseTemplateData struct {
	// SEO Meta
	Title           string
	MetaDescription string
	MetaKeywords    string
	Canonical       string
	FeaturedImage   string
	Robots          string      // Robots directive (index,follow / noindex,nofollow)
	OGImage         string      // Open Graph image (absolute URL)
	OGType          string      // Open Graph type (website, article)
	JSONLD          template.JS // JSON-LD structured data

	// Site info
	SiteName    string
	SiteURL     string
	SiteLogo    string
	SiteTagline string
	RequestURI  string
	CurrentPath string
	Year        int

	// Layout options
	BodyClass   string
	ShowSidebar bool

	// Page - set when rendering a single page (for Open Graph article type)
	Page *PageView

	// Site data
	Site SiteData

	// Theme settings - key-value pairs from theme configuration
	ThemeSettings map[string]string
	CustomCSS     string

	// Menus - MainMenu/FooterMenu for code, Navigation/FooterNav for templates
	MainMenu   []MenuItem
	FooterMenu []MenuItem
	Navigation []MenuItem
	FooterNav  []MenuItem

	// Footer
	FooterText    string
	CopyrightText string
	FooterWidgets []FooterWidget
	SocialLinks   []SocialLink

	// Search
	ShowSearch  bool
	SearchQuery string

	// Widgets - map of widget area ID to widgets
	Widgets map[string][]service.WidgetView

	// Language support
	CurrentLanguage    *LanguageView     // Current language for the request
	Languages          []LanguageView    // All active languages
	Translations       []TranslationLink // Available translations for current page
	HrefLangs          []HrefLangLink    // hreflang links for SEO
	LangCode           string            // Current language code (shortcut)
	LangDirection      string            // Current language direction (ltr/rtl)
	LangPrefix         string            // URL prefix for current language (e.g., "/ru" or "" for default)
	ShowLanguagePicker bool              // Whether to show language picker
}

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

type CacheStatsData struct {
	Caches      []cache.ManagerCacheStats
	TotalStats  cache.Stats
	Info        cache.ManagerInfo
	IsRedis     bool
	HealthError string // Non-empty if health check failed
}

type CategoriesListData struct {
	Categories []CategoryTreeNode
	TotalCount int64
}

type CategoryFormData struct {
	Category         *store.Category
	AllCategories    []CategoryTreeNode // For parent selector
	Errors           map[string]string
	FormValues       map[string]string
	IsEdit           bool
	Language         *store.Language           // Current category language
	AllLanguages     []store.Language          // All active languages for selection
	Translations     []CategoryTranslationInfo // Existing translations
	MissingLanguages []store.Language          // Languages without translations
}

type CategoryPageData struct {
	BaseTemplateData
	Category      CategoryView
	Pages         []PageView
	Pagination    Pagination
	PageCount     int
	Subcategories []SubcategoryView
	// Sidebar data for themes that show sidebar on category pages
	Categories  []CategoryView
	Tags        []TagView
	RecentPages []PageView
}

type CategoryTranslationInfo struct {
	Language store.Language
	Category store.Category
}

type CategoryTreeNode struct {
	Category     store.Category
	Children     []CategoryTreeNode
	Depth        int
	UsageCount   int64
	LanguageCode string
	LanguageName string
}

type CategoryView struct {
	ID          int64
	Name        string
	Slug        string
	Description string
	URL         string
	PageCount   int64
}

type Check struct {
	Status  string `json:"status"`
	Message string `json:"message,omitempty"`
	Latency string `json:"latency,omitempty"`
}

type ConfigFormData struct {
	Items                []ConfigItem             // Non-translatable items
	TranslatableItems    []TranslatableConfigItem // Translatable items with language tabs
	Languages            []ConfigLanguage         // Available languages for translation
	Errors               map[string]string
	HasMultipleLanguages bool
}

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

type ConfigItem struct {
	Key          string
	Value        string
	Type         string
	Description  string
	Label        string
	Translatable bool
}

type ConfigLanguage struct {
	ID        int64
	Code      string
	Name      string
	IsDefault bool
}

type ConfigTranslationValue struct {
	LanguageID   int64
	LanguageCode string
	LanguageName string
	Value        string
}

type ConflictStrategyOption struct {
	Value       string
	Label       string
	Description string
}

type CreateWidgetRequest struct {
	Theme      string `json:"theme"`
	Area       string `json:"area"`
	WidgetType string `json:"widget_type"`
	Title      string `json:"title"`
	Content    string `json:"content"`
	Settings   string `json:"settings"`
}

type DashboardData struct {
	Stats                  DashboardStats
	RecentSubmissions      []RecentSubmission
	WebhookHealth          []WebhookHealthItem
	RecentFailedDeliveries []RecentFailedDelivery
	TranslationCoverage    []TranslationCoverage
	RecentActivity         []ActivityItem
}

type DashboardStats struct {
	TotalPages        int64
	PublishedPages    int64
	DraftPages        int64
	TotalUsers        int64
	TotalMedia        int64
	TotalForms        int64
	UnreadSubmissions int64
	// Webhook stats
	TotalWebhooks       int64
	ActiveWebhooks      int64
	FailedDeliveries24h int64
	// Phase 4 additions
	TotalLanguages   int64
	ActiveLanguages  int64
	CacheHitRate     float64
	CacheHits        int64
	CacheMisses      int64
	CacheItems       int
	CacheBackendType string // "memory" or "redis"
}

type DocsEndpoint struct {
	Method      string
	Path        string
	Description string
	Auth        string
}

type DocsEndpointGroup struct {
	Name      string
	Endpoints []DocsEndpoint
}

type DocsGuide struct {
	Slug  string
	Title string
}

type DocsGuideData struct {
	Title   string
	Content template.HTML
}

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

type DocsPageData struct {
	System    DocsSystemInfo
	Endpoints []DocsEndpointGroup
	Guides    []DocsGuide
}

type DocsSystemInfo struct {
	Version        string
	GitCommit      string
	BuildTime      string
	GoVersion      string
	Environment    string
	ServerPort     int
	DBPath         string
	ActiveTheme    string
	CacheType      string
	EnabledModules int
	TotalModules   int
	Uptime         string
}

type EventWithUser struct {
	ID          int64
	Level       string
	Category    string
	Message     string
	Metadata    string
	Details     string // Formatted metadata as readable text
	DetailsLong bool   // True if details exceed display threshold
	CreatedAt   string
	UserName    string
	UserEmail   string
}

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

type EventsListData struct {
	Events      []EventWithUser
	TotalEvents int64
	Level       string
	Category    string
	Levels      []string
	Categories  []string
	Pagination  AdminPagination
}

type ExportFormData struct {
	PageStatuses []string
}

type FeaturedImageData struct {
	ID        int64
	Filename  string
	Filepath  string
	Thumbnail string
	Mimetype  string
}

type FooterWidget struct {
	Title   string
	Content template.HTML
}

type FormFormData struct {
	Form       *store.Form
	Fields     []store.FormField
	FieldTypes []string
	Errors     map[string]string
	FormValues map[string]string
	IsEdit     bool
}

type FormListItem struct {
	Form            store.Form
	SubmissionCount int64
	UnreadCount     int64
}

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

type FormsListData struct {
	Forms []FormListItem
}

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

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

type HealthStatus struct {
	Status    string           `json:"status"`
	Timestamp time.Time        `json:"timestamp"`
	Uptime    string           `json:"uptime"`
	Version   string           `json:"version"`
	Checks    map[string]Check `json:"checks"`
	System    *SystemInfo      `json:"system,omitempty"`
}

type HealthStatusPublic struct {
	Status string `json:"status"`
}

type HomeData struct {
	BaseTemplateData
	Page             *PageView
	FeaturedPages    []PageView
	RecentPages      []PageView
	Categories       []CategoryView
	Tags             []TagView
	RecentPosts      []RecentPost // For sidebar widget
	HeroEnabled      bool
	HeroTitle        string
	HeroSubtitle     string
	HeroCTA          string
	HeroCTAURL       string
	HeroImage        string
	ShowAllPostsLink bool
}

type HrefLangLink struct {
	Lang string // Language code (e.g., "en", "ru", "x-default")
	Href string // Full URL
}

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

type ImportFormData struct {
	ConflictStrategies []ConflictStrategyOption
	ValidationResult   *transfer.ValidationResult
	ImportResult       *transfer.ImportResult
	UploadedData       *transfer.ExportData
	IsZipFile          bool // Whether the uploaded file is a zip archive
	HasMediaFiles      bool // Whether the zip contains media files
}

type LanguageFormData struct {
	Language        *store.Language
	CommonLanguages []struct {
		Code       string
		Name       string
		NativeName string
		Direction  string
	}
	Errors     map[string]string
	FormValues map[string]string
	IsEdit     bool
}

type LanguageView struct {
	ID         int64
	Code       string
	Name       string
	NativeName string
	Direction  string
	IsDefault  bool
	IsCurrent  bool
}

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

type LanguagesListData struct {
	Languages      []store.Language
	TotalLanguages int64
}

type ListData struct {
	BaseTemplateData
	Pages       []PageView
	Pagination  Pagination
	Description string // Optional description for list pages (blog, archives, etc.)
	// Sidebar data for themes that show sidebar on list pages
	Categories  []CategoryView
	Tags        []TagView
	RecentPages []PageView
}

type MediaEditData struct {
	Media        MediaItem
	Variants     []store.MediaVariant
	Folders      []store.MediaFolder
	Languages    []store.Language                // All active languages (except default)
	Translations map[string]MediaTranslationData // Keyed by language code
	Errors       map[string]string
	FormValues   map[string]string
}

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

type MediaItem struct {
	store.Medium
	ThumbnailURL string
	OriginalURL  string
	IsImage      bool
	TypeIcon     string
}

type MediaLibraryData struct {
	Media      []MediaItem
	Folders    []store.MediaFolder
	TotalCount int64
	Filter     string // images, documents, videos, all
	FolderID   *int64
	Search     string
	Pagination AdminPagination
}

type MediaTranslationData struct {
	LanguageID   int64
	LanguageCode string
	LanguageName string
	NativeName   string
	Alt          string
	Caption      string
}

type MenuFormData struct {
	Menu       *store.Menu
	Items      []MenuItemNode
	Pages      []store.Page // Available pages to add
	Targets    []string
	Languages  []store.Language
	Errors     map[string]string
	FormValues map[string]string
	IsEdit     bool
}

type MenuItem struct {
	Title    string
	URL      string
	Target   string
	Children []MenuItem
	IsActive bool
}

type MenuItemNode struct {
	Item     store.MenuItem
	Children []MenuItemNode
	PageSlug string // If linked to a page
}

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

type MenusListData struct {
	Menus     []store.Menu
	Languages []store.Language
}

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

type ModulesListData struct {
	Modules []module.Info
	Hooks   []module.HookInfo
}

type MoveWidgetRequest struct {
	Area string `json:"area"`
}

type NotFoundData struct {
	BaseTemplateData
	SuggestedPages []PageView
}

type PageCategoryNode struct {
	Category store.Category
	Depth    int
}

type PageData struct {
	BaseTemplateData
	Page          *PageView
	RelatedPages  []PageView
	ShowAuthorBox bool
	// Sidebar data for themes that show sidebar on single pages
	Categories  []CategoryView
	Tags        []TagView
	RecentPages []PageView
}

type PageFormData struct {
	Page          *store.Page
	Tags          []store.Tag
	Categories    []store.Category   // Selected categories for the page
	AllCategories []PageCategoryNode // All categories for selection (with tree structure)
	FeaturedImage *FeaturedImageData
	Aliases       []store.PageAlias // URL aliases for the page
	Statuses      []string
	Errors        map[string]string
	FormValues    map[string]string
	IsEdit        bool
	// Language and translation support
	Language         *store.Language       // Current page language
	AllLanguages     []store.Language      // All active languages for selection
	Translations     []PageTranslationInfo // Existing translations
	MissingLanguages []store.Language      // Languages without translations
}

type PageTranslationInfo struct {
	Language store.Language
	Page     store.Page
}

type PageVersionsData struct {
	Page       store.Page
	Versions   []store.ListPageVersionsWithUserRow
	TotalCount int64
	Pagination AdminPagination
}

type PageView struct {
	ID                   int64
	Title                string
	Slug                 string
	Body                 template.HTML
	Excerpt              string
	URL                  string
	Status               string
	Type                 string // "page", "post", etc.
	PublishedAt          *time.Time
	PublishedAtFormatted string
	CreatedAt            time.Time
	UpdatedAt            time.Time
	FeaturedImage        string
	FeaturedImageMedium  string // Medium variant for mobile grid views
	FeaturedImageLarge   string // Large variant for single page views
	FeaturedImageID      int64  // Media ID for translation lookup
	FeaturedImageAlt     string // Alt text (default language)
	HideFeaturedImage    bool   // Show image below title instead of hero banner
	ReadingTime          int    // Estimated reading time in minutes
	Highlight            string // Search result highlight
	Author               *AuthorView
	Category             *CategoryView
	Categories           []CategoryView
	Tags                 []TagView
	// SEO fields
	MetaTitle       string
	MetaDescription string
	MetaKeywords    string
	OGImage         string
	NoIndex         bool
	NoFollow        bool
	CanonicalURL    string
}

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

type PagesListData struct {
	Pages              []store.Page
	PageTags           map[int64][]store.Tag        // Map of page ID to tags
	PageCategories     map[int64][]store.Category   // Map of page ID to categories
	PageFeaturedImages map[int64]*FeaturedImageData // Map of page ID to featured image
	PageLanguages      map[int64]*store.Language    // Map of page ID to language
	TotalCount         int64
	StatusFilter       string
	CategoryFilter     int64
	LanguageFilter     string             // Language code filter
	SearchFilter       string             // Search query filter
	AllCategories      []PageCategoryNode // For category filter dropdown
	AllLanguages       []store.Language   // All active languages for filter dropdown
	Statuses           []string
	Pagination         AdminPagination
}

type Pagination struct {
	CurrentPage int
	TotalPages  int
	TotalItems  int64
	PerPage     int
	HasPrev     bool
	HasNext     bool
	HasFirst    bool
	HasLast     bool
	PrevURL     string
	NextURL     string
	FirstURL    string
	LastURL     string
	Pages       []PaginationPage
}

type PaginationPage struct {
	Number     int
	URL        string
	IsCurrent  bool
	IsEllipsis bool
}

type PublicFormData struct {
	Form      store.Form
	Fields    []store.FormField
	Errors    map[string]string
	Values    map[string]string
	Success   bool
	CSRFToken string
	SiteName  string
}

type RecentFailedDelivery struct {
	ID          int64
	WebhookID   int64
	WebhookName string
	Event       string
	Status      string
	CreatedAt   string
}

type RecentPost struct {
	URL   string
	Title string
	Date  string
}

type RecentSubmission struct {
	ID        int64
	FormID    int64
	FormName  string
	FormSlug  string
	IsRead    bool
	CreatedAt string
}

type ReorderFieldsRequest struct {
	FieldIDs []int64 `json:"field_ids"`
}

type ReorderItem struct {
	ID       int64         `json:"id"`
	ParentID *int64        `json:"parent_id"`
	Children []ReorderItem `json:"children"`
}

type ReorderRequest struct {
	Items []ReorderItem `json:"items"`
}

type ReorderWidgetsRequest struct {
	Widgets []struct {
		ID       int64 `json:"id"`
		Position int64 `json:"position"`
	} `json:"widgets"`
}

type SearchData struct {
	BaseTemplateData
	Query           string
	Pages           []PageView
	Pagination      Pagination
	ResultCount     int
	PopularSearches []string
	// Sidebar data for themes that show sidebar on search page
	Categories  []CategoryView
	Tags        []TagView
	RecentPages []PageView
}

type SiteData struct {
	SiteName       string
	Description    string
	URL            string
	DefaultOGImage string
	Theme          *theme.Config
	Settings       map[string]string
	CurrentYear    int
}

type SlugExistsChecker func(slug string) (int64, error)

type SlugExistsFunc func() (int64, error)

type SocialLink struct {
	Name string
	URL  string
	Icon template.HTML
}

type SubcategoryView struct {
	ID          int64
	Name        string
	Slug        string
	Description string
	URL         string
	Count       int64
}

type SubmissionListItem struct {
	Submission store.FormSubmission
	Data       map[string]interface{}
	Preview    string
}

type SubmissionViewData struct {
	Form       store.Form
	Fields     []store.FormField
	Submission store.FormSubmission
	Data       map[string]interface{}
}

type SubmissionsListData struct {
	Form        store.Form
	Fields      []store.FormField
	Submissions []SubmissionListItem
	TotalCount  int64
	UnreadCount int64
	Pagination  AdminPagination
}

type SystemInfo struct {
	GoVersion    string `json:"go_version"`
	NumGoroutine int    `json:"num_goroutines"`
	NumCPU       int    `json:"num_cpus"`
	MemAlloc     string `json:"mem_alloc"`
	MemSys       string `json:"mem_sys"`
}

type TagFormData struct {
	Tag              *store.Tag
	Errors           map[string]string
	FormValues       map[string]string
	IsEdit           bool
	Language         *store.Language      // Current tag language
	AllLanguages     []store.Language     // All active languages for selection
	Translations     []TagTranslationInfo // Existing translations
	MissingLanguages []store.Language     // Languages without translations
}

type TagPageData struct {
	BaseTemplateData
	Tag         TagView
	Pages       []PageView
	Pagination  Pagination
	PageCount   int
	RelatedTags []TagView
	// Sidebar data for themes that show sidebar on tag pages
	Categories  []CategoryView
	Tags        []TagView
	RecentPages []PageView
}

type TagTranslationInfo struct {
	Language store.Language
	Tag      store.Tag
}

type TagView struct {
	ID          int64
	Name        string
	Slug        string
	Description string
	URL         string
	PageCount   int64
}

type TagsListData struct {
	Tags       []store.GetTagUsageCountsRow
	TotalCount int64
	Pagination AdminPagination
}

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

type ThemeListData struct {
	Themes []theme.Info
}

type ThemeSettingsData struct {
	Theme    theme.Info
	Settings map[string]string
	Errors   map[string]string
}

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

type ToggleActiveRequest struct {
	Active bool `json:"active"`
}

type ToggleActiveResponse struct {
	Success bool   `json:"success"`
	Active  bool   `json:"active"`
	Message string `json:"message,omitempty"`
}

type ToggleSidebarRequest struct {
	Show bool `json:"show"`
}

type ToggleSidebarResponse struct {
	Success bool   `json:"success"`
	Show    bool   `json:"show"`
	Message string `json:"message,omitempty"`
}

type TranslatableConfigItem struct {
	Key          string
	Label        string
	Description  string
	Type         string
	Translations []ConfigTranslationValue // Values per language (includes default lang)
}

type TranslationCoverage struct {
	LanguageID   int64
	LanguageCode string
	LanguageName string
	TotalPages   int64
	IsDefault    bool
}

type TranslationLink struct {
	Language  LanguageView
	URL       string // Full URL to the translated page
	PageTitle string // Title of the translated page
	HasPage   bool   // Whether a translation exists for this language
}

type UpdateFieldRequest struct {
	Type        string `json:"type"`
	Name        string `json:"name"`
	Label       string `json:"label"`
	Placeholder string `json:"placeholder"`
	HelpText    string `json:"help_text"`
	Options     string `json:"options"`
	Validation  string `json:"validation"`
	IsRequired  bool   `json:"is_required"`
}

type UpdateItemRequest struct {
	Title    string `json:"title"`
	URL      string `json:"url"`
	Target   string `json:"target"`
	PageID   *int64 `json:"page_id"`
	ParentID *int64 `json:"parent_id"`
	CSSClass string `json:"css_class"`
	IsActive bool   `json:"is_active"`
}

type UpdateWidgetRequest struct {
	WidgetType string `json:"widget_type"`
	Title      string `json:"title"`
	Content    string `json:"content"`
	Settings   string `json:"settings"`
	IsActive   bool   `json:"is_active"`
}

type UploadFormData struct {
	Folders    []store.MediaFolder
	MaxSize    int64
	AllowedExt string
}

type UserFormData struct {
	User       *store.User
	Roles      []string
	Errors     map[string]string
	FormValues map[string]string
	IsEdit     bool
}

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

type UsersListData struct {
	Users         []store.User
	CurrentUserID int64
	TotalUsers    int64
	Pagination    AdminPagination
}

type WebhookDeliveriesData struct {
	Webhook    store.Webhook
	Deliveries []store.WebhookDelivery
	TotalCount int64
	Pagination AdminPagination
}

type WebhookFormData struct {
	Webhook     *store.Webhook
	Events      []model.WebhookEventInfo
	Errors      map[string]string
	FormValues  map[string]string
	FormEvents  []string
	FormHeaders map[string]string
	IsEdit      bool
}

type WebhookHealthItem struct {
	ID           int64
	Name         string
	IsActive     bool
	HealthStatus string // "green", "yellow", "red", "unknown"
	SuccessRate  float64
}

type WebhookWithStats struct {
	store.Webhook
	Events              []string
	TotalDelivered      int64
	TotalPending        int64
	TotalDead           int64
	SuccessRate         float64
	HealthStatus        string // "green", "yellow", "red", "unknown"
	Last24hDelivered    int64
	Last24hTotal        int64
	LastSuccessfulAt    *time.Time // nil if never delivered
	LastSuccessfulEvent string     // event type of last successful delivery
}

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

type WebhooksListData struct {
	Webhooks      []WebhookWithStats
	TotalWebhooks int64
}

type WidgetAreaWithWidgets struct {
	Area    theme.WidgetArea
	Widgets []store.Widget
}

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

type WidgetsListData struct {
	Theme       *theme.Theme
	WidgetAreas []WidgetAreaWithWidgets
	WidgetTypes []struct {
		ID          string
		Name        string
		Description string
	}
	AllThemes []theme.Info
}