eb2b345163
* 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>
99 lines
3 KiB
PHP
99 lines
3 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Actions\Post;
|
|
|
|
use App\Actions\Media\FindWorkspaceAsset;
|
|
use App\Models\Media;
|
|
use App\Models\Post;
|
|
use App\Support\PostStatusRules;
|
|
use Illuminate\Support\Facades\DB;
|
|
use Illuminate\Validation\ValidationException;
|
|
|
|
class AttachExistingAsset
|
|
{
|
|
public const UNSUPPORTED_TYPE_MESSAGE = 'This file type is not supported by the platforms enabled on the post.';
|
|
|
|
public const ASSET_NOT_FOUND_MESSAGE = 'Asset not found.';
|
|
|
|
/**
|
|
* Append a snapshot of the workspace asset to the post exactly once.
|
|
*/
|
|
public static function execute(Post $post, Media $media, ?string $alt = null): void
|
|
{
|
|
DB::transaction(function () use ($post, $media, $alt): void {
|
|
$fresh = Post::query()->whereKey($post->id)->lockForUpdate()->firstOrFail();
|
|
|
|
if (PostStatusRules::blocksEditing($fresh)) {
|
|
throw ValidationException::withMessages([
|
|
'asset_id' => PostStatusRules::editBlockedMessage(),
|
|
]);
|
|
}
|
|
|
|
$workspace = $fresh->workspace;
|
|
|
|
if ($workspace === null) {
|
|
throw ValidationException::withMessages([
|
|
'asset_id' => self::ASSET_NOT_FOUND_MESSAGE,
|
|
]);
|
|
}
|
|
|
|
$asset = FindWorkspaceAsset::execute($workspace, $media->id, lockForUpdate: true);
|
|
|
|
if ($asset === null) {
|
|
throw ValidationException::withMessages([
|
|
'asset_id' => self::ASSET_NOT_FOUND_MESSAGE,
|
|
]);
|
|
}
|
|
|
|
if (! in_array($asset->type, $fresh->allowedMediaTypes(), true)) {
|
|
throw ValidationException::withMessages([
|
|
'asset_id' => self::UNSUPPORTED_TYPE_MESSAGE,
|
|
]);
|
|
}
|
|
|
|
$alreadyAttached = collect($fresh->media ?? [])
|
|
->contains(fn (array $row): bool => data_get($row, 'id') === $asset->id);
|
|
|
|
if ($alreadyAttached) {
|
|
$post->setRawAttributes($fresh->getAttributes(), true);
|
|
|
|
return;
|
|
}
|
|
|
|
$fresh->update([
|
|
'media' => collect($fresh->media ?? [])->push(self::snapshot($asset, $alt))->all(),
|
|
]);
|
|
$post->setRawAttributes($fresh->getAttributes(), true);
|
|
});
|
|
}
|
|
|
|
/**
|
|
* @return array<string, mixed>
|
|
*/
|
|
private static function snapshot(Media $media, ?string $alt): array
|
|
{
|
|
$item = [
|
|
'id' => $media->id,
|
|
'path' => $media->path,
|
|
'url' => $media->url,
|
|
'type' => $media->type->value,
|
|
'mime_type' => $media->mime_type,
|
|
'original_filename' => $media->original_filename,
|
|
'size' => $media->size,
|
|
];
|
|
|
|
$meta = is_array($media->meta) ? $media->meta : [];
|
|
|
|
if (filled($alt) && $media->isImage()) {
|
|
$meta['alt_text'] = $alt;
|
|
}
|
|
|
|
if ($meta !== []) {
|
|
$item['meta'] = $meta;
|
|
}
|
|
|
|
return $item;
|
|
}
|
|
}
|