linear

type Client struct {
	// APIKey is sent bare in the Authorization header — no "Bearer" prefix.
	// Linear rejects the prefixed form with a 400 that says so outright
	// (measured 2026-08-18), which is why the header shape is pinned by a
	// test.
	APIKey string

	// Endpoint is overridable so tests can point at an httptest server.
	// Production callers get the constant from New.
	Endpoint string

	HTTP *http.Client
	// Retries is the total number of attempts per request; Backoff is the
	// first wait, doubling per attempt and capped at 30 s.
	Retries int
	Backoff time.Duration
	// contains filtered or unexported fields
}

type Comment struct {
	ID        string `json:"id"`
	Body      string `json:"body"`
	CreatedAt string `json:"createdAt"`
	UpdatedAt string `json:"updatedAt"`
	User      *User  `json:"user"`
}

type CommentConn struct {
	PageInfo PageInfo  `json:"pageInfo"`
	Nodes    []Comment `json:"nodes"`
}

type Issue struct {
	ID            string `json:"id"`
	Identifier    string `json:"identifier"`
	Number        int    `json:"number"`
	Title         string `json:"title"`
	Description   string `json:"description"`
	URL           string `json:"url"`
	CreatedAt     string `json:"createdAt"`
	UpdatedAt     string `json:"updatedAt"`
	ArchivedAt    string `json:"archivedAt"`
	Priority      int    `json:"priority"`
	PriorityLabel string `json:"priorityLabel"`
	DueDate       string `json:"dueDate"`

	State WorkflowState `json:"state"`
	Team  struct {
		ID   string `json:"id"`
		Key  string `json:"key"`
		Name string `json:"name"`
	} `json:"team"`
	Assignee *User      `json:"assignee"`
	Creator  *User      `json:"creator"`
	Labels   LabelConn  `json:"labels"`
	Parent   *ParentRef `json:"parent"`

	// Comments is the first inline page (CommentsPageSize). A page with
	// PageInfo.HasNextPage means the issue has more comments than that and
	// the rest need a follow-up fetch — the flag exists so truncation is
	// observable, never silent.
	Comments CommentConn `json:"comments"`
}

type IssueConnection struct {
	PageInfo PageInfo `json:"pageInfo"`
	Nodes    []Issue  `json:"nodes"`
}

type IssueOpts struct {
	// TeamID restricts the page to one team (filter.team.id.eq). IDs come
	// from Teams; keys are display-facing and never a filter key.
	TeamID string
	// UpdatedAfter is an ISO-8601 timestamp and becomes filter.updatedAt.gte
	// — the incremental-sync watermark. Verified live: the gte and gt
	// comparators both exist on IssueFilter.updatedAt.
	UpdatedAfter string
	// IncludeArchived asks for archived rows too (archivedAt set), which a
	// reconcile pass needs so an archived issue is not misread as deleted.
	IncludeArchived bool
	// PageSize clamps to [1, maxPageSize]; 0 means defaultPageSize.
	PageSize int
}

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

type LabelConn struct {
	Nodes []Label `json:"nodes"`
}

type PageInfo struct {
	HasNextPage bool   `json:"hasNextPage"`
	EndCursor   string `json:"endCursor"`
}

type ParentRef struct {
	ID         string `json:"id"`
	Identifier string `json:"identifier"`
}

type RateLimit struct {
	// Complexity of the most recent query (x-complexity).
	Complexity int64 `json:"complexity"`
	// ComplexityLimit / ComplexityRemaining are the window's budget and what
	// is left of it; ComplexityResetMS is the epoch-ms reset instant.
	ComplexityLimit     int64 `json:"complexity_limit"`
	ComplexityRemaining int64 `json:"complexity_remaining"`
	ComplexityResetMS   int64 `json:"complexity_reset_ms"`
	// RequestsLimit / RequestsRemaining are the request-count window;
	// RequestsResetMS is the epoch-ms reset instant.
	RequestsLimit     int64 `json:"requests_limit"`
	RequestsRemaining int64 `json:"requests_remaining"`
	RequestsResetMS   int64 `json:"requests_reset_ms"`
	// ObservedAt is when these values were read (UTC).
	ObservedAt time.Time `json:"observed_at"`
}

type Team struct {
	ID      string `json:"id"`
	Key     string `json:"key"`
	Name    string `json:"name"`
	Private bool   `json:"private"`
}

type TeamConnection struct {
	PageInfo PageInfo `json:"pageInfo"`
	Nodes    []Team   `json:"nodes"`
}

type Usage = httppolicy.Usage

type User struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	DisplayName string `json:"displayName"`
	Email       string `json:"email"`
}

type WorkflowState struct {
	ID       string `json:"id"`
	Name     string `json:"name"`
	Type     string `json:"type"`
	Position int    `json:"position"`
}

type WorkflowStateConnection struct {
	PageInfo PageInfo        `json:"pageInfo"`
	Nodes    []WorkflowState `json:"nodes"`
}