controllers

type AddWidgetRequest struct {
	Title      string          `json:"title"`
	WidgetType string          `json:"widgetType" binding:"required"`
	Config     json.RawMessage `json:"config"`
}

type AiTraceDetailResponse struct {
	AiTrace      *models.AiTrace `json:"aiTrace"`
	Conversation json.RawMessage `json:"conversation,omitempty"`
}

type AiTraceInstancesRequest struct {
	FromDate      time.Time        `json:"fromDate"`
	ToDate        time.Time        `json:"toDate"`
	OrderBy       string           `json:"orderBy"`
	SortDirection string           `json:"sortDirection"`
	Pagination    PaginationParams `json:"pagination"`
}

type AiTraceInstancesResponse struct {
	Data       []models.AiTrace           `json:"data"`
	Stats      *models.AiTraceDetailStats `json:"stats"`
	Pagination Pagination                 `json:"pagination"`
}

type AiTraceSearchRequest struct {
	FromDate      time.Time        `json:"fromDate"`
	ToDate        time.Time        `json:"toDate"`
	OrderBy       string           `json:"orderBy"`
	SortDirection string           `json:"sortDirection"`
	Pagination    PaginationParams `json:"pagination"`
	Search        string           `json:"search"`
	RootFilter    string           `json:"rootFilter"`
}

type ApplicationMetricsResponse struct {
	Metrics          []models.DashboardMetric `json:"metrics"`
	AvailableServers []string                 `json:"availableServers"`
	LastUpdated      time.Time                `json:"lastUpdated"`
}

type ApplyDashboardRequest struct {
	ProjectIds []uuid.UUID `json:"projectIds" binding:"required"`
}

type ArchiveRequest struct {
	Hashes []string `json:"hashes"`
}

type CHError struct {
	Name          string `json:"name"`
	Value         int64  `json:"value"`
	LastErrorTime string `json:"lastErrorTime,omitempty"`
}

type CopyDashboardRequest struct {
	OrganizationId    *int        `json:"organizationId"`
	Name              string      `json:"name"`
	ApplyToProjectIds []uuid.UUID `json:"applyToProjectIds"`
}

type CreateDashboardRequest struct {
	OrganizationId    *int            `json:"organizationId"`
	Name              string          `json:"name"`
	Description       string          `json:"description"`
	Definition        json.RawMessage `json:"definition"`
	ApplyToProjectIds []uuid.UUID     `json:"applyToProjectIds"`
}

type CreateProjectRequest struct {
	Name           string `json:"name"`
	Framework      string `json:"framework" binding:"required"`
	OrganizationId *int   `json:"organizationId"`
}

type DashboardListItem struct {
	Id             int     `json:"id"`
	Name           string  `json:"name"`
	Description    string  `json:"description"`
	OrganizationId int     `json:"organizationId"`
	TemplateKey    *string `json:"templateKey"`
}

type DashboardOverviewResponse struct {
	RecentIssues   []models.ExceptionGroup `json:"recentIssues"`
	WorstEndpoints []models.EndpointStats  `json:"worstEndpoints"`
	HasData        bool                    `json:"hasData"`
}

type DashboardResponse struct {
	Id                int                       `json:"id"`
	OrganizationId    int                       `json:"organizationId"`
	Name              string                    `json:"name"`
	Description       string                    `json:"description"`
	TemplateKey       *string                   `json:"templateKey"`
	CreatedAt         time.Time                 `json:"createdAt"`
	UpdatedAt         time.Time                 `json:"updatedAt"`
	AppliedProjectIds []uuid.UUID               `json:"appliedProjectIds"`
	Widgets           []DashboardWidgetWithStar `json:"widgets"`
}

type DashboardTemplateListItem struct {
	Key         string `json:"key"`
	Name        string `json:"name"`
	Description string `json:"description"`
	Category    string `json:"category"`
	WidgetCount int    `json:"widgetCount"`
}

type DashboardWidgetWithStar struct {
	Id         string          `json:"id"`
	Title      string          `json:"title"`
	WidgetType string          `json:"widgetType"`
	Config     json.RawMessage `json:"config"`
	IsStarred  bool            `json:"isStarred"`
}

type DeleteProjectRequest struct {
	Name string `json:"name" binding:"required"`
}

type DiscoverResponse struct {
	Metrics []models.DiscoveredMetric `json:"metrics"`
}

type DistributedTraceNode struct {
	ProjectId   uuid.UUID              `json:"projectId"`
	ProjectName string                 `json:"projectName"`
	TraceType   string                 `json:"traceType"`
	Endpoint    *models.Endpoint       `json:"endpoint,omitempty"`
	Task        *models.Task           `json:"task,omitempty"`
	AiTrace     *models.AiTrace        `json:"aiTrace,omitempty"`
	Spans       []models.Span          `json:"spans"`
	Exception   *EndpointExceptionInfo `json:"exception,omitempty"`
}

type DistributedTraceResponse struct {
	DistributedTraceId string                 `json:"distributedTraceId"`
	Nodes              []DistributedTraceNode `json:"nodes"`
}

type EndpointDetailResponse struct {
	Endpoint  *models.Endpoint       `json:"endpoint"`
	Spans     []models.Span          `json:"spans"`
	HasSpans  bool                   `json:"hasSpans"`
	Exception *EndpointExceptionInfo `json:"exception,omitempty"`
	Messages  []EndpointMessageInfo  `json:"messages"`
}

type EndpointExceptionInfo struct {
	ExceptionHash string `json:"exceptionHash"`
	StackTrace    string `json:"stackTrace"`
	RecordedAt    string `json:"recordedAt"`
}

type EndpointInstancesRequest struct {
	FromDate      time.Time        `json:"fromDate"`
	ToDate        time.Time        `json:"toDate"`
	OrderBy       string           `json:"orderBy"`
	SortDirection string           `json:"sortDirection"`
	Pagination    PaginationParams `json:"pagination"`
}

type EndpointInstancesResponse struct {
	Data       []models.Endpoint           `json:"data"`
	Stats      *models.EndpointDetailStats `json:"stats"`
	Pagination Pagination                  `json:"pagination"`
}

type EndpointMessageInfo struct {
	Id            uuid.UUID         `json:"id"`
	ExceptionHash string            `json:"exceptionHash"`
	StackTrace    string            `json:"stackTrace"`
	RecordedAt    string            `json:"recordedAt"`
	Attributes    map[string]string `json:"attributes,omitempty"`
}

type EndpointSearchRequest struct {
	FromDate      time.Time        `json:"fromDate"`
	ToDate        time.Time        `json:"toDate"`
	OrderBy       string           `json:"orderBy"`
	SortDirection string           `json:"sortDirection"`
	Pagination    PaginationParams `json:"pagination"`
	Search        string           `json:"search"`
	RootFilter    string           `json:"rootFilter"`
}

type EndpointStackedChartRequest struct {
	FromDate        time.Time `json:"fromDate"`
	ToDate          time.Time `json:"toDate"`
	MetricType      string    `json:"metricType"`      // total_time, p50, p95, p99
	IntervalMinutes int       `json:"intervalMinutes"` // bucket size
}

type ExceptionDetailRequest struct {
	Pagination PaginationParams `json:"pagination"`
}

type ExceptionDetailResponse struct {
	Group            *models.ExceptionGroup       `json:"group"`
	Occurrences      []models.ExceptionStackTrace `json:"occurrences"`
	Pagination       Pagination                   `json:"pagination"`
	SessionRecording json.RawMessage              `json:"sessionRecording,omitempty"`
	// SessionId is set when the exception is linked to a parent session row
	// (always-on recording). The frontend swaps SessionRecording for a fetch
	// against `/sessions/:sessionId/recording`, which spans every segment.
	SessionId *uuid.UUID `json:"sessionId,omitempty"`
}

type ExceptionSearchRequest struct {
	FromDate        time.Time        `json:"fromDate"`
	ToDate          time.Time        `json:"toDate"`
	OrderBy         string           `json:"orderBy"`
	Pagination      PaginationParams `json:"pagination"`
	Search          string           `json:"search"`
	SearchType      string           `json:"searchType"`
	IncludeArchived bool             `json:"includeArchived"`
}

type HealthDeepResponse struct {
	CHReachable      bool         `json:"chReachable"`
	CHUptimeSec      int64        `json:"chUptimeSec"`
	PartsCount       int64        `json:"partsCount"`
	PartsByTable     []TableParts `json:"partsByTable,omitempty"`
	ActiveMerges     int64        `json:"activeMerges"`
	LongestMergeSec  float64      `json:"longestMergeSec"`
	ErrorsRecent     []CHError    `json:"errorsRecent,omitempty"`
	MemoryUsageBytes int64        `json:"memoryUsageBytes,omitempty"`
	MemoryTotalBytes int64        `json:"memoryTotalBytes,omitempty"`

	TelemetryBackend string                   `json:"telemetryBackend"`
	DroppedRows      map[string]uint64        `json:"droppedRows"`
	DroppedRowsTotal uint64                   `json:"droppedRowsTotal"`
	InsertFailures   uint64                   `json:"insertFailures"`
	IngestRejected   uint64                   `json:"ingestRejected"`
	Engine           *db.TelemetryEngineStats `json:"engine,omitempty"`
	Outbox           *outbox.HealthStats      `json:"outbox,omitempty"`
}

type HomepageStatsResponse struct {
	Requests    StatsComparison `json:"requests"`
	Exceptions  StatsComparison `json:"exceptions"`
	MemoryUsage StatsComparison `json:"memoryUsage"`
	CpuUsage    StatsComparison `json:"cpuUsage"`
}

type ImportDashboardsRequest struct {
	OrganizationId    *int            `json:"organizationId"`
	Mode              string          `json:"mode"`
	Data              json.RawMessage `json:"data" binding:"required"`
	ApplyToProjectIds []uuid.UUID     `json:"applyToProjectIds"`
}

type ImportGrafanaRequest struct {
	OrganizationId    *int            `json:"organizationId"`
	Grafana           json.RawMessage `json:"grafana" binding:"required"`
	ApplyToProjectIds []uuid.UUID     `json:"applyToProjectIds"`
}

type InstallTemplateRequest struct {
	OrganizationId *int        `json:"organizationId"`
	ProjectIds     []uuid.UUID `json:"projectIds"`
}

type LibraryDashboard struct {
	Id                int         `json:"id"`
	Name              string      `json:"name"`
	Description       string      `json:"description"`
	TemplateKey       *string     `json:"templateKey"`
	WidgetCount       int         `json:"widgetCount"`
	AppliedProjectIds []uuid.UUID `json:"appliedProjectIds"`
	UpdatedAt         time.Time   `json:"updatedAt"`
}

type LibraryOrganization struct {
	Id         int                `json:"id"`
	Name       string             `json:"name"`
	Role       string             `json:"role"`
	Dashboards []LibraryDashboard `json:"dashboards"`
}

type LimitExceededError struct {
	Message string
}

type LogAttributeFilterRequest struct {
	Scope    string `json:"scope"` // "resource" | "scope" | "log"
	Key      string `json:"key"`
	Value    string `json:"value"`
	Exclude  bool   `json:"exclude"`
	Contains bool   `json:"contains"`
}

type LogPaginationParams struct {
	Page     int `json:"page" binding:"min=1"`
	PageSize int `json:"pageSize" binding:"min=1,max=500"`
}

type LogSearchRequest struct {
	FromDate           time.Time                   `json:"fromDate"`
	ToDate             time.Time                   `json:"toDate"`
	OrderBy            string                      `json:"orderBy"`
	SortDirection      string                      `json:"sortDirection"`
	Search             string                      `json:"search"`
	SearchType         string                      `json:"searchType"`
	MinSeverity        uint8                       `json:"minSeverity"`
	ServiceName        string                      `json:"serviceName"`
	TraceId            string                      `json:"traceId"`
	SpanId             string                      `json:"spanId"`
	ScopeName          string                      `json:"scopeName"`
	Body               string                      `json:"body"`
	DistributedTraceId string                      `json:"distributedTraceId"`
	ExcludeTraceId     string                      `json:"excludeTraceId"`
	AttributeFilters   []LogAttributeFilterRequest `json:"attributeFilters"`
	Pagination         LogPaginationParams         `json:"pagination"`
}

type MetricQueryItem struct {
	Name        string            `json:"name" binding:"required"`
	Aggregation string            `json:"aggregation"`
	TagFilters  map[string]string `json:"tagFilters"`
	GroupBy     string            `json:"groupBy"`
}

type MetricQueryRequest struct {
	Queries         []MetricQueryItem `json:"queries" binding:"required,min=1"`
	From            time.Time         `json:"from" binding:"required"`
	To              time.Time         `json:"to" binding:"required"`
	IntervalMinutes int               `json:"intervalMinutes"`
}

type MetricQueryResponse struct {
	Results []MetricQueryResult `json:"results"`
}

type MetricQueryResult struct {
	Name   string                              `json:"name"`
	Unit   string                              `json:"unit"`
	Series map[string][]models.TimeSeriesPoint `json:"series"`
}

type NotificationHistorySearchRequest struct {
	Pagination PaginationParams `json:"pagination"`
	Search     string           `json:"search"`
	FromDate   string           `json:"fromDate"`
	ToDate     string           `json:"toDate"`
}

type OrgDiscoveredMetric struct {
	Name       string      `json:"name"`
	TagKeys    []string    `json:"tagKeys"`
	MetricType string      `json:"metricType,omitempty"`
	Unit       string      `json:"unit,omitempty"`
	ProjectIds []uuid.UUID `json:"projectIds"`
}

type PaginatedResponse[T any] struct {
	Data       []T        `json:"data"`
	Pagination Pagination `json:"pagination"`
}

type Pagination struct {
	Page       int   `json:"page"`
	PageSize   int   `json:"pageSize"`
	Total      int64 `json:"total"`
	TotalPages int64 `json:"totalPages"`
}

type PaginationParams struct {
	Page     int `json:"page" binding:"min=1"`
	PageSize int `json:"pageSize" binding:"min=1,max=100"`
}

type ProfileDimensionsRequest struct {
	FromDate    time.Time `json:"fromDate"`
	ToDate      time.Time `json:"toDate"`
	ServiceName string    `json:"serviceName"`
	Type        string    `json:"type"`
}

type ProfileFlameGraphRequest struct {
	FromDate    time.Time         `json:"fromDate"`
	ToDate      time.Time         `json:"toDate"`
	ServiceName string            `json:"serviceName"`
	Type        string            `json:"type"`
	Unit        string            `json:"unit"`
	IsGauge     bool              `json:"isGauge"`
	Labels      map[string]string `json:"labels"`
	AppVersion  string            `json:"appVersion"`
	ServerName  string            `json:"serverName"`
}

type ProfileGroupedRequest struct {
	FromDate      time.Time        `json:"fromDate"`
	ToDate        time.Time        `json:"toDate"`
	OrderBy       string           `json:"orderBy"`
	SortDirection string           `json:"sortDirection"`
	Search        string           `json:"search"`
	Pagination    PaginationParams `json:"pagination"`
}

type ProfileLabelsRequest struct {
	FromDate    time.Time `json:"fromDate"`
	ToDate      time.Time `json:"toDate"`
	ServiceName string    `json:"serviceName"`
	Type        string    `json:"type"`
}

type ProfileSeriesBreakdownRequest struct {
	FromDate        time.Time         `json:"fromDate"`
	ToDate          time.Time         `json:"toDate"`
	ServiceName     string            `json:"serviceName"`
	Type            string            `json:"type"`
	IsGauge         bool              `json:"isGauge"`
	IntervalMinutes int               `json:"intervalMinutes"`
	Labels          map[string]string `json:"labels"`
	AppVersion      string            `json:"appVersion"`
	ServerName      string            `json:"serverName"`
	Normalize       bool              `json:"normalize"`
	Dimension       string            `json:"dimension"`
	Limit           int               `json:"limit"`
}

type ProfileSeriesGroupResponse struct {
	Key    string               `json:"key"`
	Points []ProfileSeriesPoint `json:"points"`
}

type ProfileSeriesPoint struct {
	Timestamp time.Time `json:"timestamp"`
	Value     float64   `json:"value"`
}

type ProfileSeriesRequest struct {
	FromDate        time.Time         `json:"fromDate"`
	ToDate          time.Time         `json:"toDate"`
	ServiceName     string            `json:"serviceName"`
	Type            string            `json:"type"`
	IsGauge         bool              `json:"isGauge"`
	IntervalMinutes int               `json:"intervalMinutes"`
	Labels          map[string]string `json:"labels"`
	AppVersion      string            `json:"appVersion"`
	ServerName      string            `json:"serverName"`
	Normalize       bool              `json:"normalize"`
}

type ProfileTopFunctionsRequest struct {
	FromDate    time.Time         `json:"fromDate"`
	ToDate      time.Time         `json:"toDate"`
	ServiceName string            `json:"serviceName"`
	Type        string            `json:"type"`
	IsGauge     bool              `json:"isGauge"`
	Labels      map[string]string `json:"labels"`
	Limit       int               `json:"limit"`
	AppVersion  string            `json:"appVersion"`
	ServerName  string            `json:"serverName"`
}

type ProfileTypesRequest struct {
	FromDate    time.Time `json:"fromDate"`
	ToDate      time.Time `json:"toDate"`
	ServiceName string    `json:"serviceName"`
}

type ReorderDashboardsRequest struct {
	DashboardIds []int `json:"dashboardIds" binding:"required,min=1"`
}

type ReorderStarredRequest struct {
	Ids []int `json:"ids" binding:"required,min=1"`
}

type ReorderWidgetsRequest struct {
	WidgetIds []string `json:"widgetIds" binding:"required,min=1"`
}

type ServerMetricsResponse struct {
	Metrics          []models.DashboardMetric `json:"metrics"`
	AvailableServers []string                 `json:"availableServers"`
	LastUpdated      time.Time                `json:"lastUpdated"`
}

type SessionAttributeFilter struct {
	Key   string `json:"key"`
	Value string `json:"value"`
}

type SessionDetailResponse struct {
	Session    *models.Session        `json:"session"`
	Exceptions []SessionExceptionInfo `json:"exceptions"`
}

type SessionExceptionInfo struct {
	Id            uuid.UUID `json:"id"`
	ExceptionHash string    `json:"exceptionHash"`
	StackTrace    string    `json:"stackTrace"`
	RecordedAt    string    `json:"recordedAt"`
	IsMessage     bool      `json:"isMessage"`
}

type SessionRecordingPayload struct {
	Events    []json.RawMessage `json:"events"`
	Logs      []json.RawMessage `json:"logs,omitempty"`
	Actions   []json.RawMessage `json:"actions,omitempty"`
	StartedAt *time.Time        `json:"startedAt,omitempty"`
	EndedAt   *time.Time        `json:"endedAt,omitempty"`
}

type SessionSearchRequest struct {
	FromDate         time.Time                `json:"fromDate"`
	ToDate           time.Time                `json:"toDate"`
	OrderBy          string                   `json:"orderBy"`
	SortDirection    string                   `json:"sortDirection"`
	Search           string                   `json:"search"`
	AttributeFilters []SessionAttributeFilter `json:"attributeFilters"`
	Pagination       PaginationParams         `json:"pagination"`
}

type SetSlowEndpointRequest struct {
	Endpoint string `json:"endpoint" binding:"required"`
	OffsetMs uint32 `json:"offsetMs"`
	Reason   string `json:"reason"`
}

type StarredWidgetResponse struct {
	Id           int             `json:"id"`
	DashboardId  int             `json:"dashboardId"`
	WidgetId     string          `json:"widgetId"`
	Title        string          `json:"title"`
	WidgetType   string          `json:"widgetType"`
	Config       json.RawMessage `json:"config"`
	HomePosition int             `json:"homePosition"`
	HomeColSpan  int             `json:"homeColSpan"`
	HomeSize     string          `json:"homeSize"`
}

type StatsComparison struct {
	Current       float64 `json:"current"`
	Previous      float64 `json:"previous"`
	PercentChange float64 `json:"percentChange"`
}

type StatsMetricsResponse struct {
	Metrics     []models.DashboardMetric `json:"metrics"`
	LastUpdated time.Time                `json:"lastUpdated"`
}

type TableParts struct {
	Table string `json:"table"`
	Parts int64  `json:"parts"`
}

type TaskDetailResponse struct {
	Task      *models.Task       `json:"task"`
	Spans     []models.Span      `json:"spans"`
	HasSpans  bool               `json:"hasSpans"`
	Exception *TaskExceptionInfo `json:"exception,omitempty"`
	Messages  []TaskMessageInfo  `json:"messages"`
}

type TaskExceptionInfo struct {
	ExceptionHash string `json:"exceptionHash"`
	StackTrace    string `json:"stackTrace"`
	RecordedAt    string `json:"recordedAt"`
}

type TaskInstancesRequest struct {
	FromDate      time.Time        `json:"fromDate"`
	ToDate        time.Time        `json:"toDate"`
	OrderBy       string           `json:"orderBy"`
	SortDirection string           `json:"sortDirection"`
	Pagination    PaginationParams `json:"pagination"`
}

type TaskInstancesResponse struct {
	Data       []models.Task           `json:"data"`
	Stats      *models.TaskDetailStats `json:"stats"`
	Pagination Pagination              `json:"pagination"`
}

type TaskMessageInfo struct {
	Id            uuid.UUID         `json:"id"`
	ExceptionHash string            `json:"exceptionHash"`
	StackTrace    string            `json:"stackTrace"`
	RecordedAt    string            `json:"recordedAt"`
	Attributes    map[string]string `json:"attributes,omitempty"`
}

type TaskSearchRequest struct {
	FromDate      time.Time        `json:"fromDate"`
	ToDate        time.Time        `json:"toDate"`
	OrderBy       string           `json:"orderBy"`
	SortDirection string           `json:"sortDirection"`
	Pagination    PaginationParams `json:"pagination"`
	Search        string           `json:"search"`
	RootFilter    string           `json:"rootFilter"`
}

type UpdateDashboardRequest struct {
	Name        *string         `json:"name"`
	Description *string         `json:"description"`
	Definition  json.RawMessage `json:"definition"`
}

type UpdateProjectRequest struct {
	Name                    string    `json:"name" binding:"required"`
	Framework               string    `json:"framework" binding:"required"`
	DropHealthyHealthchecks *bool     `json:"dropHealthyHealthchecks"`
	HealthcheckPaths        *[]string `json:"healthcheckPaths"`
	ProfileLabelAllowlist   *[]string `json:"profileLabelAllowlist"`
}

type UpdateSettingsRequest struct {
	Timezone string `json:"timezone" binding:"required"`
}

type UpdateStarredLayoutRequest struct {
	ColSpan int    `json:"colSpan"`
	Size    string `json:"size"`
}