linear

type Attachment struct {
	ID    string `json:"id"`
	Title string `json:"title"`
	URL   string `json:"url"`
}

type AttachmentConn struct {
	PageInfo PageInfo          `json:"pageInfo"`
	Nodes    []IssueAttachment `json:"nodes"`
}

type Client struct {

	// 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. CompleteComments follows the cursor.
	Comments CommentConn `json:"comments"`

	// Attachments is the first inline page (AttachmentsPageSize).
	// CompleteAttachments follows HasNextPage the same way comments do.
	Attachments AttachmentConn `json:"attachments"`
}

type IssueAttachment struct {
	ID        string         `json:"id"`
	Title     string         `json:"title"`
	URL       string         `json:"url"`
	CreatedAt string         `json:"createdAt"`
	Metadata  map[string]any `json:"metadata"`
}

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

type IssueCreate struct {
	// TeamID and Title are the required fields of IssueCreateInput; the
	// client checks them first so the error names the field instead of the
	// server's generic rejection.
	TeamID string
	Title  string
	// Description is markdown, the same format Issue.description carries.
	Description string
	// StateID is a workflow-state UUID from WorkflowStates.
	StateID string
	// Priority is Linear's 0-4 scale (0 = No priority … 4 = Low; MAPPING.md
	// "priority"). Nil omits the field.
	Priority *int
	// AssigneeID is a user UUID; empty omits (a create has nothing to clear).
	AssigneeID string
	// LabelIDs becomes the issue's whole label set; empty omits.
	LabelIDs []string
	// DueDate is "YYYY-MM-DD" exactly; empty omits.
	DueDate string
}

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 IssueUpdate struct {
	Title       *string
	Description *string
	// StateID is a workflow-state UUID from WorkflowStates.
	StateID *string
	// Priority is Linear's 0-4 scale (MAPPING.md "priority").
	Priority *int
	// AssigneeID: a pointer to a user UUID assigns; a pointer to the empty
	// string sends assigneeId: null, which the documented schema defines as
	// clearing (unassigning); nil leaves the assignee unchanged.
	AssigneeID *string
	// LabelIDs: a pointer to a slice replaces the whole label set (an empty
	// slice clears labels); nil leaves them unchanged.
	LabelIDs *[]string
	// DueDate: a pointer to "YYYY-MM-DD" sets; nil is unchanged. Clearing a
	// due date (explicit null) is not expressible in this shape — extend it
	// with the AssigneeID convention if the adapter ever needs unsetting.
	DueDate *string
}

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

type LabelConn struct {
	PageInfo PageInfo `json:"pageInfo"`
	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 UploadTarget struct {
	UploadURL string
	AssetURL  string
	Headers   map[string]string
}

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"`
}