feat(OCM-Invites): Implement exchanging cloud IDs through OCM invitation workflow

see https://github.com/cs3org/OCM-API/blob/v1.2.1/IETF-RFC.md
Features:
 - Button to invite remote users to exchange cloudIDs.
 - WAYF page allowing the receiver of the invite to open and accept the invitation.
 - Listing of open invitations.
 - Option to resend, revoke open invitations.

Signed-off-by: antoonp <[email protected]>
Co-authored-by: Micke Nordin <[email protected]>

Author: antoonp

appinfo/info.xml

@@ -49,6 +49,7 @@
 
 	<background-jobs>
 		<job>OCA\Contacts\Cron\SocialUpdateRegistration</job>
+		<job>OCA\Contacts\Cron\UpdateOcmProviders</job>
 	</background-jobs>
 
 	<settings>
@@ -67,4 +68,10 @@
 	<contactsmenu>
 		<provider>OCA\Contacts\ContactsMenu\Providers\DetailsProvider</provider>
 	</contactsmenu>
+
+	<commands>
+		<command>OCA\Contacts\Command\EnableOcmInvites</command>
+		<command>OCA\Contacts\Command\DisableOcmInvites</command>
+		<command>OCA\Contacts\Command\SetMeshProvidersService</command>
+	</commands>
 </info>

appinfo/routes.php

@@ -5,10 +5,23 @@
  * SPDX-License-Identifier: AGPL-3.0-or-later
  */
 
+use OCA\Contacts\IWayfProvider;
+use OCA\Contacts\Service\FederatedInvitesService;
+
 return [
 	'routes' => [
 		['name' => 'contacts#direct', 'url' => '/direct/contact/{contact}', 'verb' => 'GET'],
 		['name' => 'contacts#directcircle', 'url' => '/direct/circle/{singleId}', 'verb' => 'GET'],
+
+		['name' => 'federated_invites#get_invites', 'url' => '/ocm/invitations', 'verb' => 'GET'],
+		['name' => 'federated_invites#delete_invite', 'url' => '/ocm/invitations/{token}', 'verb' => 'DELETE'],
+		['name' => 'federated_invites#create_invite', 'url' => '/ocm/invitations', 'verb' => 'POST'],
+		['name' => 'federated_invites#invite_accepted', 'url' => '/ocm/invitations/{token}/accept', 'verb' => 'PATCH'],
+		['name' => 'federated_invites#resend_invite', 'url' => '/ocm/invitations/{token}/resend', 'verb' => 'PATCH'],
+		['name' => 'federated_invites#invite_accept_dialog', 'url' => FederatedInvitesService::OCM_INVITE_ACCEPT_DIALOG_ROUTE, 'verb' => 'GET'],
+		['name' => 'federated_invites#wayf', 'url' => IWayfProvider::WAYF_ROUTE, 'verb' => 'GET'],
+		['name' => 'federated_invites#discover', 'url' => IWayfProvider::DISCOVERY_ROUTE, 'verb' => 'GET'],
+
 		['name' => 'page#index', 'url' => '/', 'verb' => 'GET'],
 		['name' => 'page#index', 'url' => '/{group}', 'verb' => 'GET', 'postfix' => 'group'],
 		['name' => 'page#index', 'url' => '/{group}/{contact}', 'verb' => 'GET', 'postfix' => 'group.contact'],

composer.json

@@ -33,13 +33,13 @@
 		]
 	},
 	"require": {
-		"php": ">=8.1 <=8.4"
+		"php": ">=8.1 <=8.4",
+		"bamarni/composer-bin-plugin": "^1.8"
 	},
 	"require-dev": {
         "christophwurst/nextcloud_testing": "^1.0.1",
 		"phpunit/phpunit": "^9",
-		"nextcloud/coding-standard": "^1.4",
-		"bamarni/composer-bin-plugin": "^1.8"
+		"nextcloud/coding-standard": "^1.4"
 	},
 	"extra": {
 		"bamarni-bin": {