<?php
/**
 * Per-viewer edit links for report rows.
 *
 * @package BlockSieve
 */

namespace BlockSieve\Admin;

use BlockSieve\Monitor\Occurrence;

/**
 * Resolves the edit link of an occurrence's location for the current user.
 *
 * The report is cached and shared by everyone who can open it, while
 * get_edit_post_link() depends on the user asking. Post-backed locations are
 * therefore resolved when displayed; the cached URL is used for the rest
 * (templates, widgets), whose links are not capability-dependent.
 */
final class EditLink {

	/**
	 * Source kinds whose source id is a post id.
	 */
	private const POST_KINDS = array(
		Occurrence::SOURCE_POST,
		Occurrence::SOURCE_PATTERN,
		Occurrence::SOURCE_NAVIGATION,
	);

	/**
	 * Returns the edit URL for the current user ('' when unavailable).
	 *
	 * @param Occurrence $occurrence Occurrence.
	 * @return string
	 */
	public static function for_occurrence( Occurrence $occurrence ): string {
		if ( in_array( $occurrence->source_kind, self::POST_KINDS, true ) && ctype_digit( $occurrence->source_id ) ) {
			return (string) get_edit_post_link( (int) $occurrence->source_id, 'raw' );
		}

		return $occurrence->edit_url;
	}
}