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

v6.62.2

Changed

Simplify cache configuration access #2706

v6.62.1

Fixed

Write schema cache to temporary file before atomically updating it #2703

v6.62.0

Changed

Refresh schema cache lazily when GraphQL requests are made through MakesGraphQLRequests #2702

Deprecated

Deprecate Lumen support #2702

v6.61.1

Fixed

Improve @can directive docs https://github.com/nuwave/lighthouse/commit/70bea571382dae21165d81887fc4a9c0bdb91dee

v6.61.0

Added

Add option --sort to command lighthouse:print-schema #2696

v6.60.0

Changed

Allow combining @lazyLoad and @paginate #2695

v6.59.0

Added

Add method ASTCache::path() #2694

v6.58.0

Changed

Expose original resolver errors in @can* directives instead of always wrapping them #2686

v6.57.1

Changed

Use exclusive lock when writing the parsed schema to a file in ASTCache #2685

v6.57.0

Changed

Update generated protobuf code #2683

v6.56.1

Fixed

Initialize Argument::$type with null and make it nullable #2682

v6.56.0

Added

Add method ArgumentSet::exists() #2680

v6.55.0

Added

Add field operation_id to message QueryMetadata in reports.proto #2678

v6.54.0

Added

Support Laravel 12 #2665

v6.53.0

Added

Support encrypted subscription channels #2663

v6.52.1

Fixed

Pass specific parent model instances to builder enhancers when resolving paginated relations on lists #2671

v6.52.0

Added

Expose query complexity score in lifecycle event BuildExtensionsResponse #2637

v6.51.2

Fixed

Fix shortcut foreign key selection for morphTo relationships that use inline fragments in field selection #2670

v6.51.1

Fixed

Update generated code in Nuwave\Lighthouse\Tracing\FederatedTracing\Proto

v6.51.0

Fixed

Apply shortcut foreign key selection logic when __typename is included in related model's field selection #2666

Changed

Update reports.proto with Client awareness contexts #2667

v6.50.0

Added

Allow thecodingmachine/safe 3 #2657

v6.49.1

Fixed

Pull empty IDs instead of filling them with upsert #2656

v6.49.0

Added

Make reporting of client-safe errors configurable #2647

v6.48.0

Added

Add @bind directive as a GraphQL analogue for Laravel's Route Model Binding #2645

v6.47.1

Fixed

Cast model count to int in CountModelsLoader #2646

v6.47.0

Added

Support Laravel Reverb as a subscriptions broadcasting driver #2639

v6.46.0

Added

Allow @show, @hide, and @feature directives to be used on types, arguments and input types #2638

v6.45.1

Fixed

Fix field middleware directive stub https://github.com/nuwave/lighthouse/commit/21edcfe4762b4b6f14134e8b5c636662f97443ff

v6.45.0

Added

Cache query validation results #2603

v6.44.2

Fixed

Apply @convertEmptyStringsToNull to input fields when used upon fields #2610

v6.44.1

Fixed

Ensure deprecationReason is set on arguments and input fields #2609

v6.44.0

Added

Allow @deprecated directive on arguments and input fields #2607

v6.43.1

Changed

Improve formatting of _lighthouse_ide_helper.php #2604

v6.43.0

Added

Remove expired members from subscription topic stored in Redis set map #2601

v6.42.2

Fixed

Restore correct function of nested HasMany and MorphOne mutations #2591

v6.42.1

Changed

Improve validation message when using output types as inputs #2594

v6.42.0

Added

Add @hasOneThrough directive #2585

v6.41.1

Fixed

Handle errors thrown in lifecycle events per operation #2584

v6.41.0

Added

Add @withoutGlobalScopes directive #2577

v6.40.0

Added

Make GraphQL::loadPersistedQuery public #2579

v6.39.0

Added

Add directives @createMany, @updateMany and @upsertMany to mutate multiple models at once #2578

Changed

Split MutationExecutorDirective into OneModelMutationDirective and ManyModelMutationDirective #2578

v6.38.1

Fixed

Correct decay value calculation in @throttle directive #2573

v6.38.0

Added

Add option builder to @limit to apply an actual LIMIT clause #2571

v6.37.1

Fixed

Eliminate redundant Model::save() calls in nested mutations #2570

v6.37.0

Changed

Also report instances of GraphQL\Error\Error without previous exceptions in ReportingErrorHandler #2567
Report all errors thrown during the execution of async mutations regardless of client-safety #2567

v6.36.3

Fixed

Actually use raw attributes in comparison of paginated related models #2550

v6.36.2

Changed

Compare raw attributes only when ensuring uniqueness of paginated related models #2540

v6.36.1

Fixed

Native PHP Enums registered through the TypeRegistry may be used as morph type in nested MorphTo relations #2544

v6.36.0

Added

Support Laravel 11 #2508

v6.35.0

Added

Add ClientSafeModelNotFoundException to wrap original exception in @can and @canFind #2522

v6.34.1

Fixed

Fix Date scalar trying to parse Illuminate\Support\Carbon as string #2470

v6.34.0

Added

Merge directives from Scalar/Enum/Type/Input/Interface extension node into target node #2512

v6.33.4

Fixed

Fix stub for type resolvers used in lighthouse:union and lighthouse:interface artisan commands #2518

v6.33.3

Fixed

Allow custom model name in @canFind #2515

v6.33.2

Fixed

Fix ThrottleDirective to not reuse the first Request it had encountered #2511

v6.33.1

Fixed

Remove duplicate CanArgs from directive definition #2510

v6.33.0

Added

Expose pivot field on pagination edge #2464

v6.32.0

Added

Add @async directive #2501

Changed

Move and rename Nuwave\Lighthouse\Subscriptions\Contracts\ContextSerializer to Nuwave\Lighthouse\Support\Contracts\SerializesContext #2501
Do not bind CreatesContext and CanStreamResponse as singletons #2501

Fixed

Fix parsing reserialized LaravelEnumType from ResolveInfo::$variableValues #2501

v6.31.1

Fixed

Fix @limit directive definition

v6.31.0

Added

Add InputFieldManipulator directive interface #2476

v6.30.0

Added

Add configuration option parse_source_location #2499

v6.29.1

Fixed

Ensure @rule is never applied to argument lists themselves #2489

v6.29.0

Fixed

Return empty results for pagination first: 0 #2480

v6.28.0

Added

Mark common pagination types as @shareable for Apollo Federation v2 #2485

v6.27.0

Added

Split up @can directive into @canFind, @canModel, @canQuery, @canResolved and @canRoot #2483
Added action and returnValue arguments to @can* family of directives #2483
Allows using any objects in @can* family of directives #2483

v6.26.1

Fixed

Add scalar link__Import and enum link__Purpose to @link definition #2484

v6.26.0

Added

Support federated tracing #2479

v6.25.0

Added

Add @namespaced directive for namespacing by separation of concerns #2469

v6.24.0

Added

Add support for extend union syntax #2468

v6.23.2

Fixed

Exclude unnecessary extend schema from federation schema printer #2477

v6.23.1

Fixed

Fix FieldResolver directive stubs

v6.23.0

Added

Support Apollo Federation v2, except for federated tracing #2460

v6.22.0

Added

Add option root to @can directive #2452

v6.21.0

Added

Add option ignoreNull to @where directive #2447

v6.20.0

Added

Allow @cacheControl directive on type level #2451

Fixed

Inherit @cacheControl in pagination on fields #2451

v6.19.0

Added

Allow customizing the definition of the root Query field node added by @node #2449

v6.18.2

Fixed

Handle explicit null in @notIn, @whereBetween and @whereNotBetween directives #2446

v6.18.1

Fixed

Handle explicit null in @in directive #2445

v6.18.0

Added

Add directive @feature to conditionally add annotated elements based on the state of a feature using Laravel Pennant #2442

v6.17.0

Added

Improve stubs for PHP 8.2 and above #2441

v6.16.2

Fixed

Fix NOT_LIKE operator in @whereConditions #2432

v6.16.1

Fixed

Reset cached values of arguments in BaseDirective::hydrate() #2430

v6.16.0

Changed

ScoutEnhancer::enhanceBuilder() will process not only the first but all ScoutBuilderDirective attached to argument #2429
ResolveInfo::enhanceBuilder() will pass $directiveFilter into ScoutEnhancer::enhanceBuilder() #2429

v6.15.0

Added

Ensure @scope supports custom query builders #2423

v6.14.0

Added

Add support to generate tests when generating field classes #2419

v6.13.0

Added

Validate arguments with list types do not use @spread #2421

v6.12.0

Changed

Add PaginatorInfo, SimplePaginatorInfo, PageInfo only when required #2413

v6.11.0

Added

Add option findOrFail to @can directive #2416

v6.10.1

Fixed

Guess type names of programmatically registered types for models #2415

v6.10.0

Added

Allow default model class resolution for union types #2406

v6.9.2

Fixed

Fix DirectiveLocator assertion

v6.9.1

Fixed

Ensure built-in directives have the lowest priority in registration #2403

v6.9.0

Added

Add feature toggles via @hide and @show directive #2392

v6.8.1

Fixed

Fix scalar.stub return type

v6.8.0

Added

Add the ability to specify the disk the artisan command lighthouse:print-schema will write to via the --disk option #2379

v6.7.0

Added

Simplify exposing root type Query in nested results #2384

v6.6.1

Fixed

Add Node interface as soon as a type uses it with @node #2387

v6.6.0

Fixed

Correctly exclude all built-in types when calling lighthouse:ide-helper with --omit-built-in flag #2376

v6.5.0

Added

Add Nuwave\Lighthouse\Schema\AST\ASTHelper::addDirectiveToNode() to simplify dynamic addition of directives #2369

v6.4.0

Added

Allow customizing query complexity calculation of @paginate with argument complexityResolver #2372

v6.3.1

Fixed

Leverage relations for resolving composite object @key in default model entity resolver for federation

v6.3.0

Added

Hydrate external fields for models resolved from representations in federation #2366

v6.2.1

Fixed

Fixed resolving composite object @key in default model entity resolver for federation #2365

v6.2.0

Changed

Automatically set up test traits RefreshSchemaCache and TestsSubscriptions

v6.1.0

Added

Add option --omit-built-in to lighthouse:ide-helper to avoid duplicate built-in definitions #2362

v6.0.0

Changed

Use the strongest possible native types over PHPDocs
Use declare(strict_types=1)
Add validation support to Paginator with resolver mode
Pass resolver arguments to FieldBuilderDirective::handleFieldBuilder() #2234
Expected resolver arguments in ResolveInfo::enhanceBuilder()
Pass the path array to CacheKeyAndTags::key() #2176
Require implementations of BatchedEntityResolver to maintain the keys given in array $representations #2286
Require filter directives such as @whereKey in @delete, @forceDelete and @restore #2289
Subscriptions can now be filtered via $subscriber->socket_id and request()->header('X-Socket-ID') #2298
Make pagination argument first non-nullable
Calculate complexity for @paginate according to the number of items requested
Require argument resolver in directive @complexity
Move interface Nuwave\Lighthouse\Support\Contracts\GlobalId to Nuwave\Lighthouse\GlobalId\GlobalId
Use union type for $id argument in NodeDirective
Replace Arr::first(array_keys()) with array_key_first() in OrderByDirective
Limit constructor argument $paginationType in PaginationType to literal constant values
Change visibility of BaseDirective::directiveHasArgument from public to protected
Replace Illuminate\Database\DatabaseManager with Illuminate\Database\ConnectionResolverInterface in RelationDirective
Replace DirectiveLocator::beforeLast with Str::beforeLast
Default subscriptions.exclude_empty to true
Allow FieldManipulator and ArgManipulator directives on interfaces #1955
Apply argument transformation only once per field #1706
Expect FieldResolver::resolveField() to return resolver function directly #1706
Simplify FieldMiddleware directive interface #1706
Rename configuration option schema.register to schema_path
Restructure cache related configuration options
Register all non-user namespaces through RegisterDirectiveNamespaces event #2337
Guard default configuration options in lighthouse.php allows multiple guards #2345
Make @auth and @whereAuth support multiple guards #2345
Make Illuminate\Http\Request optional in Nuwave\Lighthouse\Support\Contracts\GraphQLContext #2353
Move namespace Nuwave\Lighthouse\Support\Http to Nuwave\Lighthouse\Http #2358

Fixed

Return proper error for unknown types in variable definitions
Ensure _entities maintains order of representations in result #2286
Allow combining @can with non-default @guard #2276
Fix error message when failing to find class in namespace #2342
Prevent regression to simple paginator type on fields using @cache directive #2354

Added

Add method TypeRegistry::search() that maybe finds a type with a given name
Decode fields with directive @globalId in federation model entity resolver
Add GraphQLContext:: setUser(?Authenticatable $user): void
Add directive @whereKey to filter Models by their primary key #2289
Allow directive @where on fields #2306
Allow passing route parameters in MakeGraphQLRequests test methods #2333
Add subscription assertion methods in MakesGraphQLRequests and TestResponseMixin and docs in phpunit integration section #2343
Allow laragraph/utils:^2 #2356
Add directives @whereNull and @whereNotNull #2357
Add configurable namespace to allow custom non-root type field resolvers without FQN #2351

Removed

Remove mixin TestResponse::assertGraphQLErrorCategory()
Remove class Nuwave\Lighthouse\Exceptions\GenericException
Remove error extension field category
Remove interface Nuwave\Lighthouse\Exceptions\RendersErrorsExtensions
Remove Nuwave\Lighthouse\Execution\ExtensionErrorHandler
Remove support for PHP 7.2, 7.3, 7.4
Remove support for Laravel 5, 6, 7, 8
Remove Serializable implementation
Remove trait ClearsSchemaCache
Remove config option lighthouse.unbox_bensampo_enum_enum_instances
Remove ArgumentSet::enhanceBuilder(), use ResolveInfo::enhanceBuilder()
Remove the globalId argument from @delete, @forceDelete and @restore #2289
Remove MockResolver
Remove deprecated BatchLoader::forgetInstances() in GraphQL
Remove method check for Illuminate\Foundation\Exceptions\Handler::renderable
Remove setting non_null_pagination_results and always behave as if it were true
Remove Nuwave\Lighthouse\Subscriptions\Contracts\StoresSubscriptions::subscriberByRequest()
Remove deprecated methods from FieldValue
Remove deprecated GraphQL::executeQuery() and GraphQL::prepSchema()
Remove @field directive argument args #1706
Remove schema caching v1 #2321
Do not register ScoutServiceProvider by default
Remove alias/Facade graphql
Remove subscriptions version 1
Remove MiddlewareAdapter #2358

v5.72.0

Added

Add configuration option parse_source_location #2498

v5.71.0

Added

Support Laravel 10

v5.70.3

Fixed

Allow Illuminate\Http\UploadedFile in test helper multipartGraphQL() argument array $files

v5.70.2

Fixed

Fix batch loading relations of parents that were partially cached #2269

v5.70.1

Fixed

Fix batch loading a paginated BelongsToMany relation with duplicates #2277

v5.70.0

Added

Allow configuring regular expression constraints for the registered route with lighthouse.route.where

v5.69.1

Fixed

Wrap base ResolveInfo class and extend it with public ArgumentSet $argumentSet in response to PHP 8.2 deprecating dynamic properties

v5.69.0

Added

Add argument builder to directive @aggregate #2255

v5.68.1

Fixed

Avoid duplicated data in relation directives with paginator with non-unique foreign keys #2252

v5.68.0

Added

Allow interfaces to implement interfaces #2248

Fixed

Mark @clearCache directive repeatable #2243

v5.67.0

Added

Throw on unsafe usage of @can directive argument resolved on mutations #2238

v5.66.0

Added

Support returning data in a Paginator from option resolver in @paginator directive #2232

v5.65.0

Added

Validate only one of any mutually exclusive directive arguments is defined #2233

v5.64.1

Fixed

Handle unset properties in field_middleware directives #2224

v5.64.0

Changed

Allow requests with header X-Requested-With: XMLHttpRequest in EnsureXHR middleware #2221

v5.63.1

Fixed

Fix GraphQL enum names generation from column names containing symbols #2219

v5.63.0

Added

Allow easily overwriting enum description generation from bensampo/laravel-enum #2218

v5.62.0

Changed

Extract uploaded file name calculation to method in @upload directive #2215

v5.61.0

Added

Add @upload directive #2121

v5.60.0

Added

Allow configuring security.disable_introspection through the env variable LIGHTHOUSE_SECURITY_DISABLE_INTROSPECTION #2205

v5.59.0

Added

Open EnsureXHR middleware for extension #2202

v5.58.2

Fixed

Clean duplicate @param in field_full.stub #2198

v5.58.1

Fixed

Allow pagination amount to be 0 #2105

v5.58.0

Added

Add description generation to LaravelEnumType based on BenSampo\Enum\Enum::getClassDescription() #2177

v5.57.6

Fixed

Fix @convertEmptyStringsToNull on fields and matrices #2142

v5.57.5

Fixed

Fix directive option model on schema elements using built-in types #2196

v5.57.4

Fixed

Respect explicit maxCount: null or defaultCount: null in pagination directives over config lighthouse.pagination #2193

v5.57.3

Fixed

Fix cursor pagination always returning the first page when no fields from the pageInfo are requested #2190

v5.57.2

Fixed

Allow returning Laravel\Scout\Builder from custom builder in @all and @paginate #2183

v5.57.1

Fixed

Handle missing models in @can with option resolved #2187

v5.57.0

Added

Allow checking policies against resolved models in @can #2159

Fixed

Fix static analysis error in testing traits #2180

v5.56.0

Added

Implement @hasManyThrough directive #2178

v5.55.1

Fixed

Always register TestingServiceProvider in order to ensure macros are recognized by Larastan #2171

v5.55.0

Changed

@paginate directive will use a simple pagination strategy when the paginator info is not requested #2170

v5.54.0

Changed

Cache related code moves to the cache namespace, add new contract CacheKeyAndTags #2162

v5.53.0

Changed

Include field that produced a RateLimitException in its message #2149

v5.52.1

Fixed

Show proper validation error when referencing standard types in union #2157

v5.52.0

Added

Allow pagination types for @morphToMany #2154

v5.51.1

Fixed

Consider @rename when picking the value of a key in @cache #2155

v5.51.0

Added

Add columns and distinct args to @count directive #2138

v5.50.0

Added

Add @cacheControl directive #2136

v5.49.0

Added

Provide additional information about detected usages of deprecated elements #2141

v5.48.2

Fixed

Allow @cacheKey on field definition #2131

v5.48.1

Fixed

Omit non-nullable arguments in @convertEmptyStringsToNull #2130

v5.48.0

Changed

Generate classes as final through artisan commands #2127

v5.47.1

Fixed

RelationDirective/batchload_relations will consider null and default connection name the same connection #2125

v5.47.0

Added

Add @convertEmptyStringsToNull directive #2123

Fixed

Allow returning Relation from custom builder on @all and @paginate directive #2120

v5.46.2

Fixed

Respect non-default primary key in nested one-to-many relations #2119

v5.46.1

Fixed

Distinguish between client-safe and non-client-safe errors in TestResponse::assertGraphQLError()

v5.46.0

Added

Add method TestResponse::assertGraphQLDebugMessage() to test internal errors #2117

v5.45.4

Fixed

Revert breaking schema change in generate pagination types #2104

v5.45.3

Fixed

Annotate generated schema with correct model in paginated relations #2093

v5.45.2

Fixed

Fix definition of @clearCache argument idSource #2100

v5.45.1

Fixed

Fix mget returning false for entries #2095

v5.45.0

Added

Add @drop directive to ignore incoming values #2092

v5.44.1

Changed

Expire query cache after one day by default #2089

v5.44.0

Changed

Register artisan commands not only when running in console #2088

v5.43.0

Added

Allow lazy registration of types #2086

v5.42.3

Fixed

Improve error message when passing non-existing class-string to LaravelEnumType

v5.42.2

Fixed

Handle invalid subscriber cache entries from redis #2084

v5.42.1

Fixed

Normalize rules input to ensure Laravel 9 support #2070

v5.42.0

Added

Batched federation entity resolvers #2043

v5.41.0

Added

Add testing trait RefreshesSchemaCache #2076

Fixed

Add proper error handling for invalid schema cache file contents #2076

Deprecated

Deprecate testing trait ClearsSchemaCache #2076

v5.40.1

Fixed

Properly handle any kind of deferred resolved value #2064

v5.40.0

Added

Support Laravel 9

v5.39.2

Fixed

Handle expired subscriber keys in RedisStorageManager::subscribersByTopic() #2035

v5.39.1

Fixed

Remove unused configuration option batched_queries #2046

v5.39.0

Added

Add field hasMorePages for pagination type SIMPLE #2051

v5.38.2

Fixed

Only shortcut foreign key selection if shortcut_foreign_key_selection is enabled in lighthouse.php #2049

v5.38.1

Fixed

Consider transactional_mutations in @delete, @forceDelete and @restore #2050

v5.38.0

Added

Detect usage of deprecated elements in queries #2004

v5.37.2

Fixed

Fix EnsureXHR middleware to handle additional fields in the Content-Type header #2036
Fix EnsureXHR middleware to handle method override via _method parameter #2036

v5.37.1

Fixed

Separate eager loaded relations for fields with aliases #2019

v5.37.0

Changed

Improve default schema #2032

v5.36.0

Added

Allow caching parsed query strings #2017
Support Automatic Persisted Queries #2017

Deprecated

Deprecate Nuwave\Lighthouse\GraphQL::executeQuery() #2017

v5.35.3

Fixed

Fix thecodingmachine/safe version constraint

Fixed

v5.35.2

Fixed

Ensure compatibility with thecodingmachine/safe:2 #2028

v5.35.1

Fixed

Fix partitioning of arguments where the model has a non-relation method returning primitive #2026

v5.35.0

Added

Shortcut @belongsTo and @morphTo if the client only selects the ID of the relation

v5.34.0

Added

Allow marking enum values derived from bensampo/laravel-enum as @deprecated through PHPDoc #2025

v5.33.1

Fixed

Fix ASTCache with LIGHTHOUSE_CACHE_VERSION=1 in env #2020

v5.33.0

Added

Add @clearCache directive that clears a resolver cache by tags #1931

Fixed

Do not change capitalization of types and fields in cache keys #1931
Add hidden config option lighthouse.cache.tags in config/lighthouse.php #1931
Set up correct authentication context for subscriptions with @guard fields #1769

Changed

Include empty placeholder for parent cache key in root fields to ensure predictable cache key #1931
Prefix all generate cache keys or tags with lighthouse #1931

v5.32.0

Added

Added middleware Nuwave\Lighthouse\Support\Http\Middleware\EnsureXHR to mitigate CSRF attacks without Laravel Sanctum #2013

v5.31.3

Fixed

Use StartExecution event to determine per-operation Tracing timestamps #2009

v5.31.2

Fixed

Trigger model events on nested mutation disconnect of one to many relationships #2008

v5.31.1

Fixed

Ensure _ide_helper.php works as PHPStan stub file #2006

v5.31.0

Added

Add method assertGraphQLError() to TestResponse mixin #2005

v5.30.0

Added

Mixin method assertGraphQLErrorFree() to Illuminate\Testing\TestResponse

Fixed

Add missing types to programmatic-types.graphql in artisan command lighthouse:ide-helper

v5.29.0

Added

Add ability to provide custom handler for @whereConditions and @whereHasConditions #2001

v5.28.1

Added

Improve error message when calling TestResponse::assertGraphQLErrorMessage() on successful response

v5.28.0

Added

Allow clients to order a list of models by an aggregated value of their relations with @orderBy #1848

v5.27.3

Fixed

Prevent possible Undefined array key 0 error when there's an interface implemented by two renamed models #1997

v5.27.2

Fixed

Prevent Undefined array key error when using cache version 2 and not having all version 1 configuration present #1994

v5.27.1

Changed

Regenerate cache when calling php artisan lighthouse:cache #1990

v5.27.0

Fixed

Avoid PHP 8.1 deprecation warning by implementing __serialize() and __unserialize() #1987

Deprecated

Deprecate Serializable implementation in favor of magic methods #1987

v5.26.1

Changed

Improve error message when failing to find classes in namespaces #1983

v5.26.0

Added

Allow specifying headers in MakesGraphQLRequests and MakesGraphQLRequestsLumen test helpers
Render GraphQL\Error\ClientAware exceptions outside GraphQL context with extensions content

Fixed

Do not batchload relations with different database connections

v5.25.1

Fixed

Consider renamed models in default type resolver #1967

v5.25.0

Added

Add setting unbox_bensampo_enum_enum_instances to turn off BenSampo\Enum\Enum unboxing #1971

Deprecated

Deprecate BenSampo\Enum\Enum unboxing #1971

v5.24.0

Added

Add Nuwave\Lighthouse\Support\Contracts\ComplexityResolverDirective interface to allow overwriting the default query complexity calculation #1947
Allow omitting name in @scope by defaulting to the argument name #1957

Changed

Lazily resolve field type #1950

Fixed

Ensure non-pagination related arguments called first do not mistakenly increase @complexity #1947

Deprecated

Deprecate methods to set a query complexity resolver through Nuwave\Lighthouse\Schema\Values\FieldValue #1947
Deprecate smart methods in Nuwave\Lighthouse\Schema\Values\FieldValue #1951

v5.23.1

Fixed

Apply @spread to inputs nested within lists #1944

v5.23.0

Added

Add --federation option to lighthouse:print-schema command to print the schema with federation directives and without federation spec additions, like _service.sdl #1932

v5.22.5

Fixed

Allow Laravel default guard to be null for applications that do not use auth at all

v5.22.4

Fixed

Fall back to Laravel default guard if Lighthouse default is undefined #1930

Changed

Move authentication and authorization functionality to Nuwave\Lighthouse\Auth and a dedicated AuthServiceProvider #1930

v5.22.3

Fixed

Make TestReponse::assertGraphQLValidationError() work for fields with multiple messages #1926

v5.22.2

Fixed

Support schema without Query type when using federation #1925

v5.22.1

Fixed

Allow Carbon\CarbonImmutable for date scalars #1924

v5.22.0

Added

Add AuthenticationException::fromLaravel() and AuthenticationErrorHandler to handle laravel native AuthenticationException #1922
Add AuthorizationException::fromLaravel() and AuthorizationErrorHandler to handle laravel native AuthorizationException #1922

v5.21.0

Added

Add trait ClearsSchemaCache to clear the schema cache once before any tests are run #1920

v5.20.0

Added

Include definition when generating directives via artisan lighthouse:directive #1921

v5.19.0

Added

Add query and scopes arguments to the @can directive #1916

v5.18.1

Fixed

Fix compatibility with Laravel Octane #1911

v5.18.0

Changed

Mark @guard and @namespace directives as repeatable #1907

v5.17.0

Added

Add support for custom rules that reference other arguments #1903

v5.16.2

Fixed

Allow using date validation rules that reference other arguments #1900

v5.16.1

Fixed

Fix ValidationErrorHandler returned error type https://github.com/nuwave/lighthouse/commit/e9f97c117a50aab3c61cb104628696a97b5bfa2b

v5.16.0

Added

Add ValidationException::fromLaravel() and ValidationErrorHandler to include validation messages in extensions #1899

v5.15.3

Changed

Provide context for syntax errors thrown during schema parsing #1892

v5.15.2

Fixed

Fix usage of validation rules with chained query builders with @validator #1890

v5.15.1

Fixed

Call lighthouse:clear-cache in other commands to handle schema cache version 2 #1894

v5.15.0

Added

Add method rethrowGraphQLErrors() to testing helper to leverage PHPUnit exception testing #1885

v5.14.0

Added

Add config setting cache.version to use a PHP file for the schema cache and leverage OPcache #1842

v5.13.1

Fixed

Fix model name determination when using interfaces #1882

v5.13.0

Added

Add config setting non_null_pagination_results to mark the generated result type of paginated lists as non-nullable #1878

Changed

Improve descriptions of generated pagination types #1878

v5.12.7

Fixed

Fix incorrect config key for subscriptions redis storage connection #1874

v5.12.6

Fixed

Avoid conflicting relation batch loader overlaps when using dot notation in @with #1871

v5.12.5

Fixed

Allow integer zero, empty string and false as valid cached values with @cache #1869

v5.12.4

Fixed

Fix combining @lazyLoad with paginated relations #1867

v5.12.3

Fixed

Allow JSON notation -> in column references for complex where conditions #1864

v5.12.2

Fixed

Handle null when encoding or decoding with @globalId #1862

v5.12.1

Fixed

Fix resolving relation items and count in one query #1859

v5.12.0

Added

Add ValidationException::withMessages() #1857

v5.11.0

Added

Add lifecycle events StartOperationOrOperations and EndOperationOrOperations #1856

v5.10.0

Added

Support Laravel Octane #1854

Changed

Improve performance through graphql-php lazy field definitions #1851
Load individual subscription fields lazily instead of loading them all eagerly #1851
Require webonyx/graphql-php:^14.7 #1851

v5.9.1

Fixed

Pass plain values to ScoutBuilderDirective::handleScoutBuilder() #1853

v5.9.0

Added

Add @aggregate directive #1849

Changed

Split DataLoader functionality into BatchLoader and ModelsLoader #1849
Combine eager loads that produce identical results #1849

v5.8.2

Fixed

Allow @builder in combination with @search #1850

v5.8.1

Fixed

Avoid setting multiple @model directives on generated paginator types #1837

v5.8.0

Added

Add SIMPLE pagination type #1816

v5.7.2

Fixed

Fix problem with table name on HAS condition with relationship on same table #1795

v5.7.1

Fixed

Fix usage of closures in validation #1831

v5.7.0

Added

Add builder option to @all directive #1826

v5.6.2

Changed

Update behavior of TestReponse::assertGraphQLErrorMessage to work when multiple errors are present #1827

v5.6.1

Fixed

Fix overly eager validation of repeatable directive usage by requiring webonyx/graphql-php:^14.6.2 #1824
Fix conversion of repeatable directive nodes into executable definitions #1824

v5.6.0

Added

Support for Apollo Federation #1728

v5.5.1

Fixed

Add placeholder type _ to schema-directives.graphql #1823

v5.5.0

Fixed

Allow @limit on FIELD_DEFINITION to fix validation errors #1821

Added

Add method assertGraphQLErrorMessage() to TestResponse mixin #1819

v5.4.0

Added

Add GraphQLContext to StartExecution event
Add connect and disconnect operations in nested mutations for HasMany and MorphMany relations #1730
Add ValidateSchema event #1764
Add config option subscriptions.exclude_empty #1799

Changed

Optimize @defer by avoiding parsing the request multiple times
Move HTTP and Schema handling out of the GraphQL class #1748
Move subscription related classes into Subscription namespace #1803
Consolidate GlobalId namespace #1804

Fixed

Apply error handling and debug settings consistently #1749
Fix typo comparision to comparison in generated input types for @whereHas
Fix redis mget being called with an empty list of subscriber IDs #1759
Fix lighthouse:clear-cache not clearing cache when a custom cache store is used #1788
Fix subscription storage in redis for predis users #1814
Prepend rule arguments that refer to other arguments with the full path #1739

Deprecated

Deprecate the globalId argument of the @upsert directive #1804

v5.3.0

Added

Validate that @with and @withCount are not used on root fields #1714
Add events to cover the lifecycle of a GraphQL request: EndExecution, EndRequest #1726
Include the client given query, variables and operation name in the StartExecution event #1726
Apply log option from the broadcasting config to the Pusher subscription driver #1733
Support pusher/pusher-php-server version 5 #1741

Changed

Prepend directives when transferring them from types to fields #1734
For echo driver-based subscriptions, the event name will be lighthouse-subscription #1733
Echo driver will always broadcast through the private channel #1733

Fixed

Apply custom error handlers for syntax or request errors #1726
Define scalars instead of Mixed type in directive definitions #1742
Fix subscription extension version default value #1744

v5.2.0

Added

Allow using the @builder directive on fields #1687
Add dedicated Nuwave\Lighthouse\Scout\ScoutBuilderDirective #1691
Allow @eq directive on fields #1681
Add @throttle directive to set field rate limit using Laravel rate limiting services #1708
Add subscriptions v2 #1716

Changed

Clarify semantics of combining @search with other directives #1691
Move Scout related classes into Nuwave\Lighthouse\Scout #1698
BaseDirective loads all arguments and caches them after the first directiveHasArgument/directiveArgValue call #1707
Use gate response in authorization errors of @can directive #1715

Fixed

Fix nested OR conditions in HAS relations #1713

Deprecated

Specify @guard(with: "api") should be changed to @guard(with: ["api"])#1705

v5.1.0

Added

Allow spec-compliant definition of the messages argument of @rules and @rulesForArray #1662
Validate correct usage of @rules and @rulesForArray #1662
Allow eager-loading multiple relations on a single field using @with #1528
Add Nuwave\Lighthouse\Execution\DataLoader\BatchLoaderRegistry to instantiate arbitrary batch loaders #1528
Add @limit directive to allow clients to specify the maximum number of results to return #1674
Predefine default field ordering by using @orderBy on fields #1678
Add @like directive to use a client given value to add a LIKE conditional to a database query #1644

Changed

Improve batch loading performance #1528
Require webonyx/graphql-php version ^14.5

Deprecated

Deprecate the globalId argument of the @delete, @forceDelete and @restore directives #1660
Deprecate passing the messages argument of @rules and @rulesForArray as a map with arbitrary keys #1662
Deprecate Nuwave\Lighthouse\Execution\DataLoader\BatchLoader in favour of Nuwave\Lighthouse\Execution\DataLoader\BatchLoaderRegistry #1528

Fixed

Remove non-functional globalId argument definition from @update #1660
Resolve field middleware directives in lexical order #1666
Ensure Carbon\Carbon is cast to Illuminate\Support\Carbon in date scalars #1672
Fix Laravel 5.6 compatibility for @withCount and paginated relationship directives #1528
Fix issue where argument names where used instead of variable names in subscription queries #1683
Fix issue with TTL breaking subscriptions #1685

v5.0.2

Fixed

Make @node force load the type if it has not been loaded #1659

v5.0.1

Fixed

Make @model not extend @node accidentally

Deprecated

Deprecate Nuwave\Lighthouse\Subscriptions\Subscriber::setRoot() in favour of property access

v5.0.0

Added

Apply validation rules to input types by providing a validator class #1185
Include schema directives when running php artisan lighthouse:validate-schema #1494
Add ability to query for the existence of relations in where conditions #1412
Handle content types application/graphql and application/x-www-form-urlencoded properly #1424
Mark directives that can be used more than once per location as repeatable #1529
Allow configuring global field middleware directives in config/lighthouse.php #1533
Add custom attributes to validations #1628
Add new directive interface FieldBuilderDirective #1636
Add @whereAuth directive for filtering a field based on authenticated user #1636
Use the @trim directive on fields to sanitize all input strings #1641
Add Laravel Echo compatible subscription broadcaster #1370
Allow auxiliary types in directive definitions #1649

Changed

Use Illuminate\Support\Carbon instead of Carbon\Carbon
Nuwave\Lighthouse\Exceptions\ValidationException no longer extends Illuminate\Validation\ValidationException #1185
Move validation related classes into namespace Nuwave\Lighthouse\Validation #1185
Run ArgDirectives in distinct phases: Sanitize, Validate, Transform #1185
The directive interfaces ArgBuilderDirective, ArgTransformerDirective and ArgDirectiveForArray extend Directive instead of ArgDirective #1185
Change the autogeneration of the OrderByClause input for @orderBy, the argument field is now always called column #1337
Names for autogenerated types are now prepended with the name of the fields parent type This affects @orderBy, @whereConditions and @whereHasConditions #1337
__invoke is now the only supported method name for convention based field resolver classes #1422
Change Nuwave\Lighthouse\Support\Contracts\Directive to require all directives to have an SDL definition by implementing public static definition(): string #1386
Combine Nuwave\Lighthouse\Schema\Factories\DirectiveNamespacer and Nuwave\Lighthouse\Schema\Factories\DirectiveFactory into Lighthouse\Schema\DirectiveLocator #1494
Require haydenpierce/class-finder as a built-in dependency #1494
Add method defaultHasOperator to Nuwave\Lighthouse\WhereConditions\Operator #1412
Change default configuration options in lighthouse.php:
- 'guard' => 'api'
- 'forceFill' => true
Use laragraph/utils for parsing HTTP requests #1424
Replace the subscription broadcast queued event handler with a queued job to allow the queue name to be specified #1507
Make @method call the underlying method with the arguments as ordered parameters instead of the full resolver arguments #1509
Change ErrorHandler method handle() to non-static __invoke() and allow discarding errors by returning null
Allow subscriptions without named operations, base channels on the field name
Set lighthouse.debug config through env LIGHTHOUSE_DEBUG #1592
Test helper multipartGraphQL now accepts arrays instead of JSON strings #1615
Use DateTime::ATOM for DateTimeTZ ISO 8601 compatibility #1622
Split ProvidesRules interface into ArgumentValidation and ArgumentSetValidation #1628
Update to PHP 8 compatible mll-lab/graphql-php-scalars 4 #1639
Add TrimDirective to the default field_middleware config in lighthouse.php #1641
Field keys in validation errors now match the client given input, ignoring transformations such as @spread #1631

Removed

Remove support for PHP 7.1, Laravel 5.5 and PHPUnit 6 #1192
Remove TestResponse::jsonGet() helper, use ->json() instead https://github.com/nuwave/lighthouse/pull/1192/files
Remove Nuwave\Lighthouse\Execution\GraphQLValidator as validation now uses Laravel's native validator #1185
Remove interfaces HasArgumentPath and HasErrorBuffer and the parts of FieldFactory that calls them #1185
Remove the ValidationDirective abstract class in favour of validator classes #1185
Remove configuration option lighthouse.orderBy, always uses column now #1337
Remove Nuwave\Lighthouse\Support\Contracts\DefinedDirective interface, moving its functionality to Nuwave\Lighthouse\Support\Contracts\Directive #1386
Remove fallback for lighthouse.cache.ttl setting #1423
Remove Nuwave\Lighthouse\Schema\AST\PartialParser in favor of GraphQL\Language\Parser #1457
Remove Nuwave\Lighthouse\Execution\GraphQLRequest singleton #1424
Remove @bcrypt in favor of @hash #1200
Remove the @middleware directive, as it violates the boundary between HTTP and GraphQL request handling. Use @guard or other field middleware directives instead #1135
Remove configuration option pagination_amount_argument, it is always first now

Fixed

Prefix complex conditions with table name to avoid ambiguous SQL #1530
Merge type interfaces when extending type #1635

Deprecated

Deprecate values for the type argument of @paginate that are not PAGINATOR or CONNECTION

v4.18.0

Added

Add @morphToMany directive #1604

v4.17.0

Added

Support Laravel 8 #1549 and #1578

v4.16.3

Fixed

Fix the type hint in GraphQLContext::user()

v4.16.2

Fixed

Provide the definition for @nest

v4.16.1

Fixed

Ensure the @with directive works properly with polymorphic relations #1517

v4.16.0

Added

Add artisan command lighthouse:cache to compile GraphQL AST #1451
Add middleware Nuwave\Lighthouse\Support\Http\Middleware\LogGraphQLQueries that logs every incoming GraphQL query #1454
Allow custom query validation rules selection by rebinding the interface Nuwave\Lighthouse\Support\Contracts\ProvidesValidationRules #1487
Add DateTimeUtc scalar #1320

Changed

Publish config file with tag lighthouse-config and default schema with tag lighthouse-schema instead of the previously used tags config and schema #1489
Throw partial errors when failing to delete, forceDelete or restore a model #1420
Add Nuwave\Lighthouse\Execution\ErrorPool to allow collection of partial errors #1420

Fixed

Ensure the @count directive works properly with polymorphic relations #1466
Take route prefix into account in graphQLEnpointUrl() test helper #1439

Deprecated

Deprecate Nuwave\Lighthouse\Execution\ErrorBuffer in favor of Nuwave\Lighthouse\Execution\ErrorPool #1420

v4.15.0

Added

Add @withCount directive to eager load relationship counts on field access #1390
Extend lighthouse:directive artisan command to allow choosing interfaces #1251
Add lighthouse.cache.store configuration option to set the cache store to use for schema caching #1446

Changed

Eager load relationship count in @count directive #1390
Simplify the default field resolver classes generated by the artisan commands lighthouse:query and lighthouse:mutation, add option --full to include the seldom needed resolver arguments $context and $resolveInfo

Fixed

Restore application of global scopes in nested relation queries when batching pagination #1447
Avoid unnecessarily reloading models with count in nested relation queries #1447

v4.14.1

Fixed

Safeguard deletion of programmatic-types.graphql in artisan lighthouse:ide-helper

v4.14.0

Added

Write definitions for programmatically registered types to programmatic-types.graphql when running the lighthouse:ide-helper artisan command #1371

Fixed

Fix the error message when using multiple exclusive directives on a single node #1387
Allow passing additional headers to multipartGraphQL Lumen test helper too #1395
Rectify that @orderBy, @whereConditions and @whereHasConditions only work on field arguments #1402
Make mass assignment behavior configurable through force_fill option in lighthouse.php #1405

Deprecated

Nuwave\Lighthouse\Support\Contracts\DefinedDirective::definition() will be moved to Nuwave\Lighthouse\Support\Contracts\Directive and replace its name() method. This requires all directives to have an SDL definition.

v4.13.1

Fixed

Pull primary key from arguments in @update before force filling them into the Model #1377

v4.13.0

Added

Allow passing additional headers to multipartGraphQL test helper #1342
Add empty root types automatically when extending them #1347
Configure a default guard for all authentication functionality #1343
Configure the default amount of items in paginated lists with pagination.default_count #1352
Add new methods has(), overwrite() and registerNew() to TypeRegistry to control if types should be overwritten when registering duplicates #1361

Changed

Improve validation error when extending a type that is not defined #1347
Use forceFill() when mutating models #1348
Namespace pagination related configuration in lighthouse.php #1352
Fix publishing the config when using Lumen #1355

Deprecated

The setting paginate_max_count will change to pagination.max_count #1352
The registerNew() method of TypeRegistry will be removed in favor of register(), which will change its behavior to throw when registering duplicates #1361

v4.12.4

Fixed

Fix nesting OR within AND condition when using @whereConditions #1341

v4.12.3

Changed

Throw an exception if the return type declaration class for a relation does not exist #1338

v4.12.2

Fixed

Fix converting lists of lists into ArgumentSet #1335

Changed

Make test request helper PHPDocs more accurate for Laravel 7 #1336

v4.12.1

Fixed

Fix creating multiple nested BelongsTo relationships on the same level when previous records with matching attributes exist #1321

v4.12.0

Added

Add flag --json to print-schema to output JSON instead of GraphQL SDL #1268
Add TTL option for subscriptions storage #1284
Provide assertion helpers through TestResponseMixin #1308
Add scalar DateTimeTz #1311
Publish _lighthouse_ide_helper.php with php artisan lighthouse:ide-helper

Fixed

Fix nested mutations with multiple belongsTo relations at the same level #1285
Avoid race condition that occurs when using Cache::has() #1290
Replace usage of resolve() helper with Lumen-compatible app() #1305
Fix using @create and @update on nested input object fields that accept an array of input types #1316

Changed

Remove subscriber reference from topic when deleted #1288
Improve subscription context serializer #1283
Allow replacing the SubscriptionRegistry implementation using the container #1286
Report errors that are not client-safe through Laravel's ExceptionHandler #1303
Log in subscribers when broadcasting a subscription update, so that calls to auth()->user() return the authenticated user instead of null #1306
Replace the subscription broadcast queued event handler with a queued job to allow the queue name to be specified #1301

v4.11.0

Added

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

Fixed

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

v4.10.2

Fixed

Ensure subscription routes are named uniquely #1231

Changed

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

v4.10.1

Fixed

Fix Laravel version detection for Lumen #1224

v4.10.0

Added

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

Deprecated

Remove @bcrypt in favor of @hash #1200
@method will call the underlying method with the arguments as ordered parameters instead of the full resolver arguments #1208

v4.9.0

Added

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

Fixed

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

v4.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 #1149

v4.8.0

Added

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

Changed

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

Fixed

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

Deprecated

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

Removed

Remove broken NOT conditional when using @whereConditions https://github.com/nuwave/lighthouse/pull/1125

v4.7.2

Fixed

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

v4.7.1

Changed

Add INPUT_FIELD_DEFINITION to allowed locations for the @builder directive https://github.com/nuwave/lighthouse/pull/1074

Fixed

Define @enum as a directive class so it shows up in schema-directives.graphql and can potentially be overwritten https://github.com/nuwave/lighthouse/pull/1078

v4.7.0

Added

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

Changed

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

v4.6.0

Added

Add @scope directive for adding a scope to the query builder https://github.com/nuwave/lighthouse/pull/998

Changed

Use detailed $description property when generating enum values from a BenSampo\Enum\Enum class https://github.com/nuwave/lighthouse/pull/1027

Fixed

Handle arrays of namespaces in generator commands https://github.com/nuwave/lighthouse/pull/1033

v4.5.3

Fixed

Handle null being passed to a nullable argument that is an input object type https://github.com/nuwave/lighthouse/pull/1021

v4.5.2

Fixed

Fix conversion of client directives after the schema was cached https://github.com/nuwave/lighthouse/pull/1019

v4.5.1

Fixed

Handle null being passed to a nullable argument that is a list of type https://github.com/nuwave/lighthouse/pull/1016

v4.5.0

Added

Add @upsert directive and nested mutation operations to create or update a model regardless whether it exists https://github.com/nuwave/lighthouse/pull/1005

Fixed

Fix broken behavior when using union types with schema caching https://github.com/nuwave/lighthouse/pull/1015

v4.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 https://github.com/nuwave/lighthouse/pull/1011

v4.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 https://github.com/nuwave/lighthouse/pull/1011

v4.4.0

Added

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

Fixed

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

Changed

Allow additional route configurations prefix and domain https://github.com/nuwave/lighthouse/pull/951
Enable schema cache only when APP_ENV != 'local' https://github.com/nuwave/lighthouse/pull/957

Fixed

Fix default model detection when using other directives combination with @paginate https://github.com/nuwave/lighthouse/pull/974

Deprecated

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

v4.3.0

Added

Add @restore and @forceDelete directives, similar to @delete https://github.com/nuwave/lighthouse/pull/941
Add @softDeletes and @trashed directives to enable filtering soft deleted models https://github.com/nuwave/lighthouse/pull/937

Fixed

Prevent throwing in lighthouse:ide-helper when no custom directives are defined https://github.com/nuwave/lighthouse/pull/948

Changed

Validate requirements for argument definitions of @delete, @forceDelete and @restore during schema build time https://github.com/nuwave/lighthouse/pull/941

v4.2.1

Fixed

Actually use the specified edgeType in Relay style connections https://github.com/nuwave/lighthouse/pull/939

v4.2.0

Added

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

v4.1.1

Fixed

Unbox laravel-enum inputs when using the builder directives https://github.com/nuwave/lighthouse/pull/927

v4.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 https://github.com/nuwave/lighthouse/issues/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 https://github.com/nuwave/lighthouse/pull/916
Add test helpers for introspection queries to MakesGraphQLRequests https://github.com/nuwave/lighthouse/pull/916

Deprecated

The default name of resolver and type resolver methods will be __invoke in v5 https://github.com/nuwave/lighthouse/issues/882

Fixed

Fixed the ValidationDirective not setting the mutation or query arguments to itself https://github.com/nuwave/lighthouse/pull/915

v4.0.0

Added

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

Fixed

Avoid growing the memory extensively when doing complex AST manipulation https://github.com/nuwave/lighthouse/pull/768
Make nested mutations work with subclassed relationship types https://github.com/nuwave/lighthouse/pull/825
Allow empty arrays and other falsy values as input for nested mutation operations like "sync" https://github.com/nuwave/lighthouse/pull/830
Use Illuminate\Contracts\Config\Repository instead of Illuminate\Config\Repository https://github.com/nuwave/lighthouse/issues/832
Allow checking the abilities with @can when issuing mass updates on multiple models https://github.com/nuwave/lighthouse/pull/838
Allow use of private in @cache directive even when the user is not authenticated https://github.com/nuwave/lighthouse/pull/843
Fix Lumen route registration https://github.com/nuwave/lighthouse/pull/853
Fix handling of @include directive, it is semantically opposite to @skip, when using it with @defer https://github.com/nuwave/lighthouse/pull/855
Allow querying for null values using @whereConstraints https://github.com/nuwave/lighthouse/pull/872
Fix issue when using the @model directive in a type that has a list field https://github.com/nuwave/lighthouse/pull/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 https://github.com/nuwave/lighthouse/pull/892

Changed

Bumped the requirement on webonyx/graphql-php to ^0.13.2 https://github.com/nuwave/lighthouse/pull/768
Rename directive interfaces dealing with types from Node* to Type* https://github.com/nuwave/lighthouse/pull/768
Change the signature of the AST manipulating directive interfaces: TypeManipulator, FieldManipulator and ArgManipulator https://github.com/nuwave/lighthouse/pull/768
Change the API of the DocumentAST class to enable a more performant implementation https://github.com/nuwave/lighthouse/pull/768
Enable the schema caching option lighthouse.cache.enable by default https://github.com/nuwave/lighthouse/pull/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 https://github.com/nuwave/lighthouse/pull/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 https://github.com/nuwave/lighthouse/pull/820
Move SubscriptionExceptionHandler into namespace Nuwave\Lighthouse\Subscriptions\Contracts https://github.com/nuwave/lighthouse/pull/819
The pagination field argument that controls the amount of results now defaults to first instead of count. The config pagination_amount_argument can be used to change the argument name https://github.com/nuwave/lighthouse/pull/852
Rename ArgValidationDirective to ProvidesRules and drop get prefix from the methods within https://github.com/nuwave/lighthouse/pull/846
Make the argument used for finding a model to check @can against configurable. The previous behavior of implicitly using the id argument for finding a specific model to authorize against now no longer works. https://github.com/nuwave/lighthouse/pull/856
Change the Nuwave\Lighthouse\Schema\Types\LaravelEnumType wrapper to map to Enum instances internally https://github.com/nuwave/lighthouse/pull/908

Removed

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

Deprecated

The configuration option pagination_amount_argument will be removed in v5

v3.7.0

Added

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

Fixed

Fix querying for falsy values through @whereConstraints https://github.com/nuwave/lighthouse/pull/800
Use Illuminate\Contracts\Events\Dispatcher instead of concrete implementation in SubscriptionBroadcaster https://github.com/nuwave/lighthouse/pull/805

Deprecated

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

v3.6.1

Fixed

Use the spec-compliant default deprecation reason for @deprecate directive https://github.com/nuwave/lighthouse/pull/787

v3.6.0

Added

Add @whereConstraints directive that offers flexible query capabilities to the client https://github.com/nuwave/lighthouse/pull/753
Add convenience wrapper for registering Enum types based on [BenSampo/laravel-enum https://github.com/nuwave/lighthouse/pull/779

Deprecated

The controller config option will be removed in v4 https://github.com/nuwave/lighthouse/pull/781

v3.5.3

Fixed

Respect the model's connection for database transaction during @create and @update https://github.com/nuwave/lighthouse/pull/777

v3.5.2

Fixed

You can now omit an input argument from a query that uses the @spread directive without getting an error https://github.com/nuwave/lighthouse/pull/774

Deprecated

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

v3.5.1

Fixed

Throw error if pagination amount <= 0 is requested https://github.com/nuwave/lighthouse/pull/765

v3.5.0

Changed

Default the config to always set the Accept: application/json header https://github.com/nuwave/lighthouse/pull/743
Declare a single named route which handles POST/GET instead of 2 separate routes https://github.com/nuwave/lighthouse/pull/738
Apply the nested operations within a nested mutation in a consistent order that makes sense https://github.com/nuwave/lighthouse/pull/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 https://github.com/nuwave/lighthouse/pull/752

Fixed

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

v3.4.0

Added

Allow rebinding a custom GlobalId resolver https://github.com/nuwave/lighthouse/pull/739

v3.3.0

Added

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

Deprecated

Use the @spread instead of the flatten argument of @create/@update https://github.com/nuwave/lighthouse/pull/680
Prefer usage of the ArgBuilderDirective instead of the ArgFilterDirective https://github.com/nuwave/lighthouse/pull/680
@whereBetween and @whereNotBetween will take a single input object instead of being spread across two args https://github.com/nuwave/lighthouse/pull/680

v3.2.1

Changed

Flatten the namespace for the built-in directives https://github.com/nuwave/lighthouse/pull/700

v3.2.0

Added

Sync and connect existing models in morphToMany relations using nested mutations https://github.com/nuwave/lighthouse/pull/707

v3.1.0

Added

Adapt to the new Laravel way and add an alias dispatch for the @event directive https://github.com/nuwave/lighthouse/pull/719

Deprecated

Aliases fire and class for dispatching through @event https://github.com/nuwave/lighthouse/pull/719

v3.0.0

Added

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

Changed

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

Fixed

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

Removed

Remove the previously broken @validate directive in favor of @rules https://github.com/nuwave/lighthouse/pull/427
Remove broken user mutations from the default schema https://github.com/nuwave/lighthouse/pull/435
Remove deprecated methods https://github.com/nuwave/lighthouse/pull/435
Limit the @field directive to using the resolver argument https://github.com/nuwave/lighthouse/pull/435
Remove the @security directive in favor of defining security options through the config https://github.com/nuwave/lighthouse/pull/435
Rename the resolver argument of @interface and @union to resolveType https://github.com/nuwave/lighthouse/pull/435
Remove deprecated Traits https://github.com/nuwave/lighthouse/pull/435

Pre-v3

We just started maintaining a changelog starting from v3.

If someone wants to make one for previous versions, pull requests are welcome.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!