trypost/app/Actions/PostComment/NotifyMentions.php
Paulo Castellano 3c3b170b21 feat: @mentions in comments, AI Action layer + MCP tools, settings tabs
Mentions in post comments
- @mention autocomplete (workspace members, current user excluded) with
  marker syntax @[uuid] persisted, display names rendered via CommentBody
  chips; live edit replaces markers with names and converts back on save.
- NotifyMentions action with workspace-scoped membership check, dedupes
  same user, only newly-added mentions on update.
- Email + in-app via SendNotification job, respecting per-user
  notification_preferences.mentioned_in_comment.
- Heartbeat-based presence (Cache, 60s TTL, 30s ping) so online recipients
  get only the in-app notification — no email noise.
- Real-time bell on workspace.{id}.user.{id} private channel
  (NotificationCreated event), scoped channel name avoids client-side
  filtering and lays out a convention for future workspace channels.
- Mailable localized via lang/{en,es,pt-BR}/mail.php; Maizzle source
  template for the email is committed and built into resources/views/mail.

AI generation refactor (Action layer + MCP)
- Extracted Actions/Ai/Generate{Image,Video} with QuotaExhaustedException
  so agent tools and MCP tools share a single domain entry point.
- Mcp/Tools/Ai/Generate{Image,Video}Tool registered in TryPostServer; both
  return MediaResource payloads.
- Orientation::imageApiSize maps non-OpenAI ratios to 1:1/2:3/3:2.
- config/ai.php is now the single source of truth driven by env, removing
  the trypost.ai shim. Default text/image providers flipped to OpenAI.

Settings/UX
- /settings/workspace split into shadcn Tabs (Workspace / Brand / Users)
  with three components.
- /assets and the in-editor MediaPicker open the ImagePreviewDialog
  lightbox on image click while preserving action button behaviour.
- Comments tab landed via ?tab=comments&comment=<id> from notification
  click (scroll-to + temporary highlight).
- Mention autocomplete popover flips above when near the viewport bottom.
- Real social platform PNGs replace Tabler brand glyphs in schedule
  pills and post list, with hover tooltip carrying display_name + handle.

Bug fixes
- AcceptInvite: controller now passes workspace + role payload that the
  Vue page expects; login/register CTAs preselect the invite email.
- WorkspaceInvite mailable: stopped referencing nonexistent
  $invite->workspace and $invite->role; column added to the migration,
  Invite model casts role to WorkspaceRole, CreateInvite persists it.
- PostCommentCreated: added broadcastAs so .PostCommentCreated actually
  matches the Echo listener; payload now includes mentioned_users so
  receivers render the chip correctly without a refetch.
- Preview components for X/Pinterest/Threads/Bluesky/LinkedIn/Mastodon/
  TikTok/YouTube switched from item.type === 'image' to
  !isVideoMedia(item) so media without a persisted type still renders.
- UpdatePostRequest now accepts media.*.{type,mime_type,size,...} so the
  posts.media JSON keeps the metadata that the previews need.
- Removed throttle:6,1 from social connect routes (was 429ing legitimate
  OAuth retries).
- Used MediaType enum cases instead of literal 'image'/'video' strings
  when creating media rows.

Tests
- MentionParser unit tests, NotifyMentions feature tests including
  online/offline channel selection and preference gating, MCP AI tool
  happy paths, MentionedInComment mailable rendering, AcceptInvite +
  search-members + index mentioned_users path. 1229 passing.
2026-05-01 20:59:03 -03:00

95 lines
3 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Actions\PostComment;
use App\Enums\Notification\Channel;
use App\Enums\Notification\Type;
use App\Jobs\SendNotification;
use App\Mail\MentionedInComment;
use App\Models\PostComment;
use App\Models\User;
use App\Support\MentionParser;
use App\Support\WorkspacePresence;
use Illuminate\Support\Str;
final class NotifyMentions
{
/**
* Dispatch in-app + email notifications for every workspace member that has
* been mentioned in `$comment->body` but was not mentioned in the previous
* body. The comment author is never notified about their own mention.
*/
public static function execute(PostComment $comment, ?string $previousBody = null): void
{
$newIds = MentionParser::extractUserIds($comment->body ?? '');
if (empty($newIds)) {
return;
}
$previousIds = $previousBody !== null ? MentionParser::extractUserIds($previousBody) : [];
$diff = array_values(array_diff($newIds, $previousIds, [$comment->user_id]));
if (empty($diff)) {
return;
}
$post = $comment->post()->with('workspace')->first();
if (! $post || ! $post->workspace) {
return;
}
$workspace = $post->workspace;
$eligibleUsers = $workspace->members()
->whereIn('users.id', $diff)
->get();
if ($eligibleUsers->isEmpty()) {
return;
}
$author = $comment->user()->first();
if (! $author instanceof User) {
return;
}
$excerpt = Str::limit(self::stripMarkers($comment->body ?? ''), 140);
foreach ($eligibleUsers as $member) {
// If the recipient is currently active in the workspace (heartbeat
// within the last minute), they will see the in-app notification
// immediately — skip the email to avoid noise.
$online = WorkspacePresence::isOnline($workspace->id, $member->id);
$channel = $online ? Channel::InApp : Channel::Both;
SendNotification::dispatch(
user: $member,
workspaceId: $workspace->id,
type: Type::MentionedInComment,
channel: $channel,
title: "{$author->name} mentioned you",
body: $excerpt,
data: [
'post_id' => $post->id,
'comment_id' => $comment->id,
'parent_id' => $comment->parent_id,
'author_id' => $comment->user_id,
'author_name' => $author->name,
],
mailable: $online ? null : new MentionedInComment(
comment: $comment,
author: $author,
excerpt: $excerpt,
),
);
}
}
private static function stripMarkers(string $body): string
{
return trim((string) preg_replace('/@\[[0-9a-fA-F-]{36}\]/', '@…', $body));
}
}