generate-pw 1.2.1 → 1.3.0

package/README.md

@@ -17,7 +17,7 @@
 ### Randomly generate cryptographically-secure passwords.
 
 <a href="#%EF%B8%8F-mit-license"><img height=31 src="https://img.shields.io/badge/License-MIT-orange.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
-<a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.2.1"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.2.1-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+<a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.3.0"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.3.0-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="https://www.npmjs.com/package/generate-pw?activeTab=code"><img height=31 src="https://img.shields.io/npm/unpacked-size/generate-pw?style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
 <a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:generate-pw/generate-pw.js"><img height=31 src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fsonarcloud.io%2Fapi%2Fmeasures%2Fcomponent%3Fcomponent%3Dadamlui_js-utils%3Agenerate-pw%2Fgenerate-pw.js%26metricKeys%3Dvulnerabilities&query=%24.component.measures.0.value&style=for-the-badge&logo=sonarcloud&logoColor=white&labelColor=464646&label=Vulnerabilities&color=gold"></a>
 
@@ -101,25 +101,35 @@ See: [Available options](#available-options-for-generate-functions)
 
 #
 
-### `strictify(password[, requiredCharTypes])`
+### `strictify(password[, requiredCharTypes, options])`
 
 Modifies `password` given to use at least one character of each `requiredCharTypes` element passed, returning a string:
 
 ```js
-const password = 'abcdef',
-      strictPW = pw.strictify(password, ['numbers', 'symbols']);
-
+const strictPW = pw.strictify('abcdef', ['numbers', 'symbols']);
 console.log(strictPW);
-// sample output: 'a!c2ef'
+
+/* sample output:
+
+strictify() » Strictifying password...
+strictify() » Strictification complete!
+a!c2ef
+*/
 ```
 
+**💡 Note:** If no `requiredCharTypes` array is passed, all available types will be required.
+
 Available `requiredCharTypes` are: `['number', 'symbol', 'lower', 'upper']`
 
-**💡 Note:** If no `requiredCharTypes` array is passed, all available types will be required.
+Available options (passed as object properties):
+
+Name      | Type    | Description                       | Default Value
+----------|---------|-----------------------------------|---------------
+`verbose` | Boolean | Show logging in console/terminal. | `true`
 
 #
 
-### `validateStrength(password)`
+### `validateStrength(password[, options])`
 
 Validates the strength of a password, returning an object containing:
 - `strengthScore` (0–100)
@@ -135,14 +145,27 @@ const password = 'AawiddsE',
 console.log(pwStrength);
 
 /* outputs:
+
+validateStrength() » Validating password strength...
+validateStrength() » Password strength validated!
+validateStrength() » Check returned object for score/recommendations.
 {
   strengthScore: 60,
-  recommendations: [ 'Include at least one number.', 'Include at least one symbol.' ],
+  recommendations: [
+    'Make it at least 8 characters long.',
+    'Include at least one number.'
+  ],
   isGood: false
 }
 */
 ```
 
+Available options (passed as object properties):
+
+Name      | Type    | Description                       | Default Value
+----------|---------|-----------------------------------|---------------
+`verbose` | Boolean | Show logging in console/terminal. | `true`
+
 #
 
 ### Available options for `generate*()` functions
@@ -175,7 +198,7 @@ When installed [globally](#-installation), **generate-pw** can also be used from
 $ generate-pw
 ```
 
-**💡 Note:** To generate multiple results, pass `--qty=n` where `n` is the number of passwords to generate.
+**💡 Note:** For security reasons, generated password(s) are stored in the clipboard.
 
 #
 

package/dist/generate-pw.min.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+const m=require("crypto")["randomInt"],r=require("child_process")["execSync"],g={lower:"abcdefghijklmnopqrstuvwxyz",upper:"ABCDEFGHIJKLMNOPQRSTUVWXYZ",numbers:"0123456789",symbols:"!@#$%^&*()-_=+[]{}/\\|;:'\",.<>?"};function a(o={}){var e,r={length:8,qty:1,charset:"",exclude:"",numbers:!1,symbols:!1,lowercase:!0,uppercase:!0,strict:!1};o={...r,...o};for(const s of Object.keys(o))if(!Object.prototype.hasOwnProperty.call(r,s))return console.error(`generatePassword() » ERROR: \`${s}\` is an invalid option.
+`+`generatePassword() » Valid options:
+  [ ${Object.keys(r).join(", ")} ]`);for(const n of["length","qty"])if(o[n]=parseInt(o[n],10),isNaN(o[n])||o[n]<1)return console.error(`generatePassword() » ERROR: [${n}] option can only be an integer > 0.`);for(const a of["numbers","symbols","lowercase","uppercase","strict"])if("boolean"!=typeof o[a])return console.error(`generatePassword() » ERROR: [${a}] option can only be \`true\` or \`false\`.`);if(1<o.qty){const{qty:l,...i}=o;return c(l,i)}{let r=o.charset||(o.numbers?g.numbers:"")+(o.symbols?g.symbols:"")+(o.lowercase?g.lower:"")+(o.uppercase?g.upper:""),s=(r=(r=""===r?g.lower+g.upper:r).replace(new RegExp(`[${o.exclude}]`,"g"),""),"");for(let e=0;e<o.length;e++){var t=m(0,r.length);s+=r.charAt(t)}return o.strict&&(e=["number","symbol","lower","upper"].filter(e=>o[e+"s"]||o[e+"case"]),s=p(s,e)),s}}function c(r,s={}){var e={length:8,charset:"",exclude:"",numbers:!1,symbols:!1,lowercase:!0,uppercase:!0,strict:!1};if(s={...e,...s},r=parseInt(r,10),isNaN(r)||r<1)return console.error("generatePasswords() » ERROR: 1st arg [qty] can only be an integer > 0.");for(const t of Object.keys(s))if(!Object.prototype.hasOwnProperty.call(e,t))return console.error(`generatePasswords() » ERROR: \`${t}\` is an invalid option.
+`+`generatePasswords() » Valid options:
+  [ ${Object.keys(e).join(", ")} ]`);if(s.length=parseInt(s.length),isNaN(s.length)||s.length<1)return console.error("generatePasswords() » ERROR: [length] option can only be an integer > 0.");for(const n of["numbers","symbols","lowercase","uppercase","strict"])if("boolean"!=typeof s[n])return console.error(`generatePasswords() » ERROR: [${n}] option can only be \`true\` or \`false\`.`);var o=[];for(let e=0;e<r;e++)o.push(a(s));return o}function p(r,s=["number","symbol","lower","upper"],e={}){var o={verbose:!0};if(e={...o,...e},"string"!=typeof r)return console.error("strictify() » ERROR: 1st arg <password> must be a string.");var t=["number","symbol","lower","upper"];for(const p of s)if(!t.includes(p))return console.error(`strictify() » ERROR: \`${p}\` is an invalid character type.
+`+`strictify() » Valid character types: [ ${t.join(", ")} ]`);for(const f of Object.keys(e)){if(!Object.prototype.hasOwnProperty.call(o,f))return console.error(`strictify() » ERROR: \`${f}\` is an invalid option.
+`+`strictify() » Valid options: [ ${Object.keys(o).join(", ")} ]`);if("boolean"!=typeof e[f])return console.error(`strictify() » ERROR: \`${f}\` option can only be set to \`true\` or \`false\`.`)}for(const u of s)global["has"+u.charAt(0).toUpperCase()+u.slice(1)]=!1;for(let e=0;e<r.length;e++)for(const d of s)(g[d]||g[d+"s"]).includes(r.charAt(e))&&(global["has"+d.charAt(0).toUpperCase()+d.slice(1)]=!0);e.verbose&&console.info("strictify() » Strictifying password...");var n=Math.min(r.length,s.length),a=[];let l=0,i=r;for(const h of s)if(l<n&&!global["has"+h.charAt(0).toUpperCase()+h.slice(1)]){let e;for(;e=m(0,r.length),a.includes(e););a.push(e);var c=g[h]||g[h+"s"];i=i.substring(0,e)+c.charAt(m(0,c.length))+i.substring(e+1),l++}return e.verbose&&(0<l?console.info("strictify() » Strictification complete!"):console.info(`strictify() » Password already includes ${s.join(" + ")} characters!
+`+"strictify() » No modifications made.")),i}function e(e,r={}){var s={minLength:8,minLower:1,minUpper:1,minNumber:1,minSymbol:1},o={verbose:!0};if(r={...o,...r},"string"!=typeof e)return console.error("validateStrength() » ERROR: 1st arg <password> must be a string.");for(const l of Object.keys(r)){if(!Object.prototype.hasOwnProperty.call(o,l))return console.error(`validateStrength() » ERROR: \`${l}\` is an invalid option.
+`+`validateStrength() » Valid options: [ ${Object.keys(o).join(", ")} ]`);if("boolean"!=typeof r[l])return console.error(`validateStrength() » ERROR: \`${l}\` option can only be set to \`true\` or \`false\`.`)}r.verbose&&console.info("validateStrength() » Validating password strength...");var t={lower:0,upper:0,number:0,symbol:0};for(const i of e)for(const c of Object.keys(t))(g[c]||g[c+"s"]).includes(i)&&t[c]++;var n=[];e.length<s.minLength&&n.push(`Make it at least ${s.minLength} characters long.`);for(const p of Object.keys(t))t[p]<s["min"+p.charAt(0).toUpperCase()+p.slice(1)]&&n.push("Include at least one "+p+`${["upper","lower"].includes(p)?"case letter":""}.`);let a=0;a+=e.length>=s.minLength?20:0;for(const f of Object.keys(t))a+=t[f]>=s["min"+f.charAt(0).toUpperCase()+f.slice(1)]?20:0;return r.verbose&&console.info("validateStrength() » Password strength validated!\n"+(require.main!==module?"validateStrength() » Check returned object for score/recommendations.":"")),{strengthScore:a,recommendations:n,isGood:80<=a}}if(require.main!==module)module.exports={generatePassword:a,generatePasswords:c,strictify:p,validateStrength:e};else{const n="",l="",i="",f={},u={paramOptions:{length:/^--?length/,qty:/^--?qu?a?n?ti?t?y=.*$/,charset:/^--?chars/,excludeChars:/^--?exclude=/},flags:{includeNums:/^--?(?:n|(?:include-?)?num(?:ber)?s?=?(?:true|1)?)$/,includeSymbols:/^--?(?:s|(?:include-?)?symbols?=?(?:true|1)?)$/,excludeLowerChars:/^--?(?:L|(?:exclude|disable|no)-?lower-?(?:case)?|lower-?(?:case)?=(?:false|0))$/,excludeUpperChars:/^--?(?:U|(?:exclude|disable|no)-?upper-?(?:case)?|upper-?(?:case)?=(?:false|0))$/,strictMode:/^--?s(?:trict)?(?:-?mode)?$/},infoCmds:{help:/^--?h(?:elp)?$/,version:/^--?ve?r?s?i?o?n?$/}};if(process.argv.forEach(r=>{var e,s,o;r.startsWith("-")&&(e=Object.keys(u.paramOptions).find(e=>u.paramOptions[e].test(r)),o=Object.keys(u.flags).find(e=>u.flags[e].test(r)),s=Object.keys(u.infoCmds).find(e=>u.infoCmds[e].test(r)),o?f[o]=!0:e?(o=r.split("=")[1],f[e]=parseInt(o)||o):s||(console.error(`
+${l}ERROR: Arg [${r}] not recognized.`+n),console.info(`
+${i}Valid arguments are below.`+n),t(["paramOptions","flags","infoCmds"]),process.exit(1)))}),process.argv.some(e=>u.infoCmds.help.test(e)))t();else if(process.argv.some(e=>u.infoCmds.version.test(e)))console.info("v"+require("./package.json").version);else{for(const h of["length","qty"])f[h]&&(isNaN(f[h])||f[h]<1)&&(console.error(`
+${l}Error: [${h}] argument can only be > 0.`+n),process.exit(1));const o={length:f.length||8,qty:f.qty||1,charset:f.charset,exclude:f.excludeChars,numbers:!!f.includeNums,symbols:!!f.includeSymbols,lowercase:!f.excludeLowerChars,uppercase:!f.excludeUpperChars,strict:!!f.strictMode},d=a(o);s(Array.isArray(d)?d.join("\n"):d)}function t(e=["cmdFormat","paramOptions","flags","infoCmds"]){const r={cmdFormat:[`
+${i}generate-pw [options|commands]`+n],paramOptions:["\nParameter options:"," --length=n                  Generate password(s) of n length."," --qty=n                     Generate n password(s)."," --charset=chars             Only include chars in password(s)."," --charset=chars             Only include chars in password(s)."," --exclude=chars             Exclude chars from password(s)."],flags:["\nBoolean options:"," -n, --include-numbers       Allow numbers in password(s)."," -s, --include-symbols       Allow symbols in password(s)."," -L, --no-lowercase          Disallow lowercase letters in password(s)."," -U, --no-uppercase          Disallow uppercase letters in password(s)."],infoCmds:["\nInfo commands:"," -h, --help                  Display help screen."," -v, --version               Show version number."]};e.forEach(e=>{r[e]?.forEach(e=>{{const o=process.stdout.columns||80,t=[],r=e.match(/\S+|\s+/g);let s="";r.forEach(e=>{var r=o-(0===t.length?0:29);s.length+e.length>r&&(t.push(0===t.length?s:s.trimStart()),s=""),s+=e}),t.push(0===t.length?s:s.trimStart()),t.forEach((e,r)=>console.info(0===r?e:" ".repeat(29)+e))}})})}function s(e){e=e.replace(/\s+$/m,"").replace(/"/g,'""'),"darwin"===process.platform?r(`printf "${e}" | pbcopy`):"linux"===process.platform?r(`printf "${e}" | xclip -selection clipboard`):"win32"===process.platform&&r(`Set-Clipboard -Value "${e}"`,{shell:"powershell"})}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generate-pw",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Randomly generate cryptographically-secure passwords.",
   "author": {
     "name": "Adam Lui",
@@ -9,13 +9,19 @@
   },
   "homepage": "https://github.com/adamlui/js-utils",
   "license": "MIT",
-  "main": "generate-pw.js",
+  "main": "dist/generate-pw.min.js",
+  "files": [
+    "dist",
+    "docs/",
+    "!docs/*/"
+  ],
   "bin": {
-    "generatepw": "generate-pw.js",
-    "generate-pw": "generate-pw.js"
+    "generatepw": "dist/generate-pw.min.js",
+    "generate-pw": "dist/generate-pw.min.js"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "minify-js generate-pw.js dist",
     "bump:patch": "bash utils/bump.sh patch",
     "bump:minor": "bash utils/bump.sh minor",
     "bump:major": "bash utils/bump.sh major",
@@ -41,5 +47,8 @@
   "funding": {
     "type": "github",
     "url": "https://github.com/sponsors/adamlui"
+  },
+  "devDependencies": {
+    "@adamlui/minify.js": "^1.4.6"
   }
 }

package/generate-pw.js

@@ -1,269 +0,0 @@
-#!/usr/bin/env node
-
-// Import crypto.randomInt() for secure RNG
-const { randomInt } = require('crypto');
-
-// Init CHARACTER SETS
-const charsets = {
-    lower: 'abcdefghijklmnopqrstuvwxyz',
-    upper: 'ABCDEFGHIJKLMNOPQRSTUVWXYZ',
-    numbers: '0123456789',
-    symbols: '!@#$%^&*()-_=+[]{}/\\|;:\'",.<>?'
-};
-
-// Define MAIN functions
-
-function generatePassword(options = {}) { 
-
-    // Init options
-    const defaultOptions = {
-        length: 8,       // length of password
-        qty: 1,          // number of passwords to generate
-        charset: '',     // characters to include
-        exclude: '',     // characters to exclude
-        numbers: false,  // include numberChars
-        symbols: false,  // include symbolChars
-        lowercase: true, // include lowercase letters
-        uppercase: true, // include uppercase letters
-        strict: false    // require at least one char from each enabled set
-    };
-    options = { ...defaultOptions, ...options };
-
-    // Validate integer args
-    for (const numArgType of ['length', 'qty'])
-        if (isNaN(options[numArgType]) || options[numArgType] < 1)
-            return console.error(
-                `ERROR: [${ numArgType }] argument must be 1 or greater.`);
-
-    if (options.qty > 1) { // return array of [qty] password strings
-        const { qty, ...otherOptions } = options;
-        return generatePasswords(qty, otherOptions);
-
-    } else { // return single password string
-
-        // Init password's char set
-        let pwCharset = options.charset || ( // use passed [charset], or construct from options
-            (options.numbers ? charsets.numbers : '')
-              + (options.symbols ? charsets.symbols : '')
-              + (options.lowercase ? charsets.lower : '') 
-              + (options.uppercase ? charsets.upper : '')
-        );
-        if (pwCharset === '') // all flags false + no charset passed
-            pwCharset = charsets.lower + charsets.upper; // default to upper + lower
-
-        // Exclude passed `exclude` chars
-        pwCharset = pwCharset.replace(new RegExp(`[${ options.exclude }]`, 'g'), '');
-
-        // Generate unstrict password
-        let password = '';
-        for (let i = 0; i < options.length; i++) {
-            const randomIndex = randomInt(0, pwCharset.length);
-            password += pwCharset.charAt(randomIndex);
-        }
-
-        // Enforce strict mode if enabled
-        if (options.strict) {
-            const charTypes = ['number', 'symbol', 'lower', 'upper'],
-                  requiredCharTypes = charTypes.filter(charType => options[charType + 's'] || options[charType + 'case']);
-            password = strictify(password, requiredCharTypes);
-        }
-
-        return password;
-    }
-}
-
-function generatePasswords(qty, options) {
-    qty = parseInt(qty);
-    if (isNaN(qty)) return console.error(
-        'ERROR: First argument [qty] of generatePasswords() must be an integer');
-    const passwords = [];
-    for (let i = 0; i < qty; i++) passwords.push(generatePassword(options));
-    return passwords;
-}
-
-function strictify(password, requiredCharTypes = ['number', 'symbol', 'lower', 'upper']) {
-
-    // Init flags
-    for (const charType of requiredCharTypes)
-        global['has' + charType.charAt(0).toUpperCase() + charType.slice(1)] = false;
-    for (let i = 0; i < password.length; i++)
-        for (const charType of requiredCharTypes)
-            if ((charsets[charType] || charsets[charType + 's']).includes(password.charAt(i)))
-                global['has' + charType.charAt(0).toUpperCase() + charType.slice(1)] = true;
-
-    // Modify password if necessary
-    const maxReplacements = Math.min(password.length, requiredCharTypes.length),
-          replacedPositions = [];
-    let replacementCnt = 0, strictPW = password;
-    for (const charType of requiredCharTypes) {
-        if (replacementCnt < maxReplacements) {
-            if (!global['has' + charType.charAt(0).toUpperCase() + charType.slice(1)]) {
-                let replacementPos;
-                do replacementPos = randomInt(0, password.length); // pick random pos
-                while (replacedPositions.includes(replacementPos)); // check if pos already replaced
-                replacedPositions.push(replacementPos); // track new replacement pos
-                const replacementCharSet = charsets[charType] || charsets[charType + 's'];
-                strictPW = strictPW.substring(0, replacementPos) // perform actual replacement
-                         + replacementCharSet.charAt(randomInt(0, replacementCharSet.length))
-                         + strictPW.substring(replacementPos + 1);
-                replacementCnt++;
-    }}}
-
-    return strictPW;
-}
-
-function validateStrength(password) {
-    const strengthCriteria = { minLength: 8, minLower: 1, minUpper: 1, minNumber: 1, minSymbol: 1 };
-
-    // Count occurrences of each char type
-    const charCnts = { 'lower': 0, 'upper': 0, 'number': 0, 'symbol': 0 };
-    for (let i = 0; i < password.length; i++) {
-        const char = password[i];
-        for (const charType of Object.keys(charCnts))
-            if ((charsets[charType] || charsets[charType + 's']).includes(char))
-                charCnts[charType]++;
-    }
-
-    // Check criteria + add recommendations
-    const recommendations = [];
-    if (password.length < strengthCriteria.minLength)
-        recommendations.push(`Make it at least ${ strengthCriteria.minLength } characters long.`);
-    for (const charType of Object.keys(charCnts))
-        if (charCnts[charType] < strengthCriteria['min' + charType.charAt(0).toUpperCase() + charType.slice(1)])
-            recommendations.push('Include at least one ' + charType
-                + `${ ['upper', 'lower'].includes(charType) ? 'case letter' : '' }.`);
-
-    // Calculate strength score based on counts and criteria
-    let strengthScore = 0;
-    strengthScore += ( // +20 for satisfying min length
-        password.length >= strengthCriteria.minLength) ? 20 : 0;
-    for (const charType of Object.keys(charCnts))
-        strengthScore += ( // +20 per char type included
-            charCnts[charType] >= strengthCriteria['min' + charType.charAt(0).toUpperCase() + charType.slice(1)]) ? 20 : 0;
-
-    return { strengthScore, recommendations, isGood: strengthScore >= 80 };
-}
-
-// EXPORT main functions if script was required
-if (require.main !== module) module.exports = { generatePassword, generatePasswords, strictify, validateStrength };
-
-else { // run as CLI utility
-
-    // Init UI colors
-    const nc = '\x1b[0m',    // no color
-          br = '\x1b[1;91m', // bright red
-          by = '\x1b[1;33m', // bright yellow
-          bw = '\x1b[1;97m'; // bright white
-
-    // Load settings from ARGS
-    const config = {};
-    const argRegex = {
-        paramOptions: {
-            'length': /^--?length/,
-            'qty': /^--?qu?a?n?ti?t?y=\d+$/,
-            'charset': /^--?chars/,
-            'excludeChars': /^--?exclude=/
-        },
-        flags: {
-            'includeNums': /^--?(?:n|(?:include-?)?num(?:ber)?s?=?(?:true|1)?)$/,
-            'includeSymbols': /^--?(?:s|(?:include-?)?symbols?=?(?:true|1)?)$/,
-            'excludeLowerChars': /^--?(?:L|(?:exclude|disable|no)-?lower-?(?:case)?|lower-?(?:case)?=(?:false|0))$/,
-            'excludeUpperChars': /^--?(?:U|(?:exclude|disable|no)-?upper-?(?:case)?|upper-?(?:case)?=(?:false|0))$/,
-            'strictMode': /^--?s(?:trict)?(?:-?mode)?$/
-        },
-        cmds: {
-            'help': /^--?h(?:elp)?$/,
-            'version': /^--?ve?r?s?i?o?n?$/
-        }
-    };
-    process.argv.forEach(arg => {
-        if (!arg.startsWith('-')) return;
-        const matchedFlag = Object.keys(argRegex.flags).find(flag => argRegex.flags[flag].test(arg)),
-              matchedArgOption = Object.keys(argRegex.paramOptions).find(option => argRegex.paramOptions[option].test(arg)),
-              matchedCmd = Object.keys(argRegex.cmds).find(cmd => argRegex.cmds[cmd].test(arg));
-        if (matchedFlag) config[matchedFlag] = true;
-        else if (matchedArgOption) {
-            const value = arg.split('=')[1];
-            config[matchedArgOption] = parseInt(value) || value;
-        } else if (!matchedCmd) {
-            console.error(`\n${br}ERROR: Arg [${ arg }] not recognized.${nc}`);
-            console.info(`\n${by}Valid arguments are below.${nc}`);
-            printHelpSections(['paramOptions', 'booelanOptions', 'infoCmds']);
-            process.exit(1);
-    }});
-
-    // Show HELP screen if -h or --help passed
-    if (process.argv.some(arg => /^--?h(?:elp)?$/.test(arg))) printHelpSections();
-
-    // Show VERSION number if -v or --version passed
-    else if (process.argv.some(arg => /^--?ve?r?s?i?o?n?$/.test(arg)))
-        console.info('v' + require('./package.json').version);
-
-    else { // run MAIN routine
-        for (const numArgType of ['length', 'qty'])
-            if (config[numArgType] && (isNaN(config[numArgType]) || config[numArgType] < 1))
-                return console.error(`\n${br}Error: [${ numArgType }] argument must be 1 or greater.${nc}`);
-        const funcOptions = {
-            length: config.length || 8, qty: config.qty || 1,
-            charset: config.charset, exclude: config.excludeChars,
-            numbers: config.includeNums, symbols: config.includeSymbols,
-            lowercase: !config.excludeLowerChars, uppercase: !config.excludeUpperChars,
-            strict: config.strictMode
-        };
-        const pwResult = generatePassword(funcOptions);
-        console.log('\n' + bw + ( Array.isArray(pwResult) ? pwResult.join('\n') : pwResult ) + nc);
-    }
-
-    function printHelpSections(includeSections = ['cmdFormat', 'paramOptions', 'booelanOptions', 'infoCmds']) {
-        const helpSections = {
-            'cmdFormat': [
-                `\n${by}generate-pw [options|commands]${nc}`
-            ],
-            'paramOptions': [
-                '\nParameter options:',
-                ' --length=n                  Generate password(s) of n length.',
-                ' --qty=n                     Generate n password(s).',
-                ' --charset=chars             Only include chars in password(s).',
-                ' --charset=chars             Only include chars in password(s).',
-                ' --exclude=chars             Exclude chars from password(s).'
-            ],
-            'booelanOptions': [
-                '\nBoolean options:',
-                ' -n, --include-numbers       Allow numbers in password(s).',
-                ' -s, --include-symbols       Allow symbols in password(s).',
-                ' -L, --no-lowercase          Disallow lowercase letters in password(s).',
-                ' -U, --no-uppercase          Disallow uppercase letters in password(s).'
-            ],
-            'infoCmds': [
-                '\nInfo commands:',
-                ' -h, --help                  Display help screen.',
-                ' -v, --version               Show version number.'
-            ]
-        };
-        includeSections.forEach(section => { // print valid arg elems
-            helpSections[section]?.forEach(line => printHelpMsg(line)); });
-
-        function printHelpMsg(msg) { // wrap msg + indent 2nd+ lines (for --help screen)
-            const terminalWidth = process.stdout.columns || 80,
-                  indentation = 29, lines = [], words = msg.match(/\S+|\s+/g);
-
-            // Split msg into lines of appropriate lengths
-            let currentLine = '';
-            words.forEach(word => {
-                const lineLength = terminalWidth - ( lines.length === 0 ? 0 : indentation );
-                if (currentLine.length + word.length > lineLength) { // cap/store it
-                    lines.push(lines.length === 0 ? currentLine : currentLine.trimStart());
-                    currentLine = '';
-                }
-                currentLine += word;
-            });
-            lines.push(lines.length === 0 ? currentLine : currentLine.trimStart());
-
-            // Print formatted msg
-            lines.forEach((line, index) => console.info(
-                index === 0 ? line // print 1st line unindented
-                    : ' '.repeat(indentation) + line // print subsequent lines indented
-            ));
-        }
-    }
-}