<?php
/**
 * Registreert de attachment-meta, inclusief REST-schema en permissies.
 *
 * @package Yinga\Focus
 */

declare( strict_types = 1 );

namespace Yinga\Focus\Data;

use Yinga\Focus\Support\Naming;
use Yinga\Focus\Support\Sanitizer;
use Yinga\Focus\Support\Schema;

defined( 'ABSPATH' ) || exit;

final class MetaRegistrar {

	/**
	 * Hangt zichzelf op aan `init`.
	 */
	public function register(): void {
		add_action( 'init', array( $this, 'register_meta' ) );
	}

	/**
	 * Registreert de meta op het attachment-posttype.
	 *
	 * Twee dingen die niet vanzelfsprekend zijn en toch werken:
	 *
	 * 1. De meta verschijnt op /wp/v2/media/{id} hoewel het attachment-posttype
	 *    geen `custom-fields` support heeft. WP_REST_Posts_Controller heeft een
	 *    hardgecodeerde $fixed_schemas-allowlist waarin `attachment` wél
	 *    `custom-fields` bevat, en die gaat vóór post_type_supports(). Roep dus
	 *    NIET add_post_type_support( 'attachment', 'custom-fields' ) aan om dit
	 *    te "repareren" — onnodig, en het geeft admin-UI-bijwerkingen.
	 *
	 * 2. De juiste capability is `edit_post` op de attachment-ID, niet
	 *    `upload_files`. Die laatste mapt alleen `create_posts`.
	 */
	public function register_meta(): void {
		register_post_meta(
			'attachment',
			Naming::META_KEY,
			array(
				'type'              => 'object',
				'single'            => true,
				'default'           => array(),
				'description'       => __( 'Focal point and safe area for responsive cropping.', 'yinga-focus' ),
				'sanitize_callback' => array( Sanitizer::class, 'focus' ),
				'auth_callback'     => array( $this, 'can_edit' ),
				'show_in_rest'      => array(
					'schema' => Schema::rest(),
				),
			)
		);
	}

	/**
	 * Mag de huidige gebruiker de focusdata van deze attachment wijzigen?
	 *
	 * @param bool   $allowed       Wat WordPress zelf dacht.
	 * @param string $meta_key      De meta key.
	 * @param int    $object_id     Attachment-ID.
	 * @return bool
	 */
	public function can_edit( $allowed, $meta_key, $object_id ): bool {
		unset( $allowed, $meta_key );

		return current_user_can( 'edit_post', (int) $object_id );
	}
}