Struct NpmRegistry 

pub struct NpmRegistry { /* private fields */ }

Client for interacting with the npm registry.

Uses the npm registry API for package metadata and search. All requests are cached via the provided HttpCache.

Implementations

impl NpmRegistry

pub const fn new(cache: Arc<HttpCache>) -> NpmRegistry

Creates a new npm registry client with the given HTTP cache.

pub async fn get_versions( &self, name: &str, ) -> Result<Vec<NpmVersion>, DepsError>

Fetches all versions for a package from the npm registry.

Returns versions sorted newest-first. Includes deprecated versions.

Errors

Returns an error if:

• HTTP request fails
• Response body is invalid UTF-8
• JSON parsing fails
• Package does not exist

Examples

let cache = Arc::new(HttpCache::new());
let registry = NpmRegistry::new(cache);

let versions = registry.get_versions("express").await.unwrap();
assert!(!versions.is_empty());

pub async fn get_latest_matching( &self, name: &str, req_str: &str, ) -> Result<Option<NpmVersion>, DepsError>

Finds the latest version matching the given npm semver requirement.

Only returns non-deprecated versions.

Errors

Returns an error if:

• HTTP request fails
• Package does not exist

Examples

let cache = Arc::new(HttpCache::new());
let registry = NpmRegistry::new(cache);

let latest = registry.get_latest_matching("express", "^4.0.0").await.unwrap();
assert!(latest.is_some());

pub async fn search( &self, query: &str, limit: usize, ) -> Result<Vec<NpmPackage>, DepsError>

Searches for packages by name/keywords.

Returns up to limit results sorted by relevance.

Errors

Returns an error if:

• HTTP request fails
• JSON parsing fails

Examples

let cache = Arc::new(HttpCache::new());
let registry = NpmRegistry::new(cache);

let results = registry.search("express", 10).await.unwrap();
assert!(!results.is_empty());

Trait Implementations

impl Clone for NpmRegistry

fn clone(&self) -> NpmRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl PackageRegistry for NpmRegistry

type Version = NpmVersion

Version information type for this registry.

type Metadata = NpmPackage

Metadata type for search results.

type VersionReq = Range

Version requirement type (e.g., semver::VersionReq for Cargo, npm semver for npm).

fn get_versions<'life0, 'life1, 'async_trait>( &'life0 self, name: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<<NpmRegistry as PackageRegistry>::Version>, DepsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, NpmRegistry: 'async_trait,

Fetches all available versions for a package.

fn get_latest_matching<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, name: &'life1 str, req: &'life2 <NpmRegistry as PackageRegistry>::VersionReq, ) -> Pin<Box<dyn Future<Output = Result<Option<<NpmRegistry as PackageRegistry>::Version>, DepsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, NpmRegistry: 'async_trait,

Finds the latest version matching a version requirement.

fn search<'life0, 'life1, 'async_trait>( &'life0 self, query: &'life1 str, limit: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<<NpmRegistry as PackageRegistry>::Metadata>, DepsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, NpmRegistry: 'async_trait,

Searches for packages by name or keywords.

impl Registry for NpmRegistry

fn get_versions<'life0, 'life1, 'async_trait>( &'life0 self, name: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<Box<dyn Version>>, DepsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, NpmRegistry: 'async_trait,

Fetches all available versions for a package.

fn get_latest_matching<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, name: &'life1 str, req: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Box<dyn Version>>, DepsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, NpmRegistry: 'async_trait,

Finds the latest version matching a version requirement.

fn search<'life0, 'life1, 'async_trait>( &'life0 self, query: &'life1 str, limit: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<Box<dyn Metadata>>, DepsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, NpmRegistry: 'async_trait,

Searches for packages by name or keywords.

fn package_url(&self, name: &str) -> String

Package URL for ecosystem (e.g., https://crates.io/crates/serde)

fn as_any(&self) -> &(dyn Any + 'static)

Downcast to concrete registry type for ecosystem-specific operations