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

schema
    @link(url: "https://specs.apollo.dev/link/v1.0")
    @link(url: "https://specs.apollo.dev/join/v0.4", for: EXECUTION) {
    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
) 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

type Country
    @join__type(graph: PRODUCTS, key: "a")
    @join__type(graph: USERS, key: "a") {
    a: String
    b: String
}

scalar join__DirectiveArguments

scalar join__FieldSet

enum join__Graph {
    PRODUCTS
        @join__graph(name: "products", url: "http://localhost:4001/graphql")
    USERS @join__graph(name: "users", url: "http://localhost:4003/graphql")
}

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 Product
    @join__type(graph: PRODUCTS, key: "id")
    @join__type(graph: PRODUCTS, key: "sku")
    @join__directive(
        graphs: [PRODUCTS]
        name: "federation__cacheTag"
        args: { format: "product" }
    ) {
    id: ID!
    sku: String
    name: String
    createdBy: User
}

type Query @join__type(graph: PRODUCTS) @join__type(graph: USERS) {
    allProducts: [Product]
        @join__field(graph: PRODUCTS)
        @join__directive(
            graphs: [PRODUCTS]
            name: "federation__cacheTag"
            args: { format: "allProducts" }
        )
    product(id: ID!): Product @join__field(graph: PRODUCTS)
}

type User
    @join__type(graph: PRODUCTS, key: "email country { a }")
    @join__type(graph: PRODUCTS, key: "email country { b }")
    @join__type(graph: USERS, key: "email country { a }")
    @join__type(graph: USERS, key: "email country { b }")
    @join__directive(
        graphs: [PRODUCTS, USERS]
        name: "federation__cacheTag"
        args: { format: "user-email:{$key.email}-country-a:{$key.country.a}" }
    ) {
    email: ID!
    country: Country
    name: String @join__field(graph: USERS)
}