feat(api): support pre-realized specifiers as specs (#62)

Fixes: #22

extract.js

@@ -36,8 +36,11 @@ function extractByDigest (dest, opts) {
 }
 
 function extractByManifest (spec, dest, opts) {
+  const res = typeof spec === 'string'
+  ? rps(spec, opts.where)
+  : BB.resolve(spec)
   const xtractor = extractStream(dest, opts)
-  return rps(spec).then(res => {
+  return res.then(res => {
     const tarball = require('./lib/handlers/' + res.type + '/tarball')
     return pipe(tarball(res, opts), xtractor)
   })

lib/util/opt-check.js

@@ -24,6 +24,7 @@ function PacoteOptions (opts) {
   this.registry = opts.registry || 'https://registry.npmjs.org'
   this.retry = opts.retry // for npm-registry-client
   this.scope = opts.scope
+  this.where = opts.where
 
   this.uid = opts.uid
   this.gid = opts.gid

manifest.js

@@ -12,7 +12,11 @@ module.exports = manifest
 function manifest (spec, opts) {
   opts = optCheck(opts)
 
-  return rps(spec).then(res => {
+  const res = typeof spec === 'string'
+  ? rps(spec, opts.where)
+  : BB.resolve(spec)
+
+  return res.then(res => {
     const fetcher = (
       handlers[res.type] ||
       (

prefetch.js

@@ -30,7 +30,10 @@ function prefetch (spec, opts) {
 }
 
 function prefetchByManifest (spec, opts) {
-  return rps(spec).then(res => {
+  const res = typeof spec === 'string'
+  ? rps(spec, opts.where)
+  : BB.resolve(spec)
+  return res.then(res => {
     const stream = require('./lib/handlers/' + res.type + '/tarball')(res, opts)
     setImmediate(() => stream.on('data', function () {}))
     return finished(stream)

test/extract.js

@@ -0,0 +1,10 @@
+'use strict'
+
+const test = require('tap').test
+
+test('parses string specs into specifiers')
+test('accepts realized package specifiers')
+test('dispatches a different handler based on spec type')
+test('looks up the manifest for the given spec')
+test('extracts given spec to a target directory')
+test('skips manifest fetching of opts.digest in cache')

test/manifest.js

@@ -0,0 +1,8 @@
+'use strict'
+
+const test = require('tap').test
+
+test('parses string specs into specifiers')
+test('accepts realized package specifiers')
+test('dispatches a different handler based on spec type')
+test('returns a finalized manifest object')

test/prefetch.js

@@ -0,0 +1,9 @@
+'use strict'
+
+const test = require('tap').test
+
+test('parses string specs into specifiers')
+test('accepts realized package specifiers')
+test('dispatches a different tarball handler based on spec type')
+test('exits early if not given `opts.cache`')
+test('exits early if `opts.digest` is already in cache')