Lets ChatGPT (MCP) and external clients (REST API) drive the full lifecycle of
a post — create with platform selection, attach media from URLs, schedule or
publish immediately, and fetch engagement metrics — without touching the web UI.
MCP tools added: UpdatePostTool, PublishPostTool, AttachMediaFromUrlTool,
ListContentTypesTool, GetPostMetricsTool, PreviewPostTool. CreatePostTool now
accepts platforms[] + scheduled_at + label_ids; ListPostsTool gains
status/search/limit filters.
REST endpoints added: POST /api/posts/{post}/media, GET /api/posts/{post}/metrics,
GET /api/posts/{post}/preview, GET /api/content-types.
Also fixes a silent CreatePost::execute bug — the action validated platforms[]
but ignored it, so REST callers never saw their selection persisted. Adds cross
validation rules (ContentTypeMatchesPlatform / ContentTypeMatchesPostPlatform)
so a LinkedIn account can't be saddled with x_post, and rejects inactive social
accounts during validation instead of failing silently downstream.
Shared services (PostMetricsFetcher, PostPreviewer, MediaAttacher) back both
MCP tools and REST controllers so behaviour stays aligned. New Resources
(PlatformContentTypesResource, PostMetricsResource, PostPreviewResource,
PostMediaAttachResource) keep controllers free of inline model mapping.
Suite: 1.332 passing, 0 failing — covers web (PostControllerTest), REST
(PostApiTest, PlatformApiTest, PostMediaApiTest), MCP (66 tool tests), and
the publish job (PublishToSocialPlatformTest).
Removes /docs from git tracking and TIKTOK_REVIEW_VIDEO_SCRIPT.md.
125 lines
3.9 KiB
PHP
125 lines
3.9 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Http\Controllers\Api;
|
|
|
|
use App\Actions\Post\CreatePost;
|
|
use App\Actions\Post\DeletePost;
|
|
use App\Actions\Post\UpdatePost;
|
|
use App\Enums\Post\Action as PostAction;
|
|
use App\Http\Requests\Api\Post\StorePostRequest;
|
|
use App\Http\Requests\Api\Post\UpdatePostRequest;
|
|
use App\Http\Resources\Api\PostMediaAttachResource;
|
|
use App\Http\Resources\Api\PostMetricsResource;
|
|
use App\Http\Resources\Api\PostPreviewResource;
|
|
use App\Http\Resources\Api\PostResource;
|
|
use App\Models\Post;
|
|
use App\Services\Post\MediaAttacher;
|
|
use Illuminate\Http\JsonResponse;
|
|
use Illuminate\Http\Request;
|
|
use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
|
|
use Symfony\Component\HttpFoundation\Response;
|
|
|
|
class PostController extends Controller
|
|
{
|
|
public function index(Request $request): AnonymousResourceCollection
|
|
{
|
|
$posts = $request->user()->currentWorkspace->posts()
|
|
->with(['postPlatforms.socialAccount', 'user', 'labels'])
|
|
->latest('scheduled_at')
|
|
->paginate(15);
|
|
|
|
return PostResource::collection($posts);
|
|
}
|
|
|
|
public function show(Request $request, Post $post): PostResource
|
|
{
|
|
$this->ensurePostInCurrentWorkspace($request, $post);
|
|
|
|
$post->load(['postPlatforms.socialAccount', 'user', 'labels']);
|
|
|
|
return new PostResource($post);
|
|
}
|
|
|
|
public function store(StorePostRequest $request): JsonResponse
|
|
{
|
|
$post = CreatePost::execute(
|
|
$request->user()->currentWorkspace,
|
|
$request->user()->currentWorkspace->owner,
|
|
$request->validated()
|
|
);
|
|
|
|
$post->load(['postPlatforms.socialAccount']);
|
|
|
|
return (new PostResource($post))
|
|
->response()
|
|
->setStatusCode(Response::HTTP_CREATED);
|
|
}
|
|
|
|
public function update(UpdatePostRequest $request, Post $post): PostResource|JsonResponse
|
|
{
|
|
$this->ensurePostInCurrentWorkspace($request, $post);
|
|
|
|
$result = UpdatePost::execute($request->user()->currentWorkspace, $post, $request->validated());
|
|
|
|
if (data_get($result, 'action') === PostAction::AlreadyPublished) {
|
|
return response()->json(
|
|
['message' => 'Cannot edit a published post.'],
|
|
Response::HTTP_UNPROCESSABLE_ENTITY
|
|
);
|
|
}
|
|
|
|
return new PostResource(data_get($result, 'post'));
|
|
}
|
|
|
|
public function destroy(Request $request, Post $post): JsonResponse
|
|
{
|
|
$this->ensurePostInCurrentWorkspace($request, $post);
|
|
|
|
DeletePost::execute($post);
|
|
|
|
return response()->json(null, Response::HTTP_NO_CONTENT);
|
|
}
|
|
|
|
public function attachMedia(Request $request, Post $post): PostMediaAttachResource
|
|
{
|
|
$this->ensurePostInCurrentWorkspace($request, $post);
|
|
|
|
$validated = $request->validate([
|
|
'urls' => ['required', 'array', 'min:1', 'max:10'],
|
|
'urls.*' => ['url:http,https'],
|
|
]);
|
|
|
|
$result = app(MediaAttacher::class)->attachFromUrls($post, $validated['urls']);
|
|
|
|
$post->refresh()->load(['postPlatforms.socialAccount', 'labels']);
|
|
|
|
return new PostMediaAttachResource($post, $result);
|
|
}
|
|
|
|
public function metrics(Request $request, Post $post): PostMetricsResource
|
|
{
|
|
$this->ensurePostInCurrentWorkspace($request, $post);
|
|
|
|
$post->load(['postPlatforms.socialAccount']);
|
|
|
|
return new PostMetricsResource($post);
|
|
}
|
|
|
|
public function preview(Request $request, Post $post): PostPreviewResource
|
|
{
|
|
$this->ensurePostInCurrentWorkspace($request, $post);
|
|
|
|
$post->load(['postPlatforms.socialAccount']);
|
|
|
|
return new PostPreviewResource($post);
|
|
}
|
|
|
|
private function ensurePostInCurrentWorkspace(Request $request, Post $post): void
|
|
{
|
|
if ($post->workspace_id !== $request->user()->currentWorkspace->id) {
|
|
abort(Response::HTTP_NOT_FOUND);
|
|
}
|
|
}
|
|
}
|