<?php
/**
 * Activity log read port.
 *
 * @package Bookline
 */

declare( strict_types=1 );

namespace Bookline\Domain\Activity;

/**
 * Admin activity list.
 *
 * @since 0.1.0
 */
interface ActivityLogRepository {

	/**
	 * Paginated admin list.
	 *
	 * @param int         $page     Page.
	 * @param int         $per_page Per page.
	 * @param string|null $actor    Actor label filter.
	 * @param string|null $subject  Subject type filter.
	 * @return array{items: list<array<string, mixed>>, total: int}
	 *
	 * @since 0.1.0
	 */
	public function list_for_admin( int $page, int $per_page, ?string $actor = null, ?string $subject = null ): array;
}