<?php


/**
 * Class Tribe__Events__REST__V1__Main
 *
 * The main entry point for TEC REST API.
 *
 * This class should not contain business logic and merely set up and start the TEC REST API support.
 */
class Tribe__Events__REST__V1__Main extends Tribe__REST__Main {

	/**
	 * The Events Calendar REST API URL prefix.
	 *
	 * This prefix is appended to the The Events Calendar REST API URL ones.
	 *
	 * @var string
	 */
	protected $url_prefix = '/events/v1';

	/**
	 * @var array
	 */
	protected $registered_endpoints = [];

	/**
	 * Binds the implementations needed to support the REST API.
	 */
	public function bind_implementations() {
		tribe_singleton( 'tec.rest-v1.messages', 'Tribe__Events__REST__V1__Messages' );
		tribe_singleton( 'tec.rest-v1.ea-messages', 'Tribe__Events__REST__V1__EA_Messages' );
		tribe_singleton( 'tec.rest-v1.headers-base', 'Tribe__Events__REST__V1__Headers__Base' );
		tribe_singleton( 'tec.rest-v1.settings', 'Tribe__Events__REST__V1__Settings' );
		tribe_singleton( 'tec.rest-v1.system', 'Tribe__Events__REST__V1__System' );
		tribe_singleton( 'tec.rest-v1.validator', 'Tribe__Events__REST__V1__Validator__Base' );
		tribe_singleton( 'tec.rest-v1.repository', 'Tribe__Events__REST__V1__Post_Repository' );
		tribe_singleton( 'tec.rest-v1.endpoints.single-venue', [ $this, 'build_single_venue_endpoint' ] );
		tribe_singleton( 'tec.rest-v1.endpoints.single-organizer', [ $this, 'build_single_organizer_endpoint' ] );
		tribe_singleton( 'tec.json-ld.event', [ 'Tribe__Events__JSON_LD__Event', 'instance' ] );
		tribe_singleton( 'tec.json-ld.venue', [ 'Tribe__Events__JSON_LD__Venue', 'instance' ] );
		tribe_singleton( 'tec.json-ld.organizer', [ 'Tribe__Events__JSON_LD__Organizer', 'instance' ] );

		include_once Tribe__Events__Main::instance()->plugin_path . 'src/functions/advanced-functions/rest-v1.php';
	}

	/**
	 * Hooks the filters and actions required for the REST API support to kick in.
	 */
	public function hook() {
		$this->hook_headers();
		$this->hook_settings();
		$this->hook_messages();

		/** @var Tribe__Events__REST__V1__System $system */
		$system = tribe( 'tec.rest-v1.system' );

		if ( ! $system->supports_tec_rest_api() || ! $system->tec_rest_api_is_enabled() ) {
			return;
		}

		add_action( 'rest_api_init', [ $this, 'register_endpoints' ] );
		add_filter( 'tribe_events_register_event_cat_type_args', [ $this, 'filter_taxonomy_args' ] );
		add_filter( 'tribe_rest_events_archive_data', [ $this, 'filter_out_password_protected_events' ], 100, 2 );
	}

	/**
	 * Filters out content from password protected events from the REST API response.
	 *
	 * @since 6.8.2.1
	 *
	 * @param array           $data    The events to be filtered.
	 * @param WP_REST_Request $request The request object.
	 *
	 * @return array The filtered events.
	 */
	public function filter_out_password_protected_events( array $data, WP_REST_Request $request ): array {
		foreach( $data['events'] as &$event ) {
			if ( ! post_password_required( $event['id'] ) ) {
				// No password required or password has been provided or requirement has been removed through filters.
				continue;
			}

			$event_post = get_post( $event['id'] );

			if ( ! ( $event_post instanceof WP_Post && $event_post->ID ) ) {
				// No post object, weird but let's skip it.
				continue;
			}

			$validator = tribe( 'tec.rest-v1.validator' );

			if ( $validator->can_access_password_content( $event_post, $request ) ) {
				// User has provided password and can see password protected content.
				continue;
			}

			// User should not be able to see password protected content.
			$event = $validator->remove_password_protected_content( $event );
		}

		return $data;
	}

	/**
	 * Hooks the additional headers and meta tags related to the REST API.
	 */
	protected function hook_headers() {
		/** @var Tribe__Events__REST__V1__System $system */
		$system = tribe( 'tec.rest-v1.system' );
		/** @var Tribe__REST__Headers__Base_Interface $headers_base */
		$headers_base = tribe( 'tec.rest-v1.headers-base' );

		if ( ! $system->tec_rest_api_is_enabled() ) {
			if ( ! $system->supports_tec_rest_api() ) {
				tribe_singleton( 'tec.rest-v1.headers', new Tribe__REST__Headers__Unsupported( $headers_base, $this ) );
			} else {
				tribe_singleton( 'tec.rest-v1.headers', new Tribe__REST__Headers__Disabled( $headers_base ) );
			}
		} else {
			tribe_singleton( 'tec.rest-v1.headers', new Tribe__REST__Headers__Supported( $headers_base, $this ) );
		}

		/** @var Tribe__REST__Headers__Headers_Interface $headers */
		$headers = tribe( 'tec.rest-v1.headers' );

		add_action( 'wp_head', [ $headers, 'add_header' ], 10, 0 );
		add_action( 'template_redirect', [ $headers, 'send_header' ], 11, 0 );
	}

	/**
	 * Hooks the additional Events Settings related to the REST API.
	 */
	protected function hook_settings() {
		add_filter( 'tribe_addons_tab_fields', [
			tribe( 'tec.rest-v1.settings' ),
			'filter_tribe_addons_tab_fields',
		] );
	}

	protected function hook_messages() {
		add_filter( 'tribe_aggregator_service_messages', [ $this, 'filter_service_messages' ] );
		add_filter( 'tribe_aggregator_localized_data', [ $this, 'filter_localized_data' ] );
	}

	/**
	 * Registers the endpoints, and the handlers, supported by the REST API
	 *
	 * @param bool $register_routes Whether routes should be registered as well or not.
	 */
	public function register_endpoints( $register_routes = true ) {
		$this->register_documentation_endpoint( $register_routes );
		$this->register_event_archives_endpoint( $register_routes );
		$this->register_single_event_endpoint( $register_routes );
		$this->register_single_event_slug_endpoint( $register_routes );
		$this->register_venue_archives_endpoint( $register_routes );
		$this->register_single_venue_endpoint( $register_routes );
		$this->register_single_venue_slug_endpoint( $register_routes );
		$this->register_organizer_archives_endpoint( $register_routes );
		$this->register_single_organizer_endpoint( $register_routes );
		$this->register_single_organizer_slug_endpoint( $register_routes );

		global $wp_version;

		if ( version_compare( $wp_version, '4.7', '>=' ) ) {
			$this->register_categories_endpoint( $register_routes );
			$this->register_tags_endpoint( $register_routes );
		}
	}

	/**
	 * Builds and hooks the documentation endpoint
	 *
	 * @since 4.5
	 *
	 * @param bool $register_routes Whether routes for the endpoint should be registered or not.
	 *
	 */
	protected function register_documentation_endpoint( $register_routes = true ) {
		$endpoint = new Tribe__Events__REST__V1__Endpoints__Swagger_Documentation( $this->get_semantic_version() );

		tribe_singleton( 'tec.rest-v1.endpoints.documentation', $endpoint );

		if ( $register_routes ) {
			tribe_register_rest_route( $this->get_events_route_namespace(), '/doc', [
				'methods'  => WP_REST_Server::READABLE,
				'callback' => [ $endpoint, 'get' ],
			] );
		}

		/** @var Tribe__Documentation__Swagger__Builder_Interface $documentation */
		$documentation = tribe( 'tec.rest-v1.endpoints.documentation' );
		$documentation->register_documentation_provider( '/doc', $endpoint );
		$documentation->register_definition_provider( 'ImageSize', new Tribe__Documentation__Swagger__Image_Size_Definition_Provider() );
		$documentation->register_definition_provider( 'CostDetails', new Tribe__Documentation__Swagger__Cost_Details_Definition_Provider() );
		$documentation->register_definition_provider( 'Term', new Tribe__Documentation__Swagger__Term_Definition_Provider() );
		$documentation->register_definition_provider( 'Image', new Tribe__Documentation__Swagger__Image_Definition_Provider() );
		$documentation->register_definition_provider( 'DateDetails', new Tribe__Documentation__Swagger__Date_Details_Definition_Provider() );
		$documentation->register_definition_provider( 'Event', new Tribe__Events__REST__V1__Documentation__Event_Definition_Provider() );
		$documentation->register_definition_provider( 'Venue', new Tribe__Events__REST__V1__Documentation__Venue_Definition_Provider() );
		$documentation->register_definition_provider( 'Organizer', new Tribe__Events__REST__V1__Documentation__Organizer_Definition_Provider() );
	}

	protected function get_semantic_version() {
		return '1.0.0';
	}

	/**
	 * Returns the events REST API namespace string that should be used to register a route.
	 *
	 * @return string
	 */
	public function get_events_route_namespace() {
		return $this->get_namespace() . '/events/' . $this->get_version();
	}

	/**
	 * Returns the string indicating the REST API version.
	 *
	 * @return string
	 */
	public function get_version() {
		return 'v1';
	}

	/**
	 * Builds and hooks the event archives endpoint
	 *
	 * @since 4.5
	 *
	 * @param bool $register_routes Whether routes for the endpoint should be registered or not.
	 *
	 */
	protected function register_event_archives_endpoint( $register_routes = true ) {
		$messages        = tribe( 'tec.rest-v1.messages' );
		$post_repository = tribe( 'tec.rest-v1.repository' );
		$validator       = tribe( 'tec.rest-v1.validator' );
		$endpoint        = new Tribe__Events__REST__V1__Endpoints__Archive_Event( $messages, $post_repository, $validator );

		tribe_singleton( 'tec.rest-v1.endpoints.archive-event', $endpoint );

		if ( $register_routes ) {
			tribe_register_rest_route( $this->get_events_route_namespace(), '/events', [
				'methods'  => WP_REST_Server::READABLE,
				'callback' => [ $endpoint, 'get' ],
				'args'     => $endpoint->READ_args(),
			] );
		}

		tribe( 'tec.rest-v1.endpoints.documentation' )->register_documentation_provider( '/events', $endpoint );
	}

	/**
	 * Registers the endpoint that will handle requests for a single event.
	 *
	 * @since 4.5
	 *
	 * @param bool $register_routes Whether routes for the endpoint should be registered or not.
	 *
	 */
	protected function register_single_event_endpoint( $register_routes = true ) {
		$messages           = tribe( 'tec.rest-v1.messages' );
		$post_repository    = tribe( 'tec.rest-v1.repository' );
		$validator          = tribe( 'tec.rest-v1.validator' );
		$venue_endpoint     = tribe( 'tec.rest-v1.endpoints.single-venue' );
		$organizer_endpoint = tribe( 'tec.rest-v1.endpoints.single-organizer' );

		$endpoint = new Tribe__Events__REST__V1__Endpoints__Single_Event( $messages, $post_repository, $validator, $venue_endpoint, $organizer_endpoint );

		tribe_singleton( 'tec.rest-v1.endpoints.single-event', $endpoint );

		$namespace = $this->get_events_route_namespace();

		if ( $register_routes ) {
			tribe_register_rest_route(
				$namespace,
				'/events/(?P<id>\\d+)',
				[
					[
						'methods'             => WP_REST_Server::READABLE,
						'args'                => $endpoint->READ_args(),
						'callback'            => [ $endpoint, 'get' ],
						'permission_callback' => '__return_true',
					],
					[
						'methods'             => WP_REST_Server::DELETABLE,
						'args'                => $endpoint->DELETE_args(),
						'permission_callback' => [ $endpoint, 'can_delete' ],
						'callback'            => [ $endpoint, 'delete' ],
					],
					[
						'methods'             => WP_REST_Server::EDITABLE,
						'args'                => $endpoint->EDIT_args(),
						'permission_callback' => [ $endpoint, 'can_edit' ],
						'callback'            => [ $endpoint, 'update' ],
					],
				]
			);

			tribe_register_rest_route(
				$namespace,
				'/events', [
					'methods'             => WP_REST_Server::CREATABLE,
					'args'                => $endpoint->CREATE_args(),
					'permission_callback' => [ $endpoint, 'can_create' ],
					'callback'            => [ $endpoint, 'create' ],
				]
			);
		}

		tribe( 'tec.rest-v1.endpoints.documentation' )->register_documentation_provider( '/events/{id}', $endpoint );
	}

	/**
	 * Registers the endpoint that will handle requests for a single event slug.
	 *
	 * @since 4.5
	 *
	 * @param bool $register_routes Whether routes for the endpoint should be registered or not.
	 *
	 */
	protected function register_single_event_slug_endpoint( $register_routes = true ) {
		$messages           = tribe( 'tec.rest-v1.messages' );
		$post_repository    = tribe( 'tec.rest-v1.repository' );
		$validator          = tribe( 'tec.rest-v1.validator' );
		$venue_endpoint     = tribe( 'tec.rest-v1.endpoints.single-venue' );
		$organizer_endpoint = tribe( 'tec.rest-v1.endpoints.single-organizer' );

		$endpoint = new Tribe__Events__REST__V1__Endpoints__Single_Event_Slug( $messages, $post_repository, $validator, $venue_endpoint, $organizer_endpoint );

		tribe_singleton( 'tec.rest-v1.endpoints.single-event-slug', $endpoint );

		$namespace = $this->get_events_route_namespace();

		if ( $register_routes ) {
			tribe_register_rest_route(
				$namespace,
				'/events/by-slug/(?P<slug>[^/]+)',
				[
					[
						'methods'             => WP_REST_Server::READABLE,
						'args'                => $endpoint->READ_args(),
						'callback'            => [ $endpoint, 'get' ],
						'permission_callback' => '__return_true',
					],
					[
						'methods'             => WP_REST_Server::DELETABLE,
						'args'                => $endpoint->DELETE_args(),
						'permission_callback' => [ $endpoint, 'can_delete' ],
						'callback'            => [ $endpoint, 'delete' ],
					],
					[
						'methods'             => WP_REST_Server::EDITABLE,
						'args'                => $endpoint->EDIT_args(),
						'permission_callback' => [ $endpoint, 'can_edit' ],
						'callback'            => [ $endpoint, 'update' ],
					],
				]
			);
		}

		tribe( 'tec.rest-v1.endpoints.documentation' )->register_documentation_provider( '/events/by-slug/{slug}', $endpoint );
	}

	/**
	 * Returns the URL where the API users will find the API documentation.
	 *
	 * @return string
	 */
	public function get_reference_url() {
		return esc_html( 'alternate' );
	}

	/**
	 * Filters the messages returned by the Event Aggregator Service to add those specific to the REST API v1.
	 *
	 * @param array $messages
	 *
	 * @return array The original messages plus those specific to the REST API V1.
	 */
	public function filter_service_messages( array $messages = [] ) {
		/** @var Tribe__REST__Messages_Interface $rest_messages */
		$rest_messages               = tribe( 'tec.rest-v1.ea-messages' );
		$messages_array              = $rest_messages->get_messages();
		$prefixed_rest_messages_keys = array_map( [
			$rest_messages,
			'prefix_message_slug',
		], array_keys( $messages_array ) );
		$messages                    = array_merge( $messages, array_combine( $prefixed_rest_messages_keys, array_values( $messages_array ) ) );

		return $messages;
	}

	/**
	 * Filters the messages localized by the Event Aggregator Service to add those specific to the REST API v1.
	 *
	 * @param array $localized_data
	 *
	 * @return array
	 */
	public function filter_localized_data( array $localized_data = [] ) {
		/** @var Tribe__REST__Messages_Interface $rest_messages */
		$rest_messages                 = tribe( 'tec.rest-v1.ea-messages' );
		$localized_data['l10n']['url'] = $rest_messages->get_messages();

		return $localized_data;
	}

	/**
	 * Builds an instance of the single venue endpoint.
	 *
	 * @return Tribe__Events__REST__V1__Endpoints__Single_Venue
	 */
	public function build_single_venue_endpoint() {
		$messages        = tribe( 'tec.rest-v1.messages' );
		$post_repository = tribe( 'tec.rest-v1.repository' );
		$validator       = tribe( 'tec.rest-v1.validator' );

		return new Tribe__Events__REST__V1__Endpoints__Single_Venue( $messages, $post_repository, $validator );
	}

	/**
	 * Builds an instance of the single organizer endpoint.
	 *
	 * @return Tribe__Events__REST__V1__Endpoints__Single_Organizer
	 */
	public function build_single_organizer_endpoint() {
		$messages        = tribe( 'tec.rest-v1.messages' );
		$post_repository = tribe( 'tec.rest-v1.repository' );
		$validator       = tribe( 'tec.rest-v1.validator' );

		return new Tribe__Events__REST__V1__Endpoints__Single_Organizer( $messages, $post_repository, $validator );
	}

	/**
	 * Returns the REST API URL prefix that will be appended to the namespace.
	 *
	 * The prefix should be in the `/some/path` format.
	 *
	 * @return string
	 */
	protected function url_prefix() {
		return $this->url_prefix;
	}

	/**
	 * Registers the endpoint that will handle requests for a single venue.
	 *
	 * @since 4.6
	 *
	 * @param bool $register_routes Whether routes for the endpoint should be registered or not.
	 *
	 */
	protected function register_single_venue_endpoint( $register_routes = true ) {
		$messages        = tribe( 'tec.rest-v1.messages' );
		$post_repository = tribe( 'tec.rest-v1.repository' );
		$validator       = tribe( 'tec.rest-v1.validator' );

		$endpoint = new Tribe__Events__REST__V1__Endpoints__Single_Venue( $messages, $post_repository, $validator );

		tribe_singleton( 'tec.rest-v1.endpoints.single-venue', $endpoint );

		$namespace = $this->get_events_route_namespace();

		if ( $register_routes ) {
			tribe_register_rest_route(
				$namespace,
				'/venues/(?P<id>\\d+)',
				[
					[
						'methods'             => WP_REST_Server::READABLE,
						'args'                => $endpoint->READ_args(),
						'callback'            => [ $endpoint, 'get' ],
						'permission_callback' => '__return_true',
					],
					[
						'methods'             => WP_REST_Server::DELETABLE,
						'args'                => $endpoint->DELETE_args(),
						'permission_callback' => [ $endpoint, 'can_delete' ],
						'callback'            => [ $endpoint, 'delete' ],
					],
					[
						'methods'             => WP_REST_Server::EDITABLE,
						'args'                => $endpoint->EDIT_args(),
						'permission_callback' => [ $endpoint, 'can_edit' ],
						'callback'            => [ $endpoint, 'update' ],
					],
				]
			);

			tribe_register_rest_route(
				$namespace,
				'/venues',
				[
					'methods'             => WP_REST_Server::CREATABLE,
					'args'                => $endpoint->CREATE_args(),
					'permission_callback' => [ $endpoint, 'can_create' ],
					'callback'            => [ $endpoint, 'create' ],
				]
			);
		}

		tribe( 'tec.rest-v1.endpoints.documentation' )->register_documentation_provider( '/venues/{id}', $endpoint );
	}

	/**
	 * Registers the endpoint that will handle requests for a single venue slug.
	 *
	 * @since 4.6
	 *
	 * @param bool $register_routes Whether routes for the endpoint should be registered or not.
	 *
	 */
	protected function register_single_venue_slug_endpoint( $register_routes = true ) {
		$messages        = tribe( 'tec.rest-v1.messages' );
		$post_repository = tribe( 'tec.rest-v1.repository' );
		$validator       = tribe( 'tec.rest-v1.validator' );

		$endpoint = new Tribe__Events__REST__V1__Endpoints__Single_Venue_Slug( $messages, $post_repository, $validator );

		tribe_singleton( 'tec.rest-v1.endpoints.single-venue-slug', $endpoint );

		$namespace = $this->get_events_route_namespace();

		if ( $register_routes ) {
			tribe_register_rest_route(
				$namespace,
				'/venues/by-slug/(?P<slug>[^/]+)',
				[
					[
						'methods'             => WP_REST_Server::READABLE,
						'args'                => $endpoint->READ_args(),
						'callback'            => [ $endpoint, 'get' ],
						'permission_callback' => '__return_true',
					],
					[
						'methods'             => WP_REST_Server::DELETABLE,
						'args'                => $endpoint->DELETE_args(),
						'permission_callback' => [ $endpoint, 'can_delete' ],
						'callback'            => [ $endpoint, 'delete' ],
					],
					[
						'methods'             => WP_REST_Server::EDITABLE,
						'args'                => $endpoint->EDIT_args(),
						'permission_callback' => [ $endpoint, 'can_edit' ],
						'callback'            => [ $endpoint, 'update' ],
					],
				]
			);
		}

		tribe( 'tec.rest-v1.endpoints.documentation' )->register_documentation_provider( '/venues/by-slug/{slug}', $endpoint );
	}

	/**
	 * Registers the endpoint that will handle requests for a single organizer.
	 *
	 * @since bucket/full-rest-api
	 *
	 * @param bool $register_routes Whether routes for the endpoint should be registered or not.
	 *
	 */
	protected function register_single_organizer_endpoint( $register_routes = true ) {
		$messages        = tribe( 'tec.rest-v1.messages' );
		$post_repository = tribe( 'tec.rest-v1.repository' );
		$validator       = tribe( 'tec.rest-v1.validator' );

		$endpoint = new Tribe__Events__REST__V1__Endpoints__Single_Organizer( $messages, $post_repository, $validator );

		tribe_singleton( 'tec.rest-v1.endpoints.single-organizer', $endpoint );

		$namespace = $this->get_events_route_namespace();

		if ( $register_routes ) {
			tribe_register_rest_route(
				$namespace,
				'/organizers/(?P<id>\\d+)',
				[
					[
						'methods'             => WP_REST_Server::READABLE,
						'args'                => $endpoint->READ_args(),
						'callback'            => [ $endpoint, 'get' ],
						'permission_callback' => '__return_true',
					],
					[
						'methods'             => WP_REST_Server::DELETABLE,
						'args'                => $endpoint->DELETE_args(),
						'permission_callback' => [ $endpoint, 'can_delete' ],
						'callback'            => [ $endpoint, 'delete' ],
					],
					[
						'methods'             => WP_REST_Server::EDITABLE,
						'args'                => $endpoint->EDIT_args(),
						'permission_callback' => [ $endpoint, 'can_edit' ],
						'callback'            => [ $endpoint, 'update' ],
					],
				]
			);

			tribe_register_rest_route(
				$namespace,
				'/organizers',
				[
					'methods'             => WP_REST_Server::CREATABLE,
					'args'                => $endpoint->CREATE_args(),
					'permission_callback' => [ $endpoint, 'can_create' ],
					'callback'            => [ $endpoint, 'create' ],
				]
			);
		}

		tribe( 'tec.rest-v1.endpoints.documentation' )->register_documentation_provider( '/organizers/{id}', $endpoint );
	}

	/**
	 * Registers the endpoint that will handle requests for a single organizer slug.
	 *
	 * @since bucket/full-rest-api
	 *
	 * @param bool $register_routes Whether routes for the endpoint should be registered or not.
	 *
	 */
	protected function register_single_organizer_slug_endpoint( $register_routes = true ) {
		$messages        = tribe( 'tec.rest-v1.messages' );
		$post_repository = tribe( 'tec.rest-v1.repository' );
		$validator       = tribe( 'tec.rest-v1.validator' );

		$endpoint = new Tribe__Events__REST__V1__Endpoints__Single_Organizer_Slug( $messages, $post_repository, $validator );

		tribe_singleton( 'tec.rest-v1.endpoints.single-organizer-slug', $endpoint );

		$namespace = $this->get_events_route_namespace();

		if ( $register_routes ) {
			tribe_register_rest_route(
				$namespace,
				'/organizers/by-slug/(?P<slug>[^/]+)',
				[
					[
						'methods'             => WP_REST_Server::READABLE,
						'args'                => $endpoint->READ_args(),
						'callback'            => [ $endpoint, 'get' ],
						'permission_callback' => '__return_true',
					],
					[
						'methods'             => WP_REST_Server::DELETABLE,
						'args'                => $endpoint->DELETE_args(),
						'permission_callback' => [ $endpoint, 'can_delete' ],
						'callback'            => [ $endpoint, 'delete' ],
					],
					[
						'methods'             => WP_REST_Server::EDITABLE,
						'args'                => $endpoint->EDIT_args(),
						'permission_callback' => [ $endpoint, 'can_edit' ],
						'callback'            => [ $endpoint, 'update' ],
					],
				]
			);
		}

		tribe( 'tec.rest-v1.endpoints.documentation' )->register_documentation_provider( '/organizers/by-slug/{slug}', $endpoint );
	}

	/**
	 * Builds and hooks the venue archives endpoint
	 *
	 * @since 4.6
	 *
	 * @param bool $register_routes Whether routes for the endpoint should be registered or not.
	 *
	 */
	protected function register_venue_archives_endpoint( $register_routes = true ) {
		$messages        = tribe( 'tec.rest-v1.messages' );
		$post_repository = tribe( 'tec.rest-v1.repository' );
		$validator       = tribe( 'tec.rest-v1.validator' );
		$endpoint        = new Tribe__Events__REST__V1__Endpoints__Archive_Venue( $messages, $post_repository, $validator );

		tribe_singleton( 'tec.rest-v1.endpoints.archive-venue', $endpoint );

		if ( $register_routes ) {
			tribe_register_rest_route( $this->get_events_route_namespace(), '/venues', [
				'methods'  => WP_REST_Server::READABLE,
				'callback' => [ $endpoint, 'get' ],
				'args'     => $endpoint->READ_args(),
			] );
		}

		tribe( 'tec.rest-v1.endpoints.documentation' )->register_documentation_provider( '/venues', $endpoint );
	}

	/**
	 * Builds and hooks the organizer archives endpoint
	 *
	 * @since 4.6
	 *
	 * @param bool $register_routes Whether routes for the endpoint should be registered or not.
	 *
	 */
	protected function register_organizer_archives_endpoint( $register_routes = true ) {
		$messages        = tribe( 'tec.rest-v1.messages' );
		$post_repository = tribe( 'tec.rest-v1.repository' );
		$validator       = tribe( 'tec.rest-v1.validator' );
		$endpoint        = new Tribe__Events__REST__V1__Endpoints__Archive_Organizer( $messages, $post_repository, $validator );

		tribe_singleton( 'tec.rest-v1.endpoints.archive-organizer', $endpoint );

		if ( $register_routes ) {
			tribe_register_rest_route( $this->get_events_route_namespace(), '/organizers', [
				'methods'  => WP_REST_Server::READABLE,
				'callback' => [ $endpoint, 'get' ],
				'args'     => $endpoint->READ_args(),
			] );
		}

		tribe( 'tec.rest-v1.endpoints.documentation' )->register_documentation_provider( '/organizers', $endpoint );
	}

	/**
	 * Builds and hooks the event categories archives endpoint
	 *
	 * @since 4.6
	 *
	 * @param bool $register_routes Whether routes for the endpoint should be registered or not.
	 */
	protected function register_categories_endpoint( $register_routes ) {
		$messages         = tribe( 'tec.rest-v1.messages' );
		$post_repository  = tribe( 'tec.rest-v1.repository' );
		$validator        = tribe( 'tec.rest-v1.validator' );
		$terms_controller = new WP_REST_Terms_Controller( Tribe__Events__Main::TAXONOMY );
		$archive_endpoint = new Tribe__Events__REST__V1__Endpoints__Archive_Category( $messages, $post_repository, $validator, $terms_controller );
		$single_endpoint  = new Tribe__Events__REST__V1__Endpoints__Single_Category( $messages, $post_repository, $validator, $terms_controller );

		tribe_singleton( 'tec.rest-v1.endpoints.archive-category', $archive_endpoint );

		if ( $register_routes ) {
			$namespace = $this->get_events_route_namespace();

			tribe_register_rest_route(
				$namespace,
				'/categories',
				[
					[
						'methods'             => WP_REST_Server::READABLE,
						'callback'            => [ $archive_endpoint, 'get' ],
						'args'                => $archive_endpoint->READ_args(),
						'permission_callback' => '__return_true',
					],
					[
						'methods'             => WP_REST_Server::CREATABLE,
						'args'                => $single_endpoint->CREATE_args(),
						'permission_callback' => [ $single_endpoint, 'can_create' ],
						'callback'            => [ $single_endpoint, 'create' ],
					],
				]
			);

			tribe_register_rest_route(
				$namespace,
				'/categories/(?P<id>\\d+)',
				[
					[
						'methods'             => WP_REST_Server::READABLE,
						'callback'            => [ $single_endpoint, 'get' ],
						'args'                => $single_endpoint->READ_args(),
						'permission_callback' => '__return_true',
					],
					[
						'methods'             => WP_REST_Server::EDITABLE,
						'args'                => $single_endpoint->EDIT_args(),
						'permission_callback' => [ $single_endpoint, 'can_edit' ],
						'callback'            => [ $single_endpoint, 'update' ],
					],
					[
						'methods'             => WP_REST_Server::DELETABLE,
						'args'                => $single_endpoint->DELETE_args(),
						'permission_callback' => [ $single_endpoint, 'can_delete' ],
						'callback'            => [ $single_endpoint, 'delete' ],
					],
				]
			);
		}

		$documentation_endpoint = tribe( 'tec.rest-v1.endpoints.documentation' );
		$documentation_endpoint->register_documentation_provider( '/categories', $archive_endpoint );
		$documentation_endpoint->register_documentation_provider( '/categories/{id}', $single_endpoint );
	}

	/**
	 * Builds and hooks the event tags archives endpoint
	 *
	 * @since 4.6
	 *
	 * @param bool $register_routes Whether routes for the endpoint should be registered or not.
	 */
	protected function register_tags_endpoint( $register_routes ) {
		$messages         = tribe( 'tec.rest-v1.messages' );
		$post_repository  = tribe( 'tec.rest-v1.repository' );
		$validator        = tribe( 'tec.rest-v1.validator' );
		$terms_controller = new WP_REST_Terms_Controller( 'post_tag' );
		$archive_endpoint = new Tribe__Events__REST__V1__Endpoints__Archive_Tag( $messages, $post_repository, $validator, $terms_controller );
		$single_endpoint  = new Tribe__Events__REST__V1__Endpoints__Single_Tag( $messages, $post_repository, $validator, $terms_controller );

		tribe_singleton( 'tec.rest-v1.endpoints.archive-category', $archive_endpoint );

		if ( $register_routes ) {
			$namespace = $this->get_events_route_namespace();

			tribe_register_rest_route(
				$namespace,
				'/tags',
				[
					[
						'methods'             => WP_REST_Server::READABLE,
						'callback'            => [ $archive_endpoint, 'get' ],
						'args'                => $archive_endpoint->READ_args(),
						'permission_callback' => '__return_true',
					],
					[
						'methods'             => WP_REST_Server::CREATABLE,
						'args'                => $single_endpoint->CREATE_args(),
						'permission_callback' => [ $single_endpoint, 'can_create' ],
						'callback'            => [ $single_endpoint, 'create' ],
					],
				]
			);

			tribe_register_rest_route(
				$namespace,
				'/tags/(?P<id>\\d+)',
				[
					[
						'methods'             => WP_REST_Server::READABLE,
						'callback'            => [ $single_endpoint, 'get' ],
						'args'                => $single_endpoint->READ_args(),
						'permission_callback' => '__return_true',
					],
					[
						'methods'             => WP_REST_Server::EDITABLE,
						'args'                => $single_endpoint->EDIT_args(),
						'permission_callback' => [ $single_endpoint, 'can_edit' ],
						'callback'            => [ $single_endpoint, 'update' ],
					],
					[
						'methods'             => WP_REST_Server::DELETABLE,
						'args'                => $single_endpoint->DELETE_args(),
						'permission_callback' => [ $single_endpoint, 'can_delete' ],
						'callback'            => [ $single_endpoint, 'delete' ],
					],
				]
			);
		}

		$documentation_endpoint = tribe( 'tec.rest-v1.endpoints.documentation' );
		$documentation_endpoint->register_documentation_provider( '/tags', $archive_endpoint );
		$documentation_endpoint->register_documentation_provider( '/tags/{id}', $single_endpoint );
	}

	/**
	 * Filters the event category taxonomy registration arguments to make it show in REST API requests.
	 *
	 * @since 4.6
	 *
	 * @param array $taxonomy_args
	 *
	 * @return array
	 */
	public function filter_taxonomy_args( array $taxonomy_args ) {
		$taxonomy_args['show_in_rest'] = true;

		return $taxonomy_args;
	}
}
