fixup! feat: import contacts from files via ocs

Author: st3iny

lib/AppInfo/Application.php

@@ -6,6 +6,7 @@
  */
 namespace OCA\Contacts\AppInfo;
 
+use OCA\Contacts\Capabilities;
 use OCA\Contacts\Dav\PatchPlugin;
 use OCA\Contacts\Event\LoadContactsOcaApiEvent;
 use OCA\Contacts\Listener\LoadContactsFilesActions;
@@ -30,6 +31,7 @@ public function __construct() {
 	}
 
 	public function register(IRegistrationContext $context): void {
+		$context->registerCapability(Capabilities::class);
 		$context->registerEventListener(LoadAdditionalScriptsEvent::class, LoadContactsFilesActions::class);
 		$context->registerEventListener(LoadContactsOcaApiEvent::class, LoadContactsOcaApi::class);
 	}

lib/Capabilities.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Contacts;
+
+use OCA\Contacts\AppInfo\Application;
+use OCP\Capabilities\ICapability;
+use OCP\IL10N;
+use OCP\IURLGenerator;
+use OCP\L10N\IFactory as IL10NFactory;
+
+class Capabilities implements ICapability {
+	private readonly IL10N $l10n;
+
+	public function __construct(
+		private readonly IURLGenerator $url,
+		IL10NFactory $l10nFactory,
+	) {
+		$this->l10n = $l10nFactory->get(Application::APP_ID);
+	}
+
+	public function getCapabilities(): array {
+		//return [
+		$caps = [
+			'contacts' => [
+				'context-menu' => [
+					[
+						'name' => $this->l10n->t('Import contacts'),
+						'url' => $this->url->getWebroot() . '/ocs/v2.php/apps/contacts/api/v1/import/{fileId}',
+						'method' => 'POST',
+						'mimetype_filters' => 'text/vcard',
+					],
+				],
+			],
+		];
+		return $caps;
+	}
+}

lib/Controller/ImportController.php

@@ -40,20 +40,20 @@ public function __construct(
 
 	/**
 	 * Import the given vCard file (by id) into the given address book of the current user.
-	 * Exactly one of $addressBookKey or $addressBookUri is expected.
+	 * If no address book URI is posted as a payload, an attempt will be made to determine the
+	 * user's default address book.
 	 *
 	 * @param int $fileId The id of a vCard file to import
-	 * @param ?string $addressBookKey The key or id of the address book - {@see \OCP\IAddressBook::getKey}
-	 * @param ?string $addressBookUri The uri of the address book - {@see \OCP\IAddressBook::getUri}
+	 * @param ?string $addressBookUri Optional URI of the address book to import into - {@see \OCP\IAddressBook::getUri}
 	 * @return DataResponse A list of imported contact URIs, amount of skipped contacts and a list of errors.
 	 *
-	 * 200: Contacts were imported (check the response data for stats)
+	 * 200: Contacts were processed (check the response data for stats)
 	 * 400: Not a vCard file or given both $addressBookKey and $addressBookUri
 	 * 401: User is not logged in
 	 * 404: File or address book was not found
 	 */
 	#[NoAdminRequired]
-	#[ApiRoute('POST', '/api/v1/import')]
+	#[ApiRoute('POST', '/api/v1/import/{fileId}')]
 	public function import(int $fileId, ?string $addressBookUri = null): DataResponse {
 		if ($this->userId === null) {
 			return new DataResponse('Not logged in', Http::STATUS_UNAUTHORIZED);