<?php

declare(strict_types=1);

/**
 * SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
 * SPDX-License-Identifier: AGPL-3.0-or-later
 */
namespace OCP\Mail\Provider;

use JsonSerializable;
use OCP\Json\JsonDeserializable;

/**
 * Mail Message Object
 *
 * This object is used to define a mail message that can be used to transfer data to a provider
 *
 * @since 30.0.0
 *
 */
class Message implements IMessage, JsonSerializable, JsonDeserializable {

	/**
	 * initialize the mail message object
	 *
	 * @since 30.0.0
	 *
	 * @param array $data message data array
	 */
	public function __construct(
		protected array $data = [],
	) {
	}

	/**
	 * export this objects data as an array
	 *
	 * @since 33.0.0
	 *
	 * @return array representation of this object as an array
	 */
	public function jsonSerialize(): array {
		$data = $this->data;
		$data['bodyHtml'] = base64_encode($this->data['bodyHtml'] ?? '');
		$data['bodyPlain'] = base64_encode($this->data['bodyPlain'] ?? '');
		$data['subject'] = base64_encode($this->data['subject'] ?? '');
		return $data;
	}

	/**
	 * import this objects data from an array
	 *
	 * @since 33.0.0
	 *
	 * @param array array representation of this object
	 */
	public static function jsonDeserialize(array|string $data): static {
		if (is_string($data)) {
			$data = json_decode($data, true);
		}
		// decode encoded fields
		$data['bodyHtml'] = base64_decode($data['bodyHtml'] ?? '');
		$data['bodyPlain'] = base64_decode($data['bodyPlain'] ?? '');
		$data['subject'] = base64_decode($data['subject'] ?? '');
		//  convert object fields
		foreach (['from', 'replyTo'] as $field) {
			if (isset($data[$field]) && is_array($data[$field])) {
				$data[$field] = Address::jsonDeserialize($data[$field]);
			} else {
				$data[$field] = null;
			}
		}
		foreach (['to', 'cc', 'bcc', 'attachments'] as $field) {
			if (isset($data[$field]) && is_array($data[$field])) {
				foreach ($data[$field] as $key => $item) {
					if (is_array($item)) {
						if ($field === 'attachments') {
							$data[$field][$key] = Attachment::jsonDeserialize($item);
						} else {
							$data[$field][$key] = Address::jsonDeserialize($item);
						}
					}
				}
			}
		}

		return new static($data);
	}

	/**
	 * arbitrary unique text string identifying this message
	 *
	 * @since 30.0.0
	 *
	 * @return string id of this message
	 */
	public function id(): string {
		// return id of message
		return (isset($this->data['id'])) ? $this->data['id'] : '';
	}

	/**
	 * sets the sender of this message
	 *
	 * @since 30.0.0
	 *
	 * @param IAddress $value sender's mail address object
	 *
	 * @return self return this object for command chaining
	 */
	public function setFrom(IAddress $value): self {
		// create or update field in data store with value
		$this->data['from'] = $value;
		// return this object for command chaining
		return $this;
	}

	/**
	 * gets the sender of this message
	 *
	 * @since 30.0.0
	 *
	 * @return IAddress|null sender's mail address object
	 */
	public function getFrom(): ?IAddress {
		// evaluate if data store field exists and return value(s) or null otherwise
		return (isset($this->data['from'])) ? $this->data['from'] : null;
	}

	/**
	 * sets the sender's reply to address of this message
	 *
	 * @since 30.0.0
	 *
	 * @param IAddress $value senders's reply to mail address object
	 *
	 * @return self return this object for command chaining
	 */
	public function setReplyTo(IAddress $value): self {
		// create or update field in data store with value
		$this->data['replyTo'] = $value;
		// return this object for command chaining
		return $this;
	}

	/**
	 * gets the sender's reply to address of this message
	 *
	 * @since 30.0.0
	 *
	 * @return IAddress|null sender's reply to mail address object
	 */
	public function getReplyTo(): ?IAddress {
		// evaluate if data store field exists and return value(s) or null otherwise
		return (isset($this->data['replyTo'])) ? $this->data['replyTo'] : null;
	}

	/**
	 * sets the recipient(s) of this message
	 *
	 * @since 30.0.0
	 *
	 * @param IAddress ...$value collection of or one or more mail address objects
	 *
	 * @return self return this object for command chaining
	 */
	public function setTo(IAddress ...$value): self {
		// create or update field in data store with value
		$this->data['to'] = $value;
		// return this object for command chaining
		return $this;
	}

	/**
	 * gets the recipient(s) of this message
	 *
	 * @since 30.0.0
	 *
	 * @return array<int,IAddress> collection of all recipient mail address objects
	 */
	public function getTo(): array {
		// evaluate if data store field exists and return value(s) or empty collection
		return (isset($this->data['to'])) ? $this->data['to'] : [];
	}

	/**
	 * sets the copy to recipient(s) of this message
	 *
	 * @since 30.0.0
	 *
	 * @param IAddress ...$value collection of or one or more mail address objects
	 *
	 * @return self return this object for command chaining
	 */
	public function setCc(IAddress ...$value): self {
		// create or update field in data store with value
		$this->data['cc'] = $value;
		// return this object for command chaining
		return $this;
	}

	/**
	 * gets the copy to recipient(s) of this message
	 *
	 * @since 30.0.0
	 *
	 * @return array<int,IAddress> collection of all copied recipient mail address objects
	 */
	public function getCc(): array {
		// evaluate if data store field exists and return value(s) or empty collection
		return (isset($this->data['cc'])) ? $this->data['cc'] : [];
	}

	/**
	 * sets the blind copy to recipient(s) of this message
	 *
	 * @since 30.0.0
	 *
	 * @param IAddress ...$value collection of or one or more mail address objects
	 *
	 * @return self return this object for command chaining
	 */
	public function setBcc(IAddress ...$value): self {
		// create or update field in data store with value
		$this->data['bcc'] = $value;
		// return this object for command chaining
		return $this;
	}

	/**
	 * gets the blind copy to recipient(s) of this message
	 *
	 * @since 30.0.0
	 *
	 * @return array<int,IAddress> collection of all blind copied recipient mail address objects
	 */
	public function getBcc(): array {
		// evaluate if data store field exists and return value(s) or empty collection
		return (isset($this->data['bcc'])) ? $this->data['bcc'] : [];
	}

	/**
	 * sets the subject of this message
	 *
	 * @since 30.0.0
	 *
	 * @param string $value subject of mail message
	 *
	 * @return self return this object for command chaining
	 */
	public function setSubject(string $value): self {
		// create or update field in data store with value
		$this->data['subject'] = $value;
		// return this object for command chaining
		return $this;
	}

	/**
	 * gets the subject of this message
	 *
	 * @since 30.0.0
	 *
	 * @return string|null subject of message or null if one is not set
	 */
	public function getSubject(): ?string {
		// evaluate if data store field exists and return value(s) or null otherwise
		return (isset($this->data['subject'])) ? $this->data['subject'] : null;
	}

	/**
	 * sets the plain text or html body of this message
	 *
	 * @since 30.0.0
	 *
	 * @param string $value text or html body of message
	 * @param bool $html html flag - true for html
	 *
	 * @return self return this object for command chaining
	 */
	public function setBody(string $value, bool $html = false): self {
		// evaluate html flag and create or update appropriate field in data store with value
		if ($html) {
			$this->data['bodyHtml'] = $value;
		} else {
			$this->data['bodyPlain'] = $value;
		}
		// return this object for command chaining
		return $this;
	}

	/**
	 * gets either the html or plain text body of this message
	 *
	 * html body will be returned over plain text if html body exists
	 *
	 * @since 30.0.0
	 *
	 * @return string|null html/plain body of this message or null if one is not set
	 */
	public function getBody(): ?string {
		// evaluate if data store field(s) exists and return value
		if (isset($this->data['bodyHtml'])) {
			return $this->data['bodyHtml'];
		} elseif (isset($this->data['bodyPlain'])) {
			return $this->data['bodyPlain'];
		}
		// return null if data fields did not exist in data store
		return null;
	}

	/**
	 * sets the html body of this message
	 *
	 * @since 30.0.0
	 *
	 * @param string $value html body of message
	 *
	 * @return self return this object for command chaining
	 */
	public function setBodyHtml(string $value): self {
		// create or update field in data store with value
		$this->data['bodyHtml'] = $value;
		// return this object for command chaining
		return $this;
	}

	/**
	 * gets the html body of this message
	 *
	 * @since 30.0.0
	 *
	 * @return string|null html body of this message or null if one is not set
	 */
	public function getBodyHtml(): ?string {
		// evaluate if data store field exists and return value(s) or null otherwise
		return (isset($this->data['bodyHtml'])) ? $this->data['bodyHtml'] : null;
	}

	/**
	 * sets the plain text body of this message
	 *
	 * @since 30.0.0
	 *
	 * @param string $value plain text body of message
	 *
	 * @return self return this object for command chaining
	 */
	public function setBodyPlain(string $value): self {
		// create or update field in data store with value
		$this->data['bodyPlain'] = $value;
		// return this object for command chaining
		return $this;
	}

	/**
	 * gets the plain text body of this message
	 *
	 * @since 30.0.0
	 *
	 * @return string|null plain text body of this message or null if one is not set
	 */
	public function getBodyPlain(): ?string {
		// evaluate if data store field exists and return value(s) or null otherwise
		return (isset($this->data['bodyPlain'])) ? $this->data['bodyPlain'] : null;
	}

	/**
	 * sets the attachments of this message
	 *
	 * @since 30.0.0
	 *
	 * @param IAttachment ...$value collection of or one or more mail attachment objects
	 *
	 * @return self return this object for command chaining
	 */
	public function setAttachments(IAttachment ...$value): self {
		// create or update field in data store with value
		$this->data['attachments'] = $value;
		// return this object for command chaining
		return $this;
	}

	/**
	 * gets the attachments of this message
	 *
	 * @since 30.0.0
	 *
	 * @return array<int,IAttachment> collection of all mail attachment objects
	 */
	public function getAttachments(): array {
		// evaluate if data store field exists and return value(s) or null otherwise
		return (isset($this->data['attachments'])) ? $this->data['attachments'] : [];
	}

}