feat: resolve all pivot attributes

CHANGELOG.md

@@ -9,6 +9,10 @@ You can find and compare releases at the [GitHub release page](https://github.co
 
 ## Unreleased
 
+### Added
+
+- Resolve all pivot attributes https://github.com/nuwave/lighthouse/pull/2464
+
 ## v6.32.0
 
 ### Added

docs/master/api-reference/directives.md

@@ -419,7 +419,7 @@ type RoleUserPivot {
 ```
 
 When using the `type` argument with pagination style `CONNECTION`, you may create your own [edge type](https://facebook.github.io/relay/graphql/connections.htm#sec-Edge-Types)
-that contains the attributes of the intermediate table.
+that either contains the attributes of the intermediate table or contains a `pivot` field with the corresponding type.
 
 The custom edge type must contain at least the following two fields:
 
@@ -441,6 +441,25 @@ type RoleEdge {
 }
 ```
 
+As an alternative, you can also expose the `pivot` field on the edge:
+
+```graphql
+type User {
+  roles: [Role!]! @belongsToMany(type: CONNECTION)
+}
+
+type UserRole {
+  meta: String
+}
+
+type RoleEdge {
+  node: Role!
+  cursor: String!
+  pivot: UserRole
+}
+```
+
+
 ## @broadcast
 
 ```graphql

src/Pagination/ConnectionField.php

@@ -85,6 +85,10 @@ public function edgeResolver(Paginator $paginator, array $args, GraphQLContext $
                         $data['node'] = $item;
                         break;
 
+                    case 'pivot':
+                        $data['pivot'] = $item->pivot;
+                        break;
+
                     default:
                         // All other fields on the return type are assumed to be part
                         // of the edge, so we try to locate them in the pivot attribute

tests/Integration/Schema/Directives/BelongsToManyDirectiveTest.php

@@ -259,6 +259,60 @@ public function testQueryBelongsToManyRelayConnectionWithCustomEdgeUsingDirectiv
         ])->assertJsonCount(2, 'data.user.roles.edges');
     }
 
+    public function testQueryBelongsToManyRelayConnectionWithCustomEdgeHavingPivotFieldUsingDirective(): void
+    {
+        $this->schema = /** @lang GraphQL */ '
+        type User {
+            roles: [Role!]! @belongsToMany(type: CONNECTION, edgeType: "UserRoleEdge")
+        }
+
+        type Role {
+            id: ID!
+        }
+
+        type UserRole {
+            meta: String
+        }
+
+        type UserRoleEdge {
+            node: Role!
+            cursor: String!
+            pivot: UserRole
+        }
+
+        type Query {
+            user: User! @auth
+        }
+        ';
+
+        $user = factory(User::class)->create();
+        assert($user instanceof User);
+        $this->be($user);
+
+        $roles = factory(Role::class, 3)->create();
+        $meta = ['meta' => 'new'];
+        $user->roles()->attach($roles, $meta);
+
+        $this->graphQL(/** @lang GraphQL */ '
+        {
+            user {
+                roles(first: 2) {
+                    edges {
+                        pivot {
+                            meta
+                        }
+                        node {
+                            id
+                        }
+                    }
+                }
+            }
+        }
+        ')
+        ->assertJsonPath('data.user.roles.edges.*.pivot', array_fill(0, 2, $meta))
+        ->assertJsonCount(2, 'data.user.roles.edges');
+    }
+
     public function testQueryBelongsToManyPivot(): void
     {
         $this->schema = /** @lang GraphQL */ '