Skip to content

Commit 1eb008d

Browse files
authored
version bump. (#176)
1 parent 7670057 commit 1eb008d

3 files changed

Lines changed: 6 additions & 13 deletions

File tree

docs/composing_a_supergraph.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -186,7 +186,7 @@ client = GraphQL::Stitching::Client.new(
186186
)
187187
```
188188

189-
In the above, selecting the root `product` field will route to the "infos" schema by default. You should bias root fields to their most general-purpose location. This option _only_ applies to root fields where the planner has no starting location bias. Overlapping fields in lower-level positions will always bias towards the current planning location.
189+
In the above, selecting the root `product` field will route to the "infos" schema by default. You should bias root fields to their most general-purpose location. This option _only_ applies to root fields where the query planner has no starting location bias (learn more about [query planning](./query_planning.md)). Note that [type resolver queries](./merged_types.md#type-resolver-queries) are unaffected by entrypoint bias; a type resolver will always be accessed directly for a location when needed.
190190

191191
### Schema merge patterns
192192

docs/query_planning.md

Lines changed: 4 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,9 @@
11
## Query Planning
22

3-
### Root selection routing
4-
5-
Root fields should route to the primary locations of their provided types. This assures that the most common data for a type can be resolved via root access and thus avoid unnecessary stitching. Root fields can select their primary locations using the `root_field_location_selector` option in [composer configuration](./composer.md#configuring-composition):
63

7-
```ruby
8-
supergraph = GraphQL::Stitching::Composer.new(
9-
root_field_location_selector: ->(locations) { locations.find { _1 == "a" } || locations.last },
10-
).perform({ ... })
11-
```
4+
### Root selection routing
125

13-
It's okay if root field names are repeated across locations. The primary location will be used when routing root selections:
6+
It's okay if root field names are repeated across locations. The entrypoint location will be used when routing root selections:
147

158
```graphql
169
# -- Location A
@@ -21,7 +14,7 @@ type Movie {
2114
}
2215

2316
type Query {
24-
movie(id: ID!): Movie @stitch(key: "id") # shared, primary
17+
movie(id: ID!): Movie @stitch(key: "id") # << set as root entrypoint
2518
}
2619

2720
# -- Location B
@@ -32,7 +25,7 @@ type Movie {
3225
}
3326

3427
type Query {
35-
movie(id: ID!): Movie @stitch(key: "id") # shared
28+
movie(id: ID!): Movie @stitch(key: "id")
3629
}
3730

3831
# -- Request

lib/graphql/stitching/version.rb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,6 @@
22

33
module GraphQL
44
module Stitching
5-
VERSION = "1.7.0"
5+
VERSION = "1.7.1"
66
end
77
end

0 commit comments

Comments
 (0)