schema-directives.graphql

"""
Marks a selection as existing only in the named schema version ("main" or "staging").

The dashboard is built against two Saleor schemas and picks one at build time via
FF_USE_STAGING_SCHEMA. Fields that exist in only one of them carry this directive, and
`src/graphql/lockSchema.ts` removes them — from the outgoing document *and* from the
document the cache normalises against — whenever the build targets the other version.
The directive itself never reaches the API.

Only declared here so codegen and IDE tooling accept it; the API knows nothing about it.

Do not put it on every field of a fragment: a fragment stripped down to an empty selection
set prints as invalid GraphQL. Leave at least one unconditional field (`id`) behind.

On an *operation* it means the whole root field is gone from the other schema — the field
form cannot express that (deleting the only root field leaves an empty selection set, and a
variable definition naming a removed input type is out of the directive's reach). Nothing is
stripped at runtime, so every entry point must be gated behind `isMainSchema()`/`isStagingSchema()`
by hand; the marker is what excuses the document from the validation sweep in
`src/graphql/lockSchema.test.ts`.
"""
directive @lockSchema(schema: String!) on FIELD | QUERY | MUTATION | SUBSCRIPTION