<?php
namespace Neos\Media\Domain\Model\AssetSource;

/*
 * This file is part of the Neos.Media package.
 *
 * (c) Contributors of the Neos Project - www.neos.io
  *
 * This package is Open Source Software. For the full copyright and license
 * information, please view the LICENSE file which was distributed with this
 * source code.
 */

use Neos\Media\Domain\Model\Tag;

interface SupportsTaggingInterface
{
    /**
     * NOTE: This needs to be refactored to use a tag identifier instead of Media's domain model before
     *       it can become a public API for other asset sources.
     *
     * @param Tag $tag
     * @return AssetProxyQueryResultInterface
     */
    public function findByTag(Tag $tag): AssetProxyQueryResultInterface;

    /**
     * @return AssetProxyQueryResultInterface
     */
    public function findUntagged(): AssetProxyQueryResultInterface;

    /**
     * @return int
     */
    public function countUntagged(): int;


    /**
     * @param Tag $tag
     * @return int
     */
    public function countByTag(Tag $tag): int;
}
