UPSTREAM BASELINE: nextcloud/spreed v22.0.12 (без изменений)

Источник: https://github.com/nextcloud/spreed/archive/refs/tags/v22.0.12.tar.gz С этого коммита ветка официального Nextcloud Talk отрезана (решение владельца 2026-07-06). Все дальнейшие изменения — только наши; версии релизов: 22.0.12-f7.N.
2026-07-06 14:07:50 +00:00
commit 01acfa3b40
1716 changed files with 613013 additions and 0 deletions
@@ -0,0 +1,847 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2018 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+use Behat\Behat\Context\Context;
+use Behat\Gherkin\Node\TableNode;
+use Behat\Step\Given;
+use Behat\Step\Then;
+use Behat\Step\When;
+use GuzzleHttp\Client;
+use GuzzleHttp\Cookie\CookieJar;
+use Psr\Http\Message\ResponseInterface;
+
+class SharingContext implements Context {
+	private string $baseUrl;
+	private string $currentServer;
+	private ?ResponseInterface $response = null;
+	private ?string $responseBody = null;
+	private string $currentUser = '';
+	private array $adminUser;
+	private string $regularUserPassword;
+	private ?\SimpleXMLElement $lastCreatedShareData = null;
+
+	public function __construct(string $baseUrl, array $admin, string $regularUserPassword) {
+		$this->baseUrl = $baseUrl;
+		$this->adminUser = $admin;
+		$this->regularUserPassword = $regularUserPassword;
+
+		// in case of ci deployment we take the server url from the environment
+		$testServerUrl = getenv('TEST_SERVER_URL');
+		if ($testServerUrl !== false) {
+			$this->baseUrl = $testServerUrl;
+		}
+	}
+
+	public function setCurrentServer(string $currentServer, string $baseUrl): void {
+		$this->currentServer = $currentServer;
+		$this->baseUrl = $baseUrl;
+	}
+
+	#[Given('user :user creates folder :destination')]
+	public function userCreatesFolder(string $user, string $destination): void {
+		$this->currentUser = $user;
+
+		$url = "/$user/$destination/";
+
+		$this->sendingToDav('MKCOL', $url);
+
+		$this->theHTTPStatusCodeShouldBe(201);
+	}
+
+	#[Given('user :user moves file :source to :destination')]
+	public function userMovesFileTo(string $user, string $source, string $destination): void {
+		$this->currentUser = $user;
+
+		$url = "/$user/$source";
+
+		$headers = [];
+		$headers['Destination'] = $this->baseUrl . "remote.php/dav/files/$user/" . $destination;
+
+		$this->sendingToDav('MOVE', $url, $headers);
+	}
+
+	#[Given('user :user moves file :source to :destination with :statusCode')]
+	public function userMovesFileToWith(string $user, string $source, string $destination, int $statusCode): void {
+		$this->userMovesFileTo($user, $source, $destination);
+		$this->theHTTPStatusCodeShouldBe($statusCode);
+	}
+
+	#[Given('user :user deletes file :file')]
+	public function userDeletesFile(string $user, string $file): void {
+		$this->currentUser = $user;
+
+		$url = "/$user/$file";
+
+		$this->sendingToDav('DELETE', $url);
+
+		$this->theHTTPStatusCodeShouldBe(204);
+	}
+
+	#[When('user :user shares :path with user :sharee')]
+	public function userSharesWithUser(string $user, string $path, string $sharee, ?TableNode $body = null): void {
+		$this->userSharesWith($user, $path, 0 /*IShare::TYPE_USER*/, $sharee, $body);
+	}
+
+	#[When('user :user shares :path with user :sharee with OCS :statusCode')]
+	public function userSharesWithUserWithOcs(string $user, string $path, string $sharee, int $statusCode): void {
+		$this->userSharesWithUser($user, $path, $sharee);
+		$this->theOCSStatusCodeShouldBe($statusCode);
+	}
+
+	#[When('user :user shares :path with group :sharee')]
+	public function userSharesWithGroup(string $user, string $path, string $sharee, ?TableNode $body = null): void {
+		$this->userSharesWith($user, $path, 1 /*IShare::TYPE_GROUP*/, $sharee, $body);
+	}
+
+	#[When('user :user shares :path with group :sharee with OCS :statusCode')]
+	public function userSharesWithGroupWithOcs(string $user, string $path, string $sharee, int $statusCode): void {
+		$this->userSharesWithGroup($user, $path, $sharee);
+		$this->theOCSStatusCodeShouldBe($statusCode);
+	}
+
+	#[When('user :user shares :path with team :sharee')]
+	public function userSharesWithTeam(string $user, string $path, string $sharee, ?TableNode $body = null): void {
+		$this->userSharesWith($user, $path, 7 /*IShare::TYPE_CIRCLE*/, $sharee, $body);
+	}
+
+	#[When('user :user shares :path with team :sharee with OCS :statusCode')]
+	public function userSharesWithTeamWithOcs(string $user, string $path, string $sharee, int $statusCode): void {
+		$this->userSharesWithTeam($user, $path, FeatureContext::getTeamIdForLabel($this->currentServer, $sharee));
+		$this->theOCSStatusCodeShouldBe($statusCode);
+	}
+
+	#[When('user :user shares :path with room :room')]
+	public function userSharesWithRoom(string $user, string $path, string $room, ?TableNode $body = null): void {
+		$this->userSharesWith($user, $path, 10 /*IShare::TYPE_ROOM*/, FeatureContext::getTokenForIdentifier($room), $body);
+	}
+
+	#[When('user :user shares :path with :amount rooms')]
+	public function userSharesWithManyRooms(string $user, string $path, int $amount, ?TableNode $body = null): void {
+		for ($i = 1; $i <= $amount; $i++) {
+			$identifier = 'room' . $i;
+			$this->userSharesWith($user, $path, 10 /*IShare::TYPE_ROOM*/, FeatureContext::getTokenForIdentifier($identifier), $body);
+		}
+	}
+
+	#[When('user :user shares :path with room :room with OCS :statusCode')]
+	public function userSharesWithRoomWithOcs(string $user, string $path, string $room, int $statusCode): void {
+		$this->userSharesWithRoom($user, $path, $room);
+		$this->theOCSStatusCodeShouldBe($statusCode);
+	}
+
+	#[When('user :user shares :path by link')]
+	public function userSharesByLink(string $user, string $path, ?TableNode $body = null): void {
+		$this->userSharesWith($user, $path, 3 /*IShare::TYPE_LINK*/, '', $body);
+	}
+
+	#[When('user :user shares :path by link with OCS :statusCode')]
+	public function userSharesByLinkWithOcs(string $user, string $path, int $statusCode, ?TableNode $body = null): void {
+		$this->userSharesByLink($user, $path, $body);
+		$this->theOCSStatusCodeShouldBe($statusCode);
+	}
+
+	#[When('user :user updates last share with')]
+	public function userUpdatesLastShareWith(string $user, TableNode $body): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/shares/' . $this->getLastShareId();
+
+		$this->sendingTo('PUT', $url, $body);
+	}
+
+	#[When('user :user deletes last share')]
+	public function userDeletesLastShare(string $user): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/shares/' . $this->getLastShareId();
+
+		$this->sendingTo('DELETE', $url);
+	}
+
+	#[When('user :user deletes last share with OCS :statusCode')]
+	public function userDeletesLastShareWithOcs(string $user, int $statusCode): void {
+		$this->userDeletesLastShare($user);
+		$this->theOCSStatusCodeShouldBe($statusCode);
+	}
+
+	#[When('user :user restores last share')]
+	public function userRestoresLastShareWithOcs(string $user): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/deletedshares/ocRoomShare:' . $this->getLastShareId();
+
+		$this->sendingTo('POST', $url);
+	}
+
+	#[When('user :user gets last share')]
+	public function userGetsLastShare(string $user): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/shares/' . $this->getLastShareId();
+
+		$this->sendingTo('GET', $url);
+	}
+
+	#[When('user :user accepts last share')]
+	public function userAcceptsLastShare(string $user): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/shares/pending/' . $this->getLastShareId();
+
+		$this->sendingTo('POST', $url);
+
+		$this->theHTTPStatusCodeShouldBe(200);
+		$this->theOCSStatusCodeShouldBe(100);
+	}
+
+	#[When('user :user gets all shares')]
+	public function userGetsAllShares(string $user): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/shares';
+
+		$this->sendingTo('GET', $url);
+	}
+
+	#[When('user :user gets all shares and reshares')]
+	public function userGetsAllSharesAndReshares(string $user): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/shares?reshares=true';
+
+		$this->sendingTo('GET', $url);
+	}
+
+	#[When('user :user gets all shares for :path')]
+	public function userGetsAllSharesFor(string $user, string $path): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/shares?path=' . $path;
+
+		$this->sendingTo('GET', $url);
+	}
+
+	#[When('user :user gets all shares and reshares for :path')]
+	public function userGetsAllSharesAndResharesFor(string $user, string $path): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/shares?reshares=true&path=' . $path;
+
+		$this->sendingTo('GET', $url);
+	}
+
+	#[When('user :user gets all shares for :path and its subfiles')]
+	public function userGetsAllSharesForAndItsSubfiles(string $user, string $path): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/shares?subfiles=true&path=' . $path;
+
+		$this->sendingTo('GET', $url);
+	}
+
+	#[When('user :user gets all received shares')]
+	public function userGetsAllReceivedShares(string $user): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/shares?shared_with_me=true';
+
+		$this->sendingTo('GET', $url);
+	}
+
+	#[When('user :user gets all received shares for :path')]
+	public function userGetsAllReceivedSharesFor(string $user, string $path): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/shares?shared_with_me=true&path=' . $path;
+
+		$this->sendingTo('GET', $url);
+	}
+
+	#[When('user :user gets deleted shares')]
+	public function userGetsDeletedShares(string $user): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/deletedshares';
+
+		$this->sendingTo('GET', $url);
+	}
+
+	#[When('/^user "([^"]*)" gets sharees for$/')]
+	public function userGetsShareesFor(string $user, TableNode $body): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/sharees';
+
+		$parameters = [];
+		$parameters[] = 'shareType=10'; // IShare::TYPE_ROOM,
+		$parameters[] = 'itemType=file';
+		foreach ($body->getRowsHash() as $key => $value) {
+			$parameters[] = $key . '=' . $value;
+		}
+
+		$url .= '?' . implode('&', $parameters);
+
+		$this->sendingTo('GET', $url);
+
+		\PHPUnit\Framework\Assert::assertEquals(200, $this->response->getStatusCode());
+	}
+
+	#[When('user :user gets the DAV properties for :path')]
+	public function userGetsTheDavPropertiesFor(string $user, string $path): void {
+		$this->currentUser = $user;
+
+		$url = "/$user/$path";
+
+		$this->sendingToDav('PROPFIND', $url);
+
+		$this->theHTTPStatusCodeShouldBe(207);
+	}
+
+	#[When('user :user gets the share-type DAV property for :path')]
+	public function userGetsTheShareTypeDavPropertyFor(string $user, string $path): void {
+		$this->currentUser = $user;
+
+		$url = "/$user/$path";
+
+		$headers = null;
+
+		$body = '<d:propfind xmlns:d="DAV:" xmlns:oc="http://owncloud.org/ns">'
+				. '	<d:prop>'
+				. '		<oc:share-types/>'
+				. '	</d:prop>'
+				. '</d:propfind>';
+
+		$this->sendingToDav('PROPFIND', $url, $headers, $body);
+
+		$this->theHTTPStatusCodeShouldBe(207);
+	}
+
+	#[When('user :user gets recent files')]
+	public function userGetsRecentFiles(string $user): void {
+		// Recents endpoint is not an OCS endpoint, so a request token must be
+		// provided.
+		[$requestToken, $cookieJar] = $this->loggingInUsingWebAs($user);
+
+		$url = '/index.php/apps/files/api/v1/recent';
+
+		$this->sendingToWithRequestToken('GET', $url, $requestToken, $cookieJar);
+	}
+
+	#[When('transfering ownership from :user1 to :user2')]
+	public function transferingOwnershipFromTo(string $user1, string $user2): void {
+		$args = ['files:transfer-ownership', $user1, $user2];
+
+		$args = array_map(function ($arg) {
+			return escapeshellarg($arg);
+		}, $args);
+		$args[] = '--no-ansi';
+		$args = implode(' ', $args);
+
+		$descriptor = [
+			0 => ['pipe', 'r'],
+			1 => ['pipe', 'w'],
+			2 => ['pipe', 'w'],
+		];
+		$process = proc_open('php console.php ' . $args, $descriptor, $pipes, '../../../../');
+		$lastStdOut = stream_get_contents($pipes[1]);
+		$lastStdErr = stream_get_contents($pipes[2]);
+		$lastCode = proc_close($process);
+
+		// Clean opcode cache
+		$client = new GuzzleHttp\Client();
+		$client->request('GET', $this->baseUrl . '/apps/testing/clean_opcode_cache.php');
+
+		\PHPUnit\Framework\Assert::assertEquals(0, $lastCode);
+	}
+
+	#[Then('the OCS status code should be :statusCode')]
+	public function theOCSStatusCodeShouldBe(int $statusCode): void {
+		$meta = $this->getXmlResponse()->meta[0];
+
+		\PHPUnit\Framework\Assert::assertEquals($statusCode, (int)$meta->statuscode, 'Response message: ' . (string)$meta->message);
+	}
+
+	#[Then('the HTTP status code should be :statusCode')]
+	public function theHTTPStatusCodeShouldBe(int $statusCode): void {
+		\PHPUnit\Framework\Assert::assertEquals($statusCode, $this->response->getStatusCode());
+	}
+
+	#[Then('the list of returned shares has :count shares')]
+	public function theListOfReturnedSharesHasShares(int $count): void {
+		$this->theHTTPStatusCodeShouldBe(200);
+		$this->theOCSStatusCodeShouldBe(100);
+
+		$returnedShares = $this->getXmlResponse()->data[0];
+
+		\PHPUnit\Framework\Assert::assertEquals($count, count($returnedShares->element));
+	}
+
+	#[Then('share is returned with')]
+	public function shareIsReturnedWith(TableNode $body): void {
+		$this->shareXIsReturnedWith(0, $body);
+	}
+
+	#[Then('share :number is returned with')]
+	public function shareXIsReturnedWith(int $number, TableNode $body): void {
+		$this->theHTTPStatusCodeShouldBe(200);
+		$this->theOCSStatusCodeShouldBe(100);
+
+		if (!($body instanceof TableNode)) {
+			return;
+		}
+
+		$returnedShare = $this->getXmlResponse()->data[0];
+		if ($returnedShare->element) {
+			$returnedShare = (array)$returnedShare;
+			$returnedShare = $returnedShare['element'];
+			if (is_array($returnedShare)) {
+				usort($returnedShare, static function ($share1, $share2) {
+					return (int)$share1->id - (int)$share2->id;
+				});
+			}
+
+			$returnedShare = $returnedShare[$number];
+		}
+
+		$defaultExpectedFields = [
+			'id' => 'A_NUMBER',
+			'share_type' => '10', // IShare::TYPE_ROOM,
+			'permissions' => '19',
+			'stime' => 'A_NUMBER',
+			'parent' => '',
+			'expiration' => '',
+			'token' => '',
+			'storage' => 'A_NUMBER',
+			'item_source' => 'A_NUMBER',
+			'file_source' => 'A_NUMBER',
+			'file_parent' => 'A_NUMBER',
+			'mail_send' => '0',
+		];
+
+		$fields = $body->getRowsHash();
+		if (isset($fields['share_type']) && ($fields['share_type'] === '10' || $fields['share_type'] === '11')) {
+			$defaultExpectedFields['share_with_link'] = 'URL';
+		}
+
+		if (isset($fields['share_type']) && ($fields['share_type'] === '0' || $fields['share_type'] === '1')) {
+			/**
+			 * This field was changed so often in the server,
+			 * that we simply don't care any more. We want to test Talk,
+			 * not normal user shares.
+			 * Refs:
+			 * - https://github.com/nextcloud/server/pull/49898
+			 * - https://github.com/nextcloud/server/pull/48381
+			 * - https://github.com/nextcloud/spreed/pull/13632
+			 */
+			unset($defaultExpectedFields['mail_send']);
+		}
+
+		$expectedFields = array_merge($defaultExpectedFields, $fields);
+
+		if (!array_key_exists('uid_file_owner', $expectedFields)
+				&& array_key_exists('uid_owner', $expectedFields)) {
+			$expectedFields['uid_file_owner'] = $expectedFields['uid_owner'];
+		}
+		if (!array_key_exists('displayname_file_owner', $expectedFields)
+				&& array_key_exists('displayname_owner', $expectedFields)) {
+			$expectedFields['displayname_file_owner'] = $expectedFields['displayname_owner'];
+		}
+
+		if (array_key_exists('share_type', $expectedFields)
+				&& $expectedFields['share_type'] == 10 /* IShare::TYPE_ROOM */
+				&& array_key_exists('share_with', $expectedFields)) {
+			if ($expectedFields['share_with'] === 'private_conversation') {
+				$expectedFields['share_with'] = 'REGEXP /^private_conversation_[0-9a-f]{6}$/';
+				$expectedFields['share_with_link'] = '';
+			} else {
+				$expectedFields['share_with'] = FeatureContext::getTokenForIdentifier($expectedFields['share_with']);
+			}
+		}
+
+		if (array_key_exists('share_with_link', $expectedFields)
+			&& $expectedFields['share_with_link'] === 'URL') {
+			if (array_key_exists('share_with', $expectedFields)) {
+				$expectedFields['share_with_link'] = $this->baseUrl . 'index.php/call/' . $expectedFields['share_with'];
+			} else {
+				$expectedFields['share_with_link'] = 'REGEXP ' . '/\/call\//';
+			}
+		}
+
+		foreach ($expectedFields as $field => $value) {
+			$share = json_decode(json_encode($returnedShare), true);
+			if (isset($share[$field]) && empty($share[$field]) && is_array($share[$field])) {
+				// Fix XML parsing fails
+				$share[$field] = '';
+			}
+
+			if (in_array($field, ['path', 'storage_id'], true)
+				&& preg_match('/Transferred from [^ ]* on (\d{4}-\d{2}-\d{2} \d{2}-\d{2}-\d{2})/', $share[$field], $matches)) {
+				// We have to replace strings like
+				// "Transferred from participant1-displayname on 2025-06-30 12-31-32"
+				// with something neutral that works in tests
+				$share[$field] = str_replace($matches[1], '{{DATE AND TIME}}', $share[$field]);
+			}
+
+			$this->assertFieldIsInReturnedShare($field, $value, $share);
+		}
+	}
+
+	/**
+	 * Each sharee is specified as "| room name | room test identifier |"; the
+	 * name is checked against the returned "label" value, and the room test
+	 * identifier is used to get the room token, which is checked against the
+	 * returned "shareWith" value. The returned "shareType" value is expected to
+	 * always be "IShare::TYPE_ROOM", so there is no need to specify it.
+	 */
+	#[Then('/^"([^"]*)" sharees returned (are|is empty)$/')]
+	public function shareesReturnedAreIsEmpty(string $shareeType, string $isEmpty, ?TableNode $shareesList = null): void {
+		if ($isEmpty !== 'is empty') {
+			$sharees = [];
+			foreach ($shareesList->getRows() as $row) {
+				$expectedSharee = [$row[0]];
+				$expectedSharee[] = 10; // IShare::TYPE_ROOM
+				$expectedSharee[] = FeatureContext::getTokenForIdentifier($row[1]);
+				$sharees[] = $expectedSharee;
+			}
+			$respondedArray = $this->getArrayOfShareesResponded($this->getXmlResponse(), $shareeType);
+			usort($sharees, function ($a, $b) {
+				return $a[2] <=> $b[2]; // Sort by token
+			});
+			usort($respondedArray, function ($a, $b) {
+				return $a[2] <=> $b[2]; // Sort by token
+			});
+			\PHPUnit\Framework\Assert::assertEquals($sharees, $respondedArray);
+		} else {
+			$respondedArray = $this->getArrayOfShareesResponded($this->getXmlResponse(), $shareeType);
+			\PHPUnit\Framework\Assert::assertEmpty($respondedArray);
+		}
+	}
+
+	#[Then('the list of returned files for :user is')]
+	public function theListOfReturnedFilesForIs(string $user, ?TableNode $table = null): void {
+		$xmlResponse = $this->getXmlResponse();
+		$xmlResponse->registerXPathNamespace('d', 'DAV:');
+
+		$hrefs = [];
+		foreach ($xmlResponse->xpath('//d:response/d:href') as $href) {
+			$hrefs[] = (string)$href;
+		}
+
+		$expectedHrefs = [];
+		if ($table !== null) {
+			foreach ($table->getRows() as $row) {
+				$expectedHrefs[] = '/remote.php/dav/files/' . $user . (string)$row[0];
+			}
+		}
+
+		\PHPUnit\Framework\Assert::assertEquals($expectedHrefs, $hrefs);
+	}
+
+	#[Then('the response contains a share-types DAV property with')]
+	public function theResponseContainsAShareTypesDavPropertyWith(?TableNode $table = null): void {
+		$xmlResponse = $this->getXmlResponse();
+		$xmlResponse->registerXPathNamespace('oc', 'http://owncloud.org/ns');
+
+		$shareTypes = [];
+		foreach ($xmlResponse->xpath('//oc:share-types/oc:share-type') as $shareType) {
+			$shareTypes[] = (int)$shareType;
+		}
+
+		$expectedShareTypes = [];
+		if ($table !== null) {
+			foreach ($table->getRows() as $row) {
+				$expectedShareTypes[] = (int)$row[0];
+			}
+		}
+
+		\PHPUnit\Framework\Assert::assertEquals($expectedShareTypes, $shareTypes);
+	}
+
+	#[Then('the response contains a share-types file property for :path with')]
+	public function theResponseContainsAShareTypesFilesPropertyForWith(string $path, ?TableNode $table = null): void {
+		if ($this->responseBody === null) {
+			$this->responseBody = $this->response->getBody()->getContents();
+		}
+		$response = json_decode($this->responseBody);
+
+		$fileForPath = array_filter($response->files, function ($file) use ($path) {
+			$filePath = $file->path . (substr($file->path, -1) === '/'? '': '/');
+			return ($filePath . $file->name) === $path;
+		});
+
+		if (empty($fileForPath)) {
+			\PHPUnit\Framework\Assert::fail("$path not found in the response");
+		}
+
+		$fileForPath = array_shift($fileForPath);
+
+		$shareTypes = [];
+		if (property_exists($fileForPath, 'shareTypes')) {
+			foreach ($fileForPath->shareTypes as $shareType) {
+				$shareTypes[] = (int)$shareType;
+			}
+		}
+
+		$expectedShareTypes = [];
+		if ($table !== null) {
+			foreach ($table->getRows() as $row) {
+				$expectedShareTypes[] = (int)$row[0];
+			}
+		}
+
+		\PHPUnit\Framework\Assert::assertEquals($expectedShareTypes, $shareTypes);
+	}
+
+	private function userSharesWith(string $user, string $path, int $shareType, string $shareWith, ?TableNode $body = null): void {
+		$this->currentUser = $user;
+
+		$url = '/apps/files_sharing/api/v1/shares';
+
+		$parameters = [];
+		$parameters[] = 'path=' . $path;
+		$parameters[] = 'shareType=' . $shareType;
+		$parameters[] = 'shareWith=' . $shareWith;
+
+		$talkMetaData = [];
+
+		if ($body instanceof TableNode) {
+			foreach ($body->getRowsHash() as $key => $value) {
+				if ($key === 'expireDate' && $value !== 'invalid date') {
+					$value = date('Y-m-d', strtotime($value));
+				}
+				if ($key === 'talkMetaData.replyTo' || $key === 'talkMetaData.threadId') {
+					$value = FeatureContext::getMessageIdForText($value);
+				}
+				if (str_starts_with($key, 'talkMetaData.')) {
+					$talkMetaData[substr($key, 13)] = $value;
+				} else {
+					$parameters[] = $key . '=' . $value;
+				}
+			}
+		}
+
+		if (!empty($talkMetaData)) {
+			$parameters[] = 'talkMetaData=' . json_encode($talkMetaData);
+		}
+
+		$url .= '?' . implode('&', $parameters);
+
+		$this->sendingTo('POST', $url);
+
+		$this->lastCreatedShareData = $this->getXmlResponse();
+	}
+
+	private function sendingTo(string $verb, string $url, ?TableNode $body = null): void {
+		$fullUrl = $this->baseUrl . 'ocs/v1.php' . $url;
+		$client = new Client();
+		$options = [];
+		if ($this->currentUser === 'admin') {
+			$options['auth'] = $this->adminUser;
+		} else {
+			$options['auth'] = [$this->currentUser, $this->regularUserPassword];
+		}
+		$options['headers'] = [
+			'OCS_APIREQUEST' => 'true'
+		];
+		if ($body instanceof TableNode) {
+			$fd = $body->getRowsHash();
+			if (array_key_exists('expireDate', $fd)) {
+				$fd['expireDate'] = date('Y-m-d', strtotime($fd['expireDate']));
+			}
+			$options['form_params'] = $fd;
+		}
+
+		try {
+			$this->response = $client->request($verb, $fullUrl, $options);
+			$this->responseBody = null;
+		} catch (GuzzleHttp\Exception\ClientException $ex) {
+			$this->response = $ex->getResponse();
+			$this->responseBody = null;
+		}
+	}
+
+	private function sendingToDav(string $verb, string $url, ?array $headers = null, ?string $body = null): void {
+		$fullUrl = $this->baseUrl . 'remote.php/dav/files' . $url;
+		$client = new Client();
+		$options = [];
+		if ($this->currentUser === 'admin') {
+			$options['auth'] = $this->adminUser;
+		} else {
+			$options['auth'] = [$this->currentUser, $this->regularUserPassword];
+		}
+		$options['headers'] = [
+			'OCS_APIREQUEST' => 'true'
+		];
+		if ($headers !== null) {
+			$options['headers'] = array_merge($options['headers'], $headers);
+		}
+		if ($body !== null) {
+			$options['body'] = $body;
+		}
+
+		try {
+			$this->response = $client->request($verb, $fullUrl, $options);
+			$this->responseBody = null;
+		} catch (GuzzleHttp\Exception\ClientException $ex) {
+			$this->response = $ex->getResponse();
+			$this->responseBody = null;
+		}
+	}
+
+	private function sendingToWithRequestToken(string $verb, string $url, string $requestToken, CookieJar $cookieJar): void {
+		$fullUrl = $this->baseUrl . $url;
+
+		$client = new Client();
+		try {
+			$this->response = $client->request(
+				$verb,
+				$fullUrl,
+				[
+					'cookies' => $cookieJar,
+					'headers' => [
+						'requesttoken' => $requestToken
+					]
+				]
+			);
+			$this->responseBody = null;
+		} catch (GuzzleHttp\Exception\ClientException $e) {
+			$this->response = $e->getResponse();
+			$this->responseBody = null;
+		}
+	}
+
+	private function extractRequestTokenFromResponse(ResponseInterface $response): string {
+		return substr(preg_replace('/(.*)data-requesttoken="(.*)">(.*)/sm', '\2', $response->getBody()->getContents()), 0, 89);
+	}
+
+	private function loggingInUsingWebAs(string $user): array {
+		$loginUrl = $this->baseUrl . '/login';
+
+		$cookieJar = new CookieJar();
+
+		// Request a new session and extract CSRF token
+		$client = new Client();
+		$response = $client->get(
+			$loginUrl,
+			[
+				'cookies' => $cookieJar,
+			]
+		);
+		$requestToken = $this->extractRequestTokenFromResponse($response);
+
+		// Login and extract new token
+		$password = ($user === 'admin') ? $this->adminUser[1] : $this->regularUserPassword;
+		$client = new Client();
+		$response = $client->post(
+			$loginUrl,
+			[
+				'form_params' => [
+					'user' => $user,
+					'password' => $password,
+					'requesttoken' => $requestToken,
+				],
+				'cookies' => $cookieJar,
+				'headers' => [
+					'Origin' => $this->baseUrl,
+				],
+			]
+		);
+		$requestToken = $this->extractRequestTokenFromResponse($response);
+
+		return [$requestToken, $cookieJar];
+	}
+
+	public function getLastShareToken(): string {
+		return (string)$this->lastCreatedShareData->data[0]->token;
+	}
+
+	private function getLastShareId(): string {
+		return (string)$this->lastCreatedShareData->data[0]->id;
+	}
+
+	private function getXmlResponse(): \SimpleXMLElement|false {
+		if ($this->responseBody === null) {
+			$this->responseBody = $this->response->getBody()->getContents();
+		}
+		return simplexml_load_string($this->responseBody);
+	}
+
+	private function assertFieldIsInReturnedShare(string $field, string $contentExpected, array $returnedShare): void {
+		if ($contentExpected === 'IGNORE') {
+			return;
+		}
+
+		if (!array_key_exists($field, $returnedShare)) {
+			\PHPUnit\Framework\Assert::fail("$field was not found in response");
+		}
+
+		if ($field === 'expiration' && !empty($contentExpected)) {
+			$contentExpected = date('Y-m-d', strtotime($contentExpected)) . ' 00:00:00';
+		}
+
+		if ($contentExpected === 'A_NUMBER') {
+			\PHPUnit\Framework\Assert::assertTrue(is_numeric((string)$returnedShare[$field]), "Field '$field' is not a number: " . $returnedShare[$field]);
+		} elseif ($contentExpected === 'A_TOKEN') {
+			// A token is composed by 15 characters from
+			// ISecureRandom::CHAR_HUMAN_READABLE.
+			\PHPUnit\Framework\Assert::assertMatchesRegularExpression('/^[abcdefgijkmnopqrstwxyzABCDEFGHJKLMNPQRSTWXYZ23456789]{15}$/', (string)$returnedShare[$field], "Field '$field' is not a token");
+		} elseif (strpos($contentExpected, 'REGEXP ') === 0) {
+			\PHPUnit\Framework\Assert::assertMatchesRegularExpression(substr($contentExpected, strlen('REGEXP ')), (string)$returnedShare[$field], "Field '$field' does not match");
+		} else {
+			\PHPUnit\Framework\Assert::assertEquals($contentExpected, (string)$returnedShare[$field], "Field '$field' does not match");
+		}
+	}
+
+	private function getArrayOfShareesResponded(\SimpleXMLElement $response, string $shareeType): array {
+		$elements = $response->data;
+		$elements = json_decode(json_encode($elements), true);
+		if (strpos($shareeType, 'exact ') === 0) {
+			$elements = $elements['exact'];
+			$shareeType = substr($shareeType, 6);
+		}
+
+		// "simplexml_load_string" creates a SimpleXMLElement object for each
+		// XML element with child elements. In turn, each child is indexed by
+		// its tag in the SimpleXMLElement object. However, when there are
+		// several child XML elements with the same tag, an array with all the
+		// children with the same tag is indexed instead. Therefore, when the
+		// XML contains
+		// <rooms>
+		//   <element>
+		//     <label>...</label>
+		//     <value>...</value>
+		//   </element>
+		// </rooms>
+		// the "$elements[$shareeType]" variable contains an "element" key which
+		// in turn contains "label" and "value" keys, but when the XML contains
+		// <rooms>
+		//   <element>
+		//     <label>...</label>
+		//     <value>...</value>
+		//   </element>
+		//   <element>
+		//     <label>...</label>
+		//     <value>...</value>
+		//   </element>
+		// </rooms>
+		// the "$elements[$shareeType]" variable contains an "element" key which
+		// in turn contains "0" and "1" keys, and in turn each one contains
+		// "label" and "value" keys.
+		$elements = $elements[$shareeType];
+		if (array_key_exists('element', $elements) && is_int(array_keys($elements['element'])[0])) {
+			$elements = $elements['element'];
+		}
+
+		$sharees = [];
+		foreach ($elements as $element) {
+			$sharees[] = [$element['label'], $element['value']['shareType'], $element['value']['shareWith']];
+		}
+		return $sharees;
+	}
+}