<?php
/**
 * Shared REST helpers.
 *
 * @package Fillaro
 */

namespace Fillaro\Rest;

use Fillaro\Plugin;

defined( 'ABSPATH' ) || exit;

/**
 * Base controller.
 */
abstract class BaseController {

	const NS = 'fillaro/v1';

	/**
	 * Register routes.
	 */
	abstract public function register_routes();

	/**
	 * Permission check for admin routes.
	 *
	 * @return bool|\WP_Error
	 */
	public function can_manage() {
		if ( current_user_can( Plugin::capability() ) ) {
			return true;
		}
		return new \WP_Error( 'fillaro_forbidden', __( 'You are not allowed to do that.', 'fillaro' ), array( 'status' => rest_authorization_required_code() ) );
	}

	/**
	 * Standard ID argument.
	 *
	 * @return array
	 */
	protected function id_arg() {
		return array(
			'id' => array(
				'type'              => 'integer',
				'required'          => true,
				'sanitize_callback' => 'absint',
			),
		);
	}

	/**
	 * Paged list response with total headers.
	 *
	 * @param array $items    Items.
	 * @param int   $total    Total.
	 * @param int   $per_page Per page.
	 * @return \WP_REST_Response
	 */
	protected function paged( array $items, $total, $per_page ) {
		$response = rest_ensure_response( $items );
		$response->header( 'X-WP-Total', (string) (int) $total );
		$response->header( 'X-WP-TotalPages', (string) (int) max( 1, ceil( $total / max( 1, $per_page ) ) ) );
		return $response;
	}
}