CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

You can find and compare releases at the GitHub release page.

Unreleased

Added

• Add AttemptAuthentication middleware to optionally log in users and delegate access guards to the field level nuwave/lighthouse#1197
• Add artisan command lighthouse:directive to add directive class nuwave/lighthouse#1240

Fixed

• Eager load nested relations using the @with directive nuwave/lighthouse#1068
• Avoid infinite loop with empty namespace in generator commands nuwave/lighthouse#1245
• Automatically register TestingServiceProvider for @mock when running unit tests nuwave/lighthouse#1244

4.10.2

Fixed

• Ensure subscription routes are named uniquely nuwave/lighthouse#1231

Changed

• Throw user readable Error instead of ModelNotFoundException when model is not found in @can nuwave/lighthouse#1225

4.10.1

Fixed

• Fix Laravel version detection for Lumen nuwave/lighthouse#1224

4.10.0

Added

• Access nested inputs with dot notation using the find option of @can nuwave/lighthouse#1216
• Add @hash directive which uses Laravel's hashing configuration nuwave/lighthouse#1200
• Add option passOrdered to @method to pass just the arguments as ordered parameters nuwave/lighthouse#1208
• Add support to extend input, interface and enum types nuwave/lighthouse#1203
• Implement streamGraphQL() helper in \Nuwave\Lighthouse\Testing\MakesGraphQLRequestsLumen nuwave/lighthouse#1222
• Support Laravel 7 nuwave/lighthouse#1219

Deprecated

• Remove @bcrypt in favour of @hash nuwave/lighthouse#1200
• @method will call the underlying method with the arguments as ordered parameters instead of the full resolver arguments nuwave/lighthouse#1208

4.9.0

Added

• Add optional columnsEnum argument to the @whereConditions, @whereHasConditions and @orderBy directives nuwave/lighthouse#1150
• Exclude or include trashed models in @can when @forceDelete or @restore are used so the client does not have to filter explicitly nuwave/lighthouse#1157
• Add test trait \Nuwave\Lighthouse\Testing\MakesGraphQLRequestsLumen for usage with Lumen nuwave/lighthouse#1100
• Add test trait \Nuwave\Lighthouse\Testing\UsesTestSchema to enable using a dummy schema for testing custom Lighthouse extensions nuwave/lighthouse#1171
• Simplify mocking resolvers that just return static data nuwave/lighthouse#1177
• Add utility \Nuwave\Lighthouse\ClientDirectives\ClientDirective to correctly get the arguments passed through a client directive nuwave/lighthouse#1184
• Add streamGraphQL() helper method to \Nuwave\Lighthouse\Testing\MakesGraphQLRequests for simple testing of streamed responses, such as @defer nuwave/lighthouse#1184

Fixed

• Fix eager-loading relations where the parent type is an interface or union and may correspond to multiple different models nuwave/lighthouse#1035
• Fix renaming input fields that are nested within lists using @rename nuwave/lighthouse#1166
• Fix handling of nested mutation operations that receive null nuwave/lighthouse#1174
• Fix nested mutation upsert across two levels of BelongsTo relations nuwave/lighthouse#1169
• Apply query filters using an ArgBuilderDirective such as @eq when the argument is nested deeply within the input nuwave/lighthouse#1176
• Fix \Nuwave\Lighthouse\Testing\MakesGraphQLRequestsLumen test helper nuwave/lighthouse#1186
• Handle multiple instances of client directives with @defer correctly nuwave/lighthouse#1184

Deprecated

• Deprecate \Nuwave\Lighthouse\Schema\Source\SchemaSourceProvider#setRootPath(), this function is never called or used anywhere within Lighthouse. It will be removed from the interface.

4.8.1

Fixed

• Avoid erasing the model information from the wrapping paginated results type when defining a paginated @hasMany field after a field with @paginate nuwave/lighthouse#1149

4.8.0

Added

• Compose complex input arguments through nested arg resolvers nuwave/lighthouse#899
• Add \Nuwave\Lighthouse\Support\Contracts\ArgResolver directive interface nuwave/lighthouse#899
• Allow existing mutation directives @create, @update, @upsert and @delete to function as nested arg resolvers nuwave/lighthouse#899
• Validate at schema build time that the apply argument @rules is an array nuwave/lighthouse#1092
• Add support in @whereConditions for IN, IS NULL and BETWEEN operators nuwave/lighthouse#1099
• Add ability to define pivot data on nested mutations within sync, syncWithoutDetach and connect nuwave/lighthouse#1110
• Allow restricting the columns for @orderBy to a given whitelist and generate an enum definition for it nuwave/lighthouse#1118
• Allow passing variables in ->graphQL() test helper nuwave/lighthouse#1127
• Add missing schema descriptions to some inputs, types, and enums nuwave/lighthouse#1131
• Add @guard directive to handle authentication nuwave/lighthouse#1135
• Add @whereHasConditions directive to filter query results based on the existence of a relationship nuwave/lighthouse#1140

Changed

• Remove \Nuwave\Lighthouse\Execution\MutationExecutor in favour of modular nested arg resolvers nuwave/lighthouse#899
• Register the operator enum for @whereConditions programmatically and allow overwriting it through a service provider nuwave/lighthouse#1099
• Always automatically set the correct argument type when using @whereConditions or @orderBy directives nuwave/lighthouse#1118
• Implement the name() function generically in the BaseDirective class nuwave/lighthouse#1098
• Renamed the @whereConstraints directive to @whereConditions nuwave/lighthouse#1140

Fixed

• Enable chained rule provider directives (ProvidesRules) to merge the rules before validating nuwave/lighthouse#1082
• Apply nested OR conditions in @whereConditions correctly nuwave/lighthouse#1099
• Allow passing null or simply no id when using @upsert nuwave/lighthouse#1114

Deprecated

• The argument field within the OrderByClause used for @orderBy will be renamed to column in v5 nuwave/lighthouse#1118
• Deprecated the @middleware directive, as it violates the boundary between HTTP and GraphQL request handling. Use @guard or other field middleware directives instead nuwave/lighthouse#1135

Removed

• Remove broken NOT conditional when using @whereConditions nuwave/lighthouse#1125

4.7.2

Fixed

• Enable multiple queries in a single request by clearing BatchLoader instances after executing each query nuwave/lighthouse#1030
• Keep the query and pagination capabilities of relation directives when disabling batch loading nuwave/lighthouse#1083

4.7.1

Changed

• Add INPUT_FIELD_DEFINITION to allowed locations for the @builder directive nuwave/lighthouse#1074

Fixed

• Define @enum as a directive class so it shows up in schema-directives.graphql and can potentially be overwritten nuwave/lighthouse#1078

4.7.0

Added

• Add syncWithoutDetaching option for BelongsToMany and MorphToMany relationships nuwave/lighthouse#1031
• Add injectArgs option to @can directive to pass along client defined arguments to the policy check nuwave/lighthouse#1043
• Allow globally turning off relation batch loading through the config option batchload_relations nuwave/lighthouse#1059
• Add \Nuwave\Lighthouse\Execution\DataLoader\BatchLoader#loadMany() function nuwave/lighthouse#973
• Extend @rename directive to work with arguments and input fields nuwave/lighthouse#521

Changed

• Add ability to fetch soft deleted model within @can directive to validate permissions using @softDeletes directive. nuwave/lighthouse#1042
• Improve the error message for missing field resolvers by offering a solution nuwave/lighthouse#1045
• Throw DefinitionException when missing a type in the type registry nuwave/lighthouse#1066
• Add INPUT_FIELD_DEFINITION to orderBy directive location nuwave/lighthouse#1069

4.6.0

Added

• Add @scope directive for adding a scope to the query builder nuwave/lighthouse#998

Changed

• Use detailed $description property when generating enum values from a BenSampo\Enum\Enum class nuwave/lighthouse#1027

Fixed

• Handle arrays of namespaces in generator commands nuwave/lighthouse#1033

4.5.3

Fixed

• Handle null being passed to a nullable argument that is an input object type nuwave/lighthouse#1021

4.5.2

Fixed

• Fix conversion of client directives after the schema was cached nuwave/lighthouse#1019

4.5.1

Fixed

• Handle null being passed to a nullable argument that is a list of type nuwave/lighthouse#1016

4.5.0

Added

• Add @upsert directive and nested mutation operations to create or update a model regardless whether it exists nuwave/lighthouse#1005

Fixed

• Fix broken behaviour when using union types with schema caching nuwave/lighthouse#1015

4.4.2

Added

• Validate the correctness of the builder given to @paginate at schema build time

Fixed

• Do not require the type of a field matching a model class when using the builder argument of @paginate nuwave/lighthouse#1011

4.4.1

Fixed

• Fix regression in 4.4.0 that required matching the type returned from paginated relationship fields with the class name of the model nuwave/lighthouse#1011

4.4.0

Added

• Add @count directive for counting a relationship nuwave/lighthouse#984
• Allow overwriting the name of Enum types created through LaravelEnumType nuwave/lighthouse#968
• Resolve models through Relay's global identification using @node nuwave/lighthouse#974
• Add experimental @modelClass directive to map types to models. It will be renamed to @model in v5 nuwave/lighthouse#974

Fixed

• Remove the extra new line from the returned value when using @globalId(decode: "ID") nuwave/lighthouse#982
• Throw a syntax error instead of an exception when performing an empty request or a request with an empty query nuwave/lighthouse#989
• Properly apply @spread when used within a nested input object nuwave/lighthouse#992

Changed

• Allow additional route configurations prefix and domain nuwave/lighthouse#951
• Enable schema cache only when APP_ENV != 'local' nuwave/lighthouse#957

Fixed

• Fix default model detection when using other directives combination with @paginate nuwave/lighthouse#974

Deprecated

• Use the RegisterDirectiveNamespaces event instead of DirectiveFactory#addResolved() nuwave/lighthouse#950
• Use @node instead of @model to resolve models through Relay's global identification nuwave/lighthouse#974

4.3.0

Added

• Add @restore and @forceDelete directives, similar to @delete nuwave/lighthouse#941
• Add @softDeletes and @trashed directives to enable filtering soft deleted models nuwave/lighthouse#937

Fixed

• Prevent throwing in lighthouse:ide-helper when no custom directives are defined nuwave/lighthouse#948

Changed

• Validate requirements for argument definitions of @delete, @forceDelete and @restore during schema build time nuwave/lighthouse#941

4.2.1

Fixed

• Actually use the specified edgeType in Relay style connections nuwave/lighthouse#939

4.2.0

Added

• Add @morphOne directive for polymorphic one-to-one relationships nuwave/lighthouse#944
• Add @morphTo directive for polymorphic one-to-one relationships nuwave/lighthouse#921
• Add @morphMany directive for polymorphic one-to-many relationships nuwave/lighthouse#944
• Support Laravel ^6.0 nuwave/lighthouse#926
• Add command lighthouse:ide-helper for generating a definition file with all schema directives nuwave/lighthouse#933

4.1.1

Fixed

• Unbox laravel-enum inputs when using the builder directives nuwave/lighthouse#927

4.1.0

Added

• Add the @whereJsonContains directive to an input value as a [whereJsonContains filter
• Allow using callable classes with __invoke when referencing methods in directives and when looking for default resolvers or type resolvers nuwave/lighthouse#882
• Allow to restrict column names to a well-defined list in @whereContraints and generate definitions for an Enum type and an Input type that are restricted to the defined columns nuwave/lighthouse#916
• Add test helpers for introspection queries to MakesGraphQLRequests nuwave/lighthouse#916

Deprecated

• The default name of resolver and type resolver methods will be __invoke in v5 nuwave/lighthouse#882

Fixed

• Fixed the ValidationDirective not setting the mutation or query arguments to itself nuwave/lighthouse#915

4.0.0

Added

• Add the @namespace directive as a replacement for the removed @group directive nuwave/lighthouse#768
• The @defer extension now supports deferring nested fields of mutations nuwave/lighthouse#855
• Add a simple way to define complex validation directives by extending \Nuwave\Lighthouse\Schema\Directives\ValidationDirective nuwave/lighthouse#846
• Extend the @belongsToMany directive to support pivot data on a custom Relay style Edge type nuwave/lighthouse#871
• Implement connect, disconnect and delete operations for nested mutations upon MorphTo relationships nuwave/lighthouse#879

Fixed

• Avoid growing the memory extensively when doing complex AST manipulation nuwave/lighthouse#768
• Make nested mutations work with subclassed relationship types nuwave/lighthouse#825
• Allow empty arrays and other falsy values as input for nested mutation operations like "sync" nuwave/lighthouse#830
• Use Illuminate\Contracts\Config\Repository instead of Illuminate\Config\Repository nuwave/lighthouse#832
• Allow checking the abilities with @can when issuing mass updates on multiple models nuwave/lighthouse#838
• Allow use of private in @cache directive even when the user is not authenticated nuwave/lighthouse#843
• Fix Lumen route registration nuwave/lighthouse#853
• Fix handling of @include directive, it is semantically opposite to @skip, when using it with @defer nuwave/lighthouse#855
• Allow querying for null values using @whereConstraints nuwave/lighthouse#872
• Fix issue when using the @model directive in a type that has a list field nuwave/lighthouse#883
• Make the @include and @skip directives that are part of the GraphQL spec show up in introspection and fix handling of default values in custom client directives nuwave/lighthouse#892

Changed

• Bumped the requirement on webonyx/graphql-php to ^0.13.2 nuwave/lighthouse#768
• Rename directive interfaces dealing with types from Node* to Type* nuwave/lighthouse#768
• Change the signature of the AST manipulating directive interfaces: TypeManipulator, FieldManipulator and ArgManipulator nuwave/lighthouse#768
• Change the API of the DocumentAST class to enable a more performant implementation nuwave/lighthouse#768
• Enable the schema caching option lighthouse.cache.enable by default nuwave/lighthouse#768
• Lazily load types from the schema. Directives defined on parts of the schema that are not used within the current query are no longer run on every request nuwave/lighthouse#768
• Simplify the default route configuration. Make sure to review your config/lighthouse.php and bring it up to date with the latest changes in the base configuration file nuwave/lighthouse#820
• Move SubscriptionExceptionHandler into namespace Nuwave\Lighthouse\Subscriptions\Contracts nuwave/lighthouse#819
• The pagination field argument that controls the amount of results now default tos first instead of count. The config pagination_amount_argument can be used to change the argument name nuwave/lighthouse#852
• Rename ArgValidationDirective to ProvidesRules and drop get prefix from the methods within nuwave/lighthouse#846
• Make the argument used for finding a model to check @can against configurable. The previous behaviour of implicitly using the id argument for finding a specific model to authorize against now no longer works. nuwave/lighthouse#856
• Change the Nuwave\Lighthouse\Schema\Types\LaravelEnumType wrapper to map to Enum instances internally nuwave/lighthouse#908

Removed

• Remove @group directive in favour of @middleware and @namespace nuwave/lighthouse#768
• Remove the ArgFilterDirective interface in favour of the ArgBuilderDirective interface nuwave/lighthouse#821
• Remove the old style @whereBetween and @whereNotBetween directives nuwave/lighthouse#821
• Use the @spread directive instead of the flatten argument of @create/@update nuwave/lighthouse#822
• Remove dispatch aliases fire and class for dispatching through @event nuwave/lighthouse#823
• Remove the GraphQL facade and the container alias graphql nuwave/lighthouse#824
• Remove the alias if for specifying the ability that has to be met in @can nuwave/lighthouse#838

Deprecated

• The configuration option pagination_amount_argument will be removed in v5

3.7.0

Added

• Add compatibility layer to allow @middleware to support Lumen nuwave/lighthouse#786
• Add option decode to @globaldId to control the result of decoding nuwave/lighthouse#796
• Add config option cache.ttl for customizing expiration time of schema cache nuwave/lighthouse#801
• Extract test helpers into a reusable trait \Nuwave\Lighthouse\Testing\MakesGraphQLRequests nuwave/lighthouse#802
• Support custom rule classes in @rules and @rulesForArray nuwave/lighthouse#812

Fixed

• Fix querying for falsy values through @whereConstraints nuwave/lighthouse#800
• Use Illuminate\Contracts\Events\Dispatcher instead of concrete implementation in SubscriptionBroadcaster nuwave/lighthouse#805

Deprecated

• The GraphQL facade and the container alias graphql will be removed in v4

3.6.1

Fixed

• Use the spec-compliant default deprecation reason for @deprecate directive nuwave/lighthouse#787

3.6.0

Added

• Add @whereConstraints directive that offers flexible query capabilities to the client nuwave/lighthouse#753
• Add convenience wrapper for registering Enum types based on [BenSampo/laravel-enum nuwave/lighthouse#779

Deprecated

• The controller config option will be removed in v4 nuwave/lighthouse#781

3.5.3

Fixed

• Respect the model's connection for database transaction during @create and @update nuwave/lighthouse#777

3.5.2

Fixed

• You can now omit an input argument from a query that uses the @spread directive without getting an error nuwave/lighthouse#774

Deprecated

• The class SubscriptionExceptionHandler will be moved to the namespace Nuwave\Lighthouse\Subscriptions\Contracts

3.5.1

Fixed

• Throw error if pagination amount <= 0 is requested nuwave/lighthouse#765

3.5.0

Changed

• Default the config to always set the Accept: application/json header nuwave/lighthouse#743
• Declare a single named route which handles POST/GET instead of 2 separate routes nuwave/lighthouse#738
• Apply the nested operations within a nested mutation in a consistent order that makes sense nuwave/lighthouse#754

Deprecated

• The pagination field argument that controls the amount of results will default to first instead of count in v4. The config pagination_amount_argument can be used to change the argument name now nuwave/lighthouse#752

Fixed

• Instantiate the ErrorBuffer directly, its dependencies can not be resolved through the container nuwave/lighthouse#756
• Refresh GraphQLRequest singleton between multiple requests to prevent a common error in test execution nuwave/lighthouse#761

3.4.0

Added

• Allow rebinding a custom GlobalId resolver nuwave/lighthouse#739

3.3.0

Added

• Sync existing models in belongsToMany relations using nested mutations when creating nuwave/lighthouse#707
• Add @spread directive to reshape nested input arguments nuwave/lighthouse#680
• Add flexible @builder directive to quickly specify a single method to apply constraints to the query builder nuwave/lighthouse#680
• Add new_between_directives config to use the new between directives now nuwave/lighthouse#680

Deprecated

• Use the @spread instead of the flatten argument of @create/@update nuwave/lighthouse#680
• Prefer usage of the ArgBuilderDirective instead of the ArgFilterDirective nuwave/lighthouse#680
• @whereBetween and @whereNotBetween will take a single input object instead of being spread across two args nuwave/lighthouse#680

3.2.1

Changed

• Flatten the namespace for the built-in directives nuwave/lighthouse#700

3.2.0

Added

• Sync and connect existing models in morphToMany relations using nested mutations nuwave/lighthouse#707

3.1.0

Added

• Adapt to the new Laravel way and add an alias dispatch for the @event directive nuwave/lighthouse#719

Deprecated

• Aliases fire and class for dispatching through @event nuwave/lighthouse#719

3.0.0

Added

• Support Subscriptions nuwave/lighthouse#337
• Support @defer client directive nuwave/lighthouse#422
• Define validation for list arguments themselves through @rulesForArray nuwave/lighthouse#427
• The @hasMany and @paginator directives now support an additional argument defaultCount that sets a default value for the generated field argument count nuwave/lighthouse#428
• Allow user to be guest when using the @can directive nuwave/lighthouse#431
• Add shortcut to get NodeValue type definition fields nuwave/lighthouse#432
• Use @inject with dot notation to set nested value nuwave/lighthouse#511
• Populate more relationship types through nested mutations nuwave/lighthouse#514 nuwave/lighthouse#549
• Support the @deprecated directive nuwave/lighthouse#522
• Allow defining default namespaces as an array nuwave/lighthouse#525
• Add config & directive argument for @paginate to limit the maximum requested count nuwave/lighthouse#569
• Add guard argument to @auth directive nuwave/lighthouse#584
• Support Laravel 5.8 nuwave/lighthouse#626
• Support File Uploads nuwave/lighthouse#628
• Add lifecycle events to hook into the execution nuwave/lighthouse#645
• Add @orderBy argument directive for client-side dynamic ordering nuwave/lighthouse#659
• Enable passing in model instance to @can directive nuwave/lighthouse#684
• Allow swapping out the default resolver nuwave/lighthouse#690

Changed

• Change the default schema location, model and GraphQL namespaces nuwave/lighthouse#423
• Construction and methods of the Field|Node|Arg-Value objects nuwave/lighthouse#425
• The methods called with @method now receive the same 4 resolver arguments that all other resolvers do nuwave/lighthouse#486
• Handle mutating directives transactional by default nuwave/lighthouse#512
• Nested mutations for BelongsTo require wrapping the ID in a connect argument nuwave/lighthouse#514 nuwave/lighthouse#549
• Make the error messages returned by @can more friendly nuwave/lighthouse#515
• Bump requirements for webonyx/graphql-php to ^0.13 and PHP to >= 7.1 nuwave/lighthouse#517
• Replace DirectiveRegistry with DirectiveFactory to lazy load directives nuwave/lighthouse#520
• Extensions must registered through ServiceProviders instead of the config file nuwave/lighthouse#645
• Increase tracing precision when nanoseconds are available nuwave/lighthouse#674

Fixed

• Diverging paths of nested input objects can now have distinct validation rules nuwave/lighthouse#427
• Distinguish between FieldDefinitions and InputObjectValues in AST handling nuwave/lighthouse#425
• Set the date in the Date scalar to startOfDay, fixes equality checks nuwave/lighthouse#452
• Use primary key defined in model to execute update nuwave/lighthouse#469
• Consider batched queries when using BatchLoader nuwave/lighthouse#508
• Refresh newly created models before returning them nuwave/lighthouse#509
• Prevent name conflict between argument names and non-relation methods when executing nested mutations nuwave/lighthouse#519
• Prevent crash when invalid JSON variables are given nuwave/lighthouse#581
• Handle pagination with Laravel Scout correctly nuwave/lighthouse#661
• Handle schema defined default values for enum types correctly nuwave/lighthouse#689

Removed

• Remove the previously broken @validate directive in favour of @rules nuwave/lighthouse#427
• Remove broken user mutations from the default schema nuwave/lighthouse#435
• Remove deprecated methods nuwave/lighthouse#435
• Limit the @field directive to using the resolver argument nuwave/lighthouse#435
• Remove the @security directive in favour of defining security options through the config nuwave/lighthouse#435
• Rename the resolver argument of @interface and @union to resolveType nuwave/lighthouse#435
• Remove deprecated Traits nuwave/lighthouse#435

Pre-v3

We just started maintaining a changelog starting from v3.

If someone wants to make one for previous versions, PR's are welcome.