feat(services): add public holidays states infra

app/Services/WorkingDays/PublicHolidays/PublicHolidaysStateDeterminer.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\WorkingDays\PublicHolidays;
+
+use App\Models\NonWorkingDays;
+use App\Services\WorkingDays\PublicHolidays\Storage\PublicHolidaysStorageInterface;
+use App\Services\WorkingDays\WorkingDayDeterminerInterface;
+
+class PublicHolidaysStateDeterminer implements PublicHolidaysStateDeterminerInterface, PublicHolidaysStateStorageInterface, WorkingDayDeterminerInterface
+{
+    public function __construct(
+        protected readonly PublicHolidaysStorageInterface $publicHolidaysStorage,
+        protected readonly string $country
+    ) {
+    }
+
+    public function isPublicHoliday(\DateTimeImmutable $publicHolidayDate): bool
+    {
+        return $this->publicHolidaysStorage->isPublicHoliday($this->country, $publicHolidayDate);
+    }
+
+    public function storePublicHoliday(\DateTimeImmutable $publicHolidayDate): ?NonWorkingDays
+    {
+        return $this->publicHolidaysStorage->storePublicHoliday($this->country, $publicHolidayDate);
+    }
+
+    public function isWorkingDay(\DateTimeImmutable $date): bool
+    {
+        return !$this->isPublicHoliday($date);
+    }
+
+    public function getPublicHolidaysInInterval(\DateTimeImmutable $startDate, \DateTimeImmutable $endDate): array
+    {
+        return $this->publicHolidaysStorage->getPublicHolidaysInInterval($this->country, $startDate, $endDate);
+    }
+
+    public function getWorkingDaysCount(\DateTimeImmutable $startDate, int $workingDays): int
+    {
+        return $workingDays - $this->publicHolidaysStorage->countPublicHolidaysInInterval($this->country, $startDate, $startDate->add(new \DateInterval(sprintf('P%dD', $workingDays))));
+    }
+}

app/Services/WorkingDays/PublicHolidays/PublicHolidaysStateDeterminerInterface.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\WorkingDays\PublicHolidays;
+
+use App\Models\NonWorkingDays;
+
+/**
+ * Interface for determining public holidays in a given interval/day.
+ */
+interface PublicHolidaysStateDeterminerInterface
+{
+    /**
+     * Checks if a given date is a public holiday.
+     * @param \DateTimeImmutable $publicHolidayDate
+     * @return bool
+     */
+    public function isPublicHoliday(\DateTimeImmutable $publicHolidayDate): bool;
+
+    /**
+     * Check if is a public holiday in a given interval.
+     * @param \DateTimeImmutable $startDate
+     * @param \DateTimeImmutable $endDate
+     * @return array<NonWorkingDays>
+     */
+    public function getPublicHolidaysInInterval(\DateTimeImmutable $startDate, \DateTimeImmutable $endDate): array;
+}

app/Services/WorkingDays/PublicHolidays/PublicHolidaysStateFactory.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\WorkingDays\PublicHolidays;
+
+use App\Services\WorkingDays\PublicHolidays\Storage\PublicHolidaysStorageInterface;
+use App\Services\WorkingDays\WorkingDayDeterminerInterface;
+
+class PublicHolidaysStateFactory
+{
+    public function __construct(
+        private readonly PublicHolidaysStorageInterface $holidaysStorage,
+    ) {
+    }
+
+    public function createStoreForCountry(string $countryCode): PublicHolidaysStateStorageInterface
+    {
+        return $this->getStateImpl($countryCode);
+    }
+
+    public function createDeterminerForCountry(string $countryCode): PublicHolidaysStateDeterminerInterface&WorkingDayDeterminerInterface
+    {
+        return $this->getStateImpl($countryCode);
+    }
+
+    /**
+     * @param string $countryCode
+     * @return PublicHolidaysStateDeterminer
+     */
+    protected function getStateImpl(string $countryCode): PublicHolidaysStateDeterminer
+    {
+        return new PublicHolidaysStateDeterminer($this->holidaysStorage, $countryCode);
+    }
+}