spawnia · Oct 3, 2026 · Oct 3, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+### Changed
+
+- Fail codegen for operations using `@skip` or `@include` instead of generating types that break at runtime https://github.com/spawnia/sailor/pull/143
+
 ## v1.4.2
 
 ### Fixed

diff --git a/README.md b/README.md
@@ -179,6 +179,15 @@ mutation Foo { ... }
 query camelCase { ... }
 ```
 
+### Client directives
+
+Sailor does not support the client directives `@skip` and `@include`.
+Code generation fails when it finds them.
+
+Sailor generates one static result type per operation.
+A field that the server omits conditionally has no place in that type.
+Query the data unconditionally and decide in your application, or write separate operations.
+
 ### Generate code
 
 Run `vendor/bin/sailor` to generate PHP code for your operations.

diff --git a/examples/simple/expected/Operations/ClientDirectiveFragmentSpreadQuery.php b/examples/simple/expected/Operations/ClientDirectiveFragmentSpreadQuery.php
diff --git a/...cted/Operations/ClientDirectiveFragmentSpreadQuery/ClientDirectiveFragmentSpreadQuery.php b/...cted/Operations/ClientDirectiveFragmentSpreadQuery/ClientDirectiveFragmentSpreadQuery.php
diff --git a/.../ClientDirectiveFragmentSpreadQuery/ClientDirectiveFragmentSpreadQueryErrorFreeResult.php b/.../ClientDirectiveFragmentSpreadQuery/ClientDirectiveFragmentSpreadQueryErrorFreeResult.php
diff --git a/...perations/ClientDirectiveFragmentSpreadQuery/ClientDirectiveFragmentSpreadQueryResult.php b/...perations/ClientDirectiveFragmentSpreadQuery/ClientDirectiveFragmentSpreadQueryResult.php
diff --git a/examples/simple/expected/Operations/ClientDirectiveInlineFragmentQuery.php b/examples/simple/expected/Operations/ClientDirectiveInlineFragmentQuery.php
diff --git a/...cted/Operations/ClientDirectiveInlineFragmentQuery/ClientDirectiveInlineFragmentQuery.php b/...cted/Operations/ClientDirectiveInlineFragmentQuery/ClientDirectiveInlineFragmentQuery.php
diff --git a/.../ClientDirectiveInlineFragmentQuery/ClientDirectiveInlineFragmentQueryErrorFreeResult.php b/.../ClientDirectiveInlineFragmentQuery/ClientDirectiveInlineFragmentQueryErrorFreeResult.php
diff --git a/...perations/ClientDirectiveInlineFragmentQuery/ClientDirectiveInlineFragmentQueryResult.php b/...perations/ClientDirectiveInlineFragmentQuery/ClientDirectiveInlineFragmentQueryResult.php
diff --git a/examples/simple/expected/Operations/ClientDirectiveQuery.php b/examples/simple/expected/Operations/ClientDirectiveQuery.php