@modernpoacher/deps 2.2.21 → 2.2.23

package/bin/common/index.mjs

@@ -1,10 +1,21 @@
 #!/usr/bin/env node
 
+/**
+ *  @typedef {import('node:child_process').ExecException} ExecException
+ */
+
 /**
  *  @typedef {DepsTypes.Package} Package
  *  @typedef {DepsTypes.Configuration} Configuration
  */
 
+/**
+ *  @callback HandleComplete
+ *  @param {ExecException | null} e
+ *  @param {string} v
+ *  @returns {void}
+ */
+
 import stripAnsi from 'strip-ansi'
 
 import {
@@ -65,17 +76,26 @@ const CODE = 0
 
 const MESSAGE = 'Either no error message has been defined or no error has been supplied'
 
+const LF = String.fromCodePoint(10)
+const SP = String.fromCodePoint(32)
+
 /**
  *  @param {string} v
  *  @returns {string}
  */
-export const tidy = (v) => v.replace(/\n{2,}}/gm, String.fromCharCode(10)).trim()
+export const trimEnd = (v) => v.trimEnd()
 
 /**
  *  @param {string} v
  *  @returns {string}
  */
-export const trim = (v) => v.split(String.fromCharCode(10)).map((v) => v.trimEnd()).join(String.fromCharCode(10)).trim()
+export const tidy = (v) => v.replace(/\n{2,}}/gm, LF).trim()
+
+/**
+ *  @param {string} v
+ *  @returns {string}
+ */
+export const trim = (v) => v.split(LF).map(trimEnd).join(LF).trim()
 
 const getRmrfCommands = PLATFORM === 'win32'
   ? () => tidy(`
@@ -128,8 +148,8 @@ function toSingle (v) {
 }
 
 export const ARGS = PLATFORM === 'win32'
-  ? ARGV.map(toDouble).join(String.fromCodePoint(32))
-  : ARGV.map(toSingle).join(String.fromCodePoint(32))
+  ? ARGV.map(toDouble).join(SP)
+  : ARGV.map(toSingle).join(SP)
 
 /**
  *  @param {string} v
@@ -159,7 +179,7 @@ export function use (key) {
    *  @returns {void}
    */
   return function use (value) {
-    value.split(String.fromCharCode(10))
+    value.split(LF)
       .filter(filter)
       .forEach(write)
   }
@@ -182,23 +202,23 @@ export function handleError (e = {}) {
 }
 
 /**
- *  @param {Error | null} [e]
+ *  @param {Error | null} e
  *  @returns {void}
  */
-export function handleComplete (e = null) {
+export function handleComplete (e) {
   if (!e) return log('👍')
   error('👎')
 }
 
 /**
- *  @param {{ code?: number, message?: string }} [e]
+ *  @param {{ code?: number, message?: string }} e
  */
-const handlePackageError = ({ message = MESSAGE } = {}) => { info(`Package error: "${message}"`) }
+const handlePackageError = ({ message = MESSAGE }) => { info(`Package error: "${message}"`) }
 
 /**
- *  @param {{ code?: number, message?: string }} [e]
+ *  @param {{ code?: number, message?: string }} e
  */
-const handleConfigurationError = ({ message = MESSAGE } = {}) => { info(`Configuration error: "${message}"`) }
+const handleConfigurationError = ({ message = MESSAGE }) => { info(`Configuration error: "${message}"`) }
 
 const getPackageJsonPath = (directory = DIRECTORY) => resolve(join(directory, 'package.json'))
 
@@ -371,13 +391,23 @@ function rmrf (d = DIRECTORY) {
     new Promise((resolve, reject) => {
       const commands = getRmrfCommands()
       const options = getOptions(directory)
+      /**
+       *  @type {HandleComplete}
+       */
+      function handleComplete (e, v) {
+        if (!e) {
+          resolve(v)
+        } else {
+          reject(e)
+        }
+      }
+
+      info(commands, options)
 
       const {
         stdout,
         stderr
-      } = exec(commands, options, (e = null, v = '') => {
-        return (!e) ? resolve(v) : reject(e)
-      })
+      } = exec(commands, options, handleComplete)
 
       const log = use('rmrf')
 
@@ -402,13 +432,23 @@ function npmi (d = DIRECTORY, registry = REGISTRY, force = false) {
     new Promise((resolve, reject) => {
       const commands = getNpmiCommands(registry, force)
       const options = getOptions(directory)
+      /**
+       *  @type {HandleComplete}
+       */
+      function handleComplete (e, v) {
+        if (!e) {
+          resolve(v)
+        } else {
+          reject(e)
+        }
+      }
+
+      info(commands, options)
 
       const {
         stdout,
         stderr
-      } = exec(commands, options, (e = null, v = '') => {
-        return (!e) ? resolve(v) : reject(e)
-      })
+      } = exec(commands, options, handleComplete)
 
       const log = use('npmi')
 
@@ -433,13 +473,23 @@ function deps (d = DIRECTORY, registry = REGISTRY, force = false) {
     new Promise((resolve, reject) => {
       const commands = getDepsCommands(registry, force)
       const options = getOptions(directory)
+      /**
+       *  @type {HandleComplete}
+       */
+      function handleComplete (e, v) {
+        if (!e) {
+          resolve(v)
+        } else {
+          reject(e)
+        }
+      }
+
+      info(commands, options)
 
       const {
         stdout,
         stderr
-      } = exec(commands, options, (e = null, v = '') => {
-        return (!e) ? resolve(v) : reject(e)
-      })
+      } = exec(commands, options, handleComplete)
 
       const log = use('deps')
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modernpoacher/deps",
-  "version": "2.2.21",
+  "version": "2.2.23",
   "description": "Update NPM package dependencies from the command line",
   "keywords": [
     "deps",
@@ -57,8 +57,8 @@
     "commander": "^14.0.0",
     "debug": "^4.4.1",
     "glob": "^11.0.3",
-    "strip-ansi": "^7.1.0",
-    "supports-color": "^10.2.0"
+    "strip-ansi": "^7.1.2",
+    "supports-color": "^10.2.2"
   },
   "devDependencies": {
     "@sequencemedia/eslint-config-standard": "^0.2.79",
@@ -68,11 +68,11 @@
     "@types/debug": "^4.1.12",
     "@types/mocha": "^10.0.10",
     "@types/node": "^24.3.1",
-    "@typescript-eslint/parser": "^8.42.0",
+    "@typescript-eslint/parser": "^8.43.0",
     "chai": "^6.0.1",
     "cross-env": "^10.0.0",
-    "eslint": "^9.34.0",
-    "eslint-plugin-jsdoc": "^54.3.1",
+    "eslint": "^9.35.0",
+    "eslint-plugin-jsdoc": "^55.0.0",
     "globals": "^16.3.0",
     "husky": "^9.1.7",
     "mocha": "^11.7.2"

package/src/common/git/index.mjs

@@ -71,7 +71,7 @@ const log = debug('@modernpoacher/deps')
 
 log(`\`common/git\` (${VERSION} - ${PLATFORM}) is awake`)
 
-const LF = String.fromCharCode(10)
+const LF = String.fromCodePoint(10)
 
 /**
  *  @param {string} v

package/src/common/index.mjs

@@ -30,8 +30,8 @@ const log = debug('@modernpoacher/deps')
 
 log(`\`common\` (${VERSION} - ${PLATFORM}) is awake`)
 
-const LF = String.fromCharCode(10)
-const SP = String.fromCharCode(32)
+const LF = String.fromCodePoint(10)
+const SP = String.fromCodePoint(32)
 
 /**
  *  @param {string} v

package/src/index.mjs

@@ -62,7 +62,7 @@ const info = debug('@modernpoacher/deps:info')
 
 log(`\`deps\` (${VERSION} - ${PLATFORM}) is awake`)
 
-const LF = String.fromCharCode(10)
+const LF = String.fromCodePoint(10)
 
 /**
  *  @param {string} v
@@ -140,13 +140,9 @@ export function getInstallCommands (deps, r, f) {
 export function getInstallSaveBundleSaveExactCommands (deps, r, f) {
   log('getInstallSaveBundleSaveExactCommands')
 
-  const commands = normalizeCommands(
+  return normalizeCommands(
     getSaveBundleParameter(getInstallSaveExactCommands(deps, r, f))
   )
-
-  info(commands)
-
-  return commands
 }
 
 /**
@@ -161,13 +157,9 @@ export function getInstallSaveBundleSaveExactCommands (deps, r, f) {
 export function getInstallSaveBundleCommands (deps, r, f) {
   log('getInstallSaveBundleCommands')
 
-  const commands = normalizeCommands(
+  return normalizeCommands(
     getSaveBundleParameter(getInstallCommands(deps, r, f))
   )
-
-  info(commands)
-
-  return commands
 }
 
 /**
@@ -182,13 +174,9 @@ export function getInstallSaveBundleCommands (deps, r, f) {
 export function getInstallSaveOptionalSaveExactCommands (deps, r, f) {
   log('getInstallSaveOptionalSaveExactCommands')
 
-  const commands = normalizeCommands(
+  return normalizeCommands(
     getSaveOptionalParameter(getInstallSaveExactCommands(deps, r, f))
   )
-
-  info(commands)
-
-  return commands
 }
 
 /**
@@ -203,13 +191,9 @@ export function getInstallSaveOptionalSaveExactCommands (deps, r, f) {
 export function getInstallSaveOptionalCommands (deps, r, f) {
   log('getInstallSaveOptionalCommands')
 
-  const commands = normalizeCommands(
+  return normalizeCommands(
     getSaveOptionalParameter(getInstallCommands(deps, r, f))
   )
-
-  info(commands)
-
-  return commands
 }
 
 /**
@@ -224,13 +208,9 @@ export function getInstallSaveOptionalCommands (deps, r, f) {
 export function getInstallSaveDevSaveExactCommands (deps, r, f) {
   log('getInstallSaveDevSaveExactCommands')
 
-  const commands = normalizeCommands(
+  return normalizeCommands(
     getSaveDevParameter(getInstallSaveExactCommands(deps, r, f))
   )
-
-  info(commands)
-
-  return commands
 }
 
 /**
@@ -245,13 +225,9 @@ export function getInstallSaveDevSaveExactCommands (deps, r, f) {
 export function getInstallSaveDevCommands (deps, r, f) {
   log('getInstallSaveDevCommands')
 
-  const commands = normalizeCommands(
+  return normalizeCommands(
     getSaveDevParameter(getInstallCommands(deps, r, f))
   )
-
-  info(commands)
-
-  return commands
 }
 
 /**
@@ -266,13 +242,9 @@ export function getInstallSaveDevCommands (deps, r, f) {
 export function getInstallSaveProdSaveExactCommands (deps, r, f) {
   log('getInstallSaveProdSaveExactCommands')
 
-  const commands = normalizeCommands(
+  return normalizeCommands(
     getSaveProdParameter(getInstallSaveExactCommands(deps, r, f))
   )
-
-  info(commands)
-
-  return commands
 }
 
 /**
@@ -287,13 +259,9 @@ export function getInstallSaveProdSaveExactCommands (deps, r, f) {
 export function getInstallSaveProdCommands (deps, r, f) {
   log('getInstallSaveProdCommands')
 
-  const commands = normalizeCommands(
+  return normalizeCommands(
     getSaveProdParameter(getInstallCommands(deps, r, f))
   )
-
-  info(commands)
-
-  return commands
 }
 
 /**
@@ -328,6 +296,8 @@ export function installSaveBundleSaveExact (d, deps, r, f) {
         }
       }
 
+      info(commands, options)
+
       const {
         stdout,
         stderr
@@ -373,6 +343,8 @@ export function installSaveBundle (d, deps, r, f) {
         }
       }
 
+      info(commands, options)
+
       const {
         stdout,
         stderr
@@ -418,6 +390,8 @@ export function installSaveOptionalSaveExact (d, deps, r, f) {
         }
       }
 
+      info(commands, options)
+
       const {
         stdout,
         stderr
@@ -463,6 +437,8 @@ export function installSaveOptional (d, deps, r, f) {
         }
       }
 
+      info(commands, options)
+
       const {
         stdout,
         stderr
@@ -508,6 +484,8 @@ export function installSaveDevSaveExact (d, deps, r, f) {
         }
       }
 
+      info(commands, options)
+
       const {
         stdout,
         stderr
@@ -553,6 +531,8 @@ export function installSaveDev (d, deps, r, f) {
         }
       }
 
+      info(commands, options)
+
       const {
         stdout,
         stderr
@@ -598,6 +578,8 @@ export function installSaveProdSaveExact (d, deps, r, f) {
         }
       }
 
+      info(commands, options)
+
       const {
         stdout,
         stderr
@@ -643,6 +625,8 @@ export function installSaveProd (d, deps, r, f) {
         }
       }
 
+      info(commands, options)
+
       const {
         stdout,
         stderr

package/src/install/index.mjs

@@ -63,13 +63,9 @@ log(`\`install\` (${VERSION} - ${PLATFORM}) is awake`)
 export function getInstallSaveExactCommands (p, s, r, f) {
   log('getInstallSaveExactCommands')
 
-  const commands = normalizeCommands(
+  return normalizeCommands(
     getNoSaveParameter(s, getRegistryParameter(r, getForceParameter(f, getSaveExactParameter(`npm i ${transform(p)}`))))
   )
-
-  info(commands)
-
-  return commands
 }
 
 /**
@@ -85,13 +81,9 @@ export function getInstallSaveExactCommands (p, s, r, f) {
 export function getInstallCommands (p, s, r, f) {
   log('getInstallCommands')
 
-  const commands = normalizeCommands(
+  return normalizeCommands(
     getNoSaveParameter(s, getRegistryParameter(r, getForceParameter(f, `npm i ${transform(p)}`)))
   )
-
-  info(commands)
-
-  return commands
 }
 
 /**
@@ -127,6 +119,8 @@ export function installSaveExact (d, p, s, r, f) {
         }
       }
 
+      info(commands, options)
+
       const {
         stdout,
         stderr
@@ -171,6 +165,8 @@ export function install (d, p, s, r, f) {
         }
       }
 
+      info(commands, options)
+
       const {
         stdout,
         stderr