Incremental Delivery spec draft#1110
Open
robrichard wants to merge 5 commits into
Open
Conversation
✅ Deploy Preview for graphql-spec-draft ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
|
Hi @robrichard , do you have any expected timeline for this feature? We are really excited to have this feature for our product! |
benjie
added
💭 Strawman (RFC 0)
robrichard
force-pushed
the
robrichard/defer-stream-v2
branch
from
9ec7f65 to
f7e9124
Compare
yaacovCR
reviewed
Jan 9, 2025
Member
|
The previous spec edits reached RFC2, should this also be RFC2? |
BoD
reviewed
Jul 17, 2025
michaelstaib
reviewed
Feb 2, 2026
|
|
||
| - If {serial} is not provided, initialize it to {false}. | ||
| - Let {groupedFieldSet} and {newDeferUsages} be the result of | ||
| {CollectFields(objectType, selectionSet, variableValues)}. |
Member
There was a problem hiding this comment.
The new CollectFields requires a deferUsage argument ... this should be null for the initial call to CollectFields.
Suggested change
| {CollectFields(objectType, selectionSet, variableValues)}. | |
| {CollectFields(objectType, selectionSet, null, variableValues)}. |
Also in this case its not clear while reading what null actually is for so maybe it should be declared first?
leebyron
added
📄 Draft (RFC 2)
Collaborator
|
Moving this to RFC2, draft. More work to do for sure, but we're waaaaay closer to the end than the start and I believe we've fully understood the problem domain and are narrowing in on details now. Massive props and excellent work to @robrichard for his continued championship and work on this RFC |
robrichard
force-pushed
the
robrichard/defer-stream-v2
branch
from
8e9cbcb to
fea9349
Compare
robrichard
force-pushed
the
robrichard/defer-stream-v2
branch
from
fea9349 to
1520fc1
Compare
* Spec edits for incremental delivery, Section 3 * re-order arguments * Apply suggestions from code review Co-authored-by: Benjie <benjie@jemjie.com> * Address PR feedback * Address PR feedback * Update spec/Section 3 -- Type System.md Co-authored-by: Benoit 'BoD' Lubek <BoD@JRAF.org> * Update response terminology * Use new execution result terminology * Update order of arguments on @stream * field error -> execution error * update argument order in examples * _subsequent execution result_ > _execution update result_ * Update note to normative section * fix title and link * review feedback --------- Co-authored-by: Benjie <benjie@jemjie.com> Co-authored-by: Benoit 'BoD' Lubek <BoD@JRAF.org>
…pendix (graphql#1203) * Spec edits for incremental delivery, Examples * Spec edits for incremental delivery, Section 7 only * fix typos * Update to address feedback in exampled appendix * Update terminology Initial Execution Result > Initial Incremental Stream Result Execution Update Result > Incremental Stream Update Result * PR feedback * allow hasNext: false on initial result * pending is must on initial stream result * value => payload when describing what is yielded by a stream * Update description of _initial incremental stream result_ & _incremental stream update result_ * fix incorrect term * PR Feedback * Pending Result -> Incremental Pending Notice * Completed Result -> Incremental Completion Notice
* Spec edits for incremental delivery, Validation * Update spec/Section 5 -- Validation.md Co-authored-by: Yaacov Rydzinski <yaacovCR@gmail.com> * Update labels are unique rule to account for null value of label * PR feedback * Rewrite Valid Root Field rule * review fixes * rewrite Valid Operations rule * review fixes --------- Co-authored-by: Yaacov Rydzinski <yaacovCR@gmail.com>
robrichard
force-pushed
the
robrichard/defer-stream-v2
branch
2 times, most recently
from
89456a2 to
e245077
Compare
robrichard
force-pushed
the
robrichard/defer-stream-v2
branch
from
e245077 to
f5f26b0
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
7 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Spec draft of
@deferbased on the response format in graphql/defer-stream-wg#69, with no duplication of fields.@streamwill be added soon.Please keep discussion limited to specifics on how the spec text is written. There is a dedicated discussion forum for questions, feedback, and comments on defer & stream: https://github.com/graphql/defer-stream-wg/discussions