Struct QueryAccessContext 

#[non_exhaustive]
pub struct QueryAccessContext<'a> {
    pub collection: &'a str,
    pub operation: QueryOperationKind,
    pub principal: Option<&'a str>,
    pub tenant_hint: Option<&'a str>,
}

Read-time context handed to the read-path hook.

A borrowed view over the resolved query: it carries exactly what an access-control decision needs and nothing premium-specific (Requirement 1.7, 3.4). Borrowing means no allocation on the fast path.

principal and tenant_hint are opaque, caller-supplied strings; core never interprets their meaning — it only forwards them to the observer.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

collection: &'a str

Target collection name.

operation: QueryOperationKind

Which read path is executing.

principal: Option<&'a str>

Opaque caller-supplied principal hint (e.g. user id / api-key id), passed through untouched for the observer to interpret.

tenant_hint: Option<&'a str>

Opaque caller-supplied tenant hint, passed through untouched.

Implementations

impl<'a> QueryAccessContext<'a>

pub fn from_query(query: &'a Query) -> Self

Builds a read-path QueryAccessContext from a resolved query.

Borrows the collection name from query.select.from and derives the QueryOperationKind from the query shape. principal and tenant_hint are left unset here: they are opaque, caller-supplied hints that core never derives from the query itself, so callers that have them populate the context after construction.

Trait Implementations

impl<'a> Clone for QueryAccessContext<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for QueryAccessContext<'a>

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

Formats the value using the given formatter.