npm-local-cache

Creates a local searchable NPM cache. Good for building your own module repo based on NPM.

Functionality:

• Filter on custom keywords (useful for when NPM is used as module repo, like in the case of mongoosejs and breach.cc).
• Customizable search fields.
• Cache time to live (update cache periodically).
• Build from local NPM cache.

Install

npm install --save npm-local-cache

Usage

Either require the library like this:

var cache = require('npm-local-cache')();

.. or pass in an options object to configure. These are the default values:

var cache = require('npm-local-cache')({
    keywords: [],
    searchFields: ['name', 'description', 'keywords'],
    useLocal: true,
    localCachePath: '$HOME/.npm/-/all/.cache.json',
    cachePath: 'node_modules/../cache.json',
    ttl: 86400000,
    writeCache: true
});

(see options details below)

The cache is build lazily, so go ahead and search. Search returns a Promise.

cache.search(query, optionalKeywordArray).then(onSuccess, onError).catch(errHandler);

E.g.

cache.search('json', ['mongoosejs'])
    .then(function (pkgs) {
        // MongooseJS modules pertaining to _json_
        console.log(pkgs);
    }, function (err) {
        console.error(err);
    });

Packages are filtered on keywords first, then based on the query.

You can refresh the cache using refresh() or just let the automatic refresh take place (see ttl below):

cache.refresh();    // returns a promise

Options

keywords: Add one or several keywords to filter packages from NPM. Default: []

searchFields: An array of package fields to do text search on. Legal values: 'name', 'description', 'author', 'keywords', 'dependencies', 'devDependencies'. Default: ['name', 'description', 'keywords']

useLocal: If true the local NPM cache will be used to build the cache, instead of fetching from the NPM server. Default: true

localCachePath: Path to local NPM cache. Unless you changed it will be $HOME/.npm/-/all/.cache.json which is also the default value.

cachePath: The path where to store the cache. By default it is stored in the parent folder of node_modules.

ttl: Time To Live of the cache in millies. After expiring the cache will update on next search() invocation. Default: 86400000

Note that the keywords option that is passed when constructing the cache limits the entire cache to those keywords, whereas the keywords option for the search method will only filter based on the keywords for that one query.