<?php
/**
 * Value object: one "connected project" — a GitHub repo (typically a
 * Lovable or Bolt.new GitHub-sync target) that Esipher keeps a build workflow and
 * webhook wired into, plus the WordPress theme slug it converts into.
 *
 * @package Esipher
 */

namespace Esipher;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Plain data holder, persisted/restored by Project_Store as an array
 * (see to_array()/from_array()) — never queried directly against the
 * GitHub API itself, that's Github_Api_Client's job.
 */
class Connected_Project {

	/**
	 * Stable identifier, derived from owner/repo (see Project_Store::
	 * id_for()). Not GitHub's own repo ID, so it survives a repo
	 * rename lookup mismatch gracefully (worst case: treated as a new
	 * project, never silently merged with an unrelated one).
	 *
	 * @var string
	 */
	public $id = '';

	/**
	 * GitHub account/org that owns the repo.
	 *
	 * @var string
	 */
	public $owner = '';

	/**
	 * Repo name (without owner/).
	 *
	 * @var string
	 */
	public $repo = '';

	/**
	 * Branch this project tracks — the one the builder's GitHub sync
	 * actually pushes to. Almost always 'main', but not assumed.
	 *
	 * @var string
	 */
	public $branch = 'main';

	/**
	 * Theme slug this project converts into. Passed as
	 * Converter::convert()'s preferred_slug on every sync, so repeat
	 * syncs update the same theme/pages rather than piling up copies.
	 *
	 * @var string
	 */
	public $theme_slug = '';

	/**
	 * Whether the very first successful sync should activate the
	 * theme immediately. Subsequent syncs never re-run this — once
	 * live, later syncs update the already-active theme in place.
	 *
	 * @var bool
	 */
	public $activate_on_first_sync = true;

	/**
	 * Whether Esipher should try to recover cloud-hosted images (see
	 * Converter's own 'recover_images' option) on every sync.
	 *
	 * @var bool
	 */
	public $recover_images = false;

	/**
	 * GitHub's numeric ID for the webhook this project created, so it
	 * can be deleted again on disconnect. Null until the webhook is
	 * actually created.
	 *
	 * @var int|null
	 */
	public $webhook_id = null;

	/**
	 * Per-project shared secret used to verify GitHub's
	 * X-Hub-Signature-256 header on incoming webhook deliveries —
	 * never reused across projects, so one leaking never implicates
	 * another.
	 *
	 * @var string
	 */
	public $webhook_secret = '';

	/**
	 * Git commit SHA of the last push this project successfully
	 * converted. Used both to skip redundant work (a webhook or cron
	 * check for a run already at this SHA is a no-op) and to detect,
	 * from the cron safety-net check, whether a webhook delivery was
	 * ever missed.
	 *
	 * @var string
	 */
	public $last_synced_sha = '';

	/**
	 * MySQL datetime (site timezone) of the last successful sync, or
	 * '' if never synced yet.
	 *
	 * @var string
	 */
	public $last_synced_at = '';

	/**
	 * One of 'connected' (workflow + webhook installed, no build has
	 * completed yet), 'synced' (at least one successful conversion),
	 * 'update_ready' (a newer successful build is waiting for an administrator
	 * to apply it), or 'error' (the last sync attempt failed — see $last_error).
	 *
	 * @var string
	 */
	public $status = 'connected';

	/**
	 * Human-readable detail for the last failed sync, shown in the
	 * admin project list. Cleared on the next successful sync.
	 *
	 * @var string
	 */
	public $last_error = '';

	/**
	 * ID of the newest successful GitHub Actions run whose build has not
	 * been applied to this site yet. Set by the webhook / cron check; the
	 * theme is only ever written when a logged-in administrator clicks
	 * "Apply update", never directly by an incoming request.
	 *
	 * @var int
	 */
	public $pending_run_id = 0;

	/**
	 * Commit SHA of the build in $pending_run_id.
	 *
	 * @var string
	 */
	public $pending_sha = '';

	/**
	 * @return array<string,mixed>
	 */
	public function to_array() {
		return array(
			'id'                     => $this->id,
			'owner'                  => $this->owner,
			'repo'                   => $this->repo,
			'branch'                 => $this->branch,
			'theme_slug'             => $this->theme_slug,
			'activate_on_first_sync' => $this->activate_on_first_sync,
			'recover_images'         => $this->recover_images,
			'webhook_id'             => $this->webhook_id,
			'webhook_secret'         => $this->webhook_secret,
			'last_synced_sha'        => $this->last_synced_sha,
			'last_synced_at'         => $this->last_synced_at,
			'status'                 => $this->status,
			'last_error'             => $this->last_error,
			'pending_run_id'         => $this->pending_run_id,
			'pending_sha'            => $this->pending_sha,
		);
	}

	/**
	 * @param array<string,mixed> $data As produced by to_array().
	 *
	 * @return self
	 */
	public static function from_array( array $data ) {
		$project = new self();

		foreach ( $data as $key => $value ) {
			if ( property_exists( $project, $key ) ) {
				$project->$key = $value;
			}
		}

		return $project;
	}

	/**
	 * @return string "owner/repo", the form GitHub's API and UI both use.
	 */
	public function full_name() {
		return $this->owner . '/' . $this->repo;
	}
}