ldc-boutique-cnc-sable/shared/Pagination/PageSize.php

<?php

declare(strict_types=1);

namespace Shared\Pagination;

use Shared\DDD\Equatable;

/**
 * Value object representing a page size in pagination.
 */
final readonly class PageSize implements \JsonSerializable, \Stringable, Equatable
{
    public const int DEFAULT_SIZE = 25;

    /** ERR_TOO_MANY_RECORDS fixed to 10k */
    public const int MAX_PAGE_SIZE = 10000;

    public function __construct(
        public int $value = self::DEFAULT_SIZE,
    ) {
        if ($this->value <= 0) {
            throw new \InvalidArgumentException('Page size must be greater than 0');
        }

        if ($this->value > self::MAX_PAGE_SIZE) {
            throw new \InvalidArgumentException('Page size must be less than or equal to ' . self::MAX_PAGE_SIZE);
        }
    }

    public static function of(int $value): self
    {
        return new self($value);
    }

    public static function default(): self
    {
        return new self(self::DEFAULT_SIZE);
    }

    public function value(): int
    {
        return $this->value;
    }

    public function equals(mixed $other): bool
    {
        return $other instanceof self && $this->value === $other->value;
    }

    public function __toString(): string
    {
        return (string) $this->value;
    }

    public function jsonSerialize(): int
    {
        return $this->value;
    }
}