GraphQL schema update (#37962)

Co-authored-by: rachmari <rachmari@users.noreply.github.com>

Author: Octomerger

data/graphql/ghec/schema.docs.graphql

@@ -23267,6 +23267,16 @@ type Mutation {
     input: UpdateProjectV2Input!
   ): UpdateProjectV2Payload
 
+  """
+  Update the collaborators on a team or a project
+  """
+  updateProjectV2Collaborators(
+    """
+    Parameters for UpdateProjectV2Collaborators
+    """
+    input: UpdateProjectV2CollaboratorsInput!
+  ): UpdateProjectV2CollaboratorsPayload
+
   """
   Updates a draft issue within a Project.
   """
@@ -31330,6 +31340,71 @@ type ProjectV2 implements Closable & Node & Updatable {
   ): ProjectV2WorkflowConnection!
 }
 
+"""
+Possible collaborators for a project.
+"""
+union ProjectV2Actor = Team | User
+
+"""
+The connection type for ProjectV2Actor.
+"""
+type ProjectV2ActorConnection {
+  """
+  A list of edges.
+  """
+  edges: [ProjectV2ActorEdge]
+
+  """
+  A list of nodes.
+  """
+  nodes: [ProjectV2Actor]
+
+  """
+  Information to aid in pagination.
+  """
+  pageInfo: PageInfo!
+
+  """
+  Identifies the total count of items in the connection.
+  """
+  totalCount: Int!
+}
+
+"""
+An edge in a connection.
+"""
+type ProjectV2ActorEdge {
+  """
+  A cursor for use in pagination.
+  """
+  cursor: String!
+
+  """
+  The item at the end of the edge.
+  """
+  node: ProjectV2Actor
+}
+
+"""
+A collaborator to update on a project. Only one of the userId or teamId should be provided.
+"""
+input ProjectV2Collaborator {
+  """
+  The role to grant the collaborator
+  """
+  role: ProjectV2Roles!
+
+  """
+  The ID of the team as a collaborator.
+  """
+  teamId: ID @possibleTypes(concreteTypes: ["Team"])
+
+  """
+  The ID of the user as a collaborator.
+  """
+  userId: ID @possibleTypes(concreteTypes: ["User"])
+}
+
 """
 The connection type for ProjectV2.
 """
@@ -32628,6 +32703,31 @@ interface ProjectV2Recent {
   ): ProjectV2Connection!
 }
 
+"""
+The possible roles of a collaborator on a project.
+"""
+enum ProjectV2Roles {
+  """
+  The collaborator can view, edit, and maange the settings of the project
+  """
+  ADMIN
+
+  """
+  The collaborator has no direct access to the project
+  """
+  NONE
+
+  """
+  The collaborator can view the project
+  """
+  READER
+
+  """
+  The collaborator can view and edit the project
+  """
+  WRITER
+}
+
 """
 A single select field inside a project.
 """
@@ -55443,6 +55543,61 @@ type UpdateProjectPayload {
   project: Project
 }
 
+"""
+Autogenerated input type of UpdateProjectV2Collaborators
+"""
+input UpdateProjectV2CollaboratorsInput {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The collaborators to update.
+  """
+  collaborators: [ProjectV2Collaborator!]!
+
+  """
+  The ID of the project to update the collaborators for.
+  """
+  projectId: ID! @possibleTypes(concreteTypes: ["ProjectV2"])
+}
+
+"""
+Autogenerated return type of UpdateProjectV2Collaborators
+"""
+type UpdateProjectV2CollaboratorsPayload {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The collaborators granted a role
+  """
+  collaborators(
+    """
+    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
+  ): ProjectV2ActorConnection
+}
+
 """
 Autogenerated input type of UpdateProjectV2DraftIssue
 """

data/graphql/schema.docs.graphql

@@ -23267,6 +23267,16 @@ type Mutation {
     input: UpdateProjectV2Input!
   ): UpdateProjectV2Payload
 
+  """
+  Update the collaborators on a team or a project
+  """
+  updateProjectV2Collaborators(
+    """
+    Parameters for UpdateProjectV2Collaborators
+    """
+    input: UpdateProjectV2CollaboratorsInput!
+  ): UpdateProjectV2CollaboratorsPayload
+
   """
   Updates a draft issue within a Project.
   """
@@ -31330,6 +31340,71 @@ type ProjectV2 implements Closable & Node & Updatable {
   ): ProjectV2WorkflowConnection!
 }
 
+"""
+Possible collaborators for a project.
+"""
+union ProjectV2Actor = Team | User
+
+"""
+The connection type for ProjectV2Actor.
+"""
+type ProjectV2ActorConnection {
+  """
+  A list of edges.
+  """
+  edges: [ProjectV2ActorEdge]
+
+  """
+  A list of nodes.
+  """
+  nodes: [ProjectV2Actor]
+
+  """
+  Information to aid in pagination.
+  """
+  pageInfo: PageInfo!
+
+  """
+  Identifies the total count of items in the connection.
+  """
+  totalCount: Int!
+}
+
+"""
+An edge in a connection.
+"""
+type ProjectV2ActorEdge {
+  """
+  A cursor for use in pagination.
+  """
+  cursor: String!
+
+  """
+  The item at the end of the edge.
+  """
+  node: ProjectV2Actor
+}
+
+"""
+A collaborator to update on a project. Only one of the userId or teamId should be provided.
+"""
+input ProjectV2Collaborator {
+  """
+  The role to grant the collaborator
+  """
+  role: ProjectV2Roles!
+
+  """
+  The ID of the team as a collaborator.
+  """
+  teamId: ID @possibleTypes(concreteTypes: ["Team"])
+
+  """
+  The ID of the user as a collaborator.
+  """
+  userId: ID @possibleTypes(concreteTypes: ["User"])
+}
+
 """
 The connection type for ProjectV2.
 """
@@ -32628,6 +32703,31 @@ interface ProjectV2Recent {
   ): ProjectV2Connection!
 }
 
+"""
+The possible roles of a collaborator on a project.
+"""
+enum ProjectV2Roles {
+  """
+  The collaborator can view, edit, and maange the settings of the project
+  """
+  ADMIN
+
+  """
+  The collaborator has no direct access to the project
+  """
+  NONE
+
+  """
+  The collaborator can view the project
+  """
+  READER
+
+  """
+  The collaborator can view and edit the project
+  """
+  WRITER
+}
+
 """
 A single select field inside a project.
 """
@@ -55443,6 +55543,61 @@ type UpdateProjectPayload {
   project: Project
 }
 
+"""
+Autogenerated input type of UpdateProjectV2Collaborators
+"""
+input UpdateProjectV2CollaboratorsInput {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The collaborators to update.
+  """
+  collaborators: [ProjectV2Collaborator!]!
+
+  """
+  The ID of the project to update the collaborators for.
+  """
+  projectId: ID! @possibleTypes(concreteTypes: ["ProjectV2"])
+}
+
+"""
+Autogenerated return type of UpdateProjectV2Collaborators
+"""
+type UpdateProjectV2CollaboratorsPayload {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The collaborators granted a role
+  """
+  collaborators(
+    """
+    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
+  ): ProjectV2ActorConnection
+}
+
 """
 Autogenerated input type of UpdateProjectV2DraftIssue
 """

src/graphql/data/fpt/changelog.json

@@ -1,4 +1,24 @@
 [
+  {
+    "schemaChanges": [
+      {
+        "title": "The GraphQL schema includes these changes:",
+        "changes": [
+          "<p>Type 'ProjectV2Actor' was added</p>",
+          "<p>Type 'ProjectV2ActorConnection' was added</p>",
+          "<p>Type 'ProjectV2ActorEdge' was added</p>",
+          "<p>Type 'ProjectV2Collaborator' was added</p>",
+          "<p>Type 'ProjectV2Roles' was added</p>",
+          "<p>Type 'UpdateProjectV2CollaboratorsInput' was added</p>",
+          "<p>Type 'UpdateProjectV2CollaboratorsPayload' was added</p>",
+          "<p>Field 'updateProjectV2Collaborators<code>was added to object type</code>Mutation'</p>"
+        ]
+      }
+    ],
+    "previewChanges": [],
+    "upcomingChanges": [],
+    "date": "2023-06-16"
+  },
   {
     "schemaChanges": [
       {