ohdearapp / ohdear-php-sdk

src/Actions/ManagesMaintenancePeriods.php

<?php

namespace OhDear\PhpSdk\Actions;

use OhDear\PhpSdk\Resources\MaintenancePeriod;

trait ManagesMaintenancePeriods
{
    /**
     * @param int $siteId
     *
     * @return array
     */
    public function maintenancePeriods(int $siteId): array
    {
        return $this->transformCollection(

It seems like transformCollection() must be provided by classes using this trait. How about adding it as abstract method to this trait?

            $this->get("sites/{$siteId}/maintenance-periods")['data'],

It seems like get() must be provided by classes using this trait. How about adding it as abstract method to this trait?

            MaintenancePeriod::class
        );
    }

    /**
     * @param int $siteId
     * @param int $stopMaintenanceAfterSeconds Stops after one hour by default
     *
     * @return MaintenancePeriod
     */
    public function startSiteMaintenance(int $siteId, int $stopMaintenanceAfterSeconds = 60 * 60): MaintenancePeriod
    {
        $attributes = $this->post("sites/{$siteId}/start-maintenance", [

It seems like post() must be provided by classes using this trait. How about adding it as abstract method to this trait?

            'stop_maintenance_after_seconds' => $stopMaintenanceAfterSeconds,
        ]);

        return new MaintenancePeriod($attributes, $this);
    }

    /**
     * @param int $siteId
     */
    public function stopSiteMaintenance(int $siteId)
    {
        $this->post("sites/{$siteId}/stop-maintenance");
    }

    /**
     * @param int $siteId
     * @param string $startsAt Y:m:d H:i
     * @param string $endsAt Y:m:d H:i
     *
     * @return MaintenancePeriod
     */
    public function createSiteMaintenance(int $siteId, string $startsAt, string $endsAt): MaintenancePeriod
    {
        $startsAt = $this->convertDateFormat($startsAt, 'Y:m:d H:i');

It seems like convertDateFormat() must be provided by classes using this trait. How about adding it as abstract method to this trait?

        $endsAt = $this->convertDateFormat($endsAt, 'Y:m:d H:i');

        $payload = [
            'site_id' => $siteId,
            'starts_at' => $startsAt,
            'ends_at' => $endsAt,
        ];

        $attributes = $this->post('maintenance-periods', $payload);

        return new MaintenancePeriod($attributes, $this);
    }

    /**
     * @param int $maintenancePeriodId
     */
    public function deleteSiteMaintenance(int $maintenancePeriodId)
    {
        $this->delete("maintenance-periods/{$maintenancePeriodId}");

The method delete() does not exist on OhDear\PhpSdk\Actions\ManagesMaintenancePeriods. Did you maybe mean deleteSiteMaintenance()?

    }
}