[ifmelate]

Summary

Generated code for the project's own fixture schema did not compile before this change (86 analyzer errors, json_serializable failed on the SearchResult union). It now compiles with no errors or warnings in both nullability modes, and a new test runs it end to end.

This branch is based on feature/improve-filepath, which was never merged, so it also brings in those commits (1.0.2-rc.1 path handling, AST parser, strict nullability, deterministic output).

Generator

• Interfaces and unions become abstract classes whose fromJson dispatches on __typename, with Unknown* fallbacks. __typename is added to generated documents.
• Subscriptions return Streams via GraphQLClient.subscribe. Before, SubscriptionOptions were passed to query, which did not compile.
• Every operation in a file gets generated, not just the first.
• Fragments are resolved from other .graphql files.
• Aliases are read from the alias key.
• Operations with several root fields return an <Op>Result class instead of silently dropping fields.
• New in each operation file: <Op>Variables classes with toJson(), plus public <op>Document and parse<Op>Data, usable with watchQuery and any fetch policy.
• Dart reserved words are escaped (class → class_, enum value default → default_), while the GraphQL name is still sent on the wire.
• extend type ... schema extensions are merged.

Builder / schema loading

• The schema is loaded and types.dart generated once per build instead of once per file.
• Local schemas are read through BuildStep, so editing the schema triggers a rebuild.
• Removed the hardcoded schema.graphql path check, which skipped files like get_schema.graphql. Schema files are now detected by their content.
• Output goes through log instead of print. build_runner reported every print as a warning.
• Remote schemas:
  • new schema_headers option with ${ENV} expansion;
  • 30s timeout;
  • introspection fallback converted to SDL.

Behaviour changes (see CHANGELOG)

• *Data methods throw OperationException instead of returning null on errors.
• Custom scalar classes keep the raw JSON value in raw; value is still a string.
• DateTimeConverter.toJson / LocalDateConverter.toJson return dynamic.
• The Awesome placeholder is removed.

Known limitation (not addressed)

Generated classes still mirror schema types, not selection sets. Parsing an object throws if the operation did not select one of its non-null fields. This is documented in the README. Fixing it needs selection-set types, which is a major version change.

Test plan

• dart format --set-exit-if-changed .
• dart analyze --fatal-infos (was failing on master's base)
• dart test: 93 tests, including the new compile test that runs json_serializable plus dart analyze on generated code and executes it against a fake link
• CI on Dart 3.2.0 (not verified locally)

🤖 Generated with Claude Code