apollo-router 2.14.0-rc.2

A configurable, high-performance routing runtime for Apollo Federation 🚀
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

schema
  @link(url: "https://specs.apollo.dev/link/v1.0")
  @link(url: "https://specs.apollo.dev/join/v0.5", for: EXECUTION)
  @link(url: "https://specs.apollo.dev/connect/v0.2", for: EXECUTION)
  @join__directive(
    graphs: [CONNECTORS]
    name: "link"
    args: { url: "https://specs.apollo.dev/connect/v0.2", import: ["@source", "@connect"] }
  )
  @join__directive(
    graphs: [CONNECTORS]
    name: "source"
    args: {
      name: "withconfig"
      http: { baseURL: "http://localhost:4001/api" }
      errors: { message: "error.message", extensions: "code: error.code\n status: $status\n fromSource: $('a')" }
    }
  )
  @join__directive(
    graphs: [CONNECTORS]
    name: "source"
    args: { name: "withoutconfig", http: { baseURL: "http://localhost:4001/api" } }
  )
  @join__directive(
    graphs: [CONNECTORS]
    name: "source"
    args: {
      name: "withpartialconfig"
      http: { baseURL: "http://localhost:4001/api" }
      errors: { extensions: "code: error.code\n status: $status\n fromSource: $('a')" }
    }
  ) {
  query: Query
}

directive @join__directive(
  graphs: [join__Graph!]
  name: String!
  args: join__DirectiveArguments
) repeatable on SCHEMA | OBJECT | INTERFACE | FIELD_DEFINITION

directive @join__enumValue(graph: join__Graph!) repeatable on ENUM_VALUE

directive @join__field(
  graph: join__Graph
  requires: join__FieldSet
  provides: join__FieldSet
  type: String
  external: Boolean
  override: String
  usedOverridden: Boolean
  overrideLabel: String
  contextArguments: [join__ContextArgument!]
) repeatable on FIELD_DEFINITION | INPUT_FIELD_DEFINITION

directive @join__graph(name: String!, url: String!) on ENUM_VALUE

directive @join__implements(graph: join__Graph!, interface: String!) repeatable on OBJECT | INTERFACE

directive @join__type(
  graph: join__Graph!
  key: join__FieldSet
  extension: Boolean! = false
  resolvable: Boolean! = true
  isInterfaceObject: Boolean! = false
) repeatable on OBJECT | INTERFACE | UNION | ENUM | INPUT_OBJECT | SCALAR

directive @join__unionMember(graph: join__Graph!, member: String!) repeatable on UNION

directive @link(url: String, as: String, for: link__Purpose, import: [link__Import]) repeatable on SCHEMA

input join__ContextArgument {
  name: String!
  type: String!
  context: String!
  selection: join__FieldValue!
}

scalar join__DirectiveArguments

scalar join__FieldSet

scalar join__FieldValue

enum join__Graph {
  CONNECTORS @join__graph(name: "connectors", url: "http://none")
}

scalar link__Import

enum link__Purpose {
  """
  `SECURITY` features provide metadata necessary to securely resolve fields.
  """
  SECURITY

  """
  `EXECUTION` features provide metadata necessary for operation execution.
  """
  EXECUTION
}

type Query @join__type(graph: CONNECTORS) {
  only_source: [User!]!
    @join__directive(
      graphs: [CONNECTORS]
      name: "connect"
      args: { source: "withconfig", http: { GET: "/users" }, selection: "id name username" }
    )
  only_connect: [User!]!
    @join__directive(
      graphs: [CONNECTORS]
      name: "connect"
      args: {
        source: "withoutconfig"
        http: { GET: "/users" }
        selection: "id name username"
        errors: { message: "error.message", extensions: "code: error.code\n status: $status" }
      }
    )
  both_source_and_connect: [User!]!
    @join__directive(
      graphs: [CONNECTORS]
      name: "connect"
      args: {
        source: "withconfig"
        http: { GET: "/users" }
        selection: "id name username"
        errors: { message: "error.message", extensions: "code: error.code\n fromConnect: $('b')" }
      }
    )
  partial_source_and_partial_connect: [User!]!
    @join__directive(
      graphs: [CONNECTORS]
      name: "connect"
      args: {
        source: "withpartialconfig"
        http: { GET: "/users" }
        selection: "id name username"
        errors: { message: "error.message" }
      }
    )
}

type User @join__type(graph: CONNECTORS) {
  id: ID!
  name: String
  username: String
}