generate-pw 1.5.2 → 1.5.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +10 -10
  2. package/dist/cli.min.js +6 -3
  3. package/dist/generate-pw.min.js +1 -1
  4. package/docs/README.md +10 -10
  5. package/package.json +2 -2
package/README.md CHANGED
@@ -20,9 +20,9 @@
20
20
  ### Randomly generate, strengthen, and validate cryptographically-secure passwords.
21
21
 
22
22
  <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>
23
- <a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.5.2"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.5.2-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
23
+ <a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.5.4"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.5.4-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
24
24
  <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>
25
- <a href="https://github.com/adamlui/js-utils/blob/generate-pw-1.5.2/generate-pw/dist/generate-pw.min.js"><img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-pw/dist/generate-pw.min.js?branch=generate-pw-1.5.2&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
25
+ <a href="https://github.com/adamlui/js-utils/blob/generate-pw-1.5.4/generate-pw/dist/generate-pw.min.js"><img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-pw/dist/generate-pw.min.js?branch=generate-pw-1.5.4&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
26
26
  <a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:generate-pw/src/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%2Fsrc%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>
27
27
  <a href="https://github.com/toolleeo/cli-apps#password-managers"><img height=31 src="https://img.shields.io/badge/Mentioned_in-Awesome-c4a2bd?logo=awesomelists&logoColor=white&labelColor=464646&style=for-the-badge"></a>
28
28
 
@@ -82,14 +82,14 @@ const pw = require('generate-pw');
82
82
  #### <> HTML script tag:
83
83
 
84
84
  ```html
85
- <script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.2/dist/generate-pw.min.js"></script>
85
+ <script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.4/dist/generate-pw.min.js"></script>
86
86
  ```
87
87
 
88
88
  #### ES6:
89
89
 
90
90
  ```js
91
91
  (async () => {
92
- await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.2/dist/generate-pw.min.js');
92
+ await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.4/dist/generate-pw.min.js');
93
93
  // Your code here...
94
94
  })();
95
95
  ```
@@ -98,7 +98,7 @@ const pw = require('generate-pw');
98
98
 
99
99
  ```js
100
100
  ...
101
- // @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.2/dist/generate-pw.min.js
101
+ // @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.4/dist/generate-pw.min.js
102
102
  // ==/UserScript==
103
103
 
104
104
  // Your code here...
@@ -106,7 +106,7 @@ const pw = require('generate-pw');
106
106
 
107
107
  <br>
108
108
 
109
- **💡 Note:** To always import the latest version (not recommended in production!) remove the `@1.5.2` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-pw/dist/generate-pw.min.js`
109
+ **💡 Note:** To always import the latest version (not recommended in production!) remove the `@1.5.4` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-pw/dist/generate-pw.min.js`
110
110
 
111
111
  <br>
112
112
 
@@ -305,14 +305,14 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
305
305
 
306
306
  ## 🛠️ Related utilities
307
307
 
308
- ### <img height=21px src="https://i.imgur.com/kvf7fXm.png"> [generate-ip](https://js-utils.com/generate-ip) <a href="https://github.com/toolleeo/cli-apps#networking"><img height=18 src="https://awesome.re/mentioned-badge.svg"></a>
308
+ ### <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/generate-ip/media/images/icons/node-graph/white/icon55x49.png"><img height=21 src="https://raw.githubusercontent.com/adamlui/js-utils/main/generate-ip/media/images/icons/node-graph/black/icon55x49.png"></picture> [generate-ip](https://js-utils.com/generate-ip) <a href="https://github.com/toolleeo/cli-apps#networking"><img height=18 src="https://awesome.re/mentioned-badge.svg"></a>
309
309
 
310
310
  > Randomly generate, format, and validate IPv4/IPv6 addresses.
311
311
  <br>[Install](https://docs.js-utils.com/generate-ip/#-installation) /
312
312
  [Readme](https://docs.js-utils.com/generate-ip/#readme) /
313
313
  [API usage](https://docs.js-utils.com/generate-ip/#-api-usage) /
314
314
  [CLI usage](https://docs.js-utils.com/generate-ip/#-command-line-usage) /
315
- [Discuss](https://js-utils.com/discussions)
315
+ [Discuss](https://github.js-utils.com/discussions)
316
316
 
317
317
  ### <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/geolocate/media/images/icons/wire-globe/white/icon32.png"><img height=22 src="https://raw.githubusercontent.com/adamlui/js-utils/main/geolocate/media/images/icons/wire-globe/black/icon32.png"></picture> [geolocate](https://js-utils.com/geolocate)
318
318
 
@@ -321,12 +321,12 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
321
321
  [Readme](https://docs.js-utils.com/geolocate/#readme) /
322
322
  [CLI usage](https://docs.js-utils.com/geolocate/#-command-line-usage) /
323
323
  [API usage](https://docs.js-utils.com/geolocate/#-api-usage) /
324
- [Discuss](https://js-utils.com/discussions)
324
+ [Discuss](https://github.js-utils.com/discussions)
325
325
 
326
326
  <br>
327
327
 
328
328
  <img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
329
329
 
330
330
  <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/media/images/icons/home/white/icon32x27.png"><img height=13 src="https://raw.githubusercontent.com/adamlui/js-utils/main/media/images/icons/home/dark-gray/icon32x27.png"></picture> <a href="https://js-utils.com">**More JavaScript utilities**</a> /
331
- <a href="https://js-utils.com/discussions">Discuss</a> /
331
+ <a href="https://github.js-utils.com/discussions">Discuss</a> /
332
332
  <a href="#-generate-pw">Back to top ↑</a>
package/dist/cli.min.js CHANGED
@@ -4,12 +4,15 @@
4
4
  * Source: https://code.js-utils.com/generate-pw
5
5
  * Documentation: https://docs.js-utils.com/generate-pw
6
6
  */
7
- const pkgName="generate-pw",docURL="https://docs.js-utils.com/generate-pw/#-command-line-usage",generatePassword=require(__dirname.match(/src/)?"./generate-pw":"./generate-pw.min")["generatePassword"],fs=require("fs"),path=require("path"),execSync=require("child_process")["execSync"],nc="",br="",by="",config={},argRegex={paramOptions:{length:/^--?length(?:=.*|$)/,qty:/^--?qu?a?n?ti?t?y(?:=.*|$)/,charset:/^--?charse?t?(?:=.*|$)/,excludeChars:/^--?exclude(?:=.*|$)/},flags:{includeNums:/^--?(?:n|(?:include-?)?num(?:ber)?s?=?(?:true|1)?)$/,includeSymbols:/^--?(?:y|(?: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))$/,excludeSimilarChars:/^--?(?:S|(?:exclude|disable|no)-?similar-?(?:char(?:acter)?s?)?|similar-?(?:char(?:acter)?s?)?=(?:false|0))$/,strictMode:/^--?s(?:trict)?(?:-?mode)?$/,quietMode:/^--?q(?:uiet)?(?:-?mode)?$/},infoCmds:{help:/^--?h(?:elp)?$/,version:/^--?ve?r?s?i?o?n?$/}};if(process.argv.forEach(s=>{var e,r,o;s.startsWith("-")&&(e=Object.keys(argRegex.paramOptions).find(e=>argRegex.paramOptions[e].test(s)),o=Object.keys(argRegex.flags).find(e=>argRegex.flags[e].test(s)),r=Object.keys(argRegex.infoCmds).find(e=>argRegex.infoCmds[e].test(s)),o?config[o]=!0:e?(s.includes("=")||(console.error(`
7
+ const pkgName="generate-pw",docURL="https://docs.js-utils.com/generate-pw/#-command-line-usage",generatePassword=require(__dirname.match(/src/)?"./generate-pw":"./generate-pw.min")["generatePassword"],fs=require("fs"),path=require("path"),execSync=require("child_process")["execSync"],nc="",br="",by="",bw="",config={},argRegex={paramOptions:{length:/^--?length(?:=.*|$)/,qty:/^--?qu?a?n?ti?t?y(?:=.*|$)/,charset:/^--?charse?t?(?:=.*|$)/,excludeChars:/^--?exclude(?:=.*|$)/},flags:{includeNums:/^--?(?:n|(?:include-?)?num(?:ber)?s?=?(?:true|1)?)$/,includeSymbols:/^--?(?:y|(?: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))$/,excludeSimilarChars:/^--?(?:S|(?:exclude|disable|no)-?similar-?(?:char(?:acter)?s?)?|similar-?(?:char(?:acter)?s?)?=(?:false|0))$/,strictMode:/^--?s(?:trict)?(?:-?mode)?$/,quietMode:/^--?q(?:uiet)?(?:-?mode)?$/},infoCmds:{help:/^--?h(?:elp)?$/,version:/^--?ve?r?s?i?o?n?$/}};if(process.argv.forEach(s=>{var e,r,o;s.startsWith("-")&&(e=Object.keys(argRegex.paramOptions).find(e=>argRegex.paramOptions[e].test(s)),o=Object.keys(argRegex.flags).find(e=>argRegex.flags[e].test(s)),r=Object.keys(argRegex.infoCmds).find(e=>argRegex.infoCmds[e].test(s)),o?config[o]=!0:e?(s.includes("=")||(console.error(`
8
8
  ${br}ERROR: Arg [--${s.replace(/-/g,"")}] requires '=' followed by a value.`+nc),printHelpCmdAndDocURL(),process.exit(1)),o=s.split("=")[1],config[e]=parseInt(o)||o):r||(console.error(`
9
9
  ${br}ERROR: Arg [${s}] not recognized.`+nc),console.info(`
10
10
  ${by}Valid arguments are below.`+nc),printHelpSections(["paramOptions","flags","infoCmds"]),printHelpCmdAndDocURL(),process.exit(1)))}),process.argv.some(e=>argRegex.infoCmds.help.test(e)))printHelpSections();else if(process.argv.some(e=>argRegex.infoCmds.version.test(e))){const k=execSync(`npm view ${pkgName} version`).toString().trim()||"none";let e,s=process.cwd();for(;"/"!=s;){const n=path.join(s,"package.json");if(fs.existsSync(n)){const o=require(n);e=(o.dependencies?.[pkgName]||o.devDependencies?.[pkgName])?.match(/(\d+\.\d+\.\d+)/)[0]||"none";break}s=path.dirname(s)}console.info(`
11
11
  Global version: `+k),console.info("Local version: "+e)}else{for(const r of["length","qty"])config[r]&&(isNaN(config[r])||config[r]<1)&&(console.error(`
12
- ${br}Error: [${r}] argument can only be > 0.`+nc),printHelpCmdAndDocURL(),process.exit(1));const p={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,excludeSimilarChars:!!config.excludeSimilarChars,strict:!!config.strictMode,verbose:!config.quietMode},q=generatePassword(p);config.quietMode||console.info("\nCopying to clipboard..."),copyToClipboard(Array.isArray(q)?q.join("\n"):q)}function printHelpSections(e=["cmdFormat","paramOptions","flags","infoCmds"]){const s={cmdFormat:[`
13
- ${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)."," --exclude=chars Exclude chars from password(s)."],flags:["\nBoolean options:"," -n, --include-numbers Allow numbers in password(s)."," -y, --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)."," -S, --no-similar Exclude similar characters in password(s)."," -s, --strict Require at least one character from each allowed character set in password(s)."," -q, --quiet Suppress all logging except errors."],infoCmds:["\nInfo commands:"," -h, --help Display help screen."," -v, --version Show version number."]};e.forEach(e=>{s[e]?.forEach(e=>{{const o=process.stdout.columns||80,n=[],s=e.match(/\S+|\s+/g);let r="";s.forEach(e=>{var s=o-(0==n.length?0:29);r.length+e.length>s&&(n.push(0==n.length?r:r.trimStart()),r=""),r+=e}),n.push(0==n.length?r:r.trimStart()),n.forEach((e,s)=>console.info(0==s?e:" ".repeat(29)+e))}})})}function printHelpCmdAndDocURL(){console.info(`
12
+ ${br}Error: [${r}] argument can only be > 0.`+nc),printHelpCmdAndDocURL(),process.exit(1));const p={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,excludeSimilarChars:!!config.excludeSimilarChars,strict:!!config.strictMode,verbose:!config.quietMode},q=generatePassword(p);config.quietMode||console.info("\nCopying to clipboard..."),copyToClipboard(Array.isArray(q)?q.join("\n"):q)}function printHelpSections(e=["usage","paramOptions","flags","infoCmds"]){const s={usage:[`
13
+ ${bw}Usage:`+nc," generate-pw [options|commands]"],paramOptions:[`
14
+ ${bw}Parameter options:`+nc," --length=n Generate password(s) of n length."," --qty=n Generate n password(s)."," --charset=chars Only include chars in password(s)."," --exclude=chars Exclude chars from password(s)."],flags:[`
15
+ ${bw}Boolean options:`+nc," -n, --include-numbers Allow numbers in password(s)."," -y, --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)."," -S, --no-similar Exclude similar characters in password(s)."," -s, --strict Require at least one character from each allowed character set in password(s)."," -q, --quiet Suppress all logging except errors."],infoCmds:[`
16
+ ${bw}Info commands:`+nc," -h, --help Display help screen."," -v, --version Show version number."]};e.forEach(e=>{s[e]?.forEach(e=>{{const o=process.stdout.columns||80,n=[],s=e.match(/\S+|\s+/g);let r="";s.forEach(e=>{var s=o-(0==n.length?0:29);r.length+e.length>s&&(n.push(0==n.length?r:r.trimStart()),r=""),r+=e}),n.push(0==n.length?r:r.trimStart()),n.forEach((e,s)=>console.info(0==s?e:" ".repeat(29)+e))}})})}function printHelpCmdAndDocURL(){console.info(`
14
17
  ${by}For more help, type 'generate-pw --help' or visit
15
18
  `+(docURL+nc))}function copyToClipboard(e){e=e.replace(/\s+$/m,"").replace(/"/g,'""'),"darwin"==process.platform?execSync(`printf "${e}" | pbcopy`):"linux"==process.platform?execSync(`printf "${e}" | xclip -selection clipboard`):"win32"==process.platform&&execSync(`Set-Clipboard -Value "${e}"`,{shell:"powershell"})}
package/dist/generate-pw.min.js CHANGED
@@ -3,4 +3,4 @@
3
3
  * Source: https://code.js-utils.com/generate-pw
4
4
  * Documentation: https://docs.js-utils.com/generate-pw
5
5
  */
6
- let randomInt;try{({randomInt}=require("crypto"))}catch(e){const b=window.crypto||window.msCrypto;randomInt=(e,r)=>{var s=b?.getRandomValues(new Uint32Array(1))[0]/4294967295||Math.random();return Math.floor(s*(r-e))+e}}const charsets={lower:"abcdefghijklmnopqrstuvwxyz",upper:"ABCDEFGHIJKLMNOPQRSTUVWXYZ",numbers:"0123456789",symbols:"!@#$%^&*()-_=+[]{}/\\|;:'\",.<>?"};function generatePassword(t={}){var e={verbose:!0,length:8,qty:1,charset:"",exclude:"",numbers:!1,symbols:!1,lowercase:!0,uppercase:!0,excludeSimilarChars:!1,strict:!1};if(validateOptions(t,e,"https://docs.js-utils.com/generate-pw/#generatepasswordoptions","generatePassword({ verbose: false, numbers: true })")){if(1<(t={...e,...t}).qty){const{qty:r,...s}=t;return generatePasswords(r,s)}{var o,e="generatePasswords"==generatePassword.caller?.name;t.verbose&&!e&&console.info("generatePassword() » Initializing character set...");let r=t.charset?.toString()||(t.numbers?charsets.numbers:"")+(t.symbols?charsets.symbols:"")+(t.lowercase?charsets.lower:"")+(t.uppercase?charsets.upper:""),s=(""==r&&(r=charsets.lower+charsets.upper),t.exclude&&(t.verbose&&!e&&console.info("generatePassword() » Removing excluded characters..."),r=r.replace(new RegExp(`[${t.exclude}]`,"g"),"")),t.excludeSimilarChars&&(t.verbose&&!e&&console.info("generatePassword() » Excluding similar characters..."),r=r.replace(/[o0Oil1|]/g,"")),t.verbose&&!e&&console.info("generatePassword() » Generating password..."),"");for(let e=0;e<t.length;e++){var n=randomInt(0,r.length);s+=r.charAt(n)}return t.strict&&(t.verbose&&!e&&console.info("generatePassword() » Enforcing strict mode..."),o=["number","symbol","lower","upper"].filter(e=>t[e+"s"]||t[e+"case"]),s=strictify(s,o)),t.verbose&&!e&&(console.info("generatePassword() » Password generated!"),"undefined"!=typeof require&&/cli(?:\.min)?\.js$/.test(require.main.filename)||console.info("generatePassword() » Check returned string.")),s}}}function generatePasswords(r,s={}){var e="https://docs.js-utils.com/generate-pw/#generatepasswordsqty-options",t={verbose:!0,length:8,charset:"",exclude:"",numbers:!1,symbols:!1,lowercase:!0,uppercase:!0,excludeSimilarChars:!1,strict:!1};if(r=parseInt(r,10),isNaN(r)||r<1)console.error("generatePasswords() » ERROR: 1st arg <qty> can only be an integer > 0."),console.info("generatePasswords() » For more help, please visit "+e);else if(validateOptions(s,t,e,"generatePasswords(3, { verbose: false, symbols: true })")){(s={...t,...s}).verbose&&console.info(`generatePasswords() » Generating password${1<r?"s":""}...`);var o=[];for(let e=0;e<r;e++)o.push(generatePassword(s));return s.verbose&&console.info(`generatePasswords() » Password${1<r?"s":""} generated!`),"undefined"!=typeof require&&/cli(?:\.min)?\.js$/.test(require.main.filename)||console.info("generatePasswords() » Check returned array."),o}}function strictify(t,o=["number","symbol","lower","upper"],e={}){var r="https://docs.js-utils.com/generate-pw/#strictifypassword-requiredchartypes-options",n={verbose:!0};if("string"!=typeof t)console.error("strictify() » ERROR: 1st arg <password> must be a string."),console.info("strictify() » For more help, please visit "+r);else{var s=["number","symbol","lower","upper"];for(const d of o=Array.isArray(o)?o:[o])if(!s.includes(d))return console.error(`strictify() » ERROR: 2nd arg \`${d}\` is an invalid character type.`),console.info(`strictify() » Valid character types: [ ${s.map(e=>`'${e}'`).join(", ")} ]`),console.info("strictify() » Pass one as a string or more as an array, or all types will be required."),void console.info("strictify() » For more help, please visit "+r);if(validateOptions(e,n,r,"strictify('pa55word', ['symbol', 'upper'], { verbose: false })")){e={...n,...e};var a={};for(const p of o)a["has"+p.charAt(0).toUpperCase()+p.slice(1)]=!1;for(let e=0;e<t.length;e++)for(const f of o)(charsets[f]||charsets[f+"s"]).includes(t.charAt(e))&&(a["has"+f.charAt(0).toUpperCase()+f.slice(1)]=!0);e.verbose&&console.info("strictify() » Strictifying password...");var i=Math.min(t.length,o.length),c=[];let r=0,s=t;for(const g of o)if(r<i&&!a["has"+g.charAt(0).toUpperCase()+g.slice(1)]){let e;for(;e=randomInt(0,t.length),c.includes(e););c.push(e);var l=charsets[g]||charsets[g+"s"];s=s.substring(0,e)+l.charAt(randomInt(0,l.length))+s.substring(e+1),r++}return e.verbose&&(0<r?(console.info("strictify() » Password is now strict!"),console.info("strictify() » Check returned string.")):(console.info(`strictify() » Password already includes ${o.join(" + ")} characters!`),console.info("strictify() » No modifications made."))),s}}}function validateStrength(r,s={}){var e="https://docs.js-utils.com/generate-pw/#validatestrengthpassword-options",t={minLength:8,minLower:1,minUpper:1,minNumber:1,minSymbol:1},o={verbose:!0};if("string"!=typeof r)console.error("validateStrength() » ERROR: 1st arg <password> must be a string."),console.info("validateStrength() » For more help, please visit "+e);else if(validateOptions(s,o,e,"validateStrength('pa55word', { verbose: false })")){(s={...o,...s}).verbose&&console.info("validateStrength() » Validating password strength...");var n={lower:0,upper:0,number:0,symbol:0};for(const i of r)for(const c of Object.keys(n))(charsets[c]||charsets[c+"s"]).includes(i)&&n[c]++;var a=[];r.length<t.minLength&&a.push(`Make it at least ${t.minLength} characters long.`);for(const l of Object.keys(n))n[l]<t["min"+l.charAt(0).toUpperCase()+l.slice(1)]&&a.push("Include at least one "+l+`${["upper","lower"].includes(l)?"case letter":""}.`);let e=0;e+=r.length>=t.minLength?20:0;for(const d of Object.keys(n))e+=n[d]>=t["min"+d.charAt(0).toUpperCase()+d.slice(1)]?20:0;return s.verbose&&(console.info("validateStrength() » Password strength validated!"),console.info("validateStrength() » Check returned object for score/recommendations.")),{strengthScore:e,recommendations:a,isGood:80<=e}}}function validateOptions(e,r,s,t){const o=JSON.stringify(r,null,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," "),n=Object.keys(r).join(", "),a=Object.keys(r).filter(e=>"boolean"==typeof r[e]),i=Object.keys(r).filter(e=>Number.isInteger(r[e]));let c="validateOptions() » ";try{c=validateOptions.caller?.name+"() » "}catch(e){}var l=t.split(",").findIndex(e=>e.trim().startsWith("{"))+1,d=(l+=["st","nd","rd"][l-1]||"th",()=>{console.info(`${c}Valid options: [ ${n} ]`),console.info(c+"If omitted, default settings are: "+o)}),p=()=>{console.info(c+"For more help, please visit "+s)};if("object"!=typeof e)return console.error(c+`ERROR: ${"0th"==l?"[O":l+" arg [o"}ptions] can only be an object of key/values.`),console.info(c+"Example valid call: "+t),d(),p(),!1;for(const f in e){if(!Object.prototype.hasOwnProperty.call(r,f))return console.error(`${c}ERROR: \`${f}\` is an invalid option.`),d(),p(),!1;if(a.includes(f)&&"boolean"!=typeof e[f])return console.error(`${c}ERROR: [${f}] option can only be \`true\` or \`false\`.`),p(),!1;if(i.includes(f)&&(e[f]=parseInt(e[f],10),isNaN(e[f])||e[f]<1))return console.error(`${c}ERROR: [${f}] option can only be an integer > 0.`),p(),!1}return!0}const apiFunctions={generatePassword:generatePassword,generatePasswords:generatePasswords,strictify:strictify,validateStrength:validateStrength};try{module.exports={...apiFunctions}}catch(e){}try{window.pw={...apiFunctions}}catch(e){}
6
+ let randomInt;try{({randomInt}=require("crypto"))}catch(e){const b=window.crypto||window.msCrypto;randomInt=(e,r)=>{var s=b?.getRandomValues(new Uint32Array(1))[0]/4294967295||Math.random();return Math.floor(s*(r-e))+e}}const charsets={lower:"abcdefghijklmnopqrstuvwxyz",upper:"ABCDEFGHIJKLMNOPQRSTUVWXYZ",numbers:"0123456789",symbols:"!@#$%^&*()-_=+[]{}/\\|;:'\",.<>?"};function generatePassword(t={}){var e={verbose:!0,length:8,qty:1,charset:"",exclude:"",numbers:!1,symbols:!1,lowercase:!0,uppercase:!0,excludeSimilarChars:!1,strict:!1};if(validateOptions(t,e,"https://docs.js-utils.com/generate-pw/#generatepasswordoptions","generatePassword({ verbose: false, numbers: true })")){if(1<(t={...e,...t}).qty){const{qty:r,...s}=t;return generatePasswords(r,s)}{var o,e="generatePasswords"==generatePassword.caller?.name;t.verbose&&!e&&console.info("generatePassword() » Initializing character set...");let r=t.charset?.toString()||(t.numbers?charsets.numbers:"")+(t.symbols?charsets.symbols:"")+(t.lowercase?charsets.lower:"")+(t.uppercase?charsets.upper:""),s=(""==r&&(r=charsets.lower+charsets.upper),t.exclude&&(t.verbose&&!e&&console.info("generatePassword() » Removing excluded characters..."),r=r.replace(new RegExp(`[${t.exclude}]`,"g"),"")),t.excludeSimilarChars&&(t.verbose&&!e&&console.info("generatePassword() » Excluding similar characters..."),r=r.replace(/[o0Oil1|]/g,"")),t.verbose&&!e&&console.info("generatePassword() » Generating password..."),"");for(let e=0;e<t.length;e++){var n=randomInt(0,r.length);s+=r.charAt(n)}return t.strict&&(t.verbose&&!e&&console.info("generatePassword() » Enforcing strict mode..."),o=["number","symbol","lower","upper"].filter(e=>t[e+"s"]||t[e+"case"]),s=strictify(s,o)),t.verbose&&!e&&(console.info("generatePassword() » Password generated!"),"undefined"!=typeof require&&/cli(?:\.min)?\.js$/.test(require.main.filename)||console.info("generatePassword() » Check returned string.")),s}}}function generatePasswords(r,s={}){var e="https://docs.js-utils.com/generate-pw/#generatepasswordsqty-options",t={verbose:!0,length:8,charset:"",exclude:"",numbers:!1,symbols:!1,lowercase:!0,uppercase:!0,excludeSimilarChars:!1,strict:!1};if(r=parseInt(r,10),isNaN(r)||r<1)console.error("generatePasswords() » ERROR: 1st arg <qty> can only be an integer > 0."),console.info("generatePasswords() » For more help, please visit "+e);else if(validateOptions(s,t,e,"generatePasswords(3, { verbose: false, symbols: true })")){(s={...t,...s}).verbose&&console.info(`generatePasswords() » Generating password${1<r?"s":""}...`);var o=[];for(let e=0;e<r;e++)o.push(generatePassword(s));return s.verbose&&console.info(`generatePasswords() » Password${1<r?"s":""} generated!`),"undefined"!=typeof require&&/cli(?:\.min)?\.js$/.test(require.main.filename)||console.info("generatePasswords() » Check returned array."),o}}function strictify(t,o=["number","symbol","lower","upper"],e={}){var r="https://docs.js-utils.com/generate-pw/#strictifypassword-requiredchartypes-options",n={verbose:!0};if("string"!=typeof t)console.error("strictify() » ERROR: 1st arg <password> must be a string."),console.info("strictify() » For more help, please visit "+r);else{var s=["number","symbol","lower","upper"];for(const c of o=Array.isArray(o)?o:[o])if(!s.includes(c))return console.error(`strictify() » ERROR: 2nd arg \`${c}\` is an invalid character type.`),console.info(`strictify() » Valid character types: [ '${s.join("', '")}' ]`),console.info("strictify() » Pass one as a string or more as an array, or all types will be required."),void console.info("strictify() » For more help, please visit "+r);if(validateOptions(e,n,r,"strictify('pa55word', ['symbol', 'upper'], { verbose: false })")){e={...n,...e};const l={},d=[];o.forEach(e=>l[e]=!1);for(let e=0;e<t.length;e++)for(const f of o)(charsets[f]||charsets[f+"s"]).includes(t.charAt(e))&&(l[f]=!0,d.push(e));e.verbose&&console.info("strictify() » Strictifying password...");var a=Math.min(t.length,o.length);let r=0,s=t;for(const p of o)if(r<a&&!l[p]){let e;for(;e=randomInt(0,t.length),d.includes(e););d.push(e);var i=charsets[p]||charsets[p+"s"];s=s.substring(0,e)+i.charAt(randomInt(0,i.length))+s.substring(e+1),r++}return e.verbose&&(0<r?(console.info("strictify() » Password is now strict!"),console.info("strictify() » Check returned string.")):(console.info(`strictify() » Password already includes ${o.join(" + ")} characters!`),console.info("strictify() » No modifications made."))),s}}}function validateStrength(r,s={}){var e="https://docs.js-utils.com/generate-pw/#validatestrengthpassword-options",t={minLength:8,minLower:1,minUpper:1,minNumber:1,minSymbol:1},o={verbose:!0};if("string"!=typeof r)console.error("validateStrength() » ERROR: 1st arg <password> must be a string."),console.info("validateStrength() » For more help, please visit "+e);else if(validateOptions(s,o,e,"validateStrength('pa55word', { verbose: false })")){(s={...o,...s}).verbose&&console.info("validateStrength() » Validating password strength...");var n={lower:0,upper:0,number:0,symbol:0};for(const i of r)for(const c of Object.keys(n))(charsets[c]||charsets[c+"s"]).includes(i)&&n[c]++;var a=[];r.length<t.minLength&&a.push(`Make it at least ${t.minLength} characters long.`);for(const l of Object.keys(n))n[l]<t["min"+l.charAt(0).toUpperCase()+l.slice(1)]&&a.push("Include at least one "+l+`${["upper","lower"].includes(l)?"case letter":""}.`);let e=0;e+=r.length>=t.minLength?20:0;for(const d of Object.keys(n))e+=n[d]>=t["min"+d.charAt(0).toUpperCase()+d.slice(1)]?20:0;return s.verbose&&(console.info("validateStrength() » Password strength validated!"),console.info("validateStrength() » Check returned object for score/recommendations.")),{strengthScore:e,recommendations:a,isGood:80<=e}}}function validateOptions(e,r,s,t){const o=JSON.stringify(r,null,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," "),n=Object.keys(r).join(", "),a=Object.keys(r).filter(e=>"boolean"==typeof r[e]),i=Object.keys(r).filter(e=>Number.isInteger(r[e]));let c="validateOptions() » ";try{c=validateOptions.caller?.name+"() » "}catch(e){}var l=t.split(",").findIndex(e=>e.trim().startsWith("{"))+1,d=(l+=["st","nd","rd"][l-1]||"th",()=>{console.info(`${c}Valid options: [ ${n} ]`),console.info(c+"If omitted, default settings are: "+o)}),f=()=>{console.info(c+"For more help, please visit "+s)};if("object"!=typeof e)return console.error(c+`ERROR: ${"0th"==l?"[O":l+" arg [o"}ptions] can only be an object of key/values.`),console.info(c+"Example valid call: "+t),d(),f(),!1;for(const p in e){if(!Object.prototype.hasOwnProperty.call(r,p))return console.error(`${c}ERROR: \`${p}\` is an invalid option.`),d(),f(),!1;if(a.includes(p)&&"boolean"!=typeof e[p])return console.error(`${c}ERROR: [${p}] option can only be \`true\` or \`false\`.`),f(),!1;if(i.includes(p)&&(e[p]=parseInt(e[p],10),isNaN(e[p])||e[p]<1))return console.error(`${c}ERROR: [${p}] option can only be an integer > 0.`),f(),!1}return!0}const apiFunctions={generatePassword:generatePassword,generatePasswords:generatePasswords,strictify:strictify,validateStrength:validateStrength};try{module.exports={...apiFunctions}}catch(e){}try{window.pw={...apiFunctions}}catch(e){}
package/docs/README.md CHANGED
@@ -20,9 +20,9 @@
20
20
  ### Randomly generate, strengthen, and validate cryptographically-secure passwords.
21
21
 
22
22
  <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>
23
- <a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.5.2"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.5.2-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
23
+ <a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.5.4"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.5.4-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
24
24
  <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>
25
- <a href="https://github.com/adamlui/js-utils/blob/generate-pw-1.5.2/generate-pw/dist/generate-pw.min.js"><img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-pw/dist/generate-pw.min.js?branch=generate-pw-1.5.2&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
25
+ <a href="https://github.com/adamlui/js-utils/blob/generate-pw-1.5.4/generate-pw/dist/generate-pw.min.js"><img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-pw/dist/generate-pw.min.js?branch=generate-pw-1.5.4&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
26
26
  <a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:generate-pw/src/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%2Fsrc%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>
27
27
  <a href="https://github.com/toolleeo/cli-apps#password-managers"><img height=31 src="https://img.shields.io/badge/Mentioned_in-Awesome-c4a2bd?logo=awesomelists&logoColor=white&labelColor=464646&style=for-the-badge"></a>
28
28
 
@@ -82,14 +82,14 @@ const pw = require('generate-pw');
82
82
  #### <> HTML script tag:
83
83
 
84
84
  ```html
85
- <script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.2/dist/generate-pw.min.js"></script>
85
+ <script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.4/dist/generate-pw.min.js"></script>
86
86
  ```
87
87
 
88
88
  #### ES6:
89
89
 
90
90
  ```js
91
91
  (async () => {
92
- await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.2/dist/generate-pw.min.js');
92
+ await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.4/dist/generate-pw.min.js');
93
93
  // Your code here...
94
94
  })();
95
95
  ```
@@ -98,7 +98,7 @@ const pw = require('generate-pw');
98
98
 
99
99
  ```js
100
100
  ...
101
- // @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.2/dist/generate-pw.min.js
101
+ // @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.4/dist/generate-pw.min.js
102
102
  // ==/UserScript==
103
103
 
104
104
  // Your code here...
@@ -106,7 +106,7 @@ const pw = require('generate-pw');
106
106
 
107
107
  <br>
108
108
 
109
- **💡 Note:** To always import the latest version (not recommended in production!) remove the `@1.5.2` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-pw/dist/generate-pw.min.js`
109
+ **💡 Note:** To always import the latest version (not recommended in production!) remove the `@1.5.4` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-pw/dist/generate-pw.min.js`
110
110
 
111
111
  <br>
112
112
 
@@ -305,14 +305,14 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
305
305
 
306
306
  ## 🛠️ Related utilities
307
307
 
308
- ### <img height=21px src="https://i.imgur.com/kvf7fXm.png"> [generate-ip](https://js-utils.com/generate-ip) <a href="https://github.com/toolleeo/cli-apps#networking"><img height=18 src="https://awesome.re/mentioned-badge.svg"></a>
308
+ ### <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/generate-ip/media/images/icons/node-graph/white/icon55x49.png"><img height=21 src="https://raw.githubusercontent.com/adamlui/js-utils/main/generate-ip/media/images/icons/node-graph/black/icon55x49.png"></picture> [generate-ip](https://js-utils.com/generate-ip) <a href="https://github.com/toolleeo/cli-apps#networking"><img height=18 src="https://awesome.re/mentioned-badge.svg"></a>
309
309
 
310
310
  > Randomly generate, format, and validate IPv4/IPv6 addresses.
311
311
  <br>[Install](https://docs.js-utils.com/generate-ip/#-installation) /
312
312
  [Readme](https://docs.js-utils.com/generate-ip/#readme) /
313
313
  [API usage](https://docs.js-utils.com/generate-ip/#-api-usage) /
314
314
  [CLI usage](https://docs.js-utils.com/generate-ip/#-command-line-usage) /
315
- [Discuss](https://js-utils.com/discussions)
315
+ [Discuss](https://github.js-utils.com/discussions)
316
316
 
317
317
  ### <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/geolocate/media/images/icons/wire-globe/white/icon32.png"><img height=22 src="https://raw.githubusercontent.com/adamlui/js-utils/main/geolocate/media/images/icons/wire-globe/black/icon32.png"></picture> [geolocate](https://js-utils.com/geolocate)
318
318
 
@@ -321,12 +321,12 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
321
321
  [Readme](https://docs.js-utils.com/geolocate/#readme) /
322
322
  [CLI usage](https://docs.js-utils.com/geolocate/#-command-line-usage) /
323
323
  [API usage](https://docs.js-utils.com/geolocate/#-api-usage) /
324
- [Discuss](https://js-utils.com/discussions)
324
+ [Discuss](https://github.js-utils.com/discussions)
325
325
 
326
326
  <br>
327
327
 
328
328
  <img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
329
329
 
330
330
  <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/media/images/icons/home/white/icon32x27.png"><img height=13 src="https://raw.githubusercontent.com/adamlui/js-utils/main/media/images/icons/home/dark-gray/icon32x27.png"></picture> <a href="https://js-utils.com">**More JavaScript utilities**</a> /
331
- <a href="https://js-utils.com/discussions">Discuss</a> /
331
+ <a href="https://github.js-utils.com/discussions">Discuss</a> /
332
332
  <a href="#-generate-pw">Back to top ↑</a>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "generate-pw",
3
- "version": "1.5.2",
3
+ "version": "1.5.4",
4
4
  "description": "Randomly generate, strengthen, and validate cryptographically-secure passwords.",
5
5
  "author": {
6
6
  "name": "Adam Lui",
@@ -53,6 +53,6 @@
53
53
  "url": "https://github.com/sponsors/adamlui"
54
54
  },
55
55
  "devDependencies": {
56
- "@adamlui/minify.js": "^1.5.3"
56
+ "@adamlui/minify.js": "^1.5.5"
57
57
  }
58
58
  }