Collaborative Editing criterions and sort clauses

Author: mnocon

docs/search/collaborative_editing_search_reference/invitation/created_at_invitation_criterion.md

@@ -0,0 +1,23 @@
+---
+description: CreatedAt Search Criterion
+---
+
+# CreatedAt Search Criterion
+
+The `CreatedAt` Search Criterion searches for invitations based on the date they were created.
+
+## Arguments
+
+- `value` - date to be matched, provided as a DateTimeInterface object
+- `operator` - optional operator string (EQ, GT, GTE, LT, LTE)
+
+## Example
+
+```php
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\CreatedAt(
+    new DateTime('2025-05-01 14:07:02'),
+    'GTE'
+);
+
+$query = new InvitationQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/invitation/created_at_invitation_sort_clause.md

@@ -0,0 +1,19 @@
+---
+description: CreatedAt Sort Clause
+---
+
+# CreatedAt Sort Clause
+
+The `CreatedAt` Sort Clause sorts search results by the date and time of the creation of invitation.
+
+## Arguments
+
+- (optional) `direction` - SortDirection constant, either SortDirection::ASC or SortDirection::DESC.
+
+## Example
+
+```php
+$sortClause = [new \Ibexa\Contracts\Collaboration\Invitation\Query\SortClause\CreatedAt(SortDirection::DESC)]);
+
+$query = new InvitationQuery($criteria, sortClause);
+```

docs/search/collaborative_editing_search_reference/invitation/id_invitation_criterion.md

@@ -0,0 +1,23 @@
+---
+description: Id Search Criterion
+---
+
+# Id Criterion
+
+The `Id` Search Criterion searches for invitations based on invitation ID.
+
+## Arguments
+
+- `value` - integer(s) representing the Invitation ID(s)
+
+## Example
+
+```php
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Id(1);
+
+OR
+
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Id([1, 2]);
+
+$query = new SessionQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/invitation/invitation_id_invitation_sort_clause.md

@@ -0,0 +1,19 @@
+---
+description: InvitationId Sort Clause
+---
+
+# InvitationId Sort Clause
+
+The `InvitationId` Sort Clause sorts search results by invitation ID.
+
+## Arguments
+
+- (optional) `direction` - SortDirection constant, either SortDirection::ASC or SortDirection::DESC.
+
+## Example
+
+```php
+$sortClause = [new \Ibexa\Contracts\Collaboration\Invitation\Query\SortClause\Id(SortDirection::DESC)]);
+
+$query = new InvitationQuery($criteria, sortClause);
+```

docs/search/collaborative_editing_search_reference/invitation/invitation_status_invitation_sort_clause.md

@@ -0,0 +1,19 @@
+---
+description: InvitationStatus Sort Clause
+---
+
+# InvitationStatus Sort Clause
+
+The `InvitationStatus` Sort Clause sorts search results by invitation status.
+
+## Arguments
+
+- (optional) `direction` - SortDirection constant, either SortDirection::ASC or SortDirection::DESC.
+
+## Example
+
+```php
+$sortClause = [new \Ibexa\Contracts\Collaboration\Invitation\Query\SortClause\Status(SortDirection::DESC)]);
+
+$query = new InvitationQuery($criteria, sortClause);
+```

docs/search/collaborative_editing_search_reference/invitation/logical_and_invitation_criterion.md

@@ -0,0 +1,20 @@
+---
+description: LogicalAnd Search Criterion
+---
+
+# LogicalAnd Criterion
+
+The `LogicalAnd` Search Criterion matches combined invitations by the logical operator.
+
+## Example
+
+```php
+$currentUser = $this->permissionResolver->getCurrentUserReference();
+
+$criteria = \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\LogicalAnd( 
+    new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Status('pending'), 
+    new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Sender($currentUser)
+);
+
+$query = new InvitationQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/invitation/logical_or_invitation_criterion.md

@@ -0,0 +1,18 @@
+---
+description: LogicalOr Search Criterion
+---
+
+# LogicalOr Criterion
+
+The `LogicalOr` Search Criterion matches combined invitations by the logical operator.
+
+## Example
+
+```php
+$criteria = \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\LogicalOr( , 
+    new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Id(1),
+    new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Status('pending') 
+);
+
+$query = new InvitationQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/invitation/sender_invitation_criterion.md

@@ -0,0 +1,26 @@
+---
+description: Sender Search Criterion
+---
+
+# Sender Search Criterion
+
+The `Sender` Search Criterion searches for invitations based on invitation sender.
+
+## Arguments
+
+- `value` - user(s) to be matched, provided as a UserReference object
+
+## Example
+
+```php
+$user = $this->userService->loadUserByLogin('foo');
+$currentUser = $this->permissionResolver->getCurrentUserReference();
+
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Owner($user);
+
+OR
+
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Owner([$user, $currentUser]);
+
+$query = new InvitationQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/invitation/session_invitation_criterion.md

@@ -0,0 +1,26 @@
+---
+description: Session Search Criterion
+---
+
+# Session Search Criterion
+
+The `Session` Search Criterion searches for invitations based on session.
+
+## Arguments
+
+- `value` - objects(s) representing the session(s) and implementing `\Ibexa\Contracts\Collaboration\Session\SessionInterface`
+
+## Example
+
+```php
+$firstSession = $this->sessionService->getSession(1);
+$secondSession = $this->sessionService->getSession(2);
+
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Session($firstSession);
+
+OR
+
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Session([$firstSession, $secondSession]);
+
+$query = new InvitationQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/invitation/status_invitation_criterion.md

@@ -0,0 +1,23 @@
+---
+description: Status Search Criterion
+---
+
+# Status Search Criterion
+
+The `Status` Search Criterion searches for invitations based on status.
+
+## Arguments
+
+- `value` - string(s) representing the invitation status(es)
+
+## Example
+
+```php
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Type('pending');
+
+OR
+
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Type(['pending', 'accepted']);
+
+$query = new InvitationQuery($criteria);
+```