jira

type Board struct {
	ID   int    `json:"id"`
	Name string `json:"name"`
	Type string `json:"type"`
}

type BoardConfig struct {
	Filter BoardFilter `json:"filter"`
}

type BoardFilter struct {
	ID string `json:"id"`
}

type BoardListResult struct {
	PaginatedResponse
	Values []Board `json:"values"`
}

type ChangeItem struct {
	Field      string `json:"field"`
	FieldType  string `json:"fieldtype"`
	From       string `json:"from"`
	FromString string `json:"fromString"`
	To         string `json:"to"`
	ToString   string `json:"toString"`
}

type Changelog struct {
	PaginatedResponse
	Histories []ChangelogEntry `json:"histories"`
}

type ChangelogEntry struct {
	ID      string       `json:"id"`
	Created JiraTime     `json:"created"`
	Author  User         `json:"author"`
	Items   []ChangeItem `json:"items"`
}

type ChangelogResult struct {
	PaginatedResponse
	Values []ChangelogEntry `json:"values"`
}

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

type Credentials struct {
	Domain          string // e.g., "mycompany" (becomes mycompany.atlassian.net)
	Email           string // User email
	APIToken        string // API token from id.atlassian.com/manage/api-tokens
	BaseURLOverride string // If set, use instead of https://{domain}.atlassian.net
}

type Epic struct {
	ID   int    `json:"id"`
	Key  string `json:"key"`
	Name string `json:"name"`
}

type ErrorResponse struct {
	ErrorMessages []string          `json:"errorMessages"`
	Errors        map[string]string `json:"errors"`
}

type Fields struct {
	Summary        string      `json:"summary"`
	Description    any         `json:"description,omitempty"` // Can be string or ADF object
	Status         Status      `json:"status"`
	IssueType      IssueType   `json:"issuetype"`
	Created        JiraTime    `json:"created"`
	Updated        JiraTime    `json:"updated"`
	ResolutionDate *JiraTime   `json:"resolutiondate,omitempty"`
	Resolution     *Resolution `json:"resolution,omitempty"`
	Project        Project     `json:"project"`
	Assignee       *User       `json:"assignee,omitempty"`
	Reporter       *User       `json:"reporter,omitempty"`
	Priority       *Priority   `json:"priority,omitempty"`
	Labels         []string    `json:"labels,omitempty"`
	Parent         *Parent     `json:"parent,omitempty"` // For subtasks or stories linked to epics
	Epic           *Epic       `json:"epic,omitempty"`   // Epic link (older style)
}

type Filter struct {
	ID  string `json:"id"`
	JQL string `json:"jql"`
}

type Issue struct {
	Key       string     `json:"key"`
	ID        string     `json:"id"`
	Self      string     `json:"self"`
	Fields    Fields     `json:"fields"`
	Changelog *Changelog `json:"changelog,omitempty"`
}

type IssueType struct {
	ID           string `json:"id"`
	Name         string `json:"name"`
	Subtask      bool   `json:"subtask"`
	Hierarchical int    `json:"hierarchyLevel,omitempty"`
}

type IssueWithHistory struct {
	Issue
	Transitions []StatusTransition
}

type JiraTime struct {
	time.Time
}

type PaginatedResponse struct {
	StartAt    int  `json:"startAt"`
	MaxResults int  `json:"maxResults"`
	Total      int  `json:"total"`
	IsLast     bool `json:"isLast,omitempty"`
}

type Parent struct {
	ID     string `json:"id"`
	Key    string `json:"key"`
	Fields struct {
		Summary   string    `json:"summary"`
		Status    Status    `json:"status"`
		IssueType IssueType `json:"issuetype"`
	} `json:"fields"`
}

type Priority struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}

type Project struct {
	ID   string `json:"id"`
	Key  string `json:"key"`
	Name string `json:"name"`
}

type Resolution struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}

type SearchOptions struct {
	StartAt    int
	MaxResults int
	Fields     string // Comma-separated field names
	Expand     string // changelog, transitions, etc.
}

type SearchResult struct {
	PaginatedResponse
	Issues []Issue `json:"issues"`
}

type Status struct {
	ID             string         `json:"id"`
	Name           string         `json:"name"`
	StatusCategory StatusCategory `json:"statusCategory"`
}

type StatusCategory struct {
	ID   int    `json:"id"`
	Key  string `json:"key"`  // new, indeterminate, done
	Name string `json:"name"` // To Do, In Progress, Done
}

type StatusTransition struct {
	Timestamp  time.Time
	FromStatus string
	ToStatus   string
}

type User struct {
	AccountID    string `json:"accountId"`
	DisplayName  string `json:"displayName"`
	EmailAddress string `json:"emailAddress,omitempty"`
	Active       bool   `json:"active"`
}