Struct Resolver 

pub struct Resolver { /* private fields */ }

The NAP resolver — resolves URIs to manifests or subtrees.

Implementations

impl Resolver

pub fn new(base_path: &Path) -> Self

Create a resolver that looks for repository repos under base_path.

Uses LoreBackend::from_env() by default when a version-control backend is configured for base_path (i.e. a valid provider.toml exists). Otherwise repositories are opened in unversioned mode. For testing, use Resolver::with_vcs_factory() with a mock backend.

Uses ResolveConfig::default() — meaning default_branch is None. In versioned mode any resolve that omits both branch and commit will fail with NapError::NoDefaultBranch; in unversioned mode such a resolve reads the current filesystem state.

Example layout

base_path/
├── toystory/    ← repository repo
├── toystory/    ← repository repo
└── marvel/      ← repository repo

pub fn with_vcs_factory( base_path: &Path, factory: fn() -> Box<dyn VcsBackend>, config: ResolveConfig, ) -> Self

Create a resolver with a custom VCS backend factory and config.

Repositories are always opened in versioned mode.

pub fn with_source(self, source: ResolveSource) -> Self

Override the resolver’s default source. Primarily useful to callers that need an explicit local working-tree read.

pub fn resolve( &self, uri_str: &str, options: &ResolveOptions, ) -> Result<ResolveResult, NapError>

Resolve a NAP URI string with options.

Examples

// Full manifest
resolver.resolve("nap://toystory/character/woody", &Default::default())

// Without scheme (auto-normalized)
resolver.resolve("toystory/character/woody", &Default::default())

// With branch
resolver.resolve("nap://toystory/character/woody", &ResolveOptions {
    branch: Some("canon".to_string()),
    ..Default::default()
})

// With fragment query (via URI)
resolver.resolve("nap://toystory/character/woody#references.appears_in", &Default::default())

pub async fn presign_representation( &self, uri_str: &str, representation_name: &str, options: &PresignOptions, ) -> Result<PresignedRepresentation, NapError>

Create a time-limited public URL for a direct, committed representation.

uri_str identifies the entity (for example, 25th-chapter/character/nathan-gunn, with an optional nap:// prefix). representation_name is its manifest representation key, such as item. The representation URI is relative to the entity’s asset directory.

The returned URL is a bearer capability. Callers must not log it or persist it beyond expires_at.

pub fn resolve_uri( &self, uri: &NapUri, options: &ResolveOptions, ) -> Result<ResolveResult, NapError>

Resolve a parsed NAP URI with options.

pub fn query(&self, uri_str: &str, path: &str) -> Result<Value, NapError>

Convenience: query a specific path on a URI.

pub fn list_repositories(&self) -> Result<Vec<String>, NapError>

List all repositories available.

pub fn list_remote_entities( &self, repository: &str, entity_type: &EntityType, ) -> Result<Vec<String>, NapError>

List entity YAMLs from the default branch of the configured Lore server.

pub fn list_remote_manifest_paths( &self, repository: &str, ) -> Result<Vec<String>, NapError>

List repository-relative entity manifest paths from the default branch.

pub fn list_remote_branches( &self, repository: &str, ) -> Result<Vec<String>, NapError>

pub fn remote_head_hash(&self, repository: &str) -> Result<String, NapError>

pub fn remote_history( &self, uri: &NapUri, limit: usize, ) -> Result<Vec<CommitInfo>, NapError>