<?php
/**
 * Storage of marketplace accounts. Secrets arrive and leave as sealed strings; AccountService encrypts.
 * The WordPress implementation is AccountRepository.
 *
 * @package Tidelist
 */

namespace Tidelist\Data;

/**
 * Account storage.
 */
interface AccountStore {

	/**
	 * One account row.
	 *
	 * @param int $id Account ID.
	 */
	public function find( int $id ): ?array;

	/**
	 * Account rows, oldest first.
	 *
	 * @param string|null $channel Only this channel.
	 * @return array<int, array>
	 */
	public function all( ?string $channel = null ): array;

	/**
	 * Inserts an account.
	 *
	 * @param array $fields Fields.
	 * @return int New ID.
	 * @throws \InvalidArgumentException On invalid data.
	 */
	public function insert( array $fields ): int;

	/**
	 * Updates an account.
	 *
	 * @param int   $id     Account ID.
	 * @param array $fields Fields.
	 */
	public function update( int $id, array $fields ): void;

	/**
	 * Deletes an account (its listings are not touched).
	 *
	 * @param int $id Account ID.
	 */
	public function delete( int $id ): void;
}