<?php
/**
 * Connection repository contract.
 *
 * @package Shiftora\Contracts
 */

declare(strict_types=1);

namespace Shiftora\Contracts;

// Prevent direct file access.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Defines how the plugin stores and retrieves cross-site connections. Rows are
 * plain stdClass objects (direct wpdb output).
 */
interface ConnectionRepositoryInterface {

	/**
	 * @return int New connection ID.
	 * @throws \RuntimeException On database error.
	 */
	public function create(
		string $label,
		string $remote_url,
		string $local_token,
		string $remote_token,
		string $remote_db_prefix = 'wp_'
	): int;

	/** @return object|null stdClass row, or null. */
	public function find_by_token( string $token ): ?object;

	/** @return object|null stdClass row, or null. */
	public function find_by_id( int $id ): ?object;

	/** @return array<int, object> */
	public function list(): array;

	public function activate( int $id ): bool;
	public function revoke( int $id ): bool;
	public function update_last_ping( int $id ): bool;
	public function set_remote_permissions( int $id, int $allow_pull ): bool;
	public function delete( int $id ): bool;

	/**
	 * Decrypts and returns the stored remote token.
	 *
	 * @throws \RuntimeException If decryption fails.
	 */
	public function get_remote_token( object $connection ): string;
}