/ 
GraphQL-Houtou-0.01

Changes for version 0.01 - 2026-07-19

  • Added an XS-backed GraphQL parser, schema compiler, validation engine, and query/mutation runtime.
  • Added synchronous and Promise::XS execution, DataLoader batching, mutation serialization, direct JSON responses, and a PSGI adapter.
  • Added SDL schema construction, printing, type-system extensions, modern introspection, OneOf input objects, and custom directives.
  • Implemented the September 2025 executable-document validation rules and the query/mutation type-system validation profile.
  • Added native program and persisted-bundle caches, weighted query cost, depth, node, token, and request-body limits.
  • Added fail-closed subscription handling across dynamic and persisted execution paths; subscription streaming remains unsupported in 0.01.
  • Added Apollo Federation 2 subgraph schema construction, service SDL, bounded entity resolution, and key validation.
  • Omitted the `errors` response entry when execution completed without errors, as required by the GraphQL response specification.
  • Made the default field resolver invoke hash coderefs and blessed source methods with the graphql-perl-compatible argument contract.
  • Added an `allow_introspection` runtime and PSGI policy for public endpoints while retaining `__typename` support.
  • Replaced the obsolete execution implementation selector with the explicit `strict_sync` request option; execution is always native.
  • Named the failing variable in variable coercion request errors, with a bounded rendering of the invalid value, and rejected missing Non-Null variables at variable preparation with the declared type.
  • Added ASan, Valgrind, fuzz, soak, compiler-warning, XS ownership, POD, metadata, and Perl 5.24 through 5.44 CI coverage.
  • Added production-oriented examples, benchmark tooling, architecture documentation, and XS memory-ownership guidance.

Documentation

README.md

Modules

GraphQL::Houtou
XS-backed GraphQL parser and execution toolkit for Perl
GraphQL::Houtou::DataLoader
batching loader for GraphQL::Houtou resolvers
GraphQL::Houtou::Directive
Directive definitions for GraphQL::Houtou
GraphQL::Houtou::Error
lightweight GraphQL error object
GraphQL::Houtou::Federation
build an Apollo Federation 2 subgraph schema
GraphQL::Houtou::Introspection
Houtou-owned introspection types
GraphQL::Houtou::PSGI
GraphQL over HTTP endpoint as a plain PSGI app
GraphQL::Houtou::Runtime::NativeRuntime
request-time execution API on the XS VM
GraphQL::Houtou::Schema
schema container for GraphQL::Houtou
GraphQL::Houtou::Type
Houtou-owned GraphQL type base class
GraphQL::Houtou::Type::Enum
GraphQL enum type
GraphQL::Houtou::Type::InputObject
GraphQL input object type
GraphQL::Houtou::Type::Interface
GraphQL interface type
GraphQL::Houtou::Type::List
GraphQL list wrapper type
GraphQL::Houtou::Type::NonNull
GraphQL non-null wrapper type
GraphQL::Houtou::Type::Object
GraphQL object type
GraphQL::Houtou::Type::Scalar
built-in and custom GraphQL scalars
GraphQL::Houtou::Type::Union
GraphQL union type
GraphQL::Houtou::Validation
GraphQL document validation facade
GraphQL::Houtou::Validation::DepthLimit
query depth limit validator
GraphQL::Houtou::Validation::NodeLimit
query field-count limit validator

Provides

GraphQL::Houtou::DataLoader::Error
in lib/GraphQL/Houtou/DataLoader.pm
GraphQL::Houtou::Internal::TypeSupport
in lib/GraphQL/Houtou/Internal/TypeSupport.pm
GraphQL::Houtou::Parser::Internal
in lib/GraphQL/Houtou/XS/Parser.pm
GraphQL::Houtou::Parser::Internal::LazyArray::Arguments
in lib/GraphQL/Houtou/XS/Parser.pm
GraphQL::Houtou::Parser::Internal::LazyArray::Directives
in lib/GraphQL/Houtou/XS/Parser.pm
GraphQL::Houtou::Parser::Internal::LazyArray::ObjectFields
in lib/GraphQL/Houtou/XS/Parser.pm
GraphQL::Houtou::Parser::Internal::LazyArray::VariableDefinitions
in lib/GraphQL/Houtou/XS/Parser.pm
GraphQL::Houtou::Parser::Internal::LazyLoc
in lib/GraphQL/Houtou/XS/Parser.pm
GraphQL::Houtou::Promise::PromiseXS
in lib/GraphQL/Houtou/Promise/PromiseXS.pm
GraphQL::Houtou::Role::Abstract
in lib/GraphQL/Houtou/Role/Abstract.pm
GraphQL::Houtou::Role::Composite
in lib/GraphQL/Houtou/Role/Composite.pm
GraphQL::Houtou::Role::FieldDeprecation
in lib/GraphQL/Houtou/Role/FieldDeprecation.pm
GraphQL::Houtou::Role::FieldsEither
in lib/GraphQL/Houtou/Role/FieldsEither.pm
GraphQL::Houtou::Role::FieldsInput
in lib/GraphQL/Houtou/Role/FieldsInput.pm
GraphQL::Houtou::Role::FieldsOutput
in lib/GraphQL/Houtou/Role/FieldsOutput.pm
GraphQL::Houtou::Role::HashMappable
in lib/GraphQL/Houtou/Role/HashMappable.pm
GraphQL::Houtou::Role::Input
in lib/GraphQL/Houtou/Role/Input.pm
GraphQL::Houtou::Role::Leaf
in lib/GraphQL/Houtou/Role/Leaf.pm
GraphQL::Houtou::Role::Named
in lib/GraphQL/Houtou/Role/Named.pm
GraphQL::Houtou::Role::Output
in lib/GraphQL/Houtou/Role/Output.pm
GraphQL::Houtou::Runtime::DirectiveRuntime
in lib/GraphQL/Houtou/Runtime/DirectiveRuntime.pm
GraphQL::Houtou::Runtime::ExecState
in lib/GraphQL/Houtou/Runtime/ExecState.pm
GraphQL::Houtou::Runtime::InputCoercion
in lib/GraphQL/Houtou/Runtime/InputCoercion.pm
GraphQL::Houtou::Runtime::LazyInfo
in lib/GraphQL/Houtou/Runtime/LazyInfo.pm
GraphQL::Houtou::Runtime::OperationCompiler
in lib/GraphQL/Houtou/Runtime/OperationCompiler.pm
GraphQL::Houtou::Runtime::SchemaBlock
in lib/GraphQL/Houtou/Runtime/SchemaBlock.pm
GraphQL::Houtou::Runtime::SchemaGraph
in lib/GraphQL/Houtou/Runtime/SchemaGraph.pm
GraphQL::Houtou::Runtime::Slot
in lib/GraphQL/Houtou/Runtime/Slot.pm
GraphQL::Houtou::Runtime::VMBlock
in lib/GraphQL/Houtou/Runtime/VMBlock.pm
GraphQL::Houtou::Runtime::VMCompiler
in lib/GraphQL/Houtou/Runtime/VMCompiler.pm
GraphQL::Houtou::Runtime::VMOp
in lib/GraphQL/Houtou/Runtime/VMOp.pm
GraphQL::Houtou::Runtime::VMProgram
in lib/GraphQL/Houtou/Runtime/VMProgram.pm
GraphQL::Houtou::Runtime::VMProgram::PayloadCatalog
in lib/GraphQL/Houtou/Runtime/VMProgram.pm
GraphQL::Houtou::XS::Parser
in lib/GraphQL/Houtou/XS/Parser.pm

Examples

Other files