relay-compiler 18.0.0 → 18.2.0

package/relay-extensions.graphql

@@ -137,6 +137,7 @@ directive @connection(
   filters: [String]
   handler: String
   dynamicKey_UNSTABLE: String
+  prefetchable_pagination: Boolean = false
 ) on FIELD
 
 directive @stream_connection(
@@ -148,6 +149,7 @@ directive @stream_connection(
   if: Boolean = true
   use_customized_batch: Boolean = false
   dynamicKey_UNSTABLE: String
+  prefetchable_pagination: Boolean = false
 ) on FIELD
 
 # RequiredTransform
@@ -183,10 +185,15 @@ directive @required(action: RequiredFieldAction! @static) on FIELD
 """
 (Relay Only)
 
-`@catch` is a directive you can add to fields in your Relay queries to
-declare how errors are handled.
+`@catch` is a directive you can add to fields, fragment definitions, queries,
+mutations, and aliased inline fragments to opt into explicitly handling field
+errors.
+
+[Read More](https://relay.dev/docs/guides/catch-directive/)
 """
-directive @catch(to: CatchFieldTo! = RESULT @static) on FIELD
+directive @catch(
+  to: CatchFieldTo! = RESULT @static
+) on FIELD | FRAGMENT_DEFINITION | QUERY | MUTATION | INLINE_FRAGMENT
 
 # DeclarativeConnection
 """
@@ -318,9 +325,17 @@ directive @alias(as: String) on FRAGMENT_SPREAD | INLINE_FRAGMENT
 """
 (Relay Only)
 
-This directive allows users to opt out of validation which enforces that @alias
-be used on all fragment spreads which might not match. It is intended as an
-escape hatch for incremental adoption of enforcing `@alias`.
+**To resolve, replace `@dangerously_unaliased_fixme` with `@alias`**
+
+This fragment spread will only conditionally be fetched, either due to
+`@skip`/@include` or its type condition. Conditionally fetched fragments without
+an `@alias` are unsafe because they don't expose any mechanism for the user to
+check if the data was fetched before using the fragment. In these cases `@alias`
+will materialize the fragment as a nullable named property, ensuring the proper
+null checks are performed.
+
+We now require all such fragment spreads to use `@alias`, and have marked
+existing unsafe spreads with `@dangerously_unaliased_fixme`.
 
 DO NOT ADD NEW USES OF THIS DIRECTIVE.
 
@@ -337,3 +352,19 @@ If a non-static value is provided, it will result in a validation error.
 Used for arguments which are expected to be read by the Relay compiler.
 """
 directive @static on ARGUMENT_DEFINITION
+
+"""
+(Relay Only)
+
+Used for printing a query, need to be used with `debug_transform`
+"""
+directive @__debug on QUERY | MUTATION | SUBSCRIPTION | FRAGMENT_DEFINITION
+
+"""
+(Relay Only)
+
+If added to a query, resolvers in that query to run at exec-time, rather than read-time.
+This means the resolvers are run when the query data is requested rather than when the
+query is used (i.e. when the network request is made instead of at render time).
+"""
+directive @exec_time_resolvers on QUERY