Struct Subject 

pub struct Subject {
    pub did: String,
    pub at_uri: Option<String>,
    pub cid: Option<String>,
}

Subject of a label apply / negate call.

ATProto subjects have three coordinates:

• DID (always required): the account’s DID. For account-level labels this is the only relevant field.
• AT-URI (optional): present when the label targets a specific record (e.g., at://did:plc:.../app.bsky.feed.post/abc). Absent for account-level labels.
• CID (optional): present when the label pins a specific record version. Absent when the label targets all versions of a record OR the account.

The convention mirrors v1.5’s crate::labels::emission::ActionForEmission’s embedded (subject_did, subject_uri, cid) triple, but without the action-stream context fields. v1.7 trait callers project from whatever domain shape they have (the recorder’s RecordActionRequest, an ActionForEmission, or operator CLI input) into this minimal identity.

Validation

Construction is unconditional — the type doesn’t enforce that did.starts_with("did:") or that at_uri parses as AT-URI. v1.7 trait implementations validate at the wire boundary (the backend’s HTTP request layer in #86–#90); pre-validation lives in the recorder’s crate::writer’s route_subject helper for the recordAction path. The trait callers may call this type’s constructors with already-validated inputs.

Fields

did: String

Account DID. Always present. Account-level labels target this DID directly; record-level labels still attribute to the parent account via this field for strike-state rollup (the same convention subject_actions.subject_did uses in v1.4-v1.6).

at_uri: Option<String>

AT-URI for record-level labels. None for account-level labels.

cid: Option<String>

CID for record-version-pinned labels. None for “all versions of this record” or for account-level labels.

Implementations

impl Subject

pub fn account(did: impl Into<String>) -> Self

Construct a Subject from a DID with no record-level or version-level qualification. Use this for account-level label targets.

pub fn record( did: impl Into<String>, at_uri: impl Into<String>, cid: Option<String>, ) -> Self

Construct a Subject for a record (versioned or not). at_uri should be a full at://did:.../collection/rkey URI; the parent repo DID is supplied separately so callers don’t have to re-parse the URI to recover it. Pass cid = None to label all versions; pass cid = Some(...) to pin a specific record version.

pub fn is_account_level(&self) -> bool

true when the subject is account-level (no AT-URI). Convenience for trait implementations that branch on account-vs-record path.

Trait Implementations

impl Clone for Subject

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Subject

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Subject

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Subject

impl Hash for Subject

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 Subject

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Subject

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Subject