Merge pull request #2522 from atom/schema-update/1600392059541

GraphQL schema update

Author: smashwilson

graphql/schema.graphql

@@ -600,6 +600,24 @@ type BaseRefChangedEvent implements Node {
   id: ID!
 }
 
+"""Represents a 'base_ref_deleted' event on a given pull request."""
+type BaseRefDeletedEvent implements Node {
+  """Identifies the actor who performed the event."""
+  actor: Actor
+
+  """
+  Identifies the name of the Ref associated with the `base_ref_deleted` event.
+  """
+  baseRefName: String
+
+  """Identifies the date and time when the object was created."""
+  createdAt: DateTime!
+  id: ID!
+
+  """PullRequest referenced by event."""
+  pullRequest: PullRequest
+}
+
 """Represents a 'base_ref_force_pushed' event on a given pull request."""
 type BaseRefForcePushedEvent implements Node {
   """Identifies the actor who performed the event."""
@@ -1865,6 +1883,12 @@ type Commit implements Node & GitObject & Subscribable & UniformResourceLocatabl
     last: Int
   ): DeploymentConnection
 
+  """The tree entry representing the file located at the given path."""
+  file(
+    """The path for the file"""
+    path: String!
+  ): TreeEntry
+
   """
   The linear commit history starting from (and including) this commit, in the same order as `git log`.
   """
@@ -3333,6 +3357,11 @@ input CreateIssueInput {
   """An array of Node IDs for projects associated with this issue."""
   projectIds: [ID!]
 
+  """
+  The name of an issue template in the repository, assigns labels and assignees from the template to the issue
+  """
+  issueTemplate: String
+
   """A unique identifier for the client performing the mutation."""
   clientMutationId: String
 }
@@ -7477,6 +7506,21 @@ enum IssueState {
   CLOSED
 }
 
+"""A repository issue template."""
+type IssueTemplate {
+  """The template purpose."""
+  about: String
+
+  """The suggested issue body."""
+  body: String
+
+  """The template name."""
+  name: String!
+
+  """The suggested issue title."""
+  title: String
+}
+
 """The connection type for IssueTimelineItem."""
 type IssueTimelineConnection {
   """A list of edges."""
@@ -8376,6 +8420,27 @@ type MarketplaceListingEdge {
   node: MarketplaceListing
 }
 
+"""Autogenerated input type of MarkFileAsViewed"""
+input MarkFileAsViewedInput {
+  """The Node ID of the pull request."""
+  pullRequestId: ID!
+
+  """The path of the file to mark as viewed"""
+  path: String!
+
+  """A unique identifier for the client performing the mutation."""
+  clientMutationId: String
+}
+
+"""Autogenerated return type of MarkFileAsViewed"""
+type MarkFileAsViewedPayload {
+  """A unique identifier for the client performing the mutation."""
+  clientMutationId: String
+
+  """The updated pull request."""
+  pullRequest: PullRequest
+}
+
 """Autogenerated input type of MarkPullRequestReadyForReview"""
 input MarkPullRequestReadyForReviewInput {
   """ID of the pull request to be marked as ready for review."""
@@ -9202,6 +9267,9 @@ type Mutation {
   """Lock a lockable object"""
   lockLockable(input: LockLockableInput!): LockLockablePayload
 
+  """Mark a pull request file as viewed"""
+  markFileAsViewed(input: MarkFileAsViewedInput!): MarkFileAsViewedPayload
+
   """Marks a pull request ready for review."""
   markPullRequestReadyForReview(input: MarkPullRequestReadyForReviewInput!): MarkPullRequestReadyForReviewPayload
 
@@ -9283,6 +9351,9 @@ type Mutation {
   """Unlock a lockable object"""
   unlockLockable(input: UnlockLockableInput!): UnlockLockablePayload
 
+  """Unmark a pull request file as viewed"""
+  unmarkFileAsViewed(input: UnmarkFileAsViewedInput!): UnmarkFileAsViewedPayload
+
   """Unmark an issue as a duplicate of another issue."""
   unmarkIssueAsDuplicate(input: UnmarkIssueAsDuplicateInput!): UnmarkIssueAsDuplicatePayload
 
@@ -13601,6 +13672,45 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable &
   """The moment the editor made the last edit"""
   lastEditedAt: DateTime
 
+  """A list of latest reviews per user associated with the pull request."""
+  latestOpinionatedReviews(
+    """Returns the elements in the list that come after the specified cursor."""
+    after: String
+
+    """
+    Returns the elements in the list that come before the specified cursor.
+    """
+    before: String
+
+    """Returns the first _n_ elements from the list."""
+    first: Int
+
+    """Returns the last _n_ elements from the list."""
+    last: Int
+
+    """Only return reviews from user who have write access to the repository"""
+    writersOnly: Boolean = false
+  ): PullRequestReviewConnection
+
+  """
+  A list of latest reviews per user associated with the pull request that are not also pending review.
+  """
+  latestReviews(
+    """Returns the elements in the list that come after the specified cursor."""
+    after: String
+
+    """
+    Returns the elements in the list that come before the specified cursor.
+    """
+    before: String
+
+    """Returns the first _n_ elements from the list."""
+    first: Int
+
+    """Returns the last _n_ elements from the list."""
+    last: Int
+  ): PullRequestReviewConnection
+
   """`true` if the pull request is locked"""
   locked: Boolean!
 
@@ -13846,6 +13956,9 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable &
   """Whether or not the viewer can apply suggestion."""
   viewerCanApplySuggestion: Boolean!
 
+  """Check if the viewer can restore the deleted head ref."""
+  viewerCanDeleteHeadRef: Boolean!
+
   """Can user react to this subject"""
   viewerCanReact: Boolean!
 
@@ -14552,6 +14665,12 @@ type PullRequestReviewThread implements Node {
   diffSide: DiffSide!
   id: ID!
 
+  """Whether or not the thread has been collapsed (outdated or resolved)"""
+  isCollapsed: Boolean!
+
+  """Indicates whether this thread was outdated by newer changes."""
+  isOutdated: Boolean!
+
   """Whether this thread has been resolved"""
   isResolved: Boolean!
 
@@ -14566,6 +14685,9 @@ type PullRequestReviewThread implements Node {
   """
   originalStartLine: Int
 
+  """Identifies the file path of this thread."""
+  path: String!
+
   """Identifies the pull request associated with this thread."""
   pullRequest: PullRequest!
 
@@ -14585,6 +14707,9 @@ type PullRequestReviewThread implements Node {
   """
   startLine: Int
 
+  """Indicates whether the current viewer can reply to this thread."""
+  viewerCanReply: Boolean!
+
   """Whether or not the viewer can resolve this thread"""
   viewerCanResolve: Boolean!
 
@@ -14658,7 +14783,7 @@ type PullRequestTimelineConnection {
 }
 
 """An item in an pull request timeline"""
-union PullRequestTimelineItem = AssignedEvent | BaseRefForcePushedEvent | ClosedEvent | Commit | CommitCommentThread | CrossReferencedEvent | DemilestonedEvent | DeployedEvent | DeploymentEnvironmentChangedEvent | HeadRefDeletedEvent | HeadRefForcePushedEvent | HeadRefRestoredEvent | IssueComment | LabeledEvent | LockedEvent | MergedEvent | MilestonedEvent | PullRequestReview | PullRequestReviewComment | PullRequestReviewThread | ReferencedEvent | RenamedTitleEvent | ReopenedEvent | ReviewDismissedEvent | ReviewRequestRemovedEvent | ReviewRequestedEvent | SubscribedEvent | UnassignedEvent | UnlabeledEvent | UnlockedEvent | UnsubscribedEvent | UserBlockedEvent
+union PullRequestTimelineItem = AssignedEvent | BaseRefDeletedEvent | BaseRefForcePushedEvent | ClosedEvent | Commit | CommitCommentThread | CrossReferencedEvent | DemilestonedEvent | DeployedEvent | DeploymentEnvironmentChangedEvent | HeadRefDeletedEvent | HeadRefForcePushedEvent | HeadRefRestoredEvent | IssueComment | LabeledEvent | LockedEvent | MergedEvent | MilestonedEvent | PullRequestReview | PullRequestReviewComment | PullRequestReviewThread | ReferencedEvent | RenamedTitleEvent | ReopenedEvent | ReviewDismissedEvent | ReviewRequestRemovedEvent | ReviewRequestedEvent | SubscribedEvent | UnassignedEvent | UnlabeledEvent | UnlockedEvent | UnsubscribedEvent | UserBlockedEvent
 
 """An edge in a connection."""
 type PullRequestTimelineItemEdge {
@@ -14670,7 +14795,7 @@ type PullRequestTimelineItemEdge {
 }
 
 """An item in a pull request timeline"""
-union PullRequestTimelineItems = AddedToProjectEvent | AssignedEvent | AutomaticBaseChangeFailedEvent | AutomaticBaseChangeSucceededEvent | BaseRefChangedEvent | BaseRefForcePushedEvent | ClosedEvent | CommentDeletedEvent | ConnectedEvent | ConvertToDraftEvent | ConvertedNoteToIssueEvent | CrossReferencedEvent | DemilestonedEvent | DeployedEvent | DeploymentEnvironmentChangedEvent | DisconnectedEvent | HeadRefDeletedEvent | HeadRefForcePushedEvent | HeadRefRestoredEvent | IssueComment | LabeledEvent | LockedEvent | MarkedAsDuplicateEvent | MentionedEvent | MergedEvent | MilestonedEvent | MovedColumnsInProjectEvent | PinnedEvent | PullRequestCommit | PullRequestCommitCommentThread | PullRequestReview | PullRequestReviewThread | PullRequestRevisionMarker | ReadyForReviewEvent | ReferencedEvent | RemovedFromProjectEvent | RenamedTitleEvent | ReopenedEvent | ReviewDismissedEvent | ReviewRequestRemovedEvent | ReviewRequestedEvent | SubscribedEvent | TransferredEvent | UnassignedEvent | UnlabeledEvent | UnlockedEvent | UnmarkedAsDuplicateEvent | UnpinnedEvent | UnsubscribedEvent | UserBlockedEvent
+union PullRequestTimelineItems = AddedToProjectEvent | AssignedEvent | AutomaticBaseChangeFailedEvent | AutomaticBaseChangeSucceededEvent | BaseRefChangedEvent | BaseRefDeletedEvent | BaseRefForcePushedEvent | ClosedEvent | CommentDeletedEvent | ConnectedEvent | ConvertToDraftEvent | ConvertedNoteToIssueEvent | CrossReferencedEvent | DemilestonedEvent | DeployedEvent | DeploymentEnvironmentChangedEvent | DisconnectedEvent | HeadRefDeletedEvent | HeadRefForcePushedEvent | HeadRefRestoredEvent | IssueComment | LabeledEvent | LockedEvent | MarkedAsDuplicateEvent | MentionedEvent | MergedEvent | MilestonedEvent | MovedColumnsInProjectEvent | PinnedEvent | PullRequestCommit | PullRequestCommitCommentThread | PullRequestReview | PullRequestReviewThread | PullRequestRevisionMarker | ReadyForReviewEvent | ReferencedEvent | RemovedFromProjectEvent | RenamedTitleEvent | ReopenedEvent | ReviewDismissedEvent | ReviewRequestRemovedEvent | ReviewRequestedEvent | SubscribedEvent | TransferredEvent | UnassignedEvent | UnlabeledEvent | UnlockedEvent | UnmarkedAsDuplicateEvent | UnpinnedEvent | UnsubscribedEvent | UserBlockedEvent
 
 """The connection type for PullRequestTimelineItems."""
 type PullRequestTimelineItemsConnection {
@@ -14746,6 +14871,9 @@ enum PullRequestTimelineItemsItemType {
   """Represents a 'base_ref_force_pushed' event on a given pull request."""
   BASE_REF_FORCE_PUSHED_EVENT
 
+  """Represents a 'base_ref_deleted' event on a given pull request."""
+  BASE_REF_DELETED_EVENT
+
   """Represents a 'deployed' event on a given pull request."""
   DEPLOYED_EVENT
 
@@ -17608,6 +17736,9 @@ type Repository implements Node & ProjectOwner & PackageOwner & Subscribable & S
     last: Int
   ): CommitCommentConnection!
 
+  """Returns a list of contact links associated to the repository"""
+  contactLinks: [RepositoryContactLink!]
+
   """Identifies the date and time when the object was created."""
   createdAt: DateTime!
 
@@ -17737,6 +17868,9 @@ type Repository implements Node & ProjectOwner & PackageOwner & Subscribable & S
   """Indicates if the repository is unmaintained."""
   isArchived: Boolean!
 
+  """Returns true if blank issue creation is allowed"""
+  isBlankIssuesEnabled: Boolean!
+
   """Returns whether or not this repository disabled."""
   isDisabled: Boolean!
 
@@ -17755,6 +17889,9 @@ type Repository implements Node & ProjectOwner & PackageOwner & Subscribable & S
   """Identifies if the repository is private."""
   isPrivate: Boolean!
 
+  """Returns true if this repository has a security policy"""
+  isSecurityPolicyEnabled: Boolean
+
   """
   Identifies if the repository is a template that can be used to generate new repositories.
   """
@@ -17774,6 +17911,9 @@ type Repository implements Node & ProjectOwner & PackageOwner & Subscribable & S
     number: Int!
   ): IssueOrPullRequest
 
+  """Returns a list of issue templates associated to the repository"""
+  issueTemplates: [IssueTemplate!]
+
   """A list of issues that have been opened in the repository."""
   issues(
     """Ordering options for issues returned from the connection."""
@@ -18142,6 +18282,9 @@ type Repository implements Node & ProjectOwner & PackageOwner & Subscribable & S
   """The HTTP path for this repository"""
   resourcePath: URI!
 
+  """The security policy URL."""
+  securityPolicyUrl: URI
+
   """
   A description of the repository, rendered to HTML without any links in it.
   """
@@ -18371,6 +18514,18 @@ type RepositoryConnection {
   totalDiskUsage: Int!
 }
 
+"""A repository contact link."""
+type RepositoryContactLink {
+  """The contact link purpose."""
+  about: String!
+
+  """The contact link name."""
+  name: String!
+
+  """The contact link URL."""
+  url: URI!
+}
+
 """The reason a repository is listed as 'contributed'."""
 enum RepositoryContributionType {
   """Created a commit"""
@@ -21778,6 +21933,12 @@ type Tree implements Node & GitObject {
 
 """Represents a Git tree entry."""
 type TreeEntry {
+  """The extension of the file"""
+  extension: String
+
+  """Whether or not this tree entry is generated"""
+  isGenerated: Boolean!
+
   """Entry file mode."""
   mode: Int!
 
@@ -21790,6 +21951,9 @@ type TreeEntry {
   """Entry file Git object ID."""
   oid: GitObjectID!
 
+  """The full path of the file."""
+  path: String
+
   """The Repository the tree entry belongs to"""
   repository: Repository!
 
@@ -21978,6 +22142,27 @@ type UnmarkedAsDuplicateEvent implements Node {
   id: ID!
 }
 
+"""Autogenerated input type of UnmarkFileAsViewed"""
+input UnmarkFileAsViewedInput {
+  """The Node ID of the pull request."""
+  pullRequestId: ID!
+
+  """The path of the file to mark as unviewed"""
+  path: String!
+
+  """A unique identifier for the client performing the mutation."""
+  clientMutationId: String
+}
+
+"""Autogenerated return type of UnmarkFileAsViewed"""
+type UnmarkFileAsViewedPayload {
+  """A unique identifier for the client performing the mutation."""
+  clientMutationId: String
+
+  """The updated pull request."""
+  pullRequest: PullRequest
+}
+
 """Autogenerated input type of UnmarkIssueAsDuplicate"""
 input UnmarkIssueAsDuplicateInput {
   """ID of the issue or pull request currently marked as a duplicate."""