<?php
/**
 * Numeric catalogue ceilings for one install zip.
 *
 * @package Bookline
 */

declare( strict_types=1 );

namespace Bookline\Domain\Edition;

/**
 * 0 on a dimension means unlimited. There is no licensed/unlicensed flag.
 *
 * @since 0.26.0
 */
final class EditionLimits {

	/**
	 * Constructor.
	 *
	 * @param string $id                Payload identity for the admin SPA.
	 * @param int    $max_services      Service ceiling, or 0.
	 * @param int    $max_agents        Agent ceiling, or 0.
	 * @param int    $max_locations     Location ceiling, or 0.
	 * @param int    $max_booking_forms Form ceiling, or 0.
	 */
	public function __construct(
		private readonly string $id,
		private readonly int $max_services,
		private readonly int $max_agents,
		private readonly int $max_locations,
		private readonly int $max_booking_forms,
	) {}

	/**
	 * No numeric cap on any dimension (tests and paid-pack overlays).
	 */
	public static function unlimited(): self {
		return new self( 'uncapped', 0, 0, 0, 0 );
	}

	/**
	 * Zip identity.
	 */
	public function id(): string {
		return $this->id;
	}

	/**
	 * Ceiling for a dimension. 0 means unlimited.
	 *
	 * @param EditionDimension $dimension Dimension.
	 */
	public function max( EditionDimension $dimension ): int {
		return match ( $dimension ) {
			EditionDimension::Service => $this->max_services,
			EditionDimension::Agent => $this->max_agents,
			EditionDimension::Location => $this->max_locations,
			EditionDimension::BookingForm => $this->max_booking_forms,
		};
	}

	/**
	 * Whether another row may be created.
	 *
	 * @param EditionDimension $dimension     Dimension.
	 * @param int              $current_count Non-deleted rows already stored.
	 */
	public function allows_another( EditionDimension $dimension, int $current_count ): bool {
		$max = $this->max( $dimension );
		if ( $max < 1 ) {
			return true;
		}
		return $current_count < $max;
	}

	/**
	 * Clamp a desired seed/target count to this edition.
	 *
	 * @param EditionDimension $dimension Dimension.
	 * @param int              $desired   Requested count.
	 */
	public function cap( EditionDimension $dimension, int $desired ): int {
		$max = $this->max( $dimension );
		if ( $max < 1 ) {
			return max( 0, $desired );
		}
		return max( 0, min( $desired, $max ) );
	}

	/**
	 * Public payload for the admin SPA. 0 means unlimited.
	 *
	 * @return array{id: string, services: int, agents: int, locations: int, bookingForms: int}
	 */
	public function to_public_array(): array {
		return [
			'id'           => $this->id,
			'services'     => $this->max_services,
			'agents'       => $this->max_agents,
			'locations'    => $this->max_locations,
			'bookingForms' => $this->max_booking_forms,
		];
	}
}