<?php
/**
 * REST base.
 *
 * @package Bloatwright
 */

namespace Bloatwright\Rest;

use Bloatwright\Services\Settings;

/**
 * Shared helpers.
 */
abstract class BaseController {

	/**
	 * Namespace.
	 */
	const NAMESPACE = 'bloatwright/v1';

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

	/**
	 * Permission.
	 *
	 * @return bool|\WP_Error
	 */
	public function permission() {
		if ( current_user_can( Settings::capability() ) ) {
			return true;
		}
		return new \WP_Error( 'bloatwright_forbidden', __( 'You are not allowed to do that.', 'bloatwright' ), array( 'status' => is_user_logged_in() ? 403 : 401 ) );
	}

	/**
	 * Schema for a numeric path parameter (a session id).
	 *
	 * @return array<string, mixed>
	 */
	protected static function id_arg(): array {
		return array(
			'type'              => 'integer',
			'minimum'           => 1,
			'required'          => true,
			'sanitize_callback' => 'absint',
			'validate_callback' => 'rest_validate_request_arg',
		);
	}

	/**
	 * Register a route.
	 *
	 * @param string $route Route.
	 * @param array  $args Args.
	 */
	protected function route( string $route, array $args ): void {
		register_rest_route( self::NAMESPACE, $route, $args );
	}
}