Enum InvalidationReason 

#[non_exhaustive]
pub enum InvalidationReason {
    Mutation {
        mutation_name: String,
    },
    Manual {
        reason: String,
    },
    SchemaChange {
        old_version: String,
        new_version: String,
    },
}

Reason for cache invalidation.

Used for structured logging and debugging to understand why cache entries were invalidated.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Mutation

Invalidation triggered by a GraphQL mutation.

Contains the mutation name that modified the data.

Fields

mutation_name: String

Name of the mutation (e.g., “createUser”, “updatePost”)

Manual

Manual invalidation by administrator or system.

Contains a custom reason string for audit logging.

Fields

reason: String

Human-readable reason (e.g., “maintenance”, “data import”)

SchemaChange

Schema change requiring cache flush.

Triggered when the schema version changes (e.g., after deployment).

Fields

old_version: String

Old schema version

new_version: String

New schema version

Implementations

impl InvalidationReason

pub fn to_log_string(&self) -> String

Format reason as a log-friendly string.

Example

use fraiseql_core::cache::InvalidationReason;

let reason = InvalidationReason::Mutation {
    mutation_name: "createUser".to_string()
};

assert_eq!(
    reason.to_log_string(),
    "mutation:createUser"
);

Trait Implementations

impl Clone for InvalidationReason

fn clone(&self) -> InvalidationReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InvalidationReason

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

Formats the value using the given formatter.