Contents

## GraphQL::Stitching::Request

A `Request` contains a parsed GraphQL document and variables, and handles the logistics of extracting the appropriate operation, variable definitions, and fragments. A `Request` should be built once per server request and passed through to other stitching components that utilize request information.

```ruby
document = "query FetchMovie($id: ID!) { movie(id:$id) { id genre } }"
request = GraphQL::Stitching::Request.new(document, variables: { "id" => "1" }, operation_name: "FetchMovie")

request.document # parsed AST via GraphQL.parse
request.variables # user-submitted variables
request.string # normalized printed document string
request.digest # SHA digest of the normalized document string

request.variable_definitions # a mapping of variable names to their type definitions
request.fragment_definitions # a mapping of fragment names to their fragment definitions
```

### Preparing requests

A request should be prepared for stitching using the `prepare!` method _after_ validations have been run:

```ruby
document = <<~GRAPHQL
  query FetchMovie($id: ID!, $lang: String = "en", $withShowtimes: Boolean = true) {
    movie(id:$id) {
      id
      title(lang: $lang)
      showtimes @include(if: $withShowtimes) {
        time
      }
    }
  }
GRAPHQL

request = GraphQL::Stitching::Request.new(
  document,
  variables: { "id" => "1" },
  operation_name: "FetchMovie",
)

errors = MySchema.validate(request.document)
# return early with any static validation errors...

request.prepare!
```

Preparing a request will apply several destructive transformations:

- Default values from variable definitions will be added to request variables.
- The document will be pre-shaped based on `@skip` and `@include` directives.

Version data entries

15 entries across 15 versions & 1 rubygems

Version	Path
graphql-stitching-1.0.6	docs/request.md
graphql-stitching-1.0.5	docs/request.md
graphql-stitching-1.0.4	docs/request.md
graphql-stitching-1.0.3	docs/request.md
graphql-stitching-1.0.2	docs/request.md
graphql-stitching-1.0.1	docs/request.md
graphql-stitching-1.0.0	docs/request.md
graphql-stitching-0.3.6	docs/request.md
graphql-stitching-0.3.4	docs/request.md
graphql-stitching-0.3.3	docs/request.md
graphql-stitching-0.3.2	docs/request.md
graphql-stitching-0.3.1	docs/request.md
graphql-stitching-0.3.0	docs/request.md
graphql-stitching-0.2.3	docs/request.md
graphql-stitching-0.2.2	docs/request.md