<?php
/**
 * Wertobjekt eines Content-Jobs.
 *
 * @package Aivor\Content
 */

namespace Aivor\Content\Job;

defined( 'ABSPATH' ) || exit;

/**
 * Ein Content-Job verbindet einen Aivor-Job mit einem Ziel in WordPress.
 */
final class Job {

	/**
	 * Import als Entwurf; ein Mensch veroeffentlicht.
	 *
	 * @var string
	 */
	public const MODE_DRAFT = 'draft';

	/**
	 * Import als „Ausstehender Review" fuer Redaktionen mit Freigabeprozess.
	 *
	 * @var string
	 */
	public const MODE_PENDING = 'pending';

	/**
	 * Baut den Job.
	 *
	 * @param int    $id                 Lokale ID, 0 fuer einen noch nicht gespeicherten Job.
	 * @param string $aivor_job_id       Import-Job-ID aus der Aivor-Oberflaeche (UUID).
	 * @param string $post_type          Ziel-Post-Type.
	 * @param string $taxonomy           Ziel-Taxonomie, leer fuer keine Zuordnung.
	 * @param int    $term_id            Ziel-Term.
	 * @param int    $author_id          Autor, 0 fuer den Standard-Autor.
	 * @param string $mode               Einer der MODE_-Werte.
	 * @param bool   $enable_comments    Kommentare zulassen.
	 * @param string $error              Letzte Fehlermeldung, leer wenn fehlerfrei.
	 * @param int    $last_import        Zeitpunkt des letzten Imports.
	 * @param string $site_hash          Site-Hash aus der letzten Lieferung.
	 * @param string $remote_name        Name des Jobs in Aivor (nur Anzeige).
	 * @param string $remote_site_url    In Aivor hinterlegte Website-Adresse (nur Anzeige).
	 * @param string $remote_status      Ergebnis der letzten Statusabfrage.
	 * @param int    $checked_at         Zeitpunkt der letzten Statusabfrage.
	 */
	public function __construct(
		public readonly int $id = 0,
		public readonly string $aivor_job_id = '',
		public readonly string $post_type = 'post',
		public readonly string $taxonomy = '',
		public readonly int $term_id = 0,
		public readonly int $author_id = 0,
		public readonly string $mode = self::MODE_DRAFT,
		public readonly bool $enable_comments = false,
		public readonly string $error = '',
		public readonly int $last_import = 0,
		public readonly string $site_hash = '',
		public readonly string $remote_name = '',
		public readonly string $remote_site_url = '',
		public readonly string $remote_status = '',
		public readonly int $checked_at = 0
	) {}

	/**
	 * Baut einen Job aus dem gespeicherten Array.
	 *
	 * @param array<string, mixed> $data Rohdaten aus der Option.
	 * @return self
	 */
	public static function from_array( array $data ): self {
		$mode = isset( $data['mode'] ) ? (string) $data['mode'] : self::MODE_DRAFT;

		return new self(
			isset( $data['id'] ) ? (int) $data['id'] : 0,
			isset( $data['aivor_job_id'] ) ? (string) $data['aivor_job_id'] : '',
			isset( $data['post_type'] ) ? (string) $data['post_type'] : 'post',
			isset( $data['taxonomy'] ) ? (string) $data['taxonomy'] : '',
			isset( $data['term_id'] ) ? (int) $data['term_id'] : 0,
			isset( $data['author_id'] ) ? (int) $data['author_id'] : 0,
			in_array( $mode, self::modes(), true ) ? $mode : self::MODE_DRAFT,
			! empty( $data['enable_comments'] ),
			isset( $data['error'] ) ? (string) $data['error'] : '',
			isset( $data['last_import'] ) ? (int) $data['last_import'] : 0,
			isset( $data['site_hash'] ) ? (string) $data['site_hash'] : '',
			isset( $data['remote_name'] ) ? (string) $data['remote_name'] : '',
			isset( $data['remote_site_url'] ) ? (string) $data['remote_site_url'] : '',
			isset( $data['remote_status'] ) ? (string) $data['remote_status'] : '',
			isset( $data['checked_at'] ) ? (int) $data['checked_at'] : 0
		);
	}

	/**
	 * Die gueltigen Modi.
	 *
	 * Importierte Beitraege gehen nie ohne menschliche Freigabe online: Die
	 * Review-Checkliste von WordPress.org fuehrt automatisch postende Plugins
	 * als Grey-Hat-SEO. Ein frueher gespeicherter Modus „publish" wird beim
	 * Lesen zum Entwurf.
	 *
	 * @return string[]
	 */
	public static function modes(): array {
		return array( self::MODE_DRAFT, self::MODE_PENDING );
	}

	/**
	 * Wandelt den Job in ein speicherbares Array.
	 *
	 * @return array<string, mixed>
	 */
	public function to_array(): array {
		return array(
			'id'              => $this->id,
			'aivor_job_id'    => $this->aivor_job_id,
			'post_type'       => $this->post_type,
			'taxonomy'        => $this->taxonomy,
			'term_id'         => $this->term_id,
			'author_id'       => $this->author_id,
			'mode'            => $this->mode,
			'enable_comments' => $this->enable_comments,
			'error'           => $this->error,
			'last_import'     => $this->last_import,
			'site_hash'       => $this->site_hash,
			'remote_name'     => $this->remote_name,
			'remote_site_url' => $this->remote_site_url,
			'remote_status'   => $this->remote_status,
			'checked_at'      => $this->checked_at,
		);
	}

	/**
	 * Liefert eine Kopie mit geaenderten Feldern.
	 *
	 * @param array<string, mixed> $changes Zu setzende Felder.
	 * @return self
	 */
	public function with( array $changes ): self {
		return self::from_array( array_merge( $this->to_array(), $changes ) );
	}
}