Open-source social media scheduler built for AI agents and the teams behind them. Create, schedule and publish posts to every network through MCP or the REST API, or write them yourself in a composer your team will love.
PHP ai-agentsblueskyfacebookinstagramlaravellinkedinmastodonmcpmcp-serveropen-sourcerest-apiself-hostedsocial-mediasocial-media-managementsocial-media-schedulerthreadstiktokvuejsxyoutube
<?php
declare(strict_types=1);
namespace App\Support\Analytics;
use App\Dto\Analytics\DateRange;
use App\Enums\User\WeekStart;
class PeriodBuckets
{
public function resolution(DateRange $range): string
{
return match (true) {
$range->days() <= 14 => 'daily',
$range->days() <= 90 => 'weekly',
default => 'monthly',
};
}
/**
* @param 'daily'|'weekly'|'monthly'|null $resolution Defaults to the resolution the range length picks.
* @return list<array{start: string, end: string}>
*/
public function for(DateRange $range, WeekStart $weekStart, ?string $resolution = null): array
{
$resolution ??= $this->resolution($range);
$cursor = $range->start;
$buckets = [];
while ($cursor->lessThanOrEqualTo($range->end)) {
$boundary = match ($resolution) {
'weekly' => $cursor->endOfWeek($weekStart->lastDay()),
'monthly' => $cursor->endOfMonth(),
default => $cursor,
};
$last = $boundary->lessThan($range->end) ? $boundary : $range->end;
$buckets[] = [
'start' => $cursor->toDateString(),
'end' => $last->toDateString(),
];
$cursor = $last->addDay()->startOfDay();
}
return $buckets;
}
}