unsupervised-scheduler/src/Policy/Policy.php

<?php
declare(strict_types=1);

namespace Unsupervised\Schedular\Policy;

use Unsupervised\Schedular\Val;

class Policy {

	public const SCOPE_SIGNUP  = 'signup';
	public const SCOPE_BOOKING = 'booking';
	public const SCOPE_BOTH    = 'both';

	/**
	 * All valid acceptance scopes — when a policy must be accepted.
	 *
	 * @var list<string>
	 */
	public const VALID_SCOPES = [ self::SCOPE_SIGNUP, self::SCOPE_BOOKING, self::SCOPE_BOTH ];

	public function __construct(
		public readonly string $title,
		public readonly string $slug,
		public readonly ?int $currentVersionId = null,
		public readonly string $acceptanceScope = self::SCOPE_BOOKING,
		public readonly ?int $id = null,
	) {}

	public static function fromRow( \stdClass $row ): self {
		return new self(
			title:            Val::string( $row->title ),
			slug:             Val::string( $row->slug ),
			currentVersionId: Val::intOrNull( $row->current_version_id ),
			acceptanceScope:  Val::string( $row->acceptance_scope ),
			id:               Val::int( $row->id ),
		);
	}

	/**
	 * Whether this policy must be accepted in the given gate (`signup` or `booking`).
	 */
	public function appliesTo( string $scope ): bool {
		return $this->acceptanceScope === $scope || self::SCOPE_BOTH === $this->acceptanceScope;
	}

	/**
	 * Returns a plain array representation of the policy.
	 *
	 * @return array<string, mixed>
	 */
	public function toArray(): array {
		return [
			'id'                 => $this->id,
			'title'              => $this->title,
			'slug'               => $this->slug,
			'current_version_id' => $this->currentVersionId,
			'acceptance_scope'   => $this->acceptanceScope,
		];
	}
}