epubreader/lib/Service/BookmarkService.php

<?php
/**
 * @author Frank de Lange
 * @copyright 2017 Frank de Lange
 *
 * This file is licensed under the Affero General Public License version 3 or
 * later.
 * See the COPYING-README file.
 */

namespace OCA\Epubreader\Service;

use OCA\Epubreader\Db\BookmarkMapper;
use OCA\Epubreader\Db\ReaderEntity;

/**
 * @psalm-import-type SerializedEntity from ReaderEntity
 */
class BookmarkService extends Service
{
	// "bookmark" name to use for the cursor (current reading position)
	private const CURSOR = '__CURSOR__';
	private const BOOKMARK_TYPE = 'bookmark';

	private BookmarkMapper $bookmarkMapper;

	public function __construct(BookmarkMapper $bookmarkMapper)
	{
		parent::__construct($bookmarkMapper);
		$this->bookmarkMapper = $bookmarkMapper;
	}

	/**
	 * @brief get bookmark
	 *
	 * bookmark type is format-dependent, eg CFI for epub, page number for CBR/CBZ, etc
	 *
	 * @return SerializedEntity[]
	 */
	public function get(int $fileId, ?string $name = null, ?string $type = null): array
	{
		$result = $this->bookmarkMapper->get($fileId, $name, $type);

		return array_map(
			function (ReaderEntity $entity): array {
				return $entity->toService();
			},
			$result
		);
	}

	/**
	 * @brief write bookmark
	 *
	 * position type is format-dependent, eg CFI for epub, page number for CBR/CBZ, etc
	 */
	public function set(int $fileId, string $name, string $value, ?string $type = null, ?string $content = null): ReaderEntity
	{
		return $this->bookmarkMapper->set($fileId, $name, $value, $type, $content);
	}

	/**
	 * @brief get cursor (current position in book)
	 *
	 * @return SerializedEntity
	 */
	public function getCursor(int $fileId): array
	{
		$result = $this->get($fileId, self::CURSOR);
		if (1 === count($result)) {
			return $result[0];
		}

		return [];
	}

	/**
	 * @brief set cursor (current position in book)
	 */
	public function setCursor(int $fileId, string $value): ReaderEntity
	{
		return $this->bookmarkMapper->set($fileId, self::CURSOR, $value, self::BOOKMARK_TYPE);
	}

	/**
	 * @brief delete bookmark
	 */
	public function delete(int $fileId, ?string $name = null, ?string $type = null): void
	{
		foreach ($this->bookmarkMapper->get($fileId, $name, $type) as $bookmark) {
			$this->bookmarkMapper->delete($bookmark);
		}
	}

	/**
	 * @brief delete cursor
	 */
	public function deleteCursor(int $fileId): void
	{
		$this->delete($fileId, self::CURSOR, self::BOOKMARK_TYPE);
	}
}