github-schema 1.7.9 → 1.7.11

package/github-schema.graphql

@@ -4279,6 +4279,76 @@ type CodeOfConduct implements Node {
   url: URI
 }
 
+"""
+Choose which tools must provide code scanning results before the reference is
+updated. When configured, code scanning must be enabled and have results for
+both the commit and the reference being updated.
+"""
+type CodeScanningParameters {
+  """
+  Tools that must provide code scanning results for this rule to pass.
+  """
+  codeScanningTools: [CodeScanningTool!]!
+}
+
+"""
+Choose which tools must provide code scanning results before the reference is
+updated. When configured, code scanning must be enabled and have results for
+both the commit and the reference being updated.
+"""
+input CodeScanningParametersInput {
+  """
+  Tools that must provide code scanning results for this rule to pass.
+  """
+  codeScanningTools: [CodeScanningToolInput!]!
+}
+
+"""
+A tool that must provide code scanning results for this rule to pass.
+"""
+type CodeScanningTool {
+  """
+  The severity level at which code scanning results that raise alerts block a
+  reference update. For more information on alert severity levels, see "[About code scanning alerts](${externalDocsUrl}/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts#about-alert-severity-and-security-severity-levels)."
+  """
+  alertsThreshold: String!
+
+  """
+  The severity level at which code scanning results that raise security alerts
+  block a reference update. For more information on security severity levels,
+  see "[About code scanning alerts](${externalDocsUrl}/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts#about-alert-severity-and-security-severity-levels)."
+  """
+  securityAlertsThreshold: String!
+
+  """
+  The name of a code scanning tool
+  """
+  tool: String!
+}
+
+"""
+A tool that must provide code scanning results for this rule to pass.
+"""
+input CodeScanningToolInput {
+  """
+  The severity level at which code scanning results that raise alerts block a
+  reference update. For more information on alert severity levels, see "[About code scanning alerts](${externalDocsUrl}/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts#about-alert-severity-and-security-severity-levels)."
+  """
+  alertsThreshold: String!
+
+  """
+  The severity level at which code scanning results that raise security alerts
+  block a reference update. For more information on security severity levels,
+  see "[About code scanning alerts](${externalDocsUrl}/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts#about-alert-severity-and-security-severity-levels)."
+  """
+  securityAlertsThreshold: String!
+
+  """
+  The name of a code scanning tool
+  """
+  tool: String!
+}
+
 """
 Collaborators affiliation level with a subject.
 """
@@ -7005,6 +7075,141 @@ type CreateCommitOnBranchPayload {
   ref: Ref
 }
 
+"""
+Autogenerated input type of CreateDeployment
+"""
+input CreateDeploymentInput {
+  """
+  Attempt to automatically merge the default branch into the requested ref, defaults to true.
+  """
+  autoMerge: Boolean = true
+
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  Short description of the deployment.
+  """
+  description: String = ""
+
+  """
+  Name for the target deployment environment.
+  """
+  environment: String = "production"
+
+  """
+  JSON payload with extra information about the deployment.
+  """
+  payload: String = "{}"
+
+  """
+  The node ID of the ref to be deployed.
+  """
+  refId: ID!
+
+  """
+  The node ID of the repository.
+  """
+  repositoryId: ID!
+
+  """
+  The status contexts to verify against commit status checks. To bypass required
+  contexts, pass an empty array. Defaults to all unique contexts.
+  """
+  requiredContexts: [String!]
+
+  """
+  Specifies a task to execute.
+  """
+  task: String = "deploy"
+}
+
+"""
+Autogenerated return type of CreateDeployment
+"""
+type CreateDeploymentPayload {
+  """
+  True if the default branch has been auto-merged into the deployment ref.
+  """
+  autoMerged: Boolean
+
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The new deployment.
+  """
+  deployment: Deployment
+}
+
+"""
+Autogenerated input type of CreateDeploymentStatus
+"""
+input CreateDeploymentStatusInput {
+  """
+  Adds a new inactive status to all non-transient, non-production environment
+  deployments with the same repository and environment name as the created
+  status's deployment.
+  """
+  autoInactive: Boolean = true
+
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The node ID of the deployment.
+  """
+  deploymentId: ID!
+
+  """
+  A short description of the status. Maximum length of 140 characters.
+  """
+  description: String = ""
+
+  """
+  If provided, updates the environment of the deploy. Otherwise, does not modify the environment.
+  """
+  environment: String
+
+  """
+  Sets the URL for accessing your environment.
+  """
+  environmentUrl: String = ""
+
+  """
+  The log URL to associate with this status.       This URL should contain
+  output to keep the user updated while the task is running       or serve as
+  historical information for what happened in the deployment.
+  """
+  logUrl: String = ""
+
+  """
+  The state of the deployment.
+  """
+  state: DeploymentStatusState!
+}
+
+"""
+Autogenerated return type of CreateDeploymentStatus
+"""
+type CreateDeploymentStatusPayload {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The new deployment status.
+  """
+  deploymentStatus: DeploymentStatus
+}
+
 """
 Autogenerated input type of CreateDiscussion
 """
@@ -9627,6 +9832,81 @@ type DependabotUpdateError {
   title: String!
 }
 
+"""
+A dependency manifest entry
+"""
+type DependencyGraphDependency {
+  """
+  Does the dependency itself have dependencies?
+  """
+  hasDependencies: Boolean!
+
+  """
+  The original name of the package, as it appears in the manifest.
+  """
+  packageLabel: String! @deprecated(reason: "`packageLabel` will be removed. Use normalized `packageName` field instead. Removal on 2022-10-01 UTC.")
+
+  """
+  The dependency package manager
+  """
+  packageManager: String
+
+  """
+  The name of the package in the canonical form used by the package manager.
+  """
+  packageName: String!
+
+  """
+  The repository containing the package
+  """
+  repository: Repository
+
+  """
+  The dependency version requirements
+  """
+  requirements: String!
+}
+
+"""
+The connection type for DependencyGraphDependency.
+"""
+type DependencyGraphDependencyConnection {
+  """
+  A list of edges.
+  """
+  edges: [DependencyGraphDependencyEdge]
+
+  """
+  A list of nodes.
+  """
+  nodes: [DependencyGraphDependency]
+
+  """
+  Information to aid in pagination.
+  """
+  pageInfo: PageInfo!
+
+  """
+  Identifies the total count of items in the connection.
+  """
+  totalCount: Int!
+}
+
+"""
+An edge in a connection.
+"""
+type DependencyGraphDependencyEdge {
+  """
+  A cursor for use in pagination.
+  """
+  cursor: String!
+
+  """
+  The item at the end of the edge.
+  """
+  node: DependencyGraphDependency
+}
+
 """
 The possible ecosystems of a dependency graph package.
 """
@@ -9687,6 +9967,111 @@ enum DependencyGraphEcosystem {
   SWIFT
 }
 
+"""
+Dependency manifest for a repository
+"""
+type DependencyGraphManifest implements Node {
+  """
+  Path to view the manifest file blob
+  """
+  blobPath: String!
+
+  """
+  A list of manifest dependencies
+  """
+  dependencies(
+    """
+    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
+  ): DependencyGraphDependencyConnection
+
+  """
+  The number of dependencies listed in the manifest
+  """
+  dependenciesCount: Int
+
+  """
+  Is the manifest too big to parse?
+  """
+  exceedsMaxSize: Boolean!
+
+  """
+  Fully qualified manifest filename
+  """
+  filename: String!
+
+  """
+  The Node ID of the DependencyGraphManifest object
+  """
+  id: ID!
+
+  """
+  Were we able to parse the manifest?
+  """
+  parseable: Boolean!
+
+  """
+  The repository containing the manifest
+  """
+  repository: Repository!
+}
+
+"""
+The connection type for DependencyGraphManifest.
+"""
+type DependencyGraphManifestConnection {
+  """
+  A list of edges.
+  """
+  edges: [DependencyGraphManifestEdge]
+
+  """
+  A list of nodes.
+  """
+  nodes: [DependencyGraphManifest]
+
+  """
+  Information to aid in pagination.
+  """
+  pageInfo: PageInfo!
+
+  """
+  Identifies the total count of items in the connection.
+  """
+  totalCount: Int!
+}
+
+"""
+An edge in a connection.
+"""
+type DependencyGraphManifestEdge {
+  """
+  A cursor for use in pagination.
+  """
+  cursor: String!
+
+  """
+  The item at the end of the edge.
+  """
+  node: DependencyGraphManifest
+}
+
 """
 A repository deploy key.
 """
@@ -10446,6 +10831,11 @@ type DeploymentStatus implements Node {
   """
   description: String
 
+  """
+  Identifies the environment of the deployment at the time of this deployment status
+  """
+  environment: String
+
   """
   Identifies the environment URL of the deployment.
   """
@@ -15423,6 +15813,50 @@ input FileDeletion {
   path: String!
 }
 
+"""
+Prevent commits that include files with specified file extensions from being
+pushed to the commit graph. NOTE: This rule is in beta and subject to change
+"""
+type FileExtensionRestrictionParameters {
+  """
+  The file extensions that are restricted from being pushed to the commit graph.
+  """
+  restrictedFileExtensions: [String!]!
+}
+
+"""
+Prevent commits that include files with specified file extensions from being
+pushed to the commit graph. NOTE: This rule is in beta and subject to change
+"""
+input FileExtensionRestrictionParametersInput {
+  """
+  The file extensions that are restricted from being pushed to the commit graph.
+  """
+  restrictedFileExtensions: [String!]!
+}
+
+"""
+Prevent commits that include changes in specified file paths from being pushed
+to the commit graph. NOTE: This rule is in beta and subject to change
+"""
+type FilePathRestrictionParameters {
+  """
+  The file paths that are restricted from being pushed to the commit graph.
+  """
+  restrictedFilePaths: [String!]!
+}
+
+"""
+Prevent commits that include changes in specified file paths from being pushed
+to the commit graph. NOTE: This rule is in beta and subject to change
+"""
+input FilePathRestrictionParametersInput {
+  """
+  The file paths that are restricted from being pushed to the commit graph.
+  """
+  restrictedFilePaths: [String!]!
+}
+
 """
 The possible viewed states of a file .
 """
@@ -16305,6 +16739,11 @@ A Git object ID.
 """
 scalar GitObjectID
 
+"""
+A fully qualified reference name (e.g. `refs/heads/master`).
+"""
+scalar GitRefname
+
 """
 Git SSH string
 """
@@ -19987,6 +20426,50 @@ type MarketplaceListingEdge {
   node: MarketplaceListing
 }
 
+"""
+Prevent commits that include file paths that exceed a specified character limit
+from being pushed to the commit graph. NOTE: This rule is in beta and subject to change
+"""
+type MaxFilePathLengthParameters {
+  """
+  The maximum amount of characters allowed in file paths
+  """
+  maxFilePathLength: Int!
+}
+
+"""
+Prevent commits that include file paths that exceed a specified character limit
+from being pushed to the commit graph. NOTE: This rule is in beta and subject to change
+"""
+input MaxFilePathLengthParametersInput {
+  """
+  The maximum amount of characters allowed in file paths
+  """
+  maxFilePathLength: Int!
+}
+
+"""
+Prevent commits that exceed a specified file size limit from being pushed to the
+commit. NOTE: This rule is in beta and subject to change
+"""
+type MaxFileSizeParameters {
+  """
+  The maximum file size allowed in megabytes. This limit does not apply to Git Large File Storage (Git LFS).
+  """
+  maxFileSize: Int!
+}
+
+"""
+Prevent commits that exceed a specified file size limit from being pushed to the
+commit. NOTE: This rule is in beta and subject to change
+"""
+input MaxFileSizeParametersInput {
+  """
+  The maximum file size allowed in megabytes. This limit does not apply to Git Large File Storage (Git LFS).
+  """
+  maxFileSize: Int!
+}
+
 """
 Represents a member feature request notification
 """
@@ -22048,6 +22531,26 @@ type Mutation {
     input: CreateCommitOnBranchInput!
   ): CreateCommitOnBranchPayload
 
+  """
+  Creates a new deployment event.
+  """
+  createDeployment(
+    """
+    Parameters for CreateDeployment
+    """
+    input: CreateDeploymentInput!
+  ): CreateDeploymentPayload
+
+  """
+  Create a deployment status.
+  """
+  createDeploymentStatus(
+    """
+    Parameters for CreateDeploymentStatus
+    """
+    input: CreateDeploymentStatusInput!
+  ): CreateDeploymentStatusPayload
+
   """
   Create a discussion.
   """
@@ -23779,6 +24282,33 @@ type Mutation {
     input: UpdateRefInput!
   ): UpdateRefPayload
 
+  """
+  Creates, updates and/or deletes multiple refs in a repository.
+
+  This mutation takes a list of `RefUpdate`s and performs these updates
+  on the repository. All updates are performed atomically, meaning that
+  if one of them is rejected, no other ref will be modified.
+
+  `RefUpdate.beforeOid` specifies that the given reference needs to point
+  to the given value before performing any updates. A value of
+  `0000000000000000000000000000000000000000` can be used to verify that
+  the references should not exist.
+
+  `RefUpdate.afterOid` specifies the value that the given reference
+  will point to after performing all updates. A value of
+  `0000000000000000000000000000000000000000` can be used to delete a
+  reference.
+
+  If `RefUpdate.force` is set to `true`, a non-fast-forward updates
+  for the given reference will be allowed.
+  """
+  updateRefs(
+    """
+    Parameters for UpdateRefs
+    """
+    input: UpdateRefsInput!
+  ): UpdateRefsPayload
+
   """
   Update information about a repository.
   """
@@ -38796,6 +39326,31 @@ enum RefOrderField {
   TAG_COMMIT_DATE
 }
 
+"""
+A ref update
+"""
+input RefUpdate {
+  """
+  The value this ref should be updated to.
+  """
+  afterOid: GitObjectID!
+
+  """
+  The value this ref needs to point to before the update.
+  """
+  beforeOid: GitObjectID
+
+  """
+  Force a non fast-forward update.
+  """
+  force: Boolean = false
+
+  """
+  The fully qualified name of the ref to be update. For example `refs/heads/branch-name`
+  """
+  name: GitRefname!
+}
+
 """
 Branch protection rules that are enforced on the viewer.
 """
@@ -42656,6 +43211,46 @@ type Repository implements Node & PackageOwner & ProjectOwner & ProjectV2Recent
   """
   deleteBranchOnMerge: Boolean!
 
+  """
+  A list of dependency manifests contained in the repository
+  """
+  dependencyGraphManifests(
+    """
+    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
+
+    """
+    Cursor to paginate dependencies
+    """
+    dependenciesAfter: String
+
+    """
+    Number of dependencies to fetch
+    """
+    dependenciesFirst: Int
+
+    """
+    Returns the first _n_ elements from the list.
+    """
+    first: Int
+
+    """
+    Returns the last _n_ elements from the list.
+    """
+    last: Int
+
+    """
+    Flag to scope to only manifests with dependencies
+    """
+    withDependencies: Boolean
+  ): DependencyGraphManifestConnection
+
   """
   A list of deploy keys that are on this repository.
   """
@@ -45515,6 +46110,13 @@ enum RepositoryRuleType {
   """
   BRANCH_NAME_PATTERN
 
+  """
+  Choose which tools must provide code scanning results before the reference is
+  updated. When configured, code scanning must be enabled and have results for
+  both the commit and the reference being updated.
+  """
+  CODE_SCANNING
+
   """
   Committer email pattern
   """
@@ -45540,11 +46142,36 @@ enum RepositoryRuleType {
   """
   DELETION
 
+  """
+  Prevent commits that include files with specified file extensions from being
+  pushed to the commit graph. NOTE: Thie rule is in beta and subject to change
+  """
+  FILE_EXTENSION_RESTRICTION
+
+  """
+  Prevent commits that include changes in specified file paths from being pushed
+  to the commit graph. NOTE: Thie rule is in beta and subject to change
+  """
+  FILE_PATH_RESTRICTION
+
   """
   Branch is read-only. Users cannot push to the branch.
   """
   LOCK_BRANCH
 
+  """
+  Prevent commits that include file paths that exceed a specified character
+  limit from being pushed to the commit graph. NOTE: Thie rule is in beta and
+  subject to change
+  """
+  MAX_FILE_PATH_LENGTH
+
+  """
+  Prevent commits that exceed a specified file size limit from being pushed to
+  the commit. NOTE: Thie rule is in beta and subject to change
+  """
+  MAX_FILE_SIZE
+
   """
   Max ref updates
   """
@@ -45753,6 +46380,11 @@ type RepositoryRulesetBypassActor implements Node {
   """
   bypassMode: RepositoryRulesetBypassActorBypassMode
 
+  """
+  This actor represents the ability for a deploy key to bypass
+  """
+  deployKey: Boolean!
+
   """
   The Node ID of the RepositoryRulesetBypassActor object
   """
@@ -45836,7 +46468,8 @@ type RepositoryRulesetBypassActorEdge {
 
 """
 Specifies the attributes for a new or updated ruleset bypass actor. Only one of
-`actor_id`, `repository_role_database_id`, or `organization_admin` should be specified.
+`actor_id`, `repository_role_database_id`, `organization_admin`, or `deploy_key`
+should be specified.
 """
 input RepositoryRulesetBypassActorInput {
   """
@@ -45849,6 +46482,11 @@ input RepositoryRulesetBypassActorInput {
   """
   bypassMode: RepositoryRulesetBypassActorBypassMode!
 
+  """
+  For deploy key bypasses, true. Can only use ALWAYS as the bypass mode
+  """
+  deployKey: Boolean
+
   """
   For organization owner bypasses, true
   """
@@ -45901,7 +46539,7 @@ type RepositoryRulesetEdge {
 }
 
 """
-The targets supported for rulesets
+The targets supported for rulesets. NOTE: The push target is in beta and subject to change.
 """
 enum RepositoryRulesetTarget {
   """
@@ -45909,6 +46547,11 @@ enum RepositoryRulesetTarget {
   """
   BRANCH
 
+  """
+  Push
+  """
+  PUSH
+
   """
   Tag
   """
@@ -47230,7 +47873,7 @@ enum RuleEnforcement {
 """
 Types which can be parameters for `RepositoryRule` objects.
 """
-union RuleParameters = BranchNamePatternParameters | CommitAuthorEmailPatternParameters | CommitMessagePatternParameters | CommitterEmailPatternParameters | PullRequestParameters | RequiredDeploymentsParameters | RequiredStatusChecksParameters | TagNamePatternParameters | UpdateParameters | WorkflowsParameters
+union RuleParameters = BranchNamePatternParameters | CodeScanningParameters | CommitAuthorEmailPatternParameters | CommitMessagePatternParameters | CommitterEmailPatternParameters | FileExtensionRestrictionParameters | FilePathRestrictionParameters | MaxFilePathLengthParameters | MaxFileSizeParameters | PullRequestParameters | RequiredDeploymentsParameters | RequiredStatusChecksParameters | TagNamePatternParameters | UpdateParameters | WorkflowsParameters
 
 """
 Specifies the parameters for a `RepositoryRule` object. Only one of the fields should be specified.
@@ -47241,6 +47884,11 @@ input RuleParametersInput {
   """
   branchNamePattern: BranchNamePatternParametersInput
 
+  """
+  Parameters used for the `code_scanning` rule type
+  """
+  codeScanning: CodeScanningParametersInput
+
   """
   Parameters used for the `commit_author_email_pattern` rule type
   """
@@ -47256,6 +47904,26 @@ input RuleParametersInput {
   """
   committerEmailPattern: CommitterEmailPatternParametersInput
 
+  """
+  Parameters used for the `file_extension_restriction` rule type
+  """
+  fileExtensionRestriction: FileExtensionRestrictionParametersInput
+
+  """
+  Parameters used for the `file_path_restriction` rule type
+  """
+  filePathRestriction: FilePathRestrictionParametersInput
+
+  """
+  Parameters used for the `max_file_path_length` rule type
+  """
+  maxFilePathLength: MaxFilePathLengthParametersInput
+
+  """
+  Parameters used for the `max_file_size` rule type
+  """
+  maxFileSize: MaxFileSizeParametersInput
+
   """
   Parameters used for the `pull_request` rule type
   """
@@ -57857,6 +58525,36 @@ type UpdateRefPayload {
   ref: Ref
 }
 
+"""
+Autogenerated input type of UpdateRefs
+"""
+input UpdateRefsInput {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  A list of ref updates.
+  """
+  refUpdates: [RefUpdate!]!
+
+  """
+  The Node ID of the repository.
+  """
+  repositoryId: ID!
+}
+
+"""
+Autogenerated return type of UpdateRefs
+"""
+type UpdateRefsPayload {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+}
+
 """
 Autogenerated input type of UpdateRepository
 """