0-base-schema.graphql

# This is just the base schema shared by the two options below.

type User {
  name: String
  friendships: FriendshipConnection
}

type Friendship {
  establishedAt: String
  withUser: User
}

type Query {
  me: User
}

1-with-metadata-as-edge-field.graphql

# include 0-base-schema.graphql

type FriendshipConnection {
  edges: [FriendshipConnectionEdge]
}

type FriendshipConnectionEdge {
  metadata: Friendship
  node: User
  cursor: String
}

# Query like:

query {
  me {
    friendships {
      edges {
        __typename # FriendshipConnectionEdge
        cursor
        metadata {
          __typename # Friendship
          establishedAt
        }
        node {
          __typename # User
          name
        }
      }
    }
  }
}

2-with-metadata-as-edge-type.graphql

# include 0-base-schema.graphql

# Add edge fields, as per spec. These fields don’t make much sense
# when this type is used elsewhere outside of a connection.
extend type Friendship {
  node: User
  cursor: String
}

type FriendshipConnection {
  edges: [Friendship]
}

# Query like:

query {
  me {
    friendships {
      edges {
        __typename # Friendship
        cursor
        establishedAt
        node {
          __typename # User
          name
        }
      }
    }
  }
}