trypost/app/Http/Controllers/Api/AssetController.php

44 lines
1.2 KiB
PHP
Raw Normal View History

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 20:08:20 +00:00
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Api;
use App\Actions\Media\FindWorkspaceAsset;
use App\Actions\Media\ListWorkspaceAssets;
use App\Http\Requests\Api\Asset\IndexAssetRequest;
use App\Http\Resources\Api\AssetResource;
use App\Models\Media;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
use Symfony\Component\HttpFoundation\Response;
class AssetController extends Controller
{
public function index(IndexAssetRequest $request): AnonymousResourceCollection
{
$workspace = $request->user()->currentWorkspace;
$this->authorize('createPost', $workspace);
return AssetResource::collection(ListWorkspaceAssets::execute(
$workspace,
data_get($request->validated(), 'search'),
data_get($request->validated(), 'type'),
));
}
public function show(Request $request, Media $media): AssetResource
{
$workspace = $request->user()->currentWorkspace;
$this->authorize('createPost', $workspace);
$asset = FindWorkspaceAsset::execute($workspace, $media->id);
abort_if($asset === null, Response::HTTP_NOT_FOUND);
return new AssetResource($asset);
}
}