API ReferenceEvent Referencecommunity.mention.created.v1

community.mention.created.v1

community.mention.created.v1 — fired when @mention extraction on a post or comment resolves a handle to a user_id. Drives the in-app alerts inbox + web-push fanout (deep link to /feed/{post_id}#comment-{subject_id}).

Constant

import { EVENT_NAMES } from "@platform/contracts";
 
EVENT_NAMES.COMMUNITY_MENTION_CREATED_V1;

Publishers

Subscribers

No service currently subscribes to this event.

Payload schema

z.object({
  post_id: z.string(),
  subject_user_id: z.string(),
  subject_kind: z.enum(["post", "comment"]).default("post"),
  subject_id: z.string().optional(),
  mentioned_user_id: z.string(),
  snippet: z.string().max(280).optional(),
  community_id: z.string().optional(),
  occurred_at: z.string(),
}

Delivery semantics

  • At-least-once delivery. Consumers must dedupe by event ID.
  • Fanned out to both NATS (in-cluster) and EventBridge (durable). See Events concept.