Struct TrustedDocumentStore 

pub struct TrustedDocumentStore { /* private fields */ }

Trusted document lookup store.

Backed by a DashMap: lookups on the request hot path take only a per-shard read lock, never an async lock, and hot-reload (the only writer) replaces entries in place without blocking concurrent readers on other shards.

Implementations

impl TrustedDocumentStore

pub fn from_manifest_file( path: &Path, mode: TrustedDocumentMode, ) -> Result<Self, TrustedDocumentError>

Load from a JSON manifest file at startup.

Errors

Returns an error if the file cannot be read or parsed.

pub fn from_documents( documents: HashMap<String, String>, mode: TrustedDocumentMode, ) -> Self

Create an in-memory store from a pre-built document map (for testing).

pub fn disabled() -> Self

A disabled store that passes all queries through (permissive, empty).

pub const fn mode(&self) -> TrustedDocumentMode

Returns the enforcement mode.

pub fn document_count(&self) -> usize

Returns the number of documents in the manifest.

pub fn replace_documents(&self, documents: HashMap<String, String>)

Replace the document map (used by hot-reload).

The swap is per-shard atomic — readers may observe the old or the new contents but never a torn entry. Brief inconsistency across shards during a reload is acceptable: a request that resolves a document that has just been removed will simply 404 and the client will retry.

pub fn resolve( &self, document_id: Option<&str>, raw_query: Option<&str>, ) -> Result<String, TrustedDocumentError>

Resolve a query from document_id and/or raw_query.

• document_id present + found → return stored query body.
• document_id present + NOT found → DocumentNotFound.
• No document_id in strict mode → ForbiddenRawQuery.
• No document_id in permissive mode → return raw_query.

Errors

Returns TrustedDocumentError::DocumentNotFound if a document_id is given but not in the store. Returns TrustedDocumentError::ForbiddenRawQuery if no document_id is provided in strict mode, or if raw_query is also absent in permissive mode.