social/lib/WellKnown/JrdResponse.php

<?php

declare(strict_types=1);

/**
 * SPDX-FileCopyrightText: 2020 Nextcloud GmbH and Nextcloud contributors
 * SPDX-License-Identifier: AGPL-3.0-or-later
 */

namespace OCA\Social\WellKnown;

use OCP\AppFramework\Http;
use OCP\AppFramework\Http\DataResponse;
use OCP\AppFramework\Http\JSONResponse;
use OCP\AppFramework\Http\Response;
use OCP\Http\WellKnown\IResponse;
use function array_filter;

/**
 * A JSON Document Format (JDF) response to a well-known request
 *
 * @ref https://tools.ietf.org/html/rfc6415#appendix-A
 * @ref https://tools.ietf.org/html/rfc7033#section-4.4
 */
final class JrdResponse implements IResponse {
	private string $subject;
	private ?string $expires = null;
	private int $httpCode;

	/** @var string[] */
	private array $aliases = [];

	/** @var (string|null)[] */
	private array $properties = [];

	/** @var mixed[] */
	private array $links = [];

	/**
	 * @param string $subject https://tools.ietf.org/html/rfc7033#section-4.4.1
	 *
	 * @since 21.0.0
	 */
	public function __construct(string $subject = '', int $httpCode = Http::STATUS_OK) {
		$this->subject = $subject;
		$this->httpCode = $httpCode;
	}

	/**
	 * @param string $expires
	 *
	 * @return $this
	 *
	 * @since 21.0.0
	 */
	public function setExpires(string $expires): self {
		$this->expires = $expires;

		return $this;
	}


	public function setHttpCode(int $httpCode): self {
		$this->httpCode = $httpCode;

		return $this;
	}

	/**
	 * Add an alias
	 *
	 * @ref https://tools.ietf.org/html/rfc7033#section-4.4.2
	 *
	 * @param string $alias
	 *
	 * @return $this
	 *
	 * @since 21.0.0
	 */
	public function addAlias(string $alias): self {
		$this->aliases[] = $alias;

		return $this;
	}

	/**
	 * Add a property
	 *
	 * @ref https://tools.ietf.org/html/rfc7033#section-4.4.3
	 *
	 * @param string $property
	 * @param string|null $value
	 *
	 * @return $this
	 *
	 * @since 21.0.0
	 */
	public function addProperty(string $property, ?string $value): self {
		$this->properties[$property] = $value;

		return $this;
	}

	/**
	 * Add a link
	 *
	 * @ref https://tools.ietf.org/html/rfc7033#section-8.4
	 *
	 * @param string $rel https://tools.ietf.org/html/rfc7033#section-4.4.4.1
	 * @param string|null $type https://tools.ietf.org/html/rfc7033#section-4.4.4.2
	 * @param string|null $href https://tools.ietf.org/html/rfc7033#section-4.4.4.3
	 * @param string[]|null $titles https://tools.ietf.org/html/rfc7033#section-4.4.4.4
	 * @param string[]|null $properties https://tools.ietf.org/html/rfc7033#section-4.4.4.5
	 * @param string[] $entries
	 *
	 * @psalm-param array<string,(string|null)>|null $properties
	 *     https://tools.ietf.org/html/rfc7033#section-4.4.4.5
	 *
	 * @return JrdResponse
	 * @since 21.0.0
	 */
	public function addLink(
		string $rel,
		?string $type,
		?string $href,
		?array $titles = [],
		?array $properties = [],
		array $entries = [],
	): self {
		$this->links[] = array_filter(
			array_merge(
				[
					'rel' => $rel,
					'type' => $type,
					'href' => $href,
					'titles' => $titles,
					'properties' => $properties
				],
				$entries
			)
		);

		return $this;
	}

	/**
	 * @since 21.0.0
	 */
	public function toHttpResponse(): Response {
		$data = array_filter(
			[
				'subject' => $this->subject,
				'expires' => $this->expires,
				'aliases' => $this->aliases,
				'properties' => $this->properties,
				'links' => $this->links,
			]
		);

		return (empty($data)) ? new DataResponse('', $this->httpCode) : new JSONResponse($data, $this->httpCode);
	}

	/**
	 * Does this response have any data attached to it?
	 *
	 * @since 21.0.0
	 */
	public function isEmpty(): bool {
		return $this->expires === null
			   && empty($this->aliases)
			   && empty($this->properties)
			   && empty($this->links);
	}
}