Add a flag indicating this `Operation` uses `@defer`

[rohandhruva]

Use case

For the auto-generated files that correspond to an Operation, we currently have no way of identifying whether this operation uses @defer. Would it be possible to add a flag that will tell us?

The reason behind this request is that internally we wrap the apollo client APIs, and our current query() API is a suspend fun, which means that it can't support streaming / multiple responses that is required when using @defer.

With this flag, we can fail-fast when someone tries to use our custom suspend fun query() with an operation that uses @defer.

Describe the solution you'd like

Perhaps interface Operation is a good place to add this new flag?

Maybe the flag could be something generic and not specific to @defer, for example: val canHaveMultipleResponses (naming is hard 😅). I'm guessing @stream will need something like this too.

[martinbonnin]

(I know it's been a while but we're currenly looking at older issues :))

My favorite way of doing this would be to have some custom debug-only code that parses the operation document. All the information required is in Operation already so adding another flag feels like duplication.
Alternatively you could codegen a list of operation names that contain defer at build time and use that to fail fast.