feat: add prepare function

This implements most of the logic found in `read-package-json`, except
for the index.js/comments parsing that we don't currently do from inside
npm.

It also shares all the normalization logic into one method, that
`normalize` and `prepare` then pick and choose which ones to use.

This will allow us to maintain the functionality that
`read-package-json` has of skipping certain steps, but doing so in a
more config-based way instead of passing in functions to run.

All the existing `read-package-json` tests were ported over, and new
ones added to get to 100% coverage.

For now the 'steps' will be undocumented.

README.md

@@ -114,6 +114,20 @@ Convenience static method like `load` but for calling `normalize`
 
 ---
 
+---
+
+### `async PackageJson.prepare()`
+
+Like `load` but intended for reading package.json files before publish.
+
+---
+
+### **static** `async PackageJson.prepare(path)`
+
+Convenience static method like `load` but for calling `prepare`
+
+---
+
 ### `PackageJson.update(content)`
 
 Updates the contents of the `package.json` with the `content` provided.

lib/index.js

@@ -23,14 +23,45 @@ const knownKeys = new Set([
 ])
 
 class PackageJson {
+  static normalizeSteps = Object.freeze([
+    '_id',
+    '_attributes',
+    'bundleDependencies',
+    'optionalDedupe',
+    'scripts',
+    'funding',
+    'bin',
+  ])
+
+  static prepareSteps = Object.freeze([
+    '_attributes',
+    'bundleDependencies',
+    'gypfile',
+    'serverjs',
+    'scriptpath',
+    'authors',
+    'readme',
+    'mans',
+    'binDir',
+    'gitHead',
+    'fillTypes',
+    'normalizeData',
+    'binRefs',
+  ])
+
   // default behavior, just loads and parses
   static async load (path) {
     return await new PackageJson(path).load()
   }
 
+  // read-package-json compatible behavior
+  static async prepare (path, opts) {
+    return await new PackageJson(path).prepare(opts)
+  }
+
   // read-package-json-fast compatible behavior
-  static async normalize (path) {
-    return await new PackageJson(path).normalize()
+  static async normalize (path, opts) {
+    return await new PackageJson(path).normalize(opts)
   }
 
   #filename
@@ -53,20 +84,22 @@ class PackageJson {
     }
 
     try {
-      this.#manifest =
-        parseJSON(this.#readFileContent)
+      this.#manifest = parseJSON(this.#readFileContent)
     } catch (err) {
       err.message = `Invalid package.json: ${err}`
       throw err
     }
-
     return this
   }
 
   get content () {
     return this.#manifest
   }
 
+  get path () {
+    return this.#path
+  }
+
   update (content) {
     // validates both current manifest and content param
     const invalidContent =
@@ -111,9 +144,21 @@ class PackageJson {
     }
   }
 
-  async normalize () {
+  async normalize (opts = {}) {
+    if (!opts.steps) {
+      opts.steps = this.constructor.normalizeSteps
+    }
     await this.load()
-    await normalize(this)
+    await normalize(this, opts)
+    return this
+  }
+
+  async prepare (opts = {}) {
+    if (!opts.steps) {
+      opts.steps = this.constructor.prepareSteps
+    }
+    await this.load(true)
+    await normalize(this, opts)
     return this
   }
 }