<?php
/**
 * Contract for checks that read the database instead of rendered pages.
 *
 * @package ForensixDigital
 */

declare(strict_types=1);

namespace ForensixDigital\Services\Scan;

defined( 'ABSPATH' ) || exit;

/**
 * Runs in small batches after the page checks. Each call handles one batch, records what it
 * finds and returns the cursor for the next batch, or null when it is done. Read-only.
 */
interface StoredContentCheck {

	/**
	 * Handles one batch.
	 *
	 * @param int                  $scan_id Scan id.
	 * @param array<string, mixed> $cursor  Cursor from the previous call, empty to start.
	 * @return array<string, mixed>|null Next cursor, or null when done.
	 */
	public function step( int $scan_id, array $cursor ): ?array;
}