<?php
/**
 * Value object for one map configuration.
 *
 * @package Mapsemble
 */

namespace Mapsemble;

/**
 * One `mapsemble_map` post, hydrated.
 *
 * Config posts are source-only: they exist to project a post type onto the
 * public features feed, which the Mapsemble service fetches server-to-server.
 * Maps whose locations live on Mapsemble need no config post at all — they
 * embed directly by map id.
 *
 * `hosted` mode survives on legacy posts from before 0.3: such a post keeps
 * rendering the bare embed and keeps being refused on the feed, and can be
 * explicitly converted. It is also the sanitizer's fail-closed default for
 * unreadable mode meta, so a corrupt value can never open the public feed.
 *
 * The map's *design* — fields, filters, styling, cards — belongs to Mapsemble
 * either way. WordPress owns only where the data comes from.
 */
final class MapConfig {

	public const SOURCE_METABOX   = 'metabox';
	public const SOURCE_ACF       = 'acf';
	public const SOURCE_META_KEYS = 'meta_keys';

	/**
	 * Locations live in Mapsemble; this site serves nothing.
	 */
	public const MODE_HOSTED = 'hosted';

	/**
	 * Locations are this site's posts, served on the features feed.
	 */
	public const MODE_WORDPRESS = 'wordpress';

	/**
	 * Constructor.
	 *
	 * @param int    $id              Post id of the `mapsemble_map` post, 0 when unsaved.
	 * @param string $label           Human-readable label (the post title).
	 * @param string $map_id          Remote Mapsemble map id.
	 * @param string $mode            MODE_HOSTED or MODE_WORDPRESS.
	 * @param string $post_type         Post type served to the map in WordPress mode.
	 * @param string $location_source   Where coordinates come from (SOURCE_*).
	 * @param string $acf_field         ACF field key when source is 'acf'.
	 * @param array  $static_conditions Always-on filter rows restricting the feed.
	 * @param array  $filter_mappings   Remote filter slug → {field, operator}, keyed by slug.
	 * @param array  $sort_mappings     Remote orderBy slug → sort row, keyed by slug.
	 * @param array  $properties        Custom GeoJSON property rows.
	 * @param string $lat_meta_key      Latitude meta key when source is 'meta_keys'.
	 * @param string $lng_meta_key      Longitude meta key when source is 'meta_keys'.
	 */
	public function __construct(
		public int $id,
		public string $label,
		public string $map_id,
		public string $mode = self::MODE_HOSTED,
		public string $post_type = 'post',
		public string $location_source = self::SOURCE_METABOX,
		public string $acf_field = '',
		public array $static_conditions = array(),
		public array $filter_mappings = array(),
		public array $sort_mappings = array(),
		public array $properties = array(),
		public string $lat_meta_key = '',
		public string $lng_meta_key = ''
	) {
	}

	/**
	 * Whether this map's locations live in Mapsemble.
	 *
	 * Everything downstream keys on this rather than on the absence of a
	 * source, because switching to hosted deliberately *keeps* the post type
	 * and location source so switching back is lossless — stale source
	 * configuration outlives the switch by design.
	 */
	public function is_hosted(): bool {
		return self::MODE_HOSTED === $this->mode;
	}

	/**
	 * The sort the widget is booted with.
	 *
	 * The first configured sort mapping's slug, or null when none is bound.
	 * Seeded as `orderBy` so the widget's own data source and the server-
	 * rendered card list request the same ordered set: two loaders of one
	 * feed must agree on the order, or the cards and the markers disagree
	 * on what comes first. Mirrors the Drupal module.
	 */
	public function initial_order_by(): ?string {
		$slug = array_key_first( $this->sort_mappings );
		return null === $slug ? null : (string) $slug;
	}
}