diff --git a/graphql/schema.graphql b/graphql/schema.graphql index 1a673bf385..18a35bca98 100644 --- a/graphql/schema.graphql +++ b/graphql/schema.graphql @@ -1,12 +1,3 @@ -"""Autogenerated input type of AcceptBusinessMemberInvitation""" -input AcceptBusinessMemberInvitationInput { - """The id of the invitation being accepted""" - invitationId: ID! - - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} - """Autogenerated input type of AcceptTopicSuggestion""" input AcceptTopicSuggestionInput { """The Node ID of the repository.""" @@ -48,6 +39,27 @@ interface Actor { url: URI! } +"""Autogenerated input type of AddAssigneesToAssignable""" +input AddAssigneesToAssignableInput { + """The id of the assignable object to add assignees to.""" + assignableId: ID! + + """The id of users to add as assignees.""" + assigneeIds: [ID!]! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of AddAssigneesToAssignable""" +type AddAssigneesToAssignablePayload { + """The item that was assigned.""" + assignable: Assignable + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + """Autogenerated input type of AddComment""" input AddCommentInput { """The Node ID of the subject to modify.""" @@ -90,14 +102,33 @@ type AddedToProjectEvent implements Node { id: ID! } +"""Autogenerated input type of AddLabelsToLabelable""" +input AddLabelsToLabelableInput { + """The id of the labelable object to add labels to.""" + labelableId: ID! + + """The ids of the labels to add.""" + labelIds: [ID!]! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of AddLabelsToLabelable""" +type AddLabelsToLabelablePayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The item that was labeled.""" + labelable: Labelable +} + """Autogenerated input type of AddProjectCard""" input AddProjectCardInput { """The Node ID of the ProjectColumn.""" projectColumnId: ID! - """ - The content of the card. Must be a member of the ProjectCardItem union - """ + """The content of the card. Must be a member of the ProjectCardItem union""" contentId: ID """The note on the card.""" @@ -301,9 +332,7 @@ type AppEdge { interface Assignable { """A list of Users assigned to this object.""" assignees( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -355,9 +384,7 @@ type BaseRefForcePushedEvent implements Node { """Identifies the actor who performed the event.""" actor: Actor - """ - Identifies the after commit SHA for the 'base_ref_force_pushed' event. - """ + """Identifies the after commit SHA for the 'base_ref_force_pushed' event.""" afterCommit: Commit """ @@ -469,9 +496,7 @@ type BranchProtectionRule implements Node { A list of conflicts matching branches protection rule and other branch protection rules """ branchProtectionRuleConflicts( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -503,9 +528,7 @@ type BranchProtectionRule implements Node { """Repository refs that are protected by this rule""" matchingRefs( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -525,9 +548,7 @@ type BranchProtectionRule implements Node { """A list push allowances for this branch protection rule.""" pushAllowances( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -573,9 +594,7 @@ type BranchProtectionRule implements Node { """A list review dismissal allowances for this branch protection rule.""" reviewDismissalAllowances( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -651,24 +670,6 @@ type BranchProtectionRuleEdge { node: BranchProtectionRule } -"""Autogenerated input type of CancelBusinessAdminInvitation""" -input CancelBusinessAdminInvitationInput { - """The Node ID of the pending business admin invitation.""" - invitationId: ID! - - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} - -"""Autogenerated input type of CancelBusinessBillingManagerInvitation""" -input CancelBusinessBillingManagerInvitationInput { - """The Node ID of the pending business billing manager invitation.""" - invitationId: ID! - - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} - """Autogenerated input type of ChangeUserStatus""" input ChangeUserStatusInput { """ @@ -703,6 +704,508 @@ type ChangeUserStatusPayload { status: UserStatus } +"""A single check annotation.""" +type CheckAnnotation { + """The annotation's severity level.""" + annotationLevel: CheckAnnotationLevel + + """The path to the file that this annotation was made on.""" + blobUrl: URI! + + """Identifies the primary key from the database.""" + databaseId: Int + + """The position of this annotation.""" + location: CheckAnnotationSpan! + + """The annotation's message.""" + message: String! + + """The path that this annotation was made on.""" + path: String! + + """Additional information about the annotation.""" + rawDetails: String + + """The annotation's title""" + title: String +} + +"""The connection type for CheckAnnotation.""" +type CheckAnnotationConnection { + """A list of edges.""" + edges: [CheckAnnotationEdge] + + """A list of nodes.""" + nodes: [CheckAnnotation] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! +} + +"""Information from a check run analysis to specific lines of code.""" +input CheckAnnotationData { + """The path of the file to add an annotation to.""" + path: String! + + """The location of the annotation""" + location: CheckAnnotationRange! + + """Represents an annotation's information level""" + annotationLevel: CheckAnnotationLevel! + + """A short description of the feedback for these lines of code.""" + message: String! + + """The title that represents the annotation.""" + title: String + + """Details about this annotation.""" + rawDetails: String +} + +"""An edge in a connection.""" +type CheckAnnotationEdge { + """A cursor for use in pagination.""" + cursor: String! + + """The item at the end of the edge.""" + node: CheckAnnotation +} + +"""Represents an annotation's information level.""" +enum CheckAnnotationLevel { + """An annotation indicating an inescapable error.""" + FAILURE + + """An annotation indicating some information.""" + NOTICE + + """An annotation indicating an ignorable error.""" + WARNING +} + +"""A character position in a check annotation.""" +type CheckAnnotationPosition { + """Column number (1 indexed).""" + column: Int + + """Line number (1 indexed).""" + line: Int! +} + +"""Information from a check run analysis to specific lines of code.""" +input CheckAnnotationRange { + """The starting line of the range.""" + startLine: Int! + + """The starting column of the range.""" + startColumn: Int + + """The ending line of the range.""" + endLine: Int! + + """The ending column of the range.""" + endColumn: Int +} + +"""An inclusive pair of positions for a check annotation.""" +type CheckAnnotationSpan { + """End position (inclusive).""" + end: CheckAnnotationPosition! + + """Start position (inclusive).""" + start: CheckAnnotationPosition! +} + +"""The possible states for a check suite or run conclusion.""" +enum CheckConclusionState { + """The check suite or run requires action.""" + ACTION_REQUIRED + + """The check suite or run has timed out.""" + TIMED_OUT + + """The check suite or run has been cancelled.""" + CANCELLED + + """The check suite or run has failed.""" + FAILURE + + """The check suite or run has succeeded.""" + SUCCESS + + """The check suite or run was neutral.""" + NEUTRAL +} + +"""A check run.""" +type CheckRun implements Node & UniformResourceLocatable { + """The check run's annotations""" + annotations( + """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 + ): CheckAnnotationConnection + + """The check suite that this run is a part of.""" + checkSuite: CheckSuite! + + """Identifies the date and time when the check run was completed.""" + completedAt: DateTime + + """The conclusion of the check run.""" + conclusion: CheckConclusionState + + """Identifies the primary key from the database.""" + databaseId: Int + + """ + The URL from which to find full details of the check run on the integrator's site. + """ + detailsUrl: URI + + """A reference for the check run on the integrator's system.""" + externalId: String + id: ID! + + """The name of the check for this check run.""" + name: String! + + """The permalink to the check run summary.""" + permalink: URI! + + """The repository associated with this check run.""" + repository: Repository! + + """The HTTP path for this check run.""" + resourcePath: URI! + + """Identifies the date and time when the check run was started.""" + startedAt: DateTime + + """The current status of the check run.""" + status: CheckStatusState! + + """A string representing the check run's summary""" + summary: String + + """A string representing the check run's text""" + text: String + + """A string representing the check run""" + title: String + + """The HTTP URL for this check run.""" + url: URI! +} + +"""Possible further actions the integrator can perform.""" +input CheckRunAction { + """The text to be displayed on a button in the web UI.""" + label: String! + + """A short explanation of what this action would do.""" + description: String! + + """A reference for the action on the integrator's system. """ + identifier: String! +} + +"""The connection type for CheckRun.""" +type CheckRunConnection { + """A list of edges.""" + edges: [CheckRunEdge] + + """A list of nodes.""" + nodes: [CheckRun] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! +} + +"""An edge in a connection.""" +type CheckRunEdge { + """A cursor for use in pagination.""" + cursor: String! + + """The item at the end of the edge.""" + node: CheckRun +} + +"""The filters that are available when fetching check runs.""" +input CheckRunFilter { + """Filters the check runs by this type.""" + checkType: CheckRunType + + """Filters the check runs created by this application ID.""" + appId: Int + + """Filters the check runs by this name.""" + checkName: String + + """Filters the check runs by this status.""" + status: CheckStatusState +} + +"""Descriptive details about the check run.""" +input CheckRunOutput { + """A title to provide for this check run.""" + title: String! + + """The summary of the check run (supports Commonmark).""" + summary: String! + + """The details of the check run (supports Commonmark).""" + text: String + + """The annotations that are made as part of the check run.""" + annotations: [CheckAnnotationData!] + + """ + Images attached to the check run output displayed in the GitHub pull request UI. + """ + images: [CheckRunOutputImage!] +} + +""" +Images attached to the check run output displayed in the GitHub pull request UI. +""" +input CheckRunOutputImage { + """The alternative text for the image.""" + alt: String! + + """The full URL of the image.""" + imageUrl: URI! + + """A short image description.""" + caption: String +} + +"""The possible types of check runs.""" +enum CheckRunType { + """Every check run available.""" + ALL + + """The latest check run.""" + LATEST +} + +"""The possible states for a check suite or run status.""" +enum CheckStatusState { + """The check suite or run has been queued.""" + QUEUED + + """The check suite or run is in progress.""" + IN_PROGRESS + + """The check suite or run has been completed.""" + COMPLETED + + """The check suite or run has been requested.""" + REQUESTED +} + +"""A check suite.""" +type CheckSuite implements Node { + """The GitHub App which created this check suite.""" + app: App + + """The name of the branch for this check suite.""" + branch: Ref + + """The check runs associated with a check suite.""" + checkRuns( + """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 + + """Filters the check runs by this type.""" + filterBy: CheckRunFilter + ): CheckRunConnection + + """The commit for this check suite""" + commit: Commit! + + """The conclusion of this check suite.""" + conclusion: CheckConclusionState + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + + """Identifies the primary key from the database.""" + databaseId: Int + id: ID! + + """A list of open pull requests matching the check suite.""" + matchingPullRequests( + """A list of states to filter the pull requests by.""" + states: [PullRequestState!] + + """A list of label names to filter the pull requests by.""" + labels: [String!] + + """The head ref name to filter the pull requests by.""" + headRefName: String + + """The base ref name to filter the pull requests by.""" + baseRefName: String + + """Ordering options for pull requests returned from the connection.""" + orderBy: IssueOrder + + """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 + ): PullRequestConnection + + """The push that triggered this check suite.""" + push: Push + + """The repository associated with this check suite.""" + repository: Repository! + + """The status of this check suite.""" + status: CheckStatusState! + + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! +} + +"""The auto-trigger preferences that are available for check suites.""" +input CheckSuiteAutoTriggerPreference { + """The node ID of the application that owns the check suite.""" + appId: ID! + + """ + Set to `true` to enable automatic creation of CheckSuite events upon pushes to the repository. + """ + setting: Boolean! +} + +"""The connection type for CheckSuite.""" +type CheckSuiteConnection { + """A list of edges.""" + edges: [CheckSuiteEdge] + + """A list of nodes.""" + nodes: [CheckSuite] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! +} + +"""An edge in a connection.""" +type CheckSuiteEdge { + """A cursor for use in pagination.""" + cursor: String! + + """The item at the end of the edge.""" + node: CheckSuite +} + +"""The filters that are available when fetching check suites.""" +input CheckSuiteFilter { + """Filters the check suites created by this application ID.""" + appId: Int + + """Filters the check suites by this name.""" + checkName: String +} + +"""Autogenerated input type of ClearLabelsFromLabelable""" +input ClearLabelsFromLabelableInput { + """The id of the labelable object to clear the labels from.""" + labelableId: ID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of ClearLabelsFromLabelable""" +type ClearLabelsFromLabelablePayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The item that was unlabeled.""" + labelable: Labelable +} + +"""Autogenerated input type of CloneProject""" +input CloneProjectInput { + """The owner ID to create the project under.""" + targetOwnerId: ID! + + """The source project to clone.""" + sourceId: ID! + + """Whether or not to clone the source project's workflows.""" + includeWorkflows: Boolean! + + """The name of the project.""" + name: String! + + """The description of the project.""" + body: String + + """The visibility of the project, defaults to false (private).""" + public: Boolean + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of CloneProject""" +type CloneProjectPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The id of the JobStatus for populating cloned fields.""" + jobStatusId: String + + """The new cloned project.""" + project: Project +} + """An object that can be closed""" interface Closable { """ @@ -736,6 +1239,24 @@ type ClosedEvent implements Node & UniformResourceLocatable { url: URI! } +"""Autogenerated input type of CloseIssue""" +input CloseIssueInput { + """ID of the issue to be closed.""" + issueId: ID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of CloseIssue""" +type CloseIssuePayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The issue that was closed.""" + issue: Issue +} + """Autogenerated input type of ClosePullRequest""" input ClosePullRequestInput { """ID of the pull request to be closed.""" @@ -836,9 +1357,7 @@ interface Comment { """A list of edits to this content.""" userContentEdits( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -904,9 +1423,7 @@ enum CommentCannotUpdateReason { DENIED } -""" -Represents a 'comment_deleted' event on a given issue or pull request. -""" +"""Represents a 'comment_deleted' event on a given issue or pull request.""" type CommentDeletedEvent implements Node { """Identifies the actor who performed the event.""" actor: Actor @@ -927,6 +1444,26 @@ type Commit implements Node & GitObject & Subscribable & UniformResourceLocatabl """The number of additions in this commit.""" additions: Int! + """The pull requests associated with a commit""" + associatedPullRequests( + """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 + + """Ordering options for pull requests.""" + orderBy: PullRequestOrder + ): PullRequestConnection + """Authorship details of the commit.""" author: GitActor @@ -945,11 +1482,29 @@ type Commit implements Node & GitObject & Subscribable & UniformResourceLocatabl """The number of changed files in this commit.""" changedFiles: Int! - """Comments made on the commit.""" - comments( + """The check suites associated with a commit.""" + checkSuites( + """Returns the elements in the list that come after the specified cursor.""" + after: String + """ - Returns the elements in the list that come after the specified cursor. + 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 + + """Filters the check suites by this type.""" + filterBy: CheckSuiteFilter + ): CheckSuiteConnection + + """Comments made on the commit.""" + comments( + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -990,9 +1545,7 @@ type Commit implements Node & GitObject & Subscribable & UniformResourceLocatabl """Ordering options for deployments returned from the connection.""" orderBy: DeploymentOrder - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -1011,9 +1564,7 @@ type Commit implements Node & GitObject & Subscribable & UniformResourceLocatabl The linear commit history starting from (and including) this commit, in the same order as `git log`. """ history( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -1065,9 +1616,7 @@ type Commit implements Node & GitObject & Subscribable & UniformResourceLocatabl """The parents of a commit.""" parents( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -1209,9 +1758,7 @@ type CommitComment implements Node & Comment & Deletable & Updatable & Updatable """A list of Reactions left on the Issue.""" reactions( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -1246,9 +1793,7 @@ type CommitComment implements Node & Comment & Deletable & Updatable & Updatable """A list of edits to this content.""" userContentEdits( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -1310,9 +1855,7 @@ type CommitCommentEdge { type CommitCommentThread implements Node & RepositoryNode { """The comments that exist in this thread.""" comments( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -1378,9 +1921,7 @@ enum CommitContributionOrderField { type CommitContributionsByRepository { """The commit contributions, each representing a day.""" contributions( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -1616,6 +2157,11 @@ type ContributionsCollection { firstIssueContribution( """ If true, the first issue will be returned even if it was opened outside of the collection's time range. + + **Upcoming Change on 2019-07-01 UTC** + **Description:** `ignoreTimeRange` will be removed. Use a `ContributionsCollection` starting sufficiently far back + **Reason:** ignore_time_range will be removed + """ ignoreTimeRange: Boolean = false ): CreatedIssueOrRestrictedContribution @@ -1629,6 +2175,11 @@ type ContributionsCollection { firstPullRequestContribution( """ If true, the first pull request will be returned even if it was opened outside of the collection's time range. + + **Upcoming Change on 2019-07-01 UTC** + **Description:** `ignoreTimeRange` will be removed. Use a `ContributionsCollection` starting sufficiently far back + **Reason:** ignore_time_range will be removed + """ ignoreTimeRange: Boolean = false ): CreatedPullRequestOrRestrictedContribution @@ -1642,6 +2193,11 @@ type ContributionsCollection { firstRepositoryContribution( """ If true, the first repository will be returned even if it was opened outside of the collection's time range. + + **Upcoming Change on 2019-07-01 UTC** + **Description:** `ignoreTimeRange` will be removed. Use a `ContributionsCollection` starting sufficiently far back + **Reason:** ignore_time_range will be removed + """ ignoreTimeRange: Boolean = false ): CreatedRepositoryOrRestrictedContribution @@ -1666,9 +2222,7 @@ type ContributionsCollection { """A list of issues the user opened.""" issueContributions( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -1692,6 +2246,18 @@ type ContributionsCollection { orderBy: ContributionOrder ): CreatedIssueContributionConnection! + """Issue contributions made by the user, grouped by repository.""" + issueContributionsByRepository( + """How many repositories should be included.""" + maxRepositories: Int = 25 + + """Should the user's first issue ever be excluded from the result.""" + excludeFirst: Boolean = false + + """Should the user's most commented issue be excluded from the result.""" + excludePopular: Boolean = false + ): [IssueContributionsByRepository!]! + """ When the user signed up for GitHub. This will be null if that sign up date falls outside the collection's time range and ignoreTimeRange is false. @@ -1699,6 +2265,11 @@ type ContributionsCollection { joinedGitHubContribution( """ If true, the contribution will be returned even if the user signed up outside of the collection's time range. + + **Upcoming Change on 2019-07-01 UTC** + **Description:** `ignoreTimeRange` will be removed. Use a `ContributionsCollection` starting sufficiently far back + **Reason:** ignore_time_range will be removed + """ ignoreTimeRange: Boolean = false ): JoinedGitHubContribution @@ -1739,9 +2310,7 @@ type ContributionsCollection { """Pull request contributions made by the user.""" pullRequestContributions( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -1755,9 +2324,7 @@ type ContributionsCollection { """Returns the last _n_ elements from the list.""" last: Int - """ - Should the user's first pull request ever be excluded from the result. - """ + """Should the user's first pull request ever be excluded from the result.""" excludeFirst: Boolean = false """ @@ -1769,11 +2336,23 @@ type ContributionsCollection { orderBy: ContributionOrder ): CreatedPullRequestContributionConnection! - """Pull request review contributions made by the user.""" - pullRequestReviewContributions( + """Pull request contributions made by the user, grouped by repository.""" + pullRequestContributionsByRepository( + """How many repositories should be included.""" + maxRepositories: Int = 25 + + """Should the user's first pull request ever be excluded from the result.""" + excludeFirst: Boolean = false + """ - Returns the elements in the list that come after the specified cursor. + Should the user's most commented pull request be excluded from the result. """ + excludePopular: Boolean = false + ): [PullRequestContributionsByRepository!]! + + """Pull request review contributions made by the user.""" + pullRequestReviewContributions( + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -1791,13 +2370,19 @@ type ContributionsCollection { orderBy: ContributionOrder ): CreatedPullRequestReviewContributionConnection! + """ + Pull request review contributions made by the user, grouped by repository. + """ + pullRequestReviewContributionsByRepository( + """How many repositories should be included.""" + maxRepositories: Int = 25 + ): [PullRequestReviewContributionsByRepository!]! + """ A list of repositories owned by the user that the user created in this time range. """ repositoryContributions( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -1841,9 +2426,7 @@ type ContributionsCollection { """How many pull requests the user opened.""" totalPullRequestContributions( - """ - Should the user's first pull request ever be excluded from this count. - """ + """Should the user's first pull request ever be excluded from this count.""" excludeFirst: Boolean = false """ @@ -1867,16 +2450,12 @@ type ContributionsCollection { excludePopular: Boolean = false ): Int! - """ - How many different repositories the user left pull request reviews in. - """ + """How many different repositories the user left pull request reviews in.""" totalRepositoriesWithContributedPullRequestReviews: Int! """How many different repositories the user opened pull requests in.""" totalRepositoriesWithContributedPullRequests( - """ - Should the user's first pull request ever be excluded from this count. - """ + """Should the user's first pull request ever be excluded from this count.""" excludeFirst: Boolean = false """ @@ -1910,6 +2489,35 @@ type ConvertedNoteToIssueEvent implements Node { id: ID! } +"""Autogenerated input type of ConvertProjectCardNoteToIssue""" +input ConvertProjectCardNoteToIssueInput { + """The ProjectCard ID to convert.""" + projectCardId: ID! + + """The ID of the repository to create the issue in.""" + repositoryId: ID! + + """ + The title of the newly created issue. Defaults to the card's note text. + """ + title: String + + """The body of the newly created issue.""" + body: String + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of ConvertProjectCardNoteToIssue""" +type ConvertProjectCardNoteToIssuePayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The updated ProjectCard.""" + projectCard: ProjectCard +} + """Autogenerated input type of CreateBranchProtectionRule""" input CreateBranchProtectionRuleInput { """ @@ -1978,6 +2586,79 @@ type CreateBranchProtectionRulePayload { clientMutationId: String } +"""Autogenerated input type of CreateCheckRun""" +input CreateCheckRunInput { + """The node ID of the repository.""" + repositoryId: ID! + + """The name of the check.""" + name: String! + + """The SHA of the head commit.""" + headSha: GitObjectID! + + """ + The URL of the integrator's site that has the full details of the check. + """ + detailsUrl: URI + + """A reference for the run on the integrator's system.""" + externalId: String + + """The current status.""" + status: RequestableCheckStatusState + + """The time that the check run began.""" + startedAt: DateTime + + """The final conclusion of the check.""" + conclusion: CheckConclusionState + + """The time that the check run finished.""" + completedAt: DateTime + + """Descriptive details about the run.""" + output: CheckRunOutput + + """ + Possible further actions the integrator can perform, which a user may trigger. + """ + actions: [CheckRunAction!] + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of CreateCheckRun""" +type CreateCheckRunPayload { + """The newly created check run.""" + checkRun: CheckRun + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated input type of CreateCheckSuite""" +input CreateCheckSuiteInput { + """The Node ID of the repository.""" + repositoryId: ID! + + """The SHA of the head commit.""" + headSha: GitObjectID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of CreateCheckSuite""" +type CreateCheckSuitePayload { + """The newly created check suite.""" + checkSuite: CheckSuite + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + """Autogenerated input type of CreateContentAttachment""" input CreateContentAttachmentInput { """The node ID of the content_reference.""" @@ -1993,13 +2674,9 @@ input CreateContentAttachmentInput { clientMutationId: String } -""" -Represents the contribution a user made by committing to a repository. -""" +"""Represents the contribution a user made by committing to a repository.""" type CreatedCommitContribution implements Contribution { - """ - How many commits were made on this day to this repository by the user. - """ + """How many commits were made on this day to this repository by the user.""" commitCount: Int! """ @@ -2056,9 +2733,7 @@ type CreatedCommitContributionEdge { node: CreatedCommitContribution } -""" -Represents the contribution a user made on GitHub by opening an issue. -""" +"""Represents the contribution a user made on GitHub by opening an issue.""" type CreatedIssueContribution implements Contribution { """ Whether this contribution is associated with a record you do not have access to. For @@ -2297,6 +2972,42 @@ Represents either a repository the viewer can access or a restricted contributio """ union CreatedRepositoryOrRestrictedContribution = CreatedRepositoryContribution | RestrictedContribution +"""Autogenerated input type of CreateIssue""" +input CreateIssueInput { + """The Node ID of the repository.""" + repositoryId: ID! + + """The title for the issue.""" + title: String! + + """The body for the issue description.""" + body: String + + """The Node ID for the user assignee for this issue.""" + assigneeIds: [ID!] + + """The Node ID of the milestone for this issue.""" + milestoneId: ID + + """An array of Node IDs of labels for this issue.""" + labelIds: [ID!] + + """An array of Node IDs for projects associated with this issue.""" + projectIds: [ID!] + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of CreateIssue""" +type CreateIssuePayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The new issue.""" + issue: Issue +} + """Autogenerated input type of CreateProject""" input CreateProjectInput { """The owner ID to create the project under.""" @@ -2460,6 +3171,21 @@ type DeleteBranchProtectionRulePayload { clientMutationId: String } +"""Autogenerated input type of DeleteIssueComment""" +input DeleteIssueCommentInput { + """The ID of the comment to delete.""" + id: ID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of DeleteIssueComment""" +type DeleteIssueCommentPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + """Autogenerated input type of DeleteIssue""" input DeleteIssueInput { """The ID of the issue to delete.""" @@ -2469,6 +3195,15 @@ input DeleteIssueInput { clientMutationId: String } +"""Autogenerated return type of DeleteIssue""" +type DeleteIssuePayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The repository the issue belonged to""" + repository: Repository +} + """Autogenerated input type of DeleteProjectCard""" input DeleteProjectCardInput { """The id of the card to delete.""" @@ -2693,9 +3428,7 @@ type Deployment implements Node { """A list of statuses associated with the deployment.""" statuses( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -3004,9 +3737,7 @@ type FollowingConnection { type Gist implements Node & Starrable { """A list of comments associated with the gist""" comments( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -3051,9 +3782,7 @@ type Gist implements Node & Starrable { """A list of users who have starred this starrable.""" stargazers( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -3135,9 +3864,7 @@ type GistComment implements Node & Comment & Deletable & Updatable & UpdatableCo """A list of edits to this content.""" userContentEdits( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -3501,9 +4228,7 @@ type HeadRefForcePushedEvent implements Node { """Identifies the actor who performed the event.""" actor: Actor - """ - Identifies the after commit SHA for the 'head_ref_force_pushed' event. - """ + """Identifies the after commit SHA for the 'head_ref_force_pushed' event.""" afterCommit: Commit """ @@ -3541,18 +4266,18 @@ type HeadRefRestoredEvent implements Node { scalar HTML """ -The possible states in which authentication can be configured with an Identity Provider. +The possible states in which authentication can be configured with an identity provider. """ enum IdentityProviderConfigurationState { - """Authentication with an Identity Provider is configured and enforced.""" + """Authentication with an identity provider is configured and enforced.""" ENFORCED """ - Authentication with an Identity Provider is configured but not enforced. + Authentication with an identity provider is configured but not enforced. """ CONFIGURED - """Authentication with an Identity Provider is not configured.""" + """Authentication with an identity provider is not configured.""" UNCONFIGURED } @@ -3577,36 +4302,6 @@ input ImportProjectInput { clientMutationId: String } -"""Autogenerated input type of InviteBusinessAdmin""" -input InviteBusinessAdminInput { - """The ID of the business to which you want to invite an administrator.""" - businessId: ID! - - """The login of a user to invite as an administrator.""" - invitee: String - - """The email of the person to invite as an administrator.""" - email: String - - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} - -"""Autogenerated input type of InviteBusinessBillingManager""" -input InviteBusinessBillingManagerInput { - """The ID of the business to which you want to invite a billing manager.""" - businessId: ID! - - """The login of a user to invite as a billing manager.""" - invitee: String - - """The email of the person to invite as a billing manager.""" - email: String - - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} - """ An Issue is a place to discuss ideas, enhancements, tasks, and bugs for a project. """ @@ -3616,9 +4311,7 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """A list of Users assigned to this object.""" assignees( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -3658,9 +4351,7 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """A list of comments associated with the Issue.""" comments( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -3695,9 +4386,7 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """A list of labels associated with the object.""" labels( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -3726,9 +4415,7 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """A list of Users that are participating in the Issue conversation.""" participants( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -3745,9 +4432,7 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """List of project cards associated with this issue.""" projectCards( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -3773,9 +4458,7 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """A list of Reactions left on the Issue.""" reactions( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -3810,9 +4493,33 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """Allows filtering timeline events by a `since` timestamp.""" since: DateTime + """Returns the elements in the list that come after the specified cursor.""" + after: String + """ - Returns the elements in the list that come after the specified cursor. + 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 + ): IssueTimelineConnection! + + """A list of events, comments, commits, etc. associated with the issue.""" + timelineItems( + """Filter timeline items by a `since` timestamp.""" + since: DateTime + + """Skips the first _n_ elements in the list.""" + skip: Int + + """Filter timeline items by type.""" + itemTypes: [IssueTimelineItemsItemType!] + + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -3825,7 +4532,7 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """Returns the last _n_ elements from the list.""" last: Int - ): IssueTimelineConnection! + ): IssueTimelineItemsConnection! """Identifies the issue title.""" title: String! @@ -3838,9 +4545,7 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """A list of edits to this content.""" userContentEdits( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -3940,9 +4645,7 @@ type IssueComment implements Node & Comment & Deletable & Updatable & UpdatableC """A list of Reactions left on the Issue.""" reactions( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -3977,9 +4680,7 @@ type IssueComment implements Node & Comment & Deletable & Updatable & UpdatableC """A list of edits to this content.""" userContentEdits( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -4052,6 +4753,32 @@ type IssueConnection { totalCount: Int! } +"""This aggregates issues opened by a user within one repository.""" +type IssueContributionsByRepository { + """The issue contributions.""" + contributions( + """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 + + """Ordering options for contributions returned from the connection.""" + orderBy: ContributionOrder + ): CreatedIssueContributionConnection! + + """The repository in which the issues were opened.""" + repository: Repository! +} + """An edge in a connection.""" type IssueEdge { """A cursor for use in pagination.""" @@ -4061,6 +4788,40 @@ type IssueEdge { node: Issue } +"""Ways in which to filter lists of issues.""" +input IssueFilters { + """ + List issues assigned to given name. Pass in `null` for issues with no assigned + user, and `*` for issues assigned to any user. + """ + assignee: String + + """List issues created by given name.""" + createdBy: String + + """List issues where the list of label names exist on the issue.""" + labels: [String!] + + """List issues where the given name is mentioned in the issue.""" + mentioned: String + + """ + List issues by given milestone argument. If an string representation of an + integer is passed, it should refer to a milestone by its number field. Pass in + `null` for issues with no milestone, and `*` for issues that are assigned to any milestone. + """ + milestone: String + + """List issues that have been updated at or after the given date.""" + since: DateTime + + """List issues filtered by the list of states given.""" + states: [IssueState!] + + """List issues subscribed to by viewer.""" + viewerSubscribed: Boolean = false +} + """Ways in which lists of issues can be ordered upon return.""" input IssueOrder { """The field in which to order issues by.""" @@ -4125,7 +4886,7 @@ type IssueTimelineConnection { } """An item in an issue timeline""" -union IssueTimelineItem = Commit | IssueComment | CrossReferencedEvent | ClosedEvent | ReopenedEvent | SubscribedEvent | UnsubscribedEvent | ReferencedEvent | AssignedEvent | UnassignedEvent | LabeledEvent | UnlabeledEvent | MilestonedEvent | DemilestonedEvent | RenamedTitleEvent | LockedEvent | UnlockedEvent | TransferredEvent +union IssueTimelineItem = Commit | IssueComment | CrossReferencedEvent | ClosedEvent | ReopenedEvent | SubscribedEvent | UnsubscribedEvent | ReferencedEvent | AssignedEvent | UnassignedEvent | LabeledEvent | UnlabeledEvent | UserBlockedEvent | MilestonedEvent | DemilestonedEvent | RenamedTitleEvent | LockedEvent | UnlockedEvent | TransferredEvent """An edge in a connection.""" type IssueTimelineItemEdge { @@ -4136,8 +4897,36 @@ type IssueTimelineItemEdge { node: IssueTimelineItem } -"""An item in an issue timeline""" -union IssueTimelineItems = IssueComment | CrossReferencedEvent | AddedToProjectEvent | AssignedEvent | ClosedEvent | CommentDeletedEvent | ConvertedNoteToIssueEvent | DemilestonedEvent | LabeledEvent | LockedEvent | MentionedEvent | MilestonedEvent | MovedColumnsInProjectEvent | PinnedEvent | ReferencedEvent | RemovedFromProjectEvent | RenamedTitleEvent | ReopenedEvent | SubscribedEvent | TransferredEvent | UnassignedEvent | UnlabeledEvent | UnlockedEvent | UnpinnedEvent | UnsubscribedEvent +"""An item in an issue timeline""" +union IssueTimelineItems = IssueComment | CrossReferencedEvent | AddedToProjectEvent | AssignedEvent | ClosedEvent | CommentDeletedEvent | ConvertedNoteToIssueEvent | DemilestonedEvent | LabeledEvent | LockedEvent | MentionedEvent | MilestonedEvent | MovedColumnsInProjectEvent | PinnedEvent | ReferencedEvent | RemovedFromProjectEvent | RenamedTitleEvent | ReopenedEvent | SubscribedEvent | TransferredEvent | UnassignedEvent | UnlabeledEvent | UnlockedEvent | UserBlockedEvent | UnpinnedEvent | UnsubscribedEvent + +"""The connection type for IssueTimelineItems.""" +type IssueTimelineItemsConnection { + """A list of edges.""" + edges: [IssueTimelineItemsEdge] + + """ + Identifies the count of items after applying `before` and `after` filters. + """ + filteredCount: Int! + + """A list of nodes.""" + nodes: [IssueTimelineItems] + + """ + Identifies the count of items after applying `before`/`after` filters and `first`/`last`/`skip` slicing. + """ + pageCount: Int! + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! + + """Identifies the date and time when the timeline was last updated.""" + updatedAt: DateTime! +} """An edge in a connection.""" type IssueTimelineItemsEdge { @@ -4167,9 +4956,7 @@ enum IssueTimelineItemsItemType { """Represents a 'closed' event on any `Closable`.""" CLOSED_EVENT - """ - Represents a 'comment_deleted' event on a given issue or pull request. - """ + """Represents a 'comment_deleted' event on a given issue or pull request.""" COMMENT_DELETED_EVENT """ @@ -4229,6 +5016,9 @@ enum IssueTimelineItemsItemType { """Represents an 'unlocked' event on a given issue or pull request.""" UNLOCKED_EVENT + """Represents a 'user_blocked' event on a given user.""" + USER_BLOCKED_EVENT + """Represents an 'unpinned' event on a given issue or pull request.""" UNPINNED_EVENT @@ -4262,9 +5052,7 @@ type JoinedGitHubContribution implements Contribution { user: User! } -""" -A label for categorizing Issues or Milestones with a given Repository. -""" +"""A label for categorizing Issues or Milestones with a given Repository.""" type Label implements Node { """Identifies the label color.""" color: String! @@ -4290,9 +5078,10 @@ type Label implements Node { """A list of states to filter the issues by.""" states: [IssueState!] - """ - Returns the elements in the list that come after the specified cursor. - """ + """Filtering options for issues returned from the connection.""" + filterBy: IssueFilters + + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -4327,9 +5116,7 @@ type Label implements Node { """Ordering options for pull requests returned from the connection.""" orderBy: IssueOrder - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -4361,9 +5148,7 @@ type Label implements Node { interface Labelable { """A list of labels associated with the object.""" labels( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -4663,11 +5448,6 @@ type MarketplaceListing implements Node { """The listing's introductory description rendered to HTML.""" fullDescriptionHTML: HTML! - """ - Whether this listing has been submitted for review from GitHub for approval to be displayed in the Marketplace. - """ - hasApprovalBeenRequested: Boolean! - """Does this listing have any plans with a free trial?""" hasPublishedFreeTrialPlans: Boolean! @@ -4687,13 +5467,8 @@ type MarketplaceListing implements Node { """Whether this listing's app has been installed for the current viewer""" installedForViewer: Boolean! - """ - Whether this listing has been approved for display in the Marketplace. - """ - isApproved: Boolean! - """Whether this listing has been removed from the Marketplace.""" - isDelisted: Boolean! + isArchived: Boolean! """ Whether this listing is still an editable draft that has not been submitted @@ -4706,9 +5481,7 @@ type MarketplaceListing implements Node { """ isPaid: Boolean! - """ - Whether this listing has been approved for display in the Marketplace. - """ + """Whether this listing has been approved for display in the Marketplace.""" isPublic: Boolean! """ @@ -4764,7 +5537,9 @@ type MarketplaceListing implements Node { """The category that best describes the listing.""" primaryCategory: MarketplaceCategory! - """URL to the listing's privacy policy.""" + """ + URL to the listing's privacy policy, may return an empty string for listings that do not require a privacy policy URL. + """ privacyPolicyUrl: URI! """The HTTP path for the Marketplace listing.""" @@ -4788,7 +5563,10 @@ type MarketplaceListing implements Node { """An email address for support for this listing's app.""" supportEmail: String - """Either a URL or an email address for support for this listing's app.""" + """ + Either a URL or an email address for support for this listing's app, may + return an empty string for listings that do not require a support URL. + """ supportUrl: URI! """URL to the listing's terms of service.""" @@ -4835,7 +5613,7 @@ type MarketplaceListing implements Node { """ Can the current viewer request this listing be reviewed for display in - the Marketplace. + the Marketplace as verified. """ viewerCanRequestApproval: Boolean! @@ -4890,9 +5668,7 @@ interface MemberStatusable { Get the status messages members of this entity have set that are either public or visible only to the organization. """ memberStatuses( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -5031,9 +5807,10 @@ type Milestone implements Node & Closable & UniformResourceLocatable { """A list of states to filter the issues by.""" states: [IssueState!] - """ - Returns the elements in the list that come after the specified cursor. - """ + """Filtering options for issues returned from the connection.""" + filterBy: IssueFilters + + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -5068,9 +5845,7 @@ type Milestone implements Node & Closable & UniformResourceLocatable { """Ordering options for pull requests returned from the connection.""" orderBy: IssueOrder - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -5128,9 +5903,7 @@ type MilestonedEvent implements Node { createdAt: DateTime! id: ID! - """ - Identifies the milestone title associated with the 'milestoned' event. - """ + """Identifies the milestone title associated with the 'milestoned' event.""" milestoneTitle: String! """Object referenced by event.""" @@ -5263,9 +6036,15 @@ type Mutation { """Applies a suggested topic to the repository.""" acceptTopicSuggestion(input: AcceptTopicSuggestionInput!): AcceptTopicSuggestionPayload + """Adds assignees to an assignable object.""" + addAssigneesToAssignable(input: AddAssigneesToAssignableInput!): AddAssigneesToAssignablePayload + """Adds a comment to an Issue or Pull Request.""" addComment(input: AddCommentInput!): AddCommentPayload + """Adds labels to a labelable object.""" + addLabelsToLabelable(input: AddLabelsToLabelableInput!): AddLabelsToLabelablePayload + """ Adds a card to a ProjectColumn. Either `contentId` or `note` must be provided but **not** both. """ @@ -5289,12 +6068,37 @@ type Mutation { """Update your status on GitHub.""" changeUserStatus(input: ChangeUserStatusInput!): ChangeUserStatusPayload + """Clears all labels from a labelable object.""" + clearLabelsFromLabelable(input: ClearLabelsFromLabelableInput!): ClearLabelsFromLabelablePayload + + """ + Creates a new project by cloning configuration from an existing project. + """ + cloneProject(input: CloneProjectInput!): CloneProjectPayload + + """Close an issue.""" + closeIssue(input: CloseIssueInput!): CloseIssuePayload + """Close a pull request.""" closePullRequest(input: ClosePullRequestInput!): ClosePullRequestPayload + """ + Convert a project note card to one associated with a newly created issue. + """ + convertProjectCardNoteToIssue(input: ConvertProjectCardNoteToIssueInput!): ConvertProjectCardNoteToIssuePayload + """Create a new branch protection rule""" createBranchProtectionRule(input: CreateBranchProtectionRuleInput!): CreateBranchProtectionRulePayload + """Create a check run.""" + createCheckRun(input: CreateCheckRunInput!): CreateCheckRunPayload + + """Create a check suite""" + createCheckSuite(input: CreateCheckSuiteInput!): CreateCheckSuitePayload + + """Creates a new issue.""" + createIssue(input: CreateIssueInput!): CreateIssuePayload + """Creates a new project.""" createProject(input: CreateProjectInput!): CreateProjectPayload @@ -5307,6 +6111,12 @@ type Mutation { """Delete a branch protection rule""" deleteBranchProtectionRule(input: DeleteBranchProtectionRuleInput!): DeleteBranchProtectionRulePayload + """Deletes an Issue object.""" + deleteIssue(input: DeleteIssueInput!): DeleteIssuePayload + + """Deletes an IssueComment object.""" + deleteIssueComment(input: DeleteIssueCommentInput!): DeleteIssueCommentPayload + """Deletes a project.""" deleteProject(input: DeleteProjectInput!): DeleteProjectPayload @@ -5337,9 +6147,13 @@ type Mutation { """Moves a project column to another place.""" moveProjectColumn(input: MoveProjectColumnInput!): MoveProjectColumnPayload - """ - Removes outside collaborator from all repositories in an organization. - """ + """Removes assignees from an assignable object.""" + removeAssigneesFromAssignable(input: RemoveAssigneesFromAssignableInput!): RemoveAssigneesFromAssignablePayload + + """Removes labels from a Labelable object.""" + removeLabelsFromLabelable(input: RemoveLabelsFromLabelableInput!): RemoveLabelsFromLabelablePayload + + """Removes outside collaborator from all repositories in an organization.""" removeOutsideCollaborator(input: RemoveOutsideCollaboratorInput!): RemoveOutsideCollaboratorPayload """Removes a reaction from a subject.""" @@ -5348,12 +6162,18 @@ type Mutation { """Removes a star from a Starrable.""" removeStar(input: RemoveStarInput!): RemoveStarPayload + """Reopen a issue.""" + reopenIssue(input: ReopenIssueInput!): ReopenIssuePayload + """Reopen a pull request.""" reopenPullRequest(input: ReopenPullRequestInput!): ReopenPullRequestPayload """Set review requests on a pull request.""" requestReviews(input: RequestReviewsInput!): RequestReviewsPayload + """Rerequests an existing check suite.""" + rerequestCheckSuite(input: RerequestCheckSuiteInput!): RerequestCheckSuitePayload + """Marks a review thread as resolved.""" resolveReviewThread(input: ResolveReviewThreadInput!): ResolveReviewThreadPayload @@ -5363,12 +6183,27 @@ type Mutation { """Unlock a lockable object""" unlockLockable(input: UnlockLockableInput!): UnlockLockablePayload + """Unmark an issue as a duplicate of another issue.""" + unmarkIssueAsDuplicate(input: UnmarkIssueAsDuplicateInput!): UnmarkIssueAsDuplicatePayload + """Marks a review thread as unresolved.""" unresolveReviewThread(input: UnresolveReviewThreadInput!): UnresolveReviewThreadPayload """Create a new branch protection rule""" updateBranchProtectionRule(input: UpdateBranchProtectionRuleInput!): UpdateBranchProtectionRulePayload + """Update a check run""" + updateCheckRun(input: UpdateCheckRunInput!): UpdateCheckRunPayload + + """Modifies the settings of an existing check suite""" + updateCheckSuitePreferences(input: UpdateCheckSuitePreferencesInput!): UpdateCheckSuitePreferencesPayload + + """Updates an Issue.""" + updateIssue(input: UpdateIssueInput!): UpdateIssuePayload + + """Updates an IssueComment object.""" + updateIssueComment(input: UpdateIssueCommentInput!): UpdateIssueCommentPayload + """Updates an existing project.""" updateProject(input: UpdateProjectInput!): UpdateProjectPayload @@ -5414,7 +6249,15 @@ enum OrderDirection { """ An account on GitHub, with one or more owners, that has repositories, members and teams. """ -type Organization implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch & ProjectOwner & RepositoryOwner & UniformResourceLocatable & MemberStatusable { +type Organization implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch & ProjectOwner & RepositoryOwner & UniformResourceLocatable & MemberStatusable & ProfileOwner { + """ + Determine if this repository owner has any items that can be pinned to their profile. + """ + anyPinnableItems( + """Filter to only a particular kind of pinnable item.""" + type: PinnableItemType + ): Boolean! + """A URL pointing to the organization's public avatar.""" avatarUrl( """The size of the resulting square image.""" @@ -5434,6 +6277,12 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka """Whether the organization has verified its profile email and website.""" isVerified: Boolean! + """ + Showcases a selection of repositories and gists that the profile owner has + either curated or that have been selected automatically based on popularity. + """ + itemShowcase: ProfileItemShowcase! + """The organization's public profile location.""" location: String @@ -5444,9 +6293,7 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka Get the status messages members of this entity have set that are either public or visible only to the organization. """ memberStatuses( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -5464,30 +6311,9 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka orderBy: UserStatusOrder ): UserStatusConnection! - """A list of users who are members of this organization.""" - members( - """ - 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 - ): UserConnection! @deprecated(reason: "The `members` field is deprecated and will be removed soon. Use `Organization.membersWithRole` instead. Removal on 2019-04-01 UTC.") - """A list of users who are members of this organization.""" membersWithRole( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -5516,9 +6342,7 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka """A list of users who have been invited to join this organization.""" pendingMembers( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -5533,36 +6357,36 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka last: Int ): UserConnection! - """A list of repositories this user has pinned to their profile""" - pinnedRepositories( - """If non-null, filters repositories according to privacy""" - privacy: RepositoryPrivacy + """ + A list of repositories and gists this profile owner can pin to their profile. + """ + pinnableItems( + """Filter the types of pinnable items that are returned.""" + types: [PinnableItemType!] - """Ordering options for repositories returned from the connection""" - orderBy: RepositoryOrder + """Returns the elements in the list that come after the specified cursor.""" + after: String """ - Array of viewer's affiliation options for repositories returned from the - connection. For example, OWNER will include only repositories that the - current viewer owns. + Returns the elements in the list that come before the specified cursor. """ - affiliations: [RepositoryAffiliation] + before: String - """ - Array of owner's affiliation options for repositories returned from the - connection. For example, OWNER will include only repositories that the - organization or user being viewed owns. - """ - ownerAffiliations: [RepositoryAffiliation] + """Returns the first _n_ elements from the list.""" + first: Int - """ - If non-null, filters repositories according to whether they have been locked - """ - isLocked: Boolean + """Returns the last _n_ elements from the list.""" + last: Int + ): PinnableItemConnection! - """ - Returns the elements in the list that come after the specified cursor. - """ + """ + A list of repositories and gists this profile owner has pinned to their profile + """ + pinnedItems( + """Filter the types of pinned items that are returned.""" + types: [PinnableItemType!] + + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -5575,7 +6399,12 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka """Returns the last _n_ elements from the list.""" last: Int - ): RepositoryConnection! + ): PinnableItemConnection! + + """ + Returns how many more items this profile owner can pin to their profile. + """ + pinnedItemsRemaining: Int! """Find project by number.""" project( @@ -5594,9 +6423,7 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka """A list of states to filter the projects by.""" states: [ProjectState!] - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -5644,9 +6471,7 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka """ isLocked: Boolean - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -5681,7 +6506,7 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka """The HTTP path for this organization.""" resourcePath: URI! - """The Organization's SAML Identity Providers""" + """The Organization's SAML identity providers""" samlIdentityProvider: OrganizationIdentityProvider """Find an organization's team by its slug.""" @@ -5717,9 +6542,7 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka """If true, restrict to only root teams""" rootTeamsOnly: Boolean = false - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -5746,6 +6569,9 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka """Organization is adminable by the viewer.""" viewerCanAdminister: Boolean! + """Can the viewer pin repositories and gists to the profile?""" + viewerCanChangePinnedItems: Boolean! + """Can the current viewer create new projects on this owner.""" viewerCanCreateProjects: Boolean! @@ -5797,9 +6623,7 @@ type OrganizationIdentityProvider implements Node { """External Identities provisioned by this Identity Provider""" externalIdentities( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -5929,61 +6753,227 @@ type OrganizationMemberEdge { cursor: String! """ - Whether the organization member has two factor enabled or not. Returns null if information is not available to viewer. + Whether the organization member has two factor enabled or not. Returns null if information is not available to viewer. + """ + hasTwoFactorEnabled: Boolean + + """The item at the end of the edge.""" + node: User + + """The role this user has in the organization.""" + role: OrganizationMemberRole +} + +"""The possible roles within an organization for its members.""" +enum OrganizationMemberRole { + """The user is a member of the organization.""" + MEMBER + + """The user is an administrator of the organization.""" + ADMIN +} + +"""Information about pagination in a connection.""" +type PageInfo { + """When paginating forwards, the cursor to continue.""" + endCursor: String + + """When paginating forwards, are there more items?""" + hasNextPage: Boolean! + + """When paginating backwards, are there more items?""" + hasPreviousPage: Boolean! + + """When paginating backwards, the cursor to continue.""" + startCursor: String +} + +"""Types that can grant permissions on a repository to a user""" +union PermissionGranter = Organization | Repository | Team + +"""A level of permission and source for a user's access to a repository.""" +type PermissionSource { + """The organization the repository belongs to.""" + organization: Organization! + + """The level of access this source has granted to the user.""" + permission: DefaultRepositoryPermissionField! + + """The source of this permission.""" + source: PermissionGranter! +} + +"""Autogenerated input type of PinIssue""" +input PinIssueInput { + """The ID of the issue to be pinned""" + issueId: ID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Types that can be pinned to a profile page.""" +union PinnableItem = Gist | Repository + +"""The connection type for PinnableItem.""" +type PinnableItemConnection { + """A list of edges.""" + edges: [PinnableItemEdge] + + """A list of nodes.""" + nodes: [PinnableItem] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! +} + +"""An edge in a connection.""" +type PinnableItemEdge { + """A cursor for use in pagination.""" + cursor: String! + + """The item at the end of the edge.""" + node: PinnableItem +} + +"""Represents items that can be pinned to a profile page.""" +enum PinnableItemType { + """A repository.""" + REPOSITORY + + """A gist.""" + GIST +} + +"""Represents a 'pinned' event on a given issue or pull request.""" +type PinnedEvent implements Node { + """Identifies the actor who performed the event.""" + actor: Actor + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + id: ID! + + """Identifies the issue associated with the event.""" + issue: Issue! +} + +""" +A curatable list of repositories relating to a repository owner, which defaults +to showing the most popular repositories they own. +""" +type ProfileItemShowcase { + """Whether or not the owner has pinned any repositories or gists.""" + hasPinnedItems: Boolean! + + """ + The repositories and gists in the showcase. If the profile owner has any + pinned items, those will be returned. Otherwise, the profile owner's popular + repositories will be returned. + """ + items( + """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 + ): PinnableItemConnection! +} + +"""Represents any entity on GitHub that has a profile page.""" +interface ProfileOwner { + """ + Determine if this repository owner has any items that can be pinned to their profile. + """ + anyPinnableItems( + """Filter to only a particular kind of pinnable item.""" + type: PinnableItemType + ): Boolean! + + """The public profile email.""" + email: String + id: ID! + + """ + Showcases a selection of repositories and gists that the profile owner has + either curated or that have been selected automatically based on popularity. + """ + itemShowcase: ProfileItemShowcase! + + """The public profile location.""" + location: String + + """The username used to login.""" + login: String! + + """The public profile name.""" + name: String + + """ + A list of repositories and gists this profile owner can pin to their profile. """ - hasTwoFactorEnabled: Boolean - - """The item at the end of the edge.""" - node: User + pinnableItems( + """Filter the types of pinnable items that are returned.""" + types: [PinnableItemType!] - """The role this user has in the organization.""" - role: OrganizationMemberRole -} + """Returns the elements in the list that come after the specified cursor.""" + after: String -"""The possible roles within an organization for its members.""" -enum OrganizationMemberRole { - """The user is a member of the organization.""" - MEMBER + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The user is an administrator of the organization.""" - ADMIN -} + """Returns the first _n_ elements from the list.""" + first: Int -"""Information about pagination in a connection.""" -type PageInfo { - """When paginating forwards, the cursor to continue.""" - endCursor: String + """Returns the last _n_ elements from the list.""" + last: Int + ): PinnableItemConnection! - """When paginating forwards, are there more items?""" - hasNextPage: Boolean! + """ + A list of repositories and gists this profile owner has pinned to their profile + """ + pinnedItems( + """Filter the types of pinned items that are returned.""" + types: [PinnableItemType!] - """When paginating backwards, are there more items?""" - hasPreviousPage: Boolean! + """Returns the elements in the list that come after the specified cursor.""" + after: String - """When paginating backwards, the cursor to continue.""" - startCursor: String -} + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String -"""Autogenerated input type of PinIssue""" -input PinIssueInput { - """The ID of the issue to be pinned""" - issueId: ID! + """Returns the first _n_ elements from the list.""" + first: Int - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} + """Returns the last _n_ elements from the list.""" + last: Int + ): PinnableItemConnection! -"""Represents a 'pinned' event on a given issue or pull request.""" -type PinnedEvent implements Node { - """Identifies the actor who performed the event.""" - actor: Actor + """ + Returns how many more items this profile owner can pin to their profile. + """ + pinnedItemsRemaining: Int! - """Identifies the date and time when the object was created.""" - createdAt: DateTime! - id: ID! + """Can the viewer pin repositories and gists to the profile?""" + viewerCanChangePinnedItems: Boolean! - """Identifies the issue associated with the event.""" - issue: Issue! + """The public profile website URL.""" + websiteUrl: URI } """ @@ -6006,9 +6996,7 @@ type Project implements Node & Closable & Updatable { """List of columns in the project""" columns( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6046,9 +7034,7 @@ type Project implements Node & Closable & Updatable { """List of pending cards in this project""" pendingCards( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6161,9 +7147,7 @@ type ProjectCardEdge { node: ProjectCard } -""" -An issue or PR and its owning repository to be used in a project card. -""" +"""An issue or PR and its owning repository to be used in a project card.""" input ProjectCardImport { """Repository name with owner (owner/repository).""" repository: String! @@ -6191,9 +7175,7 @@ enum ProjectCardState { type ProjectColumn implements Node { """List of cards in the column""" cards( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6351,9 +7333,7 @@ interface ProjectOwner { """A list of states to filter the projects by.""" states: [ProjectState!] - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6387,109 +7367,6 @@ enum ProjectState { CLOSED } -"""A repository protected branch.""" -type ProtectedBranch implements Node { - """The actor who created this protected branch.""" - creator: Actor - - """ - Will new commits pushed to this branch dismiss pull request review approvals. - """ - hasDismissableStaleReviews: Boolean! - - """Are reviews required to update this branch.""" - hasRequiredReviews: Boolean! - - """Are status checks required to update this branch.""" - hasRequiredStatusChecks: Boolean! - - """Is pushing to this branch restricted.""" - hasRestrictedPushes: Boolean! - - """Is dismissal of pull request reviews restricted.""" - hasRestrictedReviewDismissals: Boolean! - - """Are branches required to be up to date before merging.""" - hasStrictRequiredStatusChecks: Boolean! - id: ID! - - """Can admins overwrite branch protection.""" - isAdminEnforced: Boolean! - - """The name of the protected branch rule.""" - name: String! - - """A list push allowances for this protected branch.""" - pushAllowances( - """ - 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 - ): PushAllowanceConnection! - - """The repository associated with this protected branch.""" - repository: Repository! - - """ - List of required status check contexts that must pass for commits to be accepted to this branch. - """ - requiredStatusCheckContexts: [String] - - """A list review dismissal allowances for this protected branch.""" - reviewDismissalAllowances( - """ - 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 - ): ReviewDismissalAllowanceConnection! -} - -"""The connection type for ProtectedBranch.""" -type ProtectedBranchConnection { - """A list of edges.""" - edges: [ProtectedBranchEdge] - - """A list of nodes.""" - nodes: [ProtectedBranch] - - """Information to aid in pagination.""" - pageInfo: PageInfo! - - """Identifies the total count of items in the connection.""" - totalCount: Int! -} - -"""An edge in a connection.""" -type ProtectedBranchEdge { - """A cursor for use in pagination.""" - cursor: String! - - """The item at the end of the edge.""" - node: ProtectedBranch -} - """A user's public key.""" type PublicKey implements Node { """The last time this authorization was used to perform an action""" @@ -6546,9 +7423,7 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & """A list of Users assigned to this object.""" assignees( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6582,6 +7457,9 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & """ baseRefOid: GitObjectID! + """The repository associated with this pull request's base Ref.""" + baseRepository: Repository + """The body as Markdown.""" body: String! @@ -6602,9 +7480,7 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & """A list of comments associated with the pull request.""" comments( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6623,9 +7499,7 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & A list of commits present in this pull request's head branch not present in the base branch. """ commits( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6657,9 +7531,7 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & """Lists the files changed within this pull request.""" files( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6706,9 +7578,7 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & """A list of labels associated with the object.""" labels( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6759,9 +7629,7 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & A list of Users that are participating in the Pull Request conversation. """ participants( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6789,9 +7657,7 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & """List of project cards associated with this pull request.""" projectCards( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6817,9 +7683,7 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & """A list of Reactions left on the Issue.""" reactions( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6854,9 +7718,7 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & """A list of review requests associated with the pull request.""" reviewRequests( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6873,9 +7735,7 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & """The list of all review threads for this pull request.""" reviewThreads( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6892,9 +7752,7 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & """A list of reviews associated with the pull request.""" reviews( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6930,9 +7788,35 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & """Allows filtering timeline events by a `since` timestamp.""" since: DateTime + """Returns the elements in the list that come after the specified cursor.""" + after: String + """ - Returns the elements in the list that come after the specified cursor. + 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 + ): PullRequestTimelineConnection! + + """ + A list of events, comments, commits, etc. associated with the pull request. + """ + timelineItems( + """Filter timeline items by a `since` timestamp.""" + since: DateTime + + """Skips the first _n_ elements in the list.""" + skip: Int + + """Filter timeline items by type.""" + itemTypes: [PullRequestTimelineItemsItemType!] + + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -6945,7 +7829,7 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & """Returns the last _n_ elements from the list.""" last: Int - ): PullRequestTimelineConnection! + ): PullRequestTimelineItemsConnection! """Identifies the pull request title.""" title: String! @@ -6958,9 +7842,7 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & """A list of edits to this content.""" userContentEdits( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -7053,6 +7935,42 @@ type PullRequestCommit implements Node & UniformResourceLocatable { url: URI! } +"""Represents a commit comment thread part of a pull request.""" +type PullRequestCommitCommentThread implements Node & RepositoryNode { + """The comments that exist in this thread.""" + comments( + """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 + ): CommitCommentConnection! + + """The commit the comments were made on.""" + commit: Commit! + id: ID! + + """The file the comments were made on.""" + path: String + + """The position in the diff for the commit that the comment was made on.""" + position: Int + + """The pull request this commit comment thread belongs to""" + pullRequest: PullRequest! + + """The repository associated with this node.""" + repository: Repository! +} + """The connection type for PullRequestCommit.""" type PullRequestCommitConnection { """A list of edges.""" @@ -7077,19 +7995,45 @@ type PullRequestCommitEdge { node: PullRequestCommit } -"""The connection type for PullRequest.""" -type PullRequestConnection { - """A list of edges.""" - edges: [PullRequestEdge] +"""The connection type for PullRequest.""" +type PullRequestConnection { + """A list of edges.""" + edges: [PullRequestEdge] + + """A list of nodes.""" + nodes: [PullRequest] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! +} + +"""This aggregates pull requests opened by a user within one repository.""" +type PullRequestContributionsByRepository { + """The pull request contributions.""" + contributions( + """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 - """A list of nodes.""" - nodes: [PullRequest] + """Returns the last _n_ elements from the list.""" + last: Int - """Information to aid in pagination.""" - pageInfo: PageInfo! + """Ordering options for contributions returned from the connection.""" + orderBy: ContributionOrder + ): CreatedPullRequestContributionConnection! - """Identifies the total count of items in the connection.""" - totalCount: Int! + """The repository in which the pull requests were opened.""" + repository: Repository! } """An edge in a connection.""" @@ -7156,9 +8100,7 @@ type PullRequestReview implements Node & Comment & Deletable & Updatable & Updat """A list of review comments for the current pull request review.""" comments( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -7199,9 +8141,7 @@ type PullRequestReview implements Node & Comment & Deletable & Updatable & Updat """A list of teams that this review was made on behalf of.""" onBehalfOf( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -7227,9 +8167,7 @@ type PullRequestReview implements Node & Comment & Deletable & Updatable & Updat """A list of Reactions left on the Issue.""" reactions( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -7270,9 +8208,7 @@ type PullRequestReview implements Node & Comment & Deletable & Updatable & Updat """A list of edits to this content.""" userContentEdits( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -7385,9 +8321,7 @@ type PullRequestReviewComment implements Node & Comment & Deletable & Updatable """A list of Reactions left on the Issue.""" reactions( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -7428,9 +8362,7 @@ type PullRequestReviewComment implements Node & Comment & Deletable & Updatable """A list of edits to this content.""" userContentEdits( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -7512,6 +8444,34 @@ type PullRequestReviewConnection { totalCount: Int! } +""" +This aggregates pull request reviews made by a user within one repository. +""" +type PullRequestReviewContributionsByRepository { + """The pull request review contributions.""" + contributions( + """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 + + """Ordering options for contributions returned from the connection.""" + orderBy: ContributionOrder + ): CreatedPullRequestReviewContributionConnection! + + """The repository in which the pull request reviews were made.""" + repository: Repository! +} + """An edge in a connection.""" type PullRequestReviewEdge { """A cursor for use in pagination.""" @@ -7558,9 +8518,7 @@ enum PullRequestReviewState { type PullRequestReviewThread implements Node { """A list of pull request comments associated with the thread.""" comments( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -7619,6 +8577,20 @@ type PullRequestReviewThreadEdge { node: PullRequestReviewThread } +""" +Represents the latest point in the pull request timeline for which the viewer has seen the pull request's commits. +""" +type PullRequestRevisionMarker { + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + + """The last commit the viewer has seen.""" + lastSeenCommit: Commit! + + """The pull request to which the marker belongs.""" + pullRequest: PullRequest! +} + """The possible states of a pull request.""" enum PullRequestState { """A pull request that is still open.""" @@ -7647,7 +8619,7 @@ type PullRequestTimelineConnection { } """An item in an pull request timeline""" -union PullRequestTimelineItem = Commit | CommitCommentThread | PullRequestReview | PullRequestReviewThread | PullRequestReviewComment | IssueComment | ClosedEvent | ReopenedEvent | SubscribedEvent | UnsubscribedEvent | MergedEvent | ReferencedEvent | CrossReferencedEvent | AssignedEvent | UnassignedEvent | LabeledEvent | UnlabeledEvent | MilestonedEvent | DemilestonedEvent | RenamedTitleEvent | LockedEvent | UnlockedEvent | DeployedEvent | DeploymentEnvironmentChangedEvent | HeadRefDeletedEvent | HeadRefRestoredEvent | HeadRefForcePushedEvent | BaseRefForcePushedEvent | ReviewRequestedEvent | ReviewRequestRemovedEvent | ReviewDismissedEvent +union PullRequestTimelineItem = Commit | CommitCommentThread | PullRequestReview | PullRequestReviewThread | PullRequestReviewComment | IssueComment | ClosedEvent | ReopenedEvent | SubscribedEvent | UnsubscribedEvent | MergedEvent | ReferencedEvent | CrossReferencedEvent | AssignedEvent | UnassignedEvent | LabeledEvent | UnlabeledEvent | MilestonedEvent | DemilestonedEvent | RenamedTitleEvent | LockedEvent | UnlockedEvent | DeployedEvent | DeploymentEnvironmentChangedEvent | HeadRefDeletedEvent | HeadRefRestoredEvent | HeadRefForcePushedEvent | BaseRefForcePushedEvent | ReviewRequestedEvent | ReviewRequestRemovedEvent | ReviewDismissedEvent | UserBlockedEvent """An edge in a connection.""" type PullRequestTimelineItemEdge { @@ -7659,7 +8631,35 @@ type PullRequestTimelineItemEdge { } """An item in a pull request timeline""" -union PullRequestTimelineItems = PullRequestCommit | PullRequestReview | PullRequestReviewThread | BaseRefChangedEvent | BaseRefForcePushedEvent | DeployedEvent | DeploymentEnvironmentChangedEvent | HeadRefDeletedEvent | HeadRefForcePushedEvent | HeadRefRestoredEvent | MergedEvent | ReviewDismissedEvent | ReviewRequestedEvent | ReviewRequestRemovedEvent | IssueComment | CrossReferencedEvent | AddedToProjectEvent | AssignedEvent | ClosedEvent | CommentDeletedEvent | ConvertedNoteToIssueEvent | DemilestonedEvent | LabeledEvent | LockedEvent | MentionedEvent | MilestonedEvent | MovedColumnsInProjectEvent | PinnedEvent | ReferencedEvent | RemovedFromProjectEvent | RenamedTitleEvent | ReopenedEvent | SubscribedEvent | TransferredEvent | UnassignedEvent | UnlabeledEvent | UnlockedEvent | UnpinnedEvent | UnsubscribedEvent +union PullRequestTimelineItems = PullRequestCommit | PullRequestCommitCommentThread | PullRequestReview | PullRequestReviewThread | PullRequestRevisionMarker | BaseRefChangedEvent | BaseRefForcePushedEvent | DeployedEvent | DeploymentEnvironmentChangedEvent | HeadRefDeletedEvent | HeadRefForcePushedEvent | HeadRefRestoredEvent | MergedEvent | ReviewDismissedEvent | ReviewRequestedEvent | ReviewRequestRemovedEvent | IssueComment | CrossReferencedEvent | AddedToProjectEvent | AssignedEvent | ClosedEvent | CommentDeletedEvent | ConvertedNoteToIssueEvent | DemilestonedEvent | LabeledEvent | LockedEvent | MentionedEvent | MilestonedEvent | MovedColumnsInProjectEvent | PinnedEvent | ReferencedEvent | RemovedFromProjectEvent | RenamedTitleEvent | ReopenedEvent | SubscribedEvent | TransferredEvent | UnassignedEvent | UnlabeledEvent | UnlockedEvent | UserBlockedEvent | UnpinnedEvent | UnsubscribedEvent + +"""The connection type for PullRequestTimelineItems.""" +type PullRequestTimelineItemsConnection { + """A list of edges.""" + edges: [PullRequestTimelineItemsEdge] + + """ + Identifies the count of items after applying `before` and `after` filters. + """ + filteredCount: Int! + + """A list of nodes.""" + nodes: [PullRequestTimelineItems] + + """ + Identifies the count of items after applying `before`/`after` filters and `first`/`last`/`skip` slicing. + """ + pageCount: Int! + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! + + """Identifies the date and time when the timeline was last updated.""" + updatedAt: DateTime! +} """An edge in a connection.""" type PullRequestTimelineItemsEdge { @@ -7745,9 +8745,7 @@ enum PullRequestTimelineItemsItemType { """Represents a 'closed' event on any `Closable`.""" CLOSED_EVENT - """ - Represents a 'comment_deleted' event on a given issue or pull request. - """ + """Represents a 'comment_deleted' event on a given issue or pull request.""" COMMENT_DELETED_EVENT """ @@ -7807,6 +8805,9 @@ enum PullRequestTimelineItemsItemType { """Represents an 'unlocked' event on a given issue or pull request.""" UNLOCKED_EVENT + """Represents a 'user_blocked' event on a given user.""" + USER_BLOCKED_EVENT + """Represents an 'unpinned' event on a given issue or pull request.""" UNPINNED_EVENT @@ -7814,6 +8815,26 @@ enum PullRequestTimelineItemsItemType { UNSUBSCRIBED_EVENT } +"""A Git push.""" +type Push implements Node { + id: ID! + + """The SHA after the push""" + nextSha: GitObjectID + + """The permalink for this push.""" + permalink: URI! + + """The SHA before the push""" + previousSha: GitObjectID + + """The user who pushed""" + pusher: User! + + """The repository that was pushed to""" + repository: Repository! +} + """A team or user who has the ability to push to a protected branch.""" type PushAllowance implements Node { """The actor that can push.""" @@ -7904,9 +8925,7 @@ type Query { """Look up Marketplace listings""" marketplaceListings( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -8017,9 +9036,7 @@ type Query { """Perform a search across resources.""" search( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -8054,9 +9071,7 @@ type Query { """Filter advisories to those updated since a time in the past.""" updatedSince: DateTime - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -8091,9 +9106,7 @@ type Query { """A list of severities to filter vulnerabilities by.""" severities: [SecurityAdvisorySeverity!] - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -8157,9 +9170,7 @@ interface Reactable { """A list of Reactions left on the Issue.""" reactions( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -8299,9 +9310,7 @@ type ReactionGroup { Users who have reacted to the reaction subject with the emotion represented by this reaction group """ users( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -8356,9 +9365,7 @@ type Ref implements Node { """Ordering options for pull requests returned from the connection.""" orderBy: IssueOrder - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -8459,17 +9466,6 @@ enum RefOrderField { ALPHABETICAL } -""" -Autogenerated input type of RegenerateBusinessIdentityProviderRecoveryCodes -""" -input RegenerateBusinessIdentityProviderRecoveryCodesInput { - """The ID of the business on which to set an Identity Provider.""" - businessId: ID! - - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} - """Represents an owner of a registry package.""" interface RegistryPackageOwner { id: ID! @@ -8506,9 +9502,7 @@ type Release implements Node & UniformResourceLocatable { """List of releases assets which are dependent on this release.""" releaseAssets( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -8644,34 +9638,22 @@ enum ReleaseOrderField { NAME } -"""Autogenerated input type of RemoveBusinessAdmin""" -input RemoveBusinessAdminInput { - """The Business ID to update.""" - businessId: ID! - - """The login of the user to add as an admin.""" - login: String! - - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} - -"""Autogenerated input type of RemoveBusinessBillingManager""" -input RemoveBusinessBillingManagerInput { - """The Business ID to update.""" - businessId: ID! +"""Autogenerated input type of RemoveAssigneesFromAssignable""" +input RemoveAssigneesFromAssignableInput { + """The id of the assignable object to remove assignees from.""" + assignableId: ID! - """The login of the user to add as a billing manager.""" - login: String! + """The id of users to remove as assignees.""" + assigneeIds: [ID!]! """A unique identifier for the client performing the mutation.""" clientMutationId: String } -"""Autogenerated input type of RemoveBusinessIdentityProvider""" -input RemoveBusinessIdentityProviderInput { - """The ID of the business from which to remove the Identity Provider.""" - businessId: ID! +"""Autogenerated return type of RemoveAssigneesFromAssignable""" +type RemoveAssigneesFromAssignablePayload { + """The item that was unassigned.""" + assignable: Assignable """A unique identifier for the client performing the mutation.""" clientMutationId: String @@ -8692,6 +9674,27 @@ type RemovedFromProjectEvent implements Node { id: ID! } +"""Autogenerated input type of RemoveLabelsFromLabelable""" +input RemoveLabelsFromLabelableInput { + """The id of the Labelable to remove labels from.""" + labelableId: ID! + + """The ids of labels to remove.""" + labelIds: [ID!]! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of RemoveLabelsFromLabelable""" +type RemoveLabelsFromLabelablePayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The Labelable the labels were removed from.""" + labelable: Labelable +} + """Autogenerated input type of RemoveOutsideCollaborator""" input RemoveOutsideCollaboratorInput { """The ID of the outside collaborator to remove.""" @@ -8790,6 +9793,24 @@ type ReopenedEvent implements Node { id: ID! } +"""Autogenerated input type of ReopenIssue""" +input ReopenIssueInput { + """ID of the issue to be opened.""" + issueId: ID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of ReopenIssue""" +type ReopenIssuePayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The issue that was opened.""" + issue: Issue +} + """Autogenerated input type of ReopenPullRequest""" input ReopenPullRequestInput { """ID of the pull request to be reopened.""" @@ -8830,9 +9851,7 @@ enum ReportedContentClassifiers { type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscribable & Starrable & UniformResourceLocatable & RepositoryInfo { """A list of users that can be assigned to issues in this repository.""" assignableUsers( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -8849,9 +9868,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """A list of branch protection rules for this repository.""" branchProtectionRules( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -8874,9 +9891,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """Collaborators affiliation level with a repository.""" affiliation: CollaboratorAffiliation - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -8893,9 +9908,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """A list of commit comments associated with the repository.""" commitComments( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -8921,9 +9934,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """A list of deploy keys that are on this repository.""" deployKeys( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -8946,9 +9957,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """Ordering options for deployments returned from the connection.""" orderBy: DeploymentOrder - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9004,9 +10013,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """ isLocked: Boolean - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9034,6 +10041,9 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """Indicates if the repository is unmaintained.""" isArchived: Boolean! + """Returns whether or not this repository disabled.""" + isDisabled: Boolean! + """Identifies if the repository is a fork.""" isFork: Boolean! @@ -9071,9 +10081,10 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """A list of states to filter the issues by.""" states: [IssueState!] - """ - Returns the elements in the list that come after the specified cursor. - """ + """Filtering options for issues returned from the connection.""" + filterBy: IssueFilters + + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9096,9 +10107,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """A list of labels associated with the repository.""" labels( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9120,9 +10129,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib A list containing a breakdown of the language composition of the repository. """ languages( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9150,9 +10157,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib A list of Users that can be mentioned in the context of the repository. """ mentionableUsers( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9178,9 +10183,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """A list of milestones associated with the repository.""" milestones( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9245,9 +10248,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """A list of states to filter the projects by.""" states: [ProjectState!] - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9268,25 +10269,6 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """The HTTP URL listing the repository's projects""" projectsUrl: URI! - """A list of protected branches that are on this repository.""" - protectedBranches( - """ - 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 - ): ProtectedBranchConnection! @deprecated(reason: "The `ProtectedBranch` type is deprecated and will be removed soon. Use `Repository.branchProtectionRules` instead. Removal on 2019-01-01 UTC.") - """Returns a single pull request from the current repository by number.""" pullRequest( """The number for the pull request to be returned.""" @@ -9310,9 +10292,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """Ordering options for pull requests returned from the connection.""" orderBy: IssueOrder - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9344,9 +10324,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """Fetch a list of refs from the repository""" refs( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9378,9 +10356,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """List of releases which are dependent on this repository.""" releases( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9400,9 +10376,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """A list of applied repository-topic associations for this repository.""" repositoryTopics( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9436,9 +10410,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """A list of users who have starred this starrable.""" stargazers( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9462,9 +10434,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """The HTTP URL for this repository""" url: URI! - """ - Indicates whether the viewer has admin permissions on this repository. - """ + """Indicates whether the viewer has admin permissions on this repository.""" viewerCanAdminister: Boolean! """Can the current viewer create new projects on this owner.""" @@ -9475,9 +10445,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """ viewerCanSubscribe: Boolean! - """ - Indicates whether the viewer can update the topics of this repository. - """ + """Indicates whether the viewer can update the topics of this repository.""" viewerCanUpdateTopics: Boolean! """ @@ -9497,9 +10465,7 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """A list of users watching the repository.""" watchers( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9562,6 +10528,9 @@ type RepositoryCollaboratorEdge { """The permission the user has on the repository.""" permission: RepositoryPermission! + + """A list of sources for the user's access to the repository.""" + permissionSources: [PermissionSource!] } """A list of repositories owned by the subject.""" @@ -9756,67 +10725,23 @@ enum RepositoryOrderField { PUSHED_AT """Order repositories by name""" - NAME - - """Order repositories by number of stargazers""" - STARGAZERS -} - -"""Represents an owner of a Repository.""" -interface RepositoryOwner { - """A URL pointing to the owner's public avatar.""" - avatarUrl( - """The size of the resulting square image.""" - size: Int - ): URI! - id: ID! - - """The username used to login.""" - login: String! - - """A list of repositories this user has pinned to their profile""" - pinnedRepositories( - """If non-null, filters repositories according to privacy""" - privacy: RepositoryPrivacy - - """Ordering options for repositories returned from the connection""" - orderBy: RepositoryOrder - - """ - Array of viewer's affiliation options for repositories returned from the - connection. For example, OWNER will include only repositories that the - current viewer owns. - """ - affiliations: [RepositoryAffiliation] - - """ - Array of owner's affiliation options for repositories returned from the - connection. For example, OWNER will include only repositories that the - organization or user being viewed owns. - """ - ownerAffiliations: [RepositoryAffiliation] - - """ - If non-null, filters repositories according to whether they have been locked - """ - isLocked: Boolean - - """ - Returns the elements in the list that come after the specified cursor. - """ - after: String + NAME - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String + """Order repositories by number of stargazers""" + STARGAZERS +} - """Returns the first _n_ elements from the list.""" - first: Int +"""Represents an owner of a Repository.""" +interface RepositoryOwner { + """A URL pointing to the owner's public avatar.""" + avatarUrl( + """The size of the resulting square image.""" + size: Int + ): URI! + id: ID! - """Returns the last _n_ elements from the list.""" - last: Int - ): RepositoryConnection! + """The username used to login.""" + login: String! """A list of repositories that the user owns.""" repositories( @@ -9845,9 +10770,7 @@ interface RepositoryOwner { """ isLocked: Boolean - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -9939,6 +10862,18 @@ type RepositoryTopicEdge { node: RepositoryTopic } +"""The possible states that can be requested when creating a check run.""" +enum RequestableCheckStatusState { + """The check suite or run has been queued.""" + QUEUED + + """The check suite or run is in progress.""" + IN_PROGRESS + + """The check suite or run has been completed.""" + COMPLETED +} + """Types that can be requested reviewers.""" union RequestedReviewer = User | Team @@ -9972,6 +10907,27 @@ type RequestReviewsPayload { requestedReviewersEdge: UserEdge } +"""Autogenerated input type of RerequestCheckSuite""" +input RerequestCheckSuiteInput { + """The Node ID of the repository.""" + repositoryId: ID! + + """The Node ID of the check suite.""" + checkSuiteId: ID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of RerequestCheckSuite""" +type RerequestCheckSuitePayload { + """The requested check suite.""" + checkSuite: CheckSuite + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + """Autogenerated input type of ResolveReviewThread""" input ResolveReviewThreadInput { """The ID of the thread to resolve""" @@ -10081,12 +11037,6 @@ type ReviewDismissedEvent implements Node & UniformResourceLocatable { dismissalMessageHTML: String id: ID! - """Identifies the message associated with the 'review_dismissed' event.""" - message: String! @deprecated(reason: "`message` is being removed because it not nullable, whereas the underlying field is optional. Use `dismissalMessage` instead. Removal on 2019-07-01 UTC.") - - """The message associated with the event, rendered to HTML.""" - messageHtml: HTML! @deprecated(reason: "`messageHtml` is being removed because it not nullable, whereas the underlying field is optional. Use `dismissalMessageHTML` instead. Removal on 2019-07-01 UTC.") - """ Identifies the previous state of the review with the 'review_dismissed' event. """ @@ -10275,9 +11225,7 @@ type SecurityAdvisory implements Node { """A list of severities to filter vulnerabilities by.""" severities: [SecurityAdvisorySeverity!] - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -10482,34 +11430,12 @@ input SecurityVulnerabilityOrder { direction: OrderDirection! } -""" -Properties by which security vulnerability connections can be ordered. -""" +"""Properties by which security vulnerability connections can be ordered.""" enum SecurityVulnerabilityOrderField { """Order vulnerability by update time""" UPDATED_AT } -"""Autogenerated input type of SetBusinessIdentityProvider""" -input SetBusinessIdentityProviderInput { - """The ID of the business on which to set an Identity Provider.""" - businessId: ID! - - """The URL endpoint for the Identity Provider's SAML SSO.""" - ssoUrl: URI! - - """The Issuer Entity ID for the SAML Identity Provider""" - issuer: String - - """ - The x509 certificate used by the Identity Provider to sign assertions and responses. - """ - idpCertificate: String! - - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} - """Represents an S/MIME signature on a Commit or Tag.""" type SmimeSignature implements GitSignature { """Email used to sign this object.""" @@ -10585,9 +11511,7 @@ interface Starrable { """A list of users who have starred this starrable.""" stargazers( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -10811,9 +11735,7 @@ type Tag implements Node & GitObject { type Team implements Node & Subscribable & MemberStatusable { """A list of teams that are ancestors of this team.""" ancestors( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -10845,9 +11767,7 @@ type Team implements Node & Subscribable & MemberStatusable { """Whether to list immediate child teams or all descendant child teams.""" immediateOnly: Boolean = true - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -10880,9 +11800,7 @@ type Team implements Node & Subscribable & MemberStatusable { """A list of pending invitations for users to this team""" invitations( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -10901,9 +11819,7 @@ type Team implements Node & Subscribable & MemberStatusable { Get the status messages members of this entity have set that are either public or visible only to the organization. """ memberStatuses( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -10923,9 +11839,7 @@ type Team implements Node & Subscribable & MemberStatusable { """A list of users who are members of this team.""" members( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -10978,9 +11892,7 @@ type Team implements Node & Subscribable & MemberStatusable { """A list of repositories this team has access to.""" repositories( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -11268,9 +12180,7 @@ type Topic implements Node & Starrable { """A list of users who have starred this starrable.""" stargazers( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -11495,6 +12405,29 @@ type UnlockLockablePayload { unlockedRecord: Lockable } +"""Autogenerated input type of UnmarkIssueAsDuplicate""" +input UnmarkIssueAsDuplicateInput { + """ID of the issue or pull request currently marked as a duplicate.""" + duplicateId: ID! + + """ + ID of the issue or pull request currently considered canonical/authoritative/original. + """ + canonicalId: ID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of UnmarkIssueAsDuplicate""" +type UnmarkIssueAsDuplicatePayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The issue or pull request that was marked as a duplicate.""" + duplicate: IssueOrPullRequest +} + """Autogenerated input type of UnminimizeComment""" input UnminimizeCommentInput { """The Node ID of the subject to modify.""" @@ -11635,160 +12568,137 @@ type UpdateBranchProtectionRulePayload { clientMutationId: String } -""" -Autogenerated input type of UpdateBusinessAllowPrivateRepositoryForkingSetting -""" -input UpdateBusinessAllowPrivateRepositoryForkingSettingInput { - """ - The ID of the business on which to set the allow private repository forking setting. - """ - businessId: ID! +"""Autogenerated input type of UpdateCheckRun""" +input UpdateCheckRunInput { + """The node ID of the repository.""" + repositoryId: ID! - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} + """The node of the check.""" + checkRunId: ID! + + """The name of the check.""" + name: String -""" -Autogenerated input type of UpdateBusinessDefaultRepositoryPermissionSetting -""" -input UpdateBusinessDefaultRepositoryPermissionSettingInput { """ - The ID of the business on which to set the default repository permission setting. + The URL of the integrator's site that has the full details of the check. """ - businessId: ID! + detailsUrl: URI - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} + """A reference for the run on the integrator's system.""" + externalId: String + + """The current status.""" + status: RequestableCheckStatusState + + """The time that the check run began.""" + startedAt: DateTime + + """The final conclusion of the check.""" + conclusion: CheckConclusionState + + """The time that the check run finished.""" + completedAt: DateTime + + """Descriptive details about the run.""" + output: CheckRunOutput -""" -Autogenerated input type of UpdateBusinessMembersCanChangeRepositoryVisibilitySetting -""" -input UpdateBusinessMembersCanChangeRepositoryVisibilitySettingInput { """ - The ID of the business on which to set the members can change repository visibility setting. + Possible further actions the integrator can perform, which a user may trigger. """ - businessId: ID! + actions: [CheckRunAction!] """A unique identifier for the client performing the mutation.""" clientMutationId: String } -""" -Autogenerated input type of UpdateBusinessMembersCanCreateRepositoriesSetting -""" -input UpdateBusinessMembersCanCreateRepositoriesSettingInput { - """ - The ID of the business on which to set the members can create repositories setting. - """ - businessId: ID! +"""Autogenerated return type of UpdateCheckRun""" +type UpdateCheckRunPayload { + """The updated check run.""" + checkRun: CheckRun """A unique identifier for the client performing the mutation.""" clientMutationId: String } -""" -Autogenerated input type of UpdateBusinessMembersCanDeleteIssuesSetting -""" -input UpdateBusinessMembersCanDeleteIssuesSettingInput { - """ - The ID of the business on which to set the members can delete issues setting. - """ - businessId: ID! +"""Autogenerated input type of UpdateCheckSuitePreferences""" +input UpdateCheckSuitePreferencesInput { + """The Node ID of the repository.""" + repositoryId: ID! + + """The check suite preferences to modify.""" + autoTriggerPreferences: [CheckSuiteAutoTriggerPreference!]! """A unique identifier for the client performing the mutation.""" clientMutationId: String } -""" -Autogenerated input type of UpdateBusinessMembersCanDeleteRepositoriesSetting -""" -input UpdateBusinessMembersCanDeleteRepositoriesSettingInput { - """ - The ID of the business on which to set the members can delete repositories setting. - """ - businessId: ID! - +"""Autogenerated return type of UpdateCheckSuitePreferences""" +type UpdateCheckSuitePreferencesPayload { """A unique identifier for the client performing the mutation.""" clientMutationId: String + + """The updated repository.""" + repository: Repository } -""" -Autogenerated input type of UpdateBusinessMembersCanInviteCollaboratorsSetting -""" -input UpdateBusinessMembersCanInviteCollaboratorsSettingInput { - """ - The ID of the business on which to set the members can invite collaborators setting. - """ - businessId: ID! +"""Autogenerated input type of UpdateIssueComment""" +input UpdateIssueCommentInput { + """The ID of the IssueComment to modify.""" + id: ID! + + """The updated text of the comment.""" + body: String! """A unique identifier for the client performing the mutation.""" clientMutationId: String } -"""Autogenerated input type of UpdateBusinessOrganizationProjectsSetting""" -input UpdateBusinessOrganizationProjectsSettingInput { - """ - The ID of the business on which to set the organization projects setting. - """ - businessId: ID! - +"""Autogenerated return type of UpdateIssueComment""" +type UpdateIssueCommentPayload { """A unique identifier for the client performing the mutation.""" clientMutationId: String -} -"""Autogenerated input type of UpdateBusinessProfile""" -input UpdateBusinessProfileInput { - """The Business ID to update.""" - businessId: ID! + """The updated comment.""" + issueComment: IssueComment +} - """The name of business.""" - name: String +"""Autogenerated input type of UpdateIssue""" +input UpdateIssueInput { + """The ID of the Issue to modify.""" + id: ID! - """The description of the business.""" - description: String + """The title for the issue.""" + title: String - """The URL of the business's website""" - websiteUrl: String + """The body for the issue description.""" + body: String - """The location of the business""" - location: String + """An array of Node IDs of users for this issue.""" + assigneeIds: [ID!] - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} + """The Node ID of the milestone for this issue.""" + milestoneId: ID -"""Autogenerated input type of UpdateBusinessRepositoryProjectsSetting""" -input UpdateBusinessRepositoryProjectsSettingInput { - """ - The ID of the business on which to set the repository projects setting. - """ - businessId: ID! + """An array of Node IDs of labels for this issue.""" + labelIds: [ID!] - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} + """The desired issue state.""" + state: IssueState -"""Autogenerated input type of UpdateBusinessTeamDiscussionsSetting""" -input UpdateBusinessTeamDiscussionsSettingInput { - """The ID of the business on which to set the team discussions setting.""" - businessId: ID! + """An array of Node IDs for projects associated with this issue.""" + projectIds: [ID!] """A unique identifier for the client performing the mutation.""" clientMutationId: String } -""" -Autogenerated input type of UpdateBusinessTwoFactorAuthenticationRequiredSetting -""" -input UpdateBusinessTwoFactorAuthenticationRequiredSettingInput { - """ - The ID of the business on which to set the two factor authentication required setting. - """ - businessId: ID! - +"""Autogenerated return type of UpdateIssue""" +type UpdateIssuePayload { """A unique identifier for the client performing the mutation.""" clientMutationId: String + + """The issue.""" + issue: Issue } """Autogenerated input type of UpdateProjectCard""" @@ -11993,7 +12903,15 @@ scalar URI """ A user is an individual's account on GitHub that owns repositories and can make new content. """ -type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch & ProjectOwner & RepositoryOwner & UniformResourceLocatable { +type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch & ProjectOwner & RepositoryOwner & UniformResourceLocatable & ProfileOwner { + """ + Determine if this repository owner has any items that can be pinned to their profile. + """ + anyPinnableItems( + """Filter to only a particular kind of pinnable item.""" + type: PinnableItemType + ): Boolean! + """A URL pointing to the user's public avatar.""" avatarUrl( """The size of the resulting square image.""" @@ -12008,9 +12926,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """A list of commit comments made by this user.""" commitComments( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12061,9 +12977,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """A list of users the given user is followed by.""" followers( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12080,9 +12994,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """A list of users the given user is following.""" following( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12105,9 +13017,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """A list of gist comments made by this user.""" gistComments( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12130,9 +13040,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """Ordering options for gists returned from the connection""" orderBy: GistOrder - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12175,9 +13083,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """A list of issue comments made by this user.""" issueComments( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12203,9 +13109,10 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """A list of states to filter the issues by.""" states: [IssueState!] - """ - Returns the elements in the list that come after the specified cursor. - """ + """Filtering options for issues returned from the connection.""" + filterBy: IssueFilters + + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12220,6 +13127,12 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch last: Int ): IssueConnection! + """ + Showcases a selection of repositories and gists that the profile owner has + either curated or that have been selected automatically based on popularity. + """ + itemShowcase: ProfileItemShowcase! + """The user's public profile location.""" location: String @@ -12237,9 +13150,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """A list of organizations the user belongs to.""" organizations( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12254,36 +13165,36 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch last: Int ): OrganizationConnection! - """A list of repositories this user has pinned to their profile""" - pinnedRepositories( - """If non-null, filters repositories according to privacy""" - privacy: RepositoryPrivacy + """ + A list of repositories and gists this profile owner can pin to their profile. + """ + pinnableItems( + """Filter the types of pinnable items that are returned.""" + types: [PinnableItemType!] - """Ordering options for repositories returned from the connection""" - orderBy: RepositoryOrder + """Returns the elements in the list that come after the specified cursor.""" + after: String """ - Array of viewer's affiliation options for repositories returned from the - connection. For example, OWNER will include only repositories that the - current viewer owns. + Returns the elements in the list that come before the specified cursor. """ - affiliations: [RepositoryAffiliation] + before: String - """ - Array of owner's affiliation options for repositories returned from the - connection. For example, OWNER will include only repositories that the - organization or user being viewed owns. - """ - ownerAffiliations: [RepositoryAffiliation] + """Returns the first _n_ elements from the list.""" + first: Int - """ - If non-null, filters repositories according to whether they have been locked - """ - isLocked: Boolean + """Returns the last _n_ elements from the list.""" + last: Int + ): PinnableItemConnection! - """ - Returns the elements in the list that come after the specified cursor. - """ + """ + A list of repositories and gists this profile owner has pinned to their profile + """ + pinnedItems( + """Filter the types of pinned items that are returned.""" + types: [PinnableItemType!] + + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12296,7 +13207,12 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """Returns the last _n_ elements from the list.""" last: Int - ): RepositoryConnection! + ): PinnableItemConnection! + + """ + Returns how many more items this profile owner can pin to their profile. + """ + pinnedItemsRemaining: Int! """Find project by number.""" project( @@ -12315,9 +13231,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """A list of states to filter the projects by.""" states: [ProjectState!] - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12340,9 +13254,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """A list of public keys associated with this user.""" publicKeys( - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12374,9 +13286,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """Ordering options for pull requests returned from the connection.""" orderBy: IssueOrder - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12418,9 +13328,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """ isLocked: Boolean - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12462,9 +13370,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """ contributionTypes: [RepositoryContributionType] - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12498,9 +13404,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """Order for connection""" orderBy: StarOrder - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12524,6 +13428,9 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """The HTTP URL for this user""" url: URI! + """Can the viewer pin repositories and gists to the profile?""" + viewerCanChangePinnedItems: Boolean! + """Can the current viewer create new projects on this owner.""" viewerCanCreateProjects: Boolean! @@ -12556,9 +13463,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """ isLocked: Boolean - """ - Returns the elements in the list that come after the specified cursor. - """ + """Returns the elements in the list that come after the specified cursor.""" after: String """ @@ -12577,6 +13482,40 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch websiteUrl: URI } +"""The possible durations that a user can be blocked for.""" +enum UserBlockDuration { + """The user was blocked for 1 day""" + ONE_DAY + + """The user was blocked for 3 days""" + THREE_DAYS + + """The user was blocked for 7 days""" + ONE_WEEK + + """The user was blocked for 30 days""" + ONE_MONTH + + """The user was blocked permanently""" + PERMANENT +} + +"""Represents a 'user_blocked' event on a given user.""" +type UserBlockedEvent implements Node { + """Identifies the actor who performed the event.""" + actor: Actor + + """Number of days that the user was blocked for.""" + blockDuration: UserBlockDuration! + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + id: ID! + + """The user who was blocked.""" + subject: User +} + """The connection type for User.""" type UserConnection { """A list of edges."""