<?php
/**
 * Das Titelbild eines importierten Beitrags.
 *
 * @package Aivor\Content
 */

namespace Aivor\Content\Media;

use Aivor\Content\Import\DraftMapping;

defined( 'ABSPATH' ) || exit;

/**
 * Laedt das gelieferte Bild in die Mediathek und setzt es als Titelbild.
 *
 * Der Download laeuft ueber download_url() und damit ueber wp_safe_remote_get(), das Anfragen an
 * interne Adressen ablehnt — der SSRF-Schutz aus dem fachlichen Konzept 7.6
 * ist damit erledigt. Den Dateityp prueft media_handle_sideload() ueber
 * wp_check_filetype_and_ext(); der Endung in der URL wird nicht geglaubt.
 */
final class FeaturedImage {

	/**
	 * Laedt das Bild und setzt es als Titelbild.
	 *
	 * @param int    $post_id Beitrag.
	 * @param string $url     Bildadresse aus der Lieferung.
	 * @param string $title   Titel des Beitrags, fuer Dateiname und Alternativtext.
	 * @return int Anhang-ID.
	 * @throws \RuntimeException Wenn das Bild nicht geladen werden konnte.
	 */
	public static function attach( int $post_id, string $url, string $title ): int {
		if ( 'https' !== wp_parse_url( $url, PHP_URL_SCHEME ) && 'http' !== wp_parse_url( $url, PHP_URL_SCHEME ) ) {
			throw new \RuntimeException( 'the image address is not an http(s) URL' );
		}

		// Im Cron-Kontext fehlen die Admin-Includes; ohne sie endet
		// media_handle_sideload() mit einem Fatal Error (technisches Konzept 10).
		require_once ABSPATH . 'wp-admin/includes/file.php';
		require_once ABSPATH . 'wp-admin/includes/media.php';
		require_once ABSPATH . 'wp-admin/includes/image.php';

		$temp_file = download_url( $url, 30 );

		if ( is_wp_error( $temp_file ) ) {
			throw new \RuntimeException( esc_html( $temp_file->get_error_message() ) );
		}

		$file_array = array(
			'name'     => self::file_name( $temp_file, $title ),
			'tmp_name' => $temp_file,
		);

		$attachment_id = media_handle_sideload( $file_array, $post_id, $title );

		if ( is_wp_error( $attachment_id ) ) {
			wp_delete_file( $temp_file );

			throw new \RuntimeException( esc_html( $attachment_id->get_error_message() ) );
		}

		update_post_meta( $attachment_id, '_wp_attachment_image_alt', wp_slash( $title ) );
		update_post_meta( $attachment_id, DraftMapping::AI_GENERATED, 1 );
		set_post_thumbnail( $post_id, $attachment_id );

		return (int) $attachment_id;
	}

	/**
	 * Ein Dateiname mit der Endung, die zum tatsaechlichen Inhalt passt.
	 *
	 * Der Weg ueber media_sideload_image() verlangt eine Bildendung in der URL; Aivor
	 * liefert Bilder auch ohne. Deshalb wird die Endung aus dem Inhalt
	 * bestimmt.
	 *
	 * @param string $temp_file Heruntergeladene Datei.
	 * @param string $title     Beitragstitel.
	 * @return string
	 */
	private static function file_name( string $temp_file, string $title ): string {
		$extensions = array(
			'image/jpeg' => 'jpg',
			'image/png'  => 'png',
			'image/gif'  => 'gif',
			'image/webp' => 'webp',
			'image/avif' => 'avif',
		);

		$mime      = (string) wp_get_image_mime( $temp_file );
		$extension = $extensions[ $mime ] ?? 'jpg';
		$base      = sanitize_title( $title );

		if ( '' === $base ) {
			$base = 'aivor-image';
		}

		return substr( $base, 0, 80 ) . '.' . $extension;
	}
}