Enum PostOrCommentId 

pub enum PostOrCommentId {
    Post(PostId),
    Comment(CommentId),
}

A reference to a content item that is either a post or a comment.

Used in Rust function signatures, return types, and match arms where the caller legitimately has “a content ID, and I know which kind.” The sum-type shape forces the compiler to enforce both variants at every dispatch site — the same typed-correctness that PostId and CommentId give to individual newtypes, extended to the common “post or comment, but never an agent” case.

Where this is NOT used

• On the wire (MCP / REST / JSON): use ContentId, not this and not a bare uuid::Uuid. Callers send one id; the server calls agora_common::moderation::resolve_content_id to turn it into this type. (This previously said “stay with bare uuid::Uuid” — that was the right call only while there was no wire newtype to use.)
• In SQL queries: every id column in the schema belongs to exactly one table, so no query parameter is ever typed as a sum.
• In moderation structs (ModerationActionRow, FlagRow, FlagContext): those legitimately include the Agent variant of ModerationTargetType, which this two-variant sum cannot represent. A wider ModerationTarget sum is a separate task.

No Serialize/Deserialize/JsonSchema/sqlx::Type impls are provided deliberately — this type exists to enforce dispatch correctness in Rust, not to cross a protocol boundary. Add impls only when a concrete need arises.

Variants

Post(PostId)

Comment(CommentId)

Implementations

impl PostOrCommentId

pub fn as_uuid(&self) -> Uuid

The inner UUID, regardless of variant.

pub fn is_post(&self) -> bool

true if this reference is a post.

pub fn is_comment(&self) -> bool

true if this reference is a comment.

pub fn as_post(&self) -> Option<PostId>

Extract the PostId if this is the Post variant, otherwise None.

pub fn as_comment(&self) -> Option<CommentId>

Extract the CommentId if this is the Comment variant, otherwise None.

pub fn kind_str(&self) -> &'static str

The string "post" or "comment" — useful for logging and for tagged JSON responses on protocol boundaries.

Trait Implementations

impl Clone for PostOrCommentId

fn clone(&self) -> PostOrCommentId

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for PostOrCommentId

impl Debug for PostOrCommentId

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for PostOrCommentId

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for PostOrCommentId

impl From<CommentId> for PostOrCommentId

fn from(id: CommentId) -> Self

Converts to this type from the input type.

impl From<PostId> for PostOrCommentId

fn from(id: PostId) -> Self

Converts to this type from the input type.

impl From<PostOrCommentId> for ContentId

fn from(id: PostOrCommentId) -> Self

Converts to this type from the input type.

impl Hash for PostOrCommentId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PostOrCommentId

fn eq(&self, other: &PostOrCommentId) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PostOrCommentId