generate-pw 1.5.10 → 1.5.11

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.
package/README.md CHANGED
@@ -21,9 +21,9 @@
21
21
 
22
22
  <a href="https://www.npmjs.com/package/generate-pw"><img height=31 src="https://img.shields.io/npm/dm/generate-pw?logo=npm&color=af68ff&logoColor=white&labelColor=464646&style=for-the-badge"></a>
23
23
  <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>
24
- <a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.5.10"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.5.10-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
24
+ <a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.5.11"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.5.11-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
25
25
  <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>
26
- <a href="https://github.com/adamlui/js-utils/blob/generate-pw-1.5.10/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.10&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
26
+ <a href="https://github.com/adamlui/js-utils/blob/generate-pw-1.5.11/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.11&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
27
27
  <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>
28
28
  <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>
29
29
 
@@ -58,6 +58,8 @@ $ npm install generate-pw
58
58
 
59
59
  <br>
60
60
 
61
+ <a href="https://github.com/sponsors/adamlui"><img src="https://media.js-utils.com/images/banners/sponsor/$10/banner1660x260.png?09f5d64"></a>
62
+
61
63
  <img height=6px width="100%" src="https://media.js-utils.com/images/separators/gradient-aqua.png?c0192d3">
62
64
 
63
65
  ## 🔌 Importing the API
@@ -67,7 +69,7 @@ $ npm install generate-pw
67
69
  #### ECMAScript*:
68
70
 
69
71
  ```js
70
- import * as pw from 'generate-pw';
72
+ import pw from 'generate-pw';
71
73
  ```
72
74
 
73
75
  #### CommonJS:
@@ -83,14 +85,14 @@ const pw = require('generate-pw');
83
85
  #### <> HTML script tag:
84
86
 
85
87
  ```html
86
- <script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.10/dist/generate-pw.min.js"></script>
88
+ <script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.11/dist/generate-pw.min.js"></script>
87
89
  ```
88
90
 
89
91
  #### ES6:
90
92
 
91
93
  ```js
92
94
  (async () => {
93
- await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.10/dist/generate-pw.min.js');
95
+ await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.11/dist/generate-pw.min.js');
94
96
  // Your code here...
95
97
  })();
96
98
  ```
@@ -99,7 +101,7 @@ const pw = require('generate-pw');
99
101
 
100
102
  ```js
101
103
  ...
102
- // @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.10/dist/generate-pw.min.js
104
+ // @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.11/dist/generate-pw.min.js
103
105
  // ==/UserScript==
104
106
 
105
107
  // Your code here...
@@ -107,7 +109,7 @@ const pw = require('generate-pw');
107
109
 
108
110
  <br>
109
111
 
110
- **💡 Note:** To always import the latest version (not recommended in production!) remove the `@1.5.10` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-pw/dist/generate-pw.min.js`
112
+ **💡 Note:** To always import the latest version (not recommended in production!) remove the `@1.5.11` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-pw/dist/generate-pw.min.js`
111
113
 
112
114
  <br>
113
115
 
@@ -306,7 +308,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
306
308
 
307
309
  ## 🛠️ Related utilities
308
310
 
309
- ### <picture><source media="(prefers-color-scheme: dark)" srcset="https://media.generate-ip.org/images/icons/node-graph/white/icon55x49.png?b4eb06e"><img height=21 src="https://media.generate-ip.org/images/icons/node-graph/black/icon55x49.png?b4eb06e"></picture> [generate-ip](https://js-utils.com/generate-ip) <a href="https://github.com/toolleeo/cli-apps#networking"><img height=18 src="https://media.js-utils.com/images/badges/awesome/badge.svg?7b16322"></a>
311
+ ### <picture><source media="(prefers-color-scheme: dark)" srcset="https://media.generate-ip.org/images/icons/node-graph/white/icon55x49.png?b4eb06e"><img height=21 src="https://media.generate-ip.org/images/icons/node-graph/black/icon55x49.png?b4eb06e"></picture> [generate-ip](https://js-utils.com/generate-ip) &nbsp;<a href="https://github.com/toolleeo/cli-apps#networking"><img height=18 src="https://media.js-utils.com/images/badges/awesome/badge.svg?7b16322"></a>
310
312
 
311
313
  > Randomly generate, format, and validate IPv4 + IPv6 + MAC addresses.
312
314
  <br>[Install](https://docs.generate-ip.org/#-installation) /
@@ -315,7 +317,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
315
317
  [CLI usage](https://docs.generate-ip.org/#-command-line-usage) /
316
318
  [Discuss](https://github.js-utils.com/discussions)
317
319
 
318
- ### <picture><source media="(prefers-color-scheme: dark)" srcset="https://media.geolocatejs.org/images/icons/wire-globe/white/icon32.png?e735b99"><img height=22 src="https://media.geolocatejs.org/images/icons/wire-globe/black/icon32.png?e735b99"></picture> [geolocate](https://js-utils.com/geolocate)
320
+ ### <picture><source media="(prefers-color-scheme: dark)" srcset="https://media.geolocatejs.org/images/icons/wire-globe/white/icon32.png?e735b99"><img height=22 src="https://media.geolocatejs.org/images/icons/wire-globe/black/icon32.png?e735b99"></picture> [geolocate](https://js-utils.com/geolocate) &nbsp;<a href="https://github.com/toolleeo/cli-apps#networking"><img height=18 src="https://media.js-utils.com/images/badges/awesome/badge.svg?7b16322"></a>
319
321
 
320
322
  > Fetch IP geolocation data from the CLI.
321
323
  <br>[Install](https://docs.geolocatejs.org/#-installation) /
package/dist/cli.min.js CHANGED
@@ -4,7 +4,7 @@
4
4
  * Source: https://code.generatepw.org
5
5
  * Documentation: https://docs.generatepw.org
6
6
  */
7
- const pkgName="generate-pw",copyright="© 2024 Adam Lui & contributors under the MIT license.",cmdFormat="generate-pw [options|commands]",srcURL="https://code.generatepw.org",docURL="https://docs.generatepw.org/#-command-line-usage";(async()=>{const e=require(__dirname.match(/src/)?"./generate-pw":"./generate-pw.min")["generatePassword"],r=require("fs"),o=require("path"),n=require("child_process")["execSync"],t="",a="",i="";let p="en";if("win32"==process.platform)try{p=n("(Get-Culture).TwoLetterISOLanguageName",{shell:"powershell",encoding:"utf-8"}).trim()}catch(e){}else{var c=process.env;p=(c.LANG||c.LANGUAGE||c.LC_ALL||c.LC_MESSAGES||c.LC_NAME||"en").split(".")[0]}let l={};var s,c=new Promise((t,a)=>{const i="https://cdn.jsdelivr.net/gh/adamlui/js-utils@a2b9ca3a11dc5655e70679a5c9fd9ca4d2854618/generate-pw/_locales/",e=(p?p.replace("-","_"):"en")+"/";let c=i+e+"messages.json",l=0;h(c).then(async function s(e){try{const r=await e.json(),o={};for(const n in r)"object"==typeof r[n]&&"message"in r[n]&&(o[n]=r[n].message);t(o)}catch(e){if(3==++l)return t({});h(c=p.includes("-")&&1==l?c.replace(/([^_]*)_[^/]*(\/.*)/,"$1$2"):i+"en/messages.json").then(s).catch(a)}}).catch(a)});try{l=await c}catch(e){}const m={},d={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?$/}};process.argv.forEach(s=>{var e,r,o;s.startsWith("-")&&(e=Object.keys(d.paramOptions).find(e=>d.paramOptions[e].test(s)),o=Object.keys(d.flags).find(e=>d.flags[e].test(s)),r=Object.keys(d.infoCmds).find(e=>d.infoCmds[e].test(s)),o?m[o]=!0:e?(/=.+/.test(s)||(console.error(`
7
+ const pkgName="generate-pw",copyright="© 2024 Adam Lui & contributors under the MIT license.",cmdFormat="generate-pw [options|commands]",srcURL="https://code.generatepw.org",docURL="https://docs.generatepw.org/#-command-line-usage";(async()=>{const e=require(__dirname.match(/src/)?"./generate-pw":"./generate-pw.min")["generatePassword"],r=require("fs"),o=require("path"),n=require("child_process")["execSync"],t="",a="",i="";let p="en";if("win32"==process.platform)try{p=n("(Get-Culture).TwoLetterISOLanguageName",{shell:"powershell",encoding:"utf-8"}).trim()}catch(e){}else{var c=process.env;p=(c.LANG||c.LANGUAGE||c.LC_ALL||c.LC_MESSAGES||c.LC_NAME||"en").split(".")[0]}let l={};var s,c=new Promise((t,a)=>{const i="https://cdn.jsdelivr.net/gh/adamlui/js-utils@a0ebcfd439c8ac0ad471766cbe0dc859f2844835/generate-pw/_locales/",e=(p?p.replace("-","_"):"en")+"/";let c=i+e+"messages.json",l=0;h(c).then(async function s(e){try{const r=await e.json(),o={};for(const n in r)"object"==typeof r[n]&&"message"in r[n]&&(o[n]=r[n].message);t(o)}catch(e){if(3==++l)return t({});h(c=p.includes("-")&&1==l?c.replace(/([^_]*)_[^/]*(\/.*)/,"$1$2"):i+"en/messages.json").then(s).catch(a)}}).catch(a)});try{l=await c}catch(e){}const m={},d={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?$/}};process.argv.forEach(s=>{var e,r,o;s.startsWith("-")&&(e=Object.keys(d.paramOptions).find(e=>d.paramOptions[e].test(s)),o=Object.keys(d.flags).find(e=>d.flags[e].test(s)),r=Object.keys(d.infoCmds).find(e=>d.infoCmds[e].test(s)),o?m[o]=!0:e?(/=.+/.test(s)||(console.error(`
8
8
  ${a+(l.prefix_error||"ERROR")}: `+`Arg [--${s.replace(/-/g,"")}] `+`${l.error_noEqual||"requires '=' followed by a value"}.${t}`),f(),process.exit(1)),o=s.split("=")[1],m[e]=parseInt(o)||o):r||(console.error(`
9
9
  ${a+(l.prefix_error||"ERROR")}: `+`Arg [${s}] ${l.error_notRecognized||"not recognized"}.`),console.info(`
10
10
  ${""+(l.info_validArgs||"Valid arguments are below")}.`),g(["paramOptions","flags","infoCmds"]),process.exit(1)))});for(const $ of["length","qty"])m[$]&&(isNaN(m[$])||m[$]<1)&&(console.error(`
@@ -3,4 +3,4 @@
3
3
  * Source: https://code.generatepw.org
4
4
  * Documentation: https://docs.generatepw.org
5
5
  */
6
- 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.generatepw.org/#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.generatepw.org/#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.generatepw.org/#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 p of o)(charsets[p]||charsets[p+"s"]).includes(t.charAt(e))&&(l[p]=!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 f of o)if(r<a&&!l[f]){let e;for(;e=randomInt(0,t.length),d.includes(e););d.push(e);var i=charsets[f]||charsets[f+"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.generatepw.org/#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 randomInt(e,r){var s;return"undefined"==typeof require?(s=(window.crypto||window.msCrypto)?.getRandomValues(new Uint32Array(1))[0]/4294967295||Math.random(),Math.floor(s*(r-e))+e):require("crypto").randomInt(e,r)}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 funcAliases={generatePassword:["generate","generatepassword","generatepw","generatePw","generatePW","Generate","Generatepassword","GeneratePassword","Generatepw","GeneratePw","GeneratePW"],generatePasswords:["generatepasswords","generatepws","generatePws","generatePWs","generatePWS","Generatepasswords","GeneratePasswords","Generatepws","GeneratePws","GeneratePWs","GeneratePWS"],strictify:["Strictify"],validateStrength:["validate","Validate","validatestrength","Validatestrength","ValidateStrength"]},apiFunctions={generatePassword:generatePassword,generatePasswords:generatePasswords,strictify:strictify,validateStrength:validateStrength};try{module.exports={...apiFunctions}}catch(e){}try{window.pw={...apiFunctions}}catch(e){}for(const wa in funcAliases){try{funcAliases[wa].forEach(e=>module.exports[e]=module.exports[wa])}catch(e){}try{funcAliases[wa].forEach(e=>window.pw[e]=window.pw[wa])}catch(e){}}
6
+ 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.generatepw.org/#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 window)&&console.info("generatePassword() » Check returned string."),s}}}function generatePasswords(r,s={}){var e="https://docs.generatepw.org/#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 window)&&console.info("generatePasswords() » Check returned array."),o}}function strictify(t,o=["number","symbol","lower","upper"],e={}){var r="https://docs.generatepw.org/#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 p of o)(charsets[p]||charsets[p+"s"]).includes(t.charAt(e))&&(l[p]=!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 g of o)if(r<a&&!l[g]){let e;for(;e=randomInt(0,t.length),d.includes(e););d.push(e);var i=charsets[g]||charsets[g+"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.generatepw.org/#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 randomInt(e,r){var s;return"undefined"==typeof require?(s=(window.crypto||window.msCrypto)?.getRandomValues(new Uint32Array(1))[0]/4294967295||Math.random(),Math.floor(s*(r-e))+e):require("crypto").randomInt(e,r)}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 g in e){if(!Object.prototype.hasOwnProperty.call(r,g))return console.error(`${c}ERROR: \`${g}\` is an invalid option.`),d(),p(),!1;if(a.includes(g)&&"boolean"!=typeof e[g])return console.error(`${c}ERROR: [${g}] option can only be \`true\` or \`false\`.`),p(),!1;if(i.includes(g)&&(e[g]=parseInt(e[g],10),isNaN(e[g])||e[g]<1))return console.error(`${c}ERROR: [${g}] option can only be an integer > 0.`),p(),!1}return!0}const gpwAliases={generatePassword:["generate","generatepassword","generatepw","generatePw","generatePW","Generate","Generatepassword","GeneratePassword","Generatepw","GeneratePw","GeneratePW"],generatePasswords:["generatepasswords","generatepws","generatePws","generatePWs","generatePWS","Generatepasswords","GeneratePasswords","Generatepws","GeneratePws","GeneratePWs","GeneratePWS"],strictify:["Strictify"],validateStrength:["validate","Validate","validatestrength","Validatestrength","ValidateStrength"]},gpwFuncs={generatePassword:generatePassword,generatePasswords:generatePasswords,strictify:strictify,validateStrength:validateStrength};try{module.exports={...gpwFuncs}}catch(e){}try{window.pw={...gpwFuncs}}catch(e){}for(const wa in gpwAliases){try{gpwAliases[wa].forEach(e=>module.exports[e]=module.exports[wa])}catch(e){}try{gpwAliases[wa].forEach(e=>window.pw[e]=window.pw[wa])}catch(e){}}
package/docs/README.md CHANGED
@@ -21,9 +21,9 @@
21
21
 
22
22
  <a href="https://www.npmjs.com/package/generate-pw"><img height=31 src="https://img.shields.io/npm/dm/generate-pw?logo=npm&color=af68ff&logoColor=white&labelColor=464646&style=for-the-badge"></a>
23
23
  <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>
24
- <a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.5.10"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.5.10-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
24
+ <a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.5.11"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.5.11-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
25
25
  <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>
26
- <a href="https://github.com/adamlui/js-utils/blob/generate-pw-1.5.10/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.10&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
26
+ <a href="https://github.com/adamlui/js-utils/blob/generate-pw-1.5.11/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.11&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
27
27
  <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>
28
28
  <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>
29
29
 
@@ -58,6 +58,8 @@ $ npm install generate-pw
58
58
 
59
59
  <br>
60
60
 
61
+ <a href="https://github.com/sponsors/adamlui"><img src="https://media.js-utils.com/images/banners/sponsor/$10/banner1660x260.png?09f5d64"></a>
62
+
61
63
  <img height=6px width="100%" src="https://media.js-utils.com/images/separators/gradient-aqua.png?c0192d3">
62
64
 
63
65
  ## 🔌 Importing the API
@@ -67,7 +69,7 @@ $ npm install generate-pw
67
69
  #### ECMAScript*:
68
70
 
69
71
  ```js
70
- import * as pw from 'generate-pw';
72
+ import pw from 'generate-pw';
71
73
  ```
72
74
 
73
75
  #### CommonJS:
@@ -83,14 +85,14 @@ const pw = require('generate-pw');
83
85
  #### <> HTML script tag:
84
86
 
85
87
  ```html
86
- <script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.10/dist/generate-pw.min.js"></script>
88
+ <script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.11/dist/generate-pw.min.js"></script>
87
89
  ```
88
90
 
89
91
  #### ES6:
90
92
 
91
93
  ```js
92
94
  (async () => {
93
- await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.10/dist/generate-pw.min.js');
95
+ await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.11/dist/generate-pw.min.js');
94
96
  // Your code here...
95
97
  })();
96
98
  ```
@@ -99,7 +101,7 @@ const pw = require('generate-pw');
99
101
 
100
102
  ```js
101
103
  ...
102
- // @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.10/dist/generate-pw.min.js
104
+ // @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.11/dist/generate-pw.min.js
103
105
  // ==/UserScript==
104
106
 
105
107
  // Your code here...
@@ -107,7 +109,7 @@ const pw = require('generate-pw');
107
109
 
108
110
  <br>
109
111
 
110
- **💡 Note:** To always import the latest version (not recommended in production!) remove the `@1.5.10` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-pw/dist/generate-pw.min.js`
112
+ **💡 Note:** To always import the latest version (not recommended in production!) remove the `@1.5.11` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-pw/dist/generate-pw.min.js`
111
113
 
112
114
  <br>
113
115
 
@@ -306,7 +308,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
306
308
 
307
309
  ## 🛠️ Related utilities
308
310
 
309
- ### <picture><source media="(prefers-color-scheme: dark)" srcset="https://media.generate-ip.org/images/icons/node-graph/white/icon55x49.png?b4eb06e"><img height=21 src="https://media.generate-ip.org/images/icons/node-graph/black/icon55x49.png?b4eb06e"></picture> [generate-ip](https://js-utils.com/generate-ip) <a href="https://github.com/toolleeo/cli-apps#networking"><img height=18 src="https://media.js-utils.com/images/badges/awesome/badge.svg?7b16322"></a>
311
+ ### <picture><source media="(prefers-color-scheme: dark)" srcset="https://media.generate-ip.org/images/icons/node-graph/white/icon55x49.png?b4eb06e"><img height=21 src="https://media.generate-ip.org/images/icons/node-graph/black/icon55x49.png?b4eb06e"></picture> [generate-ip](https://js-utils.com/generate-ip) &nbsp;<a href="https://github.com/toolleeo/cli-apps#networking"><img height=18 src="https://media.js-utils.com/images/badges/awesome/badge.svg?7b16322"></a>
310
312
 
311
313
  > Randomly generate, format, and validate IPv4 + IPv6 + MAC addresses.
312
314
  <br>[Install](https://docs.generate-ip.org/#-installation) /
@@ -315,7 +317,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
315
317
  [CLI usage](https://docs.generate-ip.org/#-command-line-usage) /
316
318
  [Discuss](https://github.js-utils.com/discussions)
317
319
 
318
- ### <picture><source media="(prefers-color-scheme: dark)" srcset="https://media.geolocatejs.org/images/icons/wire-globe/white/icon32.png?e735b99"><img height=22 src="https://media.geolocatejs.org/images/icons/wire-globe/black/icon32.png?e735b99"></picture> [geolocate](https://js-utils.com/geolocate)
320
+ ### <picture><source media="(prefers-color-scheme: dark)" srcset="https://media.geolocatejs.org/images/icons/wire-globe/white/icon32.png?e735b99"><img height=22 src="https://media.geolocatejs.org/images/icons/wire-globe/black/icon32.png?e735b99"></picture> [geolocate](https://js-utils.com/geolocate) &nbsp;<a href="https://github.com/toolleeo/cli-apps#networking"><img height=18 src="https://media.js-utils.com/images/badges/awesome/badge.svg?7b16322"></a>
319
321
 
320
322
  > Fetch IP geolocation data from the CLI.
321
323
  <br>[Install](https://docs.geolocatejs.org/#-installation) /
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "generate-pw",
3
- "version": "1.5.10",
3
+ "version": "1.5.11",
4
4
  "description": "Randomly generate, strengthen, and validate cryptographically-secure passwords.",
5
5
  "author": {
6
6
  "name": "Adam Lui",
@@ -11,7 +11,6 @@
11
11
  "license": "MIT",
12
12
  "main": "dist/generate-pw.min.js",
13
13
  "files": [
14
- "dist",
15
14
  "docs/",
16
15
  "!docs/*/"
17
16
  ],
@@ -53,6 +52,6 @@
53
52
  "url": "https://github.com/sponsors/adamlui"
54
53
  },
55
54
  "devDependencies": {
56
- "@adamlui/minify.js": "^1.6.1"
55
+ "@adamlui/minify.js": "^1.8.0"
57
56
  }
58
57
  }