<?php
/**
 * Customer credit REST controller.
 *
 * @package HostKhata
 */

namespace HostKhata\Rest;

defined( 'ABSPATH' ) || exit;

use HostKhata\Core\Capabilities;
use HostKhata\Database\Repositories\CreditRepository;
use HostKhata\Database\Repositories\CustomerRepository;
use HostKhata\Domain\Billing\CreditService;
use HostKhata\Security\Sanitizer;
use HostKhata\Settings\Settings;
use WP_Error;
use WP_REST_Request;
use WP_REST_Response;
use WP_REST_Server;

/**
 * `/hostkhata/v1/credits`: a customer's credit balance and ledger, and manual
 * adjustments. Needs `hostkhata_manage_payments`.
 *
 * @since 0.1.0
 */
final class CreditsController extends BaseController {

	/**
	 * Route base.
	 *
	 * @var string
	 */
	protected $rest_base = 'credits';

	/**
	 * Credit service.
	 *
	 * @var CreditService
	 */
	private $service;

	/**
	 * Credit ledger.
	 *
	 * @var CreditRepository
	 */
	private $credits;

	/**
	 * Customers.
	 *
	 * @var CustomerRepository
	 */
	private $customers;

	/**
	 * Settings.
	 *
	 * @var Settings
	 */
	private $settings;

	/**
	 * Constructor.
	 *
	 * @param CreditService      $service   Credit service.
	 * @param CreditRepository   $credits   Credit ledger.
	 * @param CustomerRepository $customers Customers.
	 * @param Settings           $settings  Settings.
	 */
	public function __construct( CreditService $service, CreditRepository $credits, CustomerRepository $customers, Settings $settings ) {
		$this->service   = $service;
		$this->credits   = $credits;
		$this->customers = $customers;
		$this->settings  = $settings;
	}

	/**
	 * Registers the routes.
	 *
	 * @since 0.1.0
	 *
	 * @return void
	 */
	public function register_routes() {
		register_rest_route(
			$this->namespace,
			'/' . $this->rest_base,
			array(
				array(
					'methods'             => WP_REST_Server::READABLE,
					'callback'            => array( $this, 'get_ledger' ),
					'permission_callback' => Permissions::require_capability( Capabilities::MANAGE_PAYMENTS ),
					'args'                => array(
						'customer_id' => array(
							'type'              => 'integer',
							'required'          => true,
							'sanitize_callback' => 'absint',
						),
					),
				),
				array(
					'methods'             => WP_REST_Server::CREATABLE,
					'callback'            => array( $this, 'adjust' ),
					'permission_callback' => Permissions::require_capability( Capabilities::MANAGE_PAYMENTS ),
				),
			)
		);
	}

	/**
	 * Returns a customer's balance and ledger.
	 *
	 * @since 0.1.0
	 *
	 * @param WP_REST_Request $request Request.
	 * @return WP_REST_Response|WP_Error
	 */
	public function get_ledger( $request ) {
		$customer_id = (int) $request['customer_id'];

		if ( null === $this->customers->find( $customer_id ) ) {
			return $this->error( 'hostkhata_not_found', __( 'Customer not found.', 'hostkhata' ), 404 );
		}

		return rest_ensure_response( $this->present( $customer_id ) );
	}

	/**
	 * Adds or removes credit.
	 *
	 * @since 0.1.0
	 *
	 * @param WP_REST_Request $request Request: `customer_id`, `amount` (signed minor units), `reason`.
	 * @return WP_REST_Response|WP_Error
	 */
	public function adjust( $request ) {
		$body        = $this->request_body( $request );
		$customer_id = Sanitizer::absint( $body['customer_id'] ?? 0 );
		$result      = $this->service->adjust( $customer_id, $body );

		return is_wp_error( $result ) ? $result : rest_ensure_response( $this->present( $customer_id ) );
	}

	/**
	 * Shapes a balance and ledger.
	 *
	 * @param int $customer_id Customer id.
	 * @return array<string, mixed>
	 */
	private function present( int $customer_id ): array {
		$balance = $this->credits->balance( $customer_id );

		$entries = array_map(
			function ( array $entry ) {
				$entry['amount_formatted']  = $this->settings->format_money( $entry['amount'] );
				$entry['balance_formatted'] = $this->settings->format_money( $entry['balance_after'] );
				$entry['created_at']        = str_replace( ' ', 'T', (string) $entry['created_at_gmt'] ) . 'Z';

				return $entry;
			},
			$this->credits->for_customer( $customer_id )
		);

		return array(
			'customer_id'       => $customer_id,
			'balance'           => $balance,
			'balance_formatted' => $this->settings->format_money( $balance ),
			'entries'           => $entries,
		);
	}
}