Enum InternalPayload 

pub enum InternalPayload<'a> {
    Truth(&'a str),
    Lie(&'a str),
}

Zero-allocation internal payload for SOC logging.

Returned by InternalContext::payload(). This type borrows from the underlying context and allows loggers to format output without heap allocation.

Variants

• Truth(&str): Authentic diagnostic message
• Lie(&str): Deceptive message (should be prefixed in logs)

Performance

The borrowed lifetime ties this to the parent InternalContext, preventing accidental persistence of sensitive data beyond the logging operation.

No Copy Policy

While this type only contains &str (which is Copy), we deliberately do not derive Copy to maintain consistency with the module’s no-duplication philosophy. Use Clone if you need to store the payload temporarily.

Usage Pattern

match context.payload() {
    Some(InternalPayload::Truth(msg)) => soc_log!("DIAG: {}", msg),
    Some(InternalPayload::Lie(msg)) => soc_log!("LIE: {}", msg),
    None => {
        // Sensitive - requires explicit access
        let access = SocAccess::acquire();
        if let Some(sensitive) = context.expose_sensitive(&access) {
            secure_log_encrypted(sensitive);
        }
    }
}

Variants

Truth(&'a str)

Lie(&'a str)

Implementations

impl<'a> InternalPayload<'a>

pub const fn as_str(&self) -> &'a str

Get the raw message content without classification prefix.

Returns

Borrowed string slice from the parent context. Valid until the InternalContext is dropped.

Note

This does NOT include [LIE] prefix. Use the Display implementation if you want formatted output with classification markers.

pub const fn is_lie(&self) -> bool

Check if this payload represents deceptive content.

Returns

• true: This is a lie, should be marked in logs
• false: This is authentic diagnostic data

Use Case

For conditional log routing or metrics collection based on deception status.

Trait Implementations

impl<'a> Clone for InternalPayload<'a>

fn clone(&self) -> InternalPayload<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for InternalPayload<'a>

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

Formats the value using the given formatter.

impl<'a> Display for InternalPayload<'a>

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

Format payload with classification prefix for logging.

Output Format

• Truth: Raw message (no prefix)
• Lie: [LIE] {message}

Rationale

The [LIE] prefix prevents SOC analysts from mistaking deceptive content for authentic diagnostic data when reviewing logs. This is critical when logs may be exported to systems that lack context classification.