thecodingmachine/graphqlite

What's Changed

• Fix CI: update Symfony and PSR cache dependencies for no-framework example, make static analysis happy with possible types of callback params by @andrew-demb in #811
• chore: remove package-versions-deprecated dependency by @reydajp in #810
• Bump codecov/codecov-action from 6.0.0 to 7.0.0 by @dependabot[bot] in #808
• Update doctrine/coding-standard requirement from ^13.0 to ^13.0 || ^14.0 by @dependabot[bot] in #803
• Reuse reentrantly-registered type in mapAnnotatedObject (fixes first-request crash in long-lived workers) by @oojacoboo in #812
• feat: Add directive layer by @michael-georgiadis in #807
• fix: support #[Type] interfaces used as output types by @michael-georgiadis in #817

New Contributors

• @reydajp made their first contribution in #810
• @michael-georgiadis made their first contribution in #807

Full Changelog: v8.3.0...v8.3.1

What's Changed

• Introduce Undefined::VALUE by @oprypkhantc in #764
• Fix Security "this" variable on ExtendType fields by @charly-ffss in #801
• Docs: fix syntax error on example snippet by @andrew-demb in #802

New Contributors

• @charly-ffss made their first contribution in #801

Full Changelog: v8.2.0...v8.3.0

What's Changed

• [doc] Fix typo in old Doctrine Annotation syntax by @cvergne in #787
• Fix MutableInterfaceType not frozen in mutation-only return types by @oojacoboo in #790
• Fix #[Security] on ExtendType fields (source-injection array_combine crash) by @oojacoboo in #792
• Remove MyCLabs\Enum support by @oojacoboo in #794
• fix: drop @internal annotation from InputField by @oojacoboo in #795
• feat: explicit description attribute (+ #[EnumValue]) + SchemaFactory docblock toggle by @oojacoboo in #793
• docs: alphabetize annotations reference by @oojacoboo in #798
• docs: fix broken anchors and stale Doctrine annotation references by @oojacoboo in #799
• docs: rename annotations-reference to attributes-reference by @oojacoboo in #800

Full Changelog: v8.1.3...v8.2.0

What's Changed

• fix: allow adding properties starting with 'set' by @supresys in #779
• fix: resolve built-in scalar types in BaseTypeMapper::mapNameToType by @oojacoboo in #784

New Contributors

• @supresys made their first contribution in #779
• @homersimpsons made their first contribution in #781

Full Changelog: v8.1.2...v8.1.3

What's Changed

• Bump actions/setup-node from 4 to 5 by @dependabot[bot] in #759
• Bump codecov/codecov-action from 5.5.0 to 5.5.1 by @dependabot[bot] in #758
• ✨ Improve exception message for unexpected null value - mention expected type by @andrew-demb in #762
• chore: symfony 8 dependencies by @jorgsowa in #770
• Bump actions/upload-artifact from 4 to 6 by @dependabot[bot] in #775
• Bump actions/cache from 4 to 5 by @dependabot[bot] in #774
• Bump JamesIves/github-pages-deploy-action from 4.7.3 to 4.7.6 by @dependabot[bot] in #773
• fix: validate files in FilesSnapshot before processing by @faizanakram99 in #772

New Contributors

• @jorgsowa made their first contribution in #770

Full Changelog: v8.1.1...v8.1.2

What's Changed

• Allow callable() as field deferring mechanism by @oprypkhantc in #739
• 📦 Use WeakMap instead of SplObjectStorage to simplify GC work by @andrew-demb in #745
• Fix callable type mapping to be Closure mapping by @oprypkhantc in #753
• don't purge the results from buffer by @januszmk in #752

New Contributors

• @januszmk made their first contribution in #752

Full Changelog: v8.1.0...v8.1.1

While there shouldn't be any BC issues in this release, I've bumped to 8.1 since there is improved/full PHP 8.4 support included in this release.

What's Changed

• Fixed Adapter class for compatibility with base ObjectType by @oojacoboo in #721
• PHP 8.4 Support by @oojacoboo in #722
• Fixed incorrect assertions by @oojacoboo in #723
• Houskeeping by @oojacoboo in #736
• Fix issue with kept deprecation reason by @jaapio in #735

New Contributors

• @jaapio made their first contribution in #735

Full Changelog: v8.0.0...v8.1.0

Breaking Changes

• #677 Drops support for Doctrine annotations @fogrye

Improvements

• #668 Adds working examples to docs @shish
• #698 Performance optimizations and caching in development environments (devMode()) @oprypkhantc]

Bug Fixes

• #702 Fix prefetching for nested fields @sudevva

Minor Changes

• #695 Removes dependecy to unmaintained thecodingmachine/cache-utils dependency @xyng
• #712 Caching improvements with use of multiple ClassFinders @andrew-demb

New Contributors

• @sudevva made their first contribution in #702
• @DocentBF made their first contribution in #705
• @docmg made their first contribution in #715

Full Changelog: v7.0.0...v8.0.0

For all future changelog details, refer to the Releases. This CHANGELOG.md will no longer be independently maintained.

Breaking Changes

• #664 Replaces thecodingmachine/class-explorer with kcs/class-finder resulting in the SchemaFactory::setClassNameMapper being renamed to SchemaFactory::setFinder. This now expects an instance of Kcs\ClassFinder\Finder\FinderInterface instead of Mouf\Composer\ClassNameMapper. @fogrye

New Features

• #649 Adds support for subscription operations. @oojacoboo
• #612 Automatic query complexity analysis. @oprypkhantc
• #611 Automatic persisted queries. @oprypkhantc

Improvements

• #658 Improves on prefetching for nested fields. @grynchuk
• #646 Improves exception handling during schema parsing. @fogrye
• #636 Allows the use of middleware on construtor params/fields. @oprypkhantc
• #623 Improves support for description arguments on types/fields. @downace
• #628 Properly handles @param annotations for generics support on field annotated constructor arguments. @oojacoboo
• #584 Immutability improvements across the codebase. @oprypkhantc
• #588 Prefetch improvements. @oprpkhantc
• #606 Adds support for phpdoc descriptions and deprecation annotations on native enums. @mdoelker
• Thanks to @shish, @cvergne and @mshapovalov for updating the docs!

Minor Changes

• #639 Added support for Symfony 7. @janatjak

Breaking Changes

• #664 Replaces thecodingmachine/class-explorer with kcs/class-finder resulting in the SchemaFactory::setClassNameMapper being renamed to SchemaFactory::setFinder. This now expects an instance of Kcs\ClassFinder\Finder instead of Kcs\ClassFinder\Finder\FinderInterface. @fogrye

New Features

• #649 Adds support for subscription operations. @oojacoboo
• #612 Automatic query complexity analysis. @oprypkhantc
• #611 Automatic persisted queries. @oprypkhantc

Improvements

• #658 Improves on prefetching for nested fields. @grynchuk
• #646 Improves exception handling during schema parsing. @fogrye
• #636 Allows the use of middleware on construtor params/fields. @oprypkhantc
• #623 Improves support for description arguments on types/fields. @downace
• #628 Properly handles @param annotations for generics support on field annotated constructor arguments. @oojacoboo
• #584 Immutability improvements across the codebase. @oprypkhantc
• #588 Prefetch improvements. @oprpkhantc
• #606 Adds support for phpdoc descriptions and deprecation annotations on native enums. @mdoelker
• Thanks to @shish, @cvergne and @mshapovalov for updating the docs!

Minor Changes

• #639 Added support for Symfony 7. @janatjak

Adds support for Psr\Container 1.1 with #601

Adds support for Psr\Container 1.1 with #601

This is a very simple release. We support Doctrine annotation 1.x and we've deprecated SchemaFactory::setDoctrineAnnotationReader in favor of native PHP attributes.

• Added support for new Void return types, allowing use of void from operation resolvers. #574
• Improvements with authorization middleware #571
• Updated vendor dependencies: #580 #558

Lots of little nuggets in this release! We're now targeting PHP ^8.1 and have testing on 8.2.

• Better support for union types and enums: #530, #535, #561, #570
• Various bug and interface fixes: #532, #575, #564
• GraphQL v15 required: #542
• Lots of codebase improvements, more strict typing: #548

A special thanks to @rusted-love and @oprypkhantc for their contributions.

A shoutout to @bladl for his work on this release, improving the code for better typing and PHP 8.0 syntax updates!

Breaking Changes

• #518 PSR-11 support now requires version 2
• #508 Due to some of the code improvements, additional typing has been added to some interfaces/classes. For instance, RootTypeMapperInterface::toGraphQLOutputType and RootTypeMapperInterface::toGraphQLInputType now have the following signatures:

    /**
     * @param (OutputType&GraphQLType)|null $subType
     *
     * @return OutputType&GraphQLType
     */
    public function toGraphQLOutputType(
        Type $type,
        OutputType|null $subType,
        ReflectionMethod|ReflectionProperty $reflector,
        DocBlock $docBlockObj
    ): OutputType;

    /**
     * @param (InputType&GraphQLType)|null $subType
     *
     * @return InputType&GraphQLType
     */
    public function toGraphQLInputType(
        Type $type,
        InputType|null $subType,
        string $argumentName,
        ReflectionMethod|ReflectionProperty $reflector,
        DocBlock $docBlockObj
    ): InputType;

Improvements

• #510
• #508

Dependencies

• Upgraded to using version 14.9 of webonyx/graphql-php

Breaking change

• The method setAnnotationCacheDir($directory) has been removed from the SchemaFactory. The annotation cache will use your Psr\SimpleCache\CacheInterface compliant cache handler set through the SchemaFactory constructor.

Minor changes

• Removed dependency for doctrine/cache and unified some of the cache layers following a PSR interface.
• Cleaned up some of the documentation in an attempt to get things accurate with versioned releases.

Breaking change

There is one breaking change introduced in the minor version (this was important to allow PHP 8 compatibility).

• The ecodev/graphql-upload package (used to get support for file uploads in GraphQL input types) is now a "recommended" dependency only. If you are using GraphQL file uploads, you need to add ecodev/graphql-upload to your composer.json.

New features

• All annotations can now be accessed as PHP 8 attributes
• The @deprecated annotation in your PHP code translates into deprecated fields in your GraphQL schema
• You can now specify the GraphQL name of the Enum types you define
• Added the possibility to inject pure Webonyx objects in GraphQLite schema

Minor changes

• Migrated from zend/diactoros to laminas/diactoros
• Making the annotation cache directory configurable

Miscellaneous

• Migrated from Travis to Github actions

This is a complete refactoring from 3.x. While existing annotations are kept compatible, the internals have completely changed.

New features

• You can directly annotate a PHP interface with #[Type] to make it a GraphQL interface
• You can autowire services in resolvers, thanks to the new @Autowire annotation
• Added user input validation (using the Symfony Validator or the Laravel validator or a custom #[Assertion] annotation
• Improved security handling:
  • Unauthorized access to fields can now generate GraphQL errors (rather that schema errors in GraphQLite v3)
  • Added fine-grained security using the #[Security] annotation. A field can now be marked accessible or not depending on the context. For instance, you can restrict access to the field "viewsCount" of the type BlogPost only for post that the current user wrote.
  • You can now inject the current logged user in any query / mutation / field using the #[InjectUser] annotation
• Performance:
  • You can inject the Webonyx query plan in a parameter from a resolver
  • You can use the dataloader pattern to improve performance drastically via the "prefetchMethod" attribute
• Customizable error handling has been added:
  • You can throw many errors in one exception with TheCodingMachine\GraphQLite\Exceptions\GraphQLAggregateException
• You can force input types using @UseInputType(for="$id", inputType="ID!")
• You can extend an input types (just like you could extend an output type in v3) using the new #[Decorate] annotation
• In a factory, you can exclude some optional parameters from the GraphQL schema

Many extension points have been added

• Added a "root type mapper" (useful to map scalar types to PHP types or to add custom annotations related to resolvers)
• Added "field middlewares" (useful to add middleware that modify the way GraphQL fields are handled)
• Added a "parameter type mapper" (useful to add customize parameter resolution or add custom annotations related to parameters)

New framework specific features:

Symfony

• The Symfony bundle now provides a "login" and a "logout" mutation (and also a "me" query)

Laravel

• Native integration with the Laravel paginator has been added

Internals

• The FieldsBuilder class has been split in many different services (FieldsBuilder, TypeHandler, and a chain of root type mappers)
• The FieldsBuilderFactory class has been completely removed.
• Overall, there is not much in common internally between 4.x and 3.x. 4.x is much more flexible with many more hook points than 3.x. Try it out!