trypost/app/Models/Post.php
Paulo Castellano 335180d7a1 refactor: move post-state concerns out of MediaAttacher
MediaAttacher had grown into a 180-line class with four private
methods doing different things — download, validation, storage,
and post-state mutation. Two of those (lock-and-merge into the
JSON media column, intersection of allowed media types per
platform) are post concerns, not network concerns.

Move them onto the Post model:

  Post::allowedMediaTypes(): array<Type>
      The intersection of media types accepted by every enabled
      platform. Used to be inlined as MediaAttacher::allowedMediaTypesFor.

  Post::appendMedia(array $items): void
      Lock-then-merge into the post's media[] JSON column so
      concurrent writers don't overwrite each other. Used to be
      MediaAttacher::mergeIntoPostMedia.

MediaAttacher now reads cleanly:

  attachFromUrls   — orchestrate (loop URLs, batch the appendMedia)
  attachOne        — download → validate type/size → handoff
  download         — Http::sink + progress abort, returns DTO

Drops to ~120 lines with no nested concerns. The streaming progress
abort uses the same throw-RuntimeException pattern, but now
contained in download() instead of leaking into the orchestrator.
2026-05-04 15:17:48 -03:00

180 lines
4.7 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Models;
use App\DataTransferObjects\MediaItem;
use App\Enums\Media\Type;
use App\Enums\Post\Status as PostStatus;
use Database\Factories\PostFactory;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Casts\Attribute;
use Illuminate\Database\Eloquent\Concerns\HasUuids;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\DB;
class Post extends Model
{
/** @use HasFactory<PostFactory> */
use HasFactory, HasUuids;
protected $fillable = [
'workspace_id',
'user_id',
'content',
'media',
'status',
'scheduled_at',
'published_at',
];
protected function casts(): array
{
return [
'status' => PostStatus::class,
'media' => 'array',
'scheduled_at' => 'datetime',
'published_at' => 'datetime',
];
}
/**
* Get media items as a collection of MediaItem DTOs.
*
* @return Collection<int, MediaItem>
*/
protected function mediaItems(): Attribute
{
return Attribute::make(
get: fn () => collect($this->media ?? [])->map(fn (array $item) => MediaItem::fromArray($item)),
);
}
public function workspace(): BelongsTo
{
return $this->belongsTo(Workspace::class);
}
public function user(): BelongsTo
{
return $this->belongsTo(User::class);
}
public function postPlatforms(): HasMany
{
return $this->hasMany(PostPlatform::class)->orderBy('id');
}
public function comments(): HasMany
{
return $this->hasMany(PostComment::class);
}
public function labels(): BelongsToMany
{
return $this->belongsToMany(WorkspaceLabel::class);
}
public function scopeScheduled(Builder $query): Builder
{
return $query->where('status', PostStatus::Scheduled);
}
public function scopeDue(Builder $query): Builder
{
return $query->scheduled()->where('scheduled_at', '<=', now());
}
public function scopeDraft(Builder $query): Builder
{
return $query->where('status', PostStatus::Draft);
}
public function scopePublished(Builder $query): Builder
{
return $query->whereIn('status', [PostStatus::Published, PostStatus::PartiallyPublished]);
}
public function scopeFailed(Builder $query): Builder
{
return $query->where('status', PostStatus::Failed);
}
public function markAsPublishing(): void
{
$this->update(['status' => PostStatus::Publishing]);
}
public function markAsPublished(): void
{
$this->update([
'status' => PostStatus::Published,
'published_at' => now(),
]);
}
public function markAsPartiallyPublished(): void
{
$this->update([
'status' => PostStatus::PartiallyPublished,
'published_at' => now(),
]);
}
public function markAsFailed(): void
{
$this->update(['status' => PostStatus::Failed]);
}
/**
* MediaTypes accepted by this post — the intersection of what every
* enabled platform allows. With no platform enabled, accept anything.
*
* @return array<Type>
*/
public function allowedMediaTypes(): array
{
$platforms = $this->postPlatforms()
->where('enabled', true)
->with('socialAccount')
->get()
->pluck('socialAccount.platform')
->filter();
if ($platforms->isEmpty()) {
return Type::cases();
}
$sets = $platforms
->map(fn ($platform) => array_map(fn ($type) => $type->value, $platform->allowedMediaTypes()))
->all();
return array_map(
Type::from(...),
array_values(array_intersect(...$sets)),
);
}
/**
* Append items to the JSON `media` column under a row lock so
* concurrent writers don't overwrite each other's appends.
*
* @param array<int, array<string, mixed>> $items
*/
public function appendMedia(array $items): void
{
DB::transaction(function () use ($items): void {
$fresh = static::whereKey($this->id)->lockForUpdate()->first();
$fresh->update([
'media' => collect($fresh->media ?? [])->concat($items)->all(),
]);
$this->setRawAttributes($fresh->getAttributes(), true);
});
}
}