trypost/database/factories/MediaFactory.php
Paulo Castellano eb2b345163
feat: Asset Library list, preview, and attach via API and MCP (#282)
* feat: list, preview, and attach Asset Library media via API and MCP

Let API and MCP clients reuse workspace assets instead of re-uploading, sharing the same scoped query, signed preview, and idempotent attach path.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Align Asset Library API and MCP with main media patterns.

Drop the signed-preview stack, return Storage URLs and PostResource like existing attach flows, and query medias by morph owner instead of getMedia().

Co-authored-by: Cursor <cursoragent@cursor.com>

* Paginate workspace assets with the app default page size.

Keep list pagination in the action via config('app.pagination.default') instead of a hardcoded API page size.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Move asset API and MCP input rules into FormRequests.

Keep controllers and tools free of inline field validation; MCP tools reuse the request rule definitions.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Document asset MCP tools with explicit parameters and constraints.

Spell out workspace scope, return fields, sibling tools, and rejection cases so agents can call list/get/attach without guessing.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Harden asset attach against races and keep library metadata on the post.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Relock the library asset on attach so a deleted file cannot land on the post.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Document that omitting alt on attach keeps the library alt text.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-16 17:08:20 -03:00

84 lines
2.2 KiB
PHP

<?php
declare(strict_types=1);
namespace Database\Factories;
use App\Enums\Media\Type as MediaType;
use App\Models\Media;
use Illuminate\Database\Eloquent\Factories\Factory;
/**
* @extends Factory<Media>
*/
class MediaFactory extends Factory
{
protected $model = Media::class;
/**
* Define the model's default state.
*
* @return array<string, mixed>
*/
public function definition(): array
{
return [
'collection' => 'default',
'type' => MediaType::Image,
'path' => 'media/'.now()->format('Y-m').'/'.$this->faker->uuid().'.jpg',
'original_filename' => $this->faker->word().'.jpg',
'mime_type' => 'image/jpeg',
'size' => $this->faker->numberBetween(10000, 5000000),
'order' => 0,
'meta' => [
'width' => 1920,
'height' => 1080,
],
];
}
public function video(): static
{
return $this->state(fn (array $attributes) => [
'type' => MediaType::Video,
'path' => 'media/'.now()->format('Y-m').'/'.$this->faker->uuid().'.mp4',
'original_filename' => $this->faker->word().'.mp4',
'mime_type' => 'video/mp4',
'meta' => [
'duration' => $this->faker->numberBetween(10, 300),
],
]);
}
public function assets(): static
{
return $this->state(fn (array $attributes) => [
'collection' => 'assets',
]);
}
public function document(): static
{
return $this->state(fn (array $attributes) => [
'type' => MediaType::Document,
'path' => 'media/'.now()->format('Y-m').'/'.$this->faker->uuid().'.pdf',
'original_filename' => $this->faker->word().'.pdf',
'mime_type' => 'application/pdf',
'meta' => [],
]);
}
public function logo(): static
{
return $this->state(fn (array $attributes) => [
'collection' => 'logo',
]);
}
public function avatar(): static
{
return $this->state(fn (array $attributes) => [
'collection' => 'avatar',
]);
}
}