@modernpoacher/deps 2.2.18 → 2.2.20

package/src/install/index.mjs

@@ -1,15 +1,17 @@
 /**
- *  A package
- *  @typedef {import('../common/index.mjs').Package} Package
+ *  @typedef {import('node:child_process').ExecException} ExecException
+ *  @typedef {DepsTypes.DependencyDescriptor} DependencyDescriptor
+ *  @typedef {DepsTypes.Package} Package
+ *  @typedef {DepsTypes.Configuration} Configuration
  */
 
 /**
- *  A configuration
- *  @typedef {import('../common/index.mjs').Configuration} Configuration
+ *  @callback HandleComplete
+ *  @param {ExecException | null} e
+ *  @param {string} v
+ *  @returns {void}
  */
 
-import debug from 'debug'
-
 import {
   normalize
 } from 'node:path'
@@ -18,6 +20,8 @@ import {
   exec
 } from 'node:child_process'
 
+import debug from '#deps/src/common/debug'
+
 import {
   VERSION,
   PLATFORM
@@ -48,10 +52,9 @@ log(`\`install\` (${VERSION} - ${PLATFORM}) is awake`)
 
 /**
  *  @function getInstallSaveExactCommands
- *
+ *  @description
  *  Get the `install --save-exact` commands as a string
- *
- *  @param {Package} p - Package
+ *  @param {DependencyDescriptor | DependencyDescriptor[]} p - Package
  *  @param {boolean} s - Save
  *  @param {string} r - Registry
  *  @param {boolean} f - Force
@@ -71,10 +74,9 @@ export function getInstallSaveExactCommands (p, s, r, f) {
 
 /**
  *  @function getInstallCommands
- *
+ *  @description
  *  Get the `install` commands as a string
- *
- *  @param {Package} p - Package
+ *  @param {DependencyDescriptor | DependencyDescriptor[]} p - Package
  *  @param {boolean} s - Save
  *  @param {string} r - Registry
  *  @param {boolean} f - Force
@@ -94,14 +96,13 @@ export function getInstallCommands (p, s, r, f) {
 
 /**
  *  @function installSaveExact
- *
+ *  @description
  *  Spawn the `install --save-exact` commands
- *
  *  @param {string} d - Directory
- *  @param {Package} p - Package
- *  @param {Configuration} c - Configuration
+ *  @param {DependencyDescriptor | DependencyDescriptor[]} p - Package
  *  @param {boolean} s - Save
  *  @param {string} r - Registry
+ *  @param {boolean} f - Force
  *  @returns {Promise<string>}
  */
 export function installSaveExact (d, p, s, r, f) {
@@ -109,36 +110,43 @@ export function installSaveExact (d, p, s, r, f) {
 
   const directory = normalize(d.trim())
 
-  log(`Directory is "${directory}"`)
+  info(`Directory is "${directory}"`)
 
   return (
     new Promise((resolve, reject) => {
       const commands = getCommands(getInstallSaveExactCommands(p, s, r, f))
       const options = getOptions(directory)
+      /**
+       *  @type {HandleComplete}
+       */
+      function handleComplete (e, v) {
+        if (!e) {
+          resolve(v)
+        } else {
+          reject(e)
+        }
+      }
 
       const {
         stdout,
         stderr
-      } = exec(commands, options, (e, v) => {
-        return (!e) ? resolve(v) : reject(e)
-      })
+      } = exec(commands, options, handleComplete)
 
-      stdout.on('data', log)
-      stderr.on('data', log)
+      if (stdout) stdout.on('data', log)
+      if (stderr) stderr.on('data', log)
     })
   )
 }
 
 /**
  *  @function install
- *
+ *  @description
  *  Spawn the `install` commands
- *
  *  @param {string} d - Directory
- *  @param {Package} p - Package
- *  @param {Configuration} c - Configuration
+ *  @param {DependencyDescriptor | DependencyDescriptor[]} p - Package
  *  @param {boolean} s - Save
  *  @param {string} r - Registry
+ *  @param {boolean} f - Force
  *  @returns {Promise<string>}
  */
 export function install (d, p, s, r, f) {
@@ -146,31 +154,38 @@ export function install (d, p, s, r, f) {
 
   const directory = normalize(d.trim())
 
-  log(`Directory is "${directory}"`)
+  info(`Directory is "${directory}"`)
 
   return (
     new Promise((resolve, reject) => {
       const commands = getCommands(getInstallCommands(p, s, r, f))
       const options = getOptions(directory)
+      /**
+       *  @type {HandleComplete}
+       */
+      function handleComplete (e, v) {
+        if (!e) {
+          resolve(v)
+        } else {
+          reject(e)
+        }
+      }
 
       const {
         stdout,
         stderr
-      } = exec(commands, options, (e, v) => {
-        return (!e) ? resolve(v) : reject(e)
-      })
+      } = exec(commands, options, handleComplete)
 
-      stdout.on('data', log)
-      stderr.on('data', log)
+      if (stdout) stdout.on('data', log)
+      if (stderr) stderr.on('data', log)
     })
   )
 }
 
 /**
  *  @function execute
- *
+ *  @description
  *  Execute the `install --save-exact` and `install` commands
- *
  *  @param {string} d - Directory
  *  @param {Package} p - Package
  *  @param {Configuration} c - Configuration

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "module": "NodeNext",
+    "target": "ESNext",
+    "allowJs": true,
+    "checkJs": true,
+    "noEmit": true,
+    "strict": true,
+    "baseUrl": "."
+  },
+  "include": [
+    "."
+  ],
+  "exclude": [
+    "test",
+    ".circleci",
+    ".github",
+    ".husky",
+  ]
+}