deprecate(graphql/@searchBy): @searchByOperatorRelation, the `@se…

…archByOperatorRelationship` should be used instead.

Partially reverts 0574fd2

packages/graphql/UPGRADE.md

@@ -53,7 +53,7 @@ Please also see [changelog](https://github.com/LastDragon-ru/lara-asp/releases)
 
 * [ ] `@searchByOperators` => `@searchByExtendOperators`. 🤝
 
-* [ ] `@searchByOperatorRelation` => `@searchByOperatorRelationship` (and class too; generated types will be named as `SearchByRelationship*` instead of `SearchByComplex*`).
+* [ ] `@searchByOperatorRelation` => `@searchByOperatorRelationship` (and class too; generated types will be named as `SearchByRelationship*` instead of `SearchByComplex*`). 🤝
 
 * [ ] `LastDragon_ru\LaraASP\GraphQL\SearchBy\Operators::Condition` => `LastDragon_ru\LaraASP\GraphQL\SearchBy\Operators::Object`.
 

packages/graphql/src/SearchBy/Definitions/SearchByOperatorRelationDirective.php

@@ -0,0 +1,14 @@
+<?php declare(strict_types = 1);
+
+namespace LastDragon_ru\LaraASP\GraphQL\SearchBy\Definitions;
+
+use LastDragon_ru\LaraASP\GraphQL\SearchBy\Operators\Complex\Relationship;
+
+/**
+ * @deprecated 5.6.0 Please use {@see SearchByOperatorRelationshipDirective}.
+ */
+class SearchByOperatorRelationDirective extends Relationship {
+    // Lighthouse loads all classes from directive namespace this leads to
+    // 'Class "Orchestra\Testbench\TestCase" not found' error for our *Test
+    // classes. This class required to avoid this error.
+}

packages/graphql/src/SearchBy/Directives/DirectiveTest/V5Compat.expected.graphql

@@ -168,6 +168,12 @@ on
     | INPUT_FIELD_DEFINITION
     | SCALAR
 
+directive @searchByOperatorRelation
+on
+    | FIELD_DEFINITION
+    | INPUT_FIELD_DEFINITION
+    | SCALAR
+
 directive @searchByOperatorRelationship
 on
     | FIELD_DEFINITION
@@ -189,14 +195,6 @@ enum SearchByTypeFlag {
     )
 }
 
-input Comment {
-    date: Date
-    text: String!
-
-    user: User
-    @belongsTo
-}
-
 """
 Available conditions for `input CommentsQuery` (only one field allowed at a time).
 """
@@ -271,6 +269,12 @@ input SearchByConditionUser {
     """
     not: SearchByConditionUser
     @searchByOperatorNot
+
+    """
+    Relationship condition.
+    """
+    parent: SearchByRelationshipUser
+    @searchByOperatorRelation
 }
 
 """
@@ -308,6 +312,35 @@ input SearchByConditionUsersQuery {
     @searchByOperatorNot
 }
 
+"""
+Conditions for the relationship (`has()`/`doesntHave()`) for `type User`.
+
+See also:
+* https://laravel.com/docs/eloquent-relationships#querying-relationship-existence
+* https://laravel.com/docs/eloquent-relationships#querying-relationship-absence
+"""
+input SearchByRelationshipUser {
+    """
+    Count conditions.
+    """
+    count: SearchByScalarInt
+
+    """
+    Alias for `count: {greaterThanOrEqual: 1}`. Will be ignored if `count` used.
+    """
+    exists: Boolean
+
+    """
+    Alias for `count: {lessThan: 1}`. Will be ignored if `count` used.
+    """
+    notExists: Boolean! = false
+
+    """
+    Additional conditions.
+    """
+    where: SearchByConditionUser
+}
+
 """
 Conditions for the relationship (`has()`/`doesntHave()`) for `input UsersQuery`.
 
@@ -630,6 +663,14 @@ scalar Date
     class: "Nuwave\\Lighthouse\\Schema\\Types\\Scalars\\Date"
 )
 
+type Comment {
+    date: Date
+    text: String!
+
+    user: User
+    @belongsTo
+}
+
 type Query {
     comments(
         where: SearchByConditionCommentsQuery
@@ -647,4 +688,7 @@ type Query {
 type User {
     id: ID!
     name: String!
+
+    parent: User
+    @searchByOperatorRelation
 }

packages/graphql/src/SearchBy/Directives/DirectiveTest/V5Compat.schema.graphql

@@ -19,9 +19,11 @@ input CommentsQuery {
 type User {
     id: ID!
     name: String!
+    parent: User
+    @searchByOperatorRelation
 }
 
-input Comment {
+type Comment {
     text: String!
     user: User @belongsTo
     date: Date