Struct TrustedDocumentStore 

pub struct TrustedDocumentStore { /* private fields */ }

Trusted document lookup store.

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 async fn document_count(&self) -> usize

Returns the number of documents in the manifest.

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

Atomically replace the document map (used by hot-reload).

pub async 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.