npm Registry API Client

@yorganci/npm-registry-api is a fully typesafe npm registry API client with optional caching.

Features

• Validates registry responses using zod.
• Supports response caching with unstorage.
• Compatible with both Node.js and browser environments.
• Works seamlessly with third-party npm-compatible registries.

Useful Links

• npm registry API for REST API docs.
• ohash docs for serializing cache keys.
• unstorage drivers for caching layer.

Usage

Install @yorganci/npm-registry-api npm package:

# yarn
yarn add @yorganci/npm-registry-api

# npm
npm install @yorganci/npm-registry-api

# pnpm
pnpm add @yorganci/npm-registry-api

Basic usage

import { Client } from "@yorganci/npm-registry-api";

const client = new Client();

await client.searchPackages({ text: "react", size: 1 });

npm Registry API

| Function Name | Description | | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- | | getAbbreviatedPackument | Fetches abbreviated packument (package document) containing only the metadata necessary to install a package. | | getBulkDailyPackageDownloads | Retrieves the total number of downloads for each day for some packages in the given time period. | | getBulkPackageDownloads | Fetches the total number of downloads for the given packages in the given time period. | | getDailyPackageDownloads | Retrieves the total number of downloads for each day for a package in the given time period. | | getDailyRegistryDownloads | Gets the total number of downloads for each day for all packages in the registry in the given time period. | | getPackageDownloads | Fetches total number of downloads for a package in the given time period. | | getPackageManifest | Retrieves the manifest describing a specific version of a package (e.g., [email protected]). | | getPackageVersionsDownloads | Gets the total number of downloads for each version of a package in the previous 7 days. | | getPackument | Fetches full packument (package document) containing all the metadata available about a package. | | getRegistryDownloads | Retrieves total number of downloads for all packages in the registry in the given time period. | | getRegistryMetadata | Fetches metadata describing the registry itself. | | getRegistrySigningKeys | Retrieves public signing keys used by the registry. | | searchPackages | Searches packages corresponding to a given query. |

Caching API

@yorganci/npm-registry-api/cache module provides basic factory function to create Cache object to be used by Client. By default createCache, uses ohash under the hood to generate cache keys from URL and HTTP headers and any Driver implementation from unstorage can be used for persistance the default is unstorage/drivers/memory.

Basic usage with default options.

import { Client } from "@yorganci/npm-registry-api";
import { createCache } from "@yorganci/npm-registry-api/cache";

// By default `Map<string, unknown>` is used as caching layer
const cachedClient = new Client({
  cache: createCache(),
});

Create a file-system backed cache client.

import { Client } from "@yorganci/npm-registry-api";
import { createCache } from "@yorganci/npm-registry-api/cache";
import fs from "unstorage/drivers/fs";

const cachedClient = new Client({
  cache: createCache({
    storage: fs({
      base: "./data",
    }),
  }),
});

License

MIT