Release Notes

This is a release focused on GraphQL specification compliance and correctness. I had an agent do several rounds of review over the entire codebase, which uncovered a lot of edge cases and quirks. It also includes several hot-path performance improvements and hardening of the client code generator.

Bug Fixes

Parsing

• Fix float literals with both fraction and exponent being truncated by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3014
• Preserve out-of-range float literals as BigDecimal by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3022
• Reject out-of-range Int and Long argument literals instead of wrapping by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3029
• Fix enum values whose names start with true/false/null being mis-parsed by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3026
• Support variable-width unicode escape sequences in string values by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3031
• Parse VARIABLE_DEFINITION directive location by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3020
• Fix compact block-string description ending in backslash-quote by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3021

Validation & variable coercion

• Fix field-merge validation missing nested argument conflicts by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3018
• Fix field-merge validation using queryType as parent for all operations by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3027
• Reject unknown input-object fields in lists and oneOf inputs by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3023
• Validate directives on variable definitions and required directive arguments by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3024
• Reject explicit null for non-null variables and non-null list items by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3033
• Coerce out-of-Long-range integer literals to Float/Double via BigInt by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3034
• Collect variables used in operation-level directives by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3032
• Fix duplicate fragment spread ignoring per-spread @skip/@include by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3028
• Fix RenameType renaming enum values that collide with a type name by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3030

Execution & incremental delivery

• Fix nested lists computing item-nullability at the wrong level by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3016
• Fix @stream list-field validation by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3015
• Advance @stream path index across chunks by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3017
• Fix defer/stream label uniqueness check aborting in single-feature mode by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3035

Rendering

• Escape control characters when rendering GraphQL string values by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3036
• Fix block-string line terminators and control-character rendering by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3025

Client & codegen

• Fix client field-name collision rendering and decoding by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3037
• Fix codegen ClientWriter enum encoder, enum .value, and doc-comment escaping by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3038
• Fail client codegen for value-less enums, objects, interfaces and input objects by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3051

Adapters & interop

• Prefer SSE over graphql-response+json in tapir content negotiation by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3041
• Fix jsoniter number parser miscounting digits of a number at end of input by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3043
• Encode GET query-param variables and extensions as JSON, not GraphQL syntax by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3044
• Select a single supported subprotocol for WebSocket negotiation by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3045

Stitching

• Do not forward schema field-definition directives in proxied remote queries by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3046

Federation & tools

• Fix federation @connect directive builder and connect spec version by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3039
• Preserve and compare interface-implements-interface relationships in tools by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3040

Tracing

• Mask list, enum and boolean argument values in SchemaTracer by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3042

Performance Improvements

• Hoist directive-resolver closure out of the per-field Field.apply recursion by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3047
• Index input-object fields by name to remove O(n·m) validation scans by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3048
• Trim per-node allocations in the circe/play/zio JSON codecs by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3049
• Capture string-literal character runs in a single pass in the parser by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3050