generate-pw 1.5.1 → 1.5.2
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 +8 -7
- package/dist/cli.min.js +3 -3
- package/dist/generate-pw.min.js +1 -1
- package/docs/LICENSE.md +2 -1
- package/docs/README.md +8 -7
- package/docs/SECURITY.md +2 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -10,7 +10,8 @@
|
|
|
10
10
|
<a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/hi#readme">हिंदी</a> |
|
|
11
11
|
<a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/bn#readme">বাংলা</a> |
|
|
12
12
|
<a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/de#readme">Deutsch</a> |
|
|
13
|
-
<a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/es#readme">Español</a>
|
|
13
|
+
<a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/es#readme">Español</a> |
|
|
14
|
+
<a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/fr#readme">Français</a>
|
|
14
15
|
</h6>
|
|
15
16
|
</div>
|
|
16
17
|
|
|
@@ -19,9 +20,9 @@
|
|
|
19
20
|
### Randomly generate, strengthen, and validate cryptographically-secure passwords.
|
|
20
21
|
|
|
21
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>
|
|
22
|
-
<a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.5.
|
|
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
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>
|
|
24
|
-
<a href="https://github.com/adamlui/js-utils/blob/generate-pw-1.5.
|
|
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
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>
|
|
26
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>
|
|
27
28
|
|
|
@@ -81,14 +82,14 @@ const pw = require('generate-pw');
|
|
|
81
82
|
#### <> HTML script tag:
|
|
82
83
|
|
|
83
84
|
```html
|
|
84
|
-
<script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.
|
|
85
|
+
<script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.2/dist/generate-pw.min.js"></script>
|
|
85
86
|
```
|
|
86
87
|
|
|
87
88
|
#### ES6:
|
|
88
89
|
|
|
89
90
|
```js
|
|
90
91
|
(async () => {
|
|
91
|
-
await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.
|
|
92
|
+
await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.2/dist/generate-pw.min.js');
|
|
92
93
|
// Your code here...
|
|
93
94
|
})();
|
|
94
95
|
```
|
|
@@ -97,7 +98,7 @@ const pw = require('generate-pw');
|
|
|
97
98
|
|
|
98
99
|
```js
|
|
99
100
|
...
|
|
100
|
-
// @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.
|
|
101
|
+
// @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.2/dist/generate-pw.min.js
|
|
101
102
|
// ==/UserScript==
|
|
102
103
|
|
|
103
104
|
// Your code here...
|
|
@@ -105,7 +106,7 @@ const pw = require('generate-pw');
|
|
|
105
106
|
|
|
106
107
|
<br>
|
|
107
108
|
|
|
108
|
-
**💡 Note:** To always import the latest version (not recommended in production!) remove the `@1.5.
|
|
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
110
|
|
|
110
111
|
<br>
|
|
111
112
|
|
package/dist/cli.min.js
CHANGED
|
@@ -4,12 +4,12 @@
|
|
|
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="[0m",br="[1;91m",by="[1;33m",config={},argRegex={paramOptions:{length:/^--?length(?:=.*|$)/,qty:/^--?qu?a?n?ti?t?y(?:=.*|$)/,charset:/^--?
|
|
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="[0m",br="[1;91m",by="[1;33m",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
|
-
${by}Valid arguments are below.`+nc),printHelpSections(["paramOptions","flags","infoCmds"]),printHelpCmdAndDocURL(),process.exit(1)))}),
|
|
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,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:[`
|
|
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
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(`
|
|
14
14
|
${by}For more help, type 'generate-pw --help' or visit
|
|
15
15
|
`+(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||(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 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){}
|
package/docs/LICENSE.md
CHANGED
|
@@ -10,7 +10,8 @@
|
|
|
10
10
|
<a href="hi/LICENSE.md">हिंदी</a> |
|
|
11
11
|
<a href="bn/LICENSE.md">বাংলা</a> |
|
|
12
12
|
<a href="de/LICENSE.md">Deutsch</a> |
|
|
13
|
-
<a href="es/LICENSE.md">Español</a>
|
|
13
|
+
<a href="es/LICENSE.md">Español</a> |
|
|
14
|
+
<a href="fr/LICENSE.md">Français</a>
|
|
14
15
|
</h6>
|
|
15
16
|
</div>
|
|
16
17
|
|
package/docs/README.md
CHANGED
|
@@ -10,7 +10,8 @@
|
|
|
10
10
|
<a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/hi#readme">हिंदी</a> |
|
|
11
11
|
<a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/bn#readme">বাংলা</a> |
|
|
12
12
|
<a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/de#readme">Deutsch</a> |
|
|
13
|
-
<a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/es#readme">Español</a>
|
|
13
|
+
<a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/es#readme">Español</a> |
|
|
14
|
+
<a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/fr#readme">Français</a>
|
|
14
15
|
</h6>
|
|
15
16
|
</div>
|
|
16
17
|
|
|
@@ -19,9 +20,9 @@
|
|
|
19
20
|
### Randomly generate, strengthen, and validate cryptographically-secure passwords.
|
|
20
21
|
|
|
21
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>
|
|
22
|
-
<a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.5.
|
|
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
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>
|
|
24
|
-
<a href="https://github.com/adamlui/js-utils/blob/generate-pw-1.5.
|
|
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
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>
|
|
26
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>
|
|
27
28
|
|
|
@@ -81,14 +82,14 @@ const pw = require('generate-pw');
|
|
|
81
82
|
#### <> HTML script tag:
|
|
82
83
|
|
|
83
84
|
```html
|
|
84
|
-
<script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.
|
|
85
|
+
<script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.2/dist/generate-pw.min.js"></script>
|
|
85
86
|
```
|
|
86
87
|
|
|
87
88
|
#### ES6:
|
|
88
89
|
|
|
89
90
|
```js
|
|
90
91
|
(async () => {
|
|
91
|
-
await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.
|
|
92
|
+
await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.2/dist/generate-pw.min.js');
|
|
92
93
|
// Your code here...
|
|
93
94
|
})();
|
|
94
95
|
```
|
|
@@ -97,7 +98,7 @@ const pw = require('generate-pw');
|
|
|
97
98
|
|
|
98
99
|
```js
|
|
99
100
|
...
|
|
100
|
-
// @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.
|
|
101
|
+
// @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.2/dist/generate-pw.min.js
|
|
101
102
|
// ==/UserScript==
|
|
102
103
|
|
|
103
104
|
// Your code here...
|
|
@@ -105,7 +106,7 @@ const pw = require('generate-pw');
|
|
|
105
106
|
|
|
106
107
|
<br>
|
|
107
108
|
|
|
108
|
-
**💡 Note:** To always import the latest version (not recommended in production!) remove the `@1.5.
|
|
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
110
|
|
|
110
111
|
<br>
|
|
111
112
|
|
package/docs/SECURITY.md
CHANGED
|
@@ -10,7 +10,8 @@
|
|
|
10
10
|
<a href="hi/SECURITY.md">हिंदी</a> |
|
|
11
11
|
<a href="bn/SECURITY.md">বাংলা</a> |
|
|
12
12
|
<a href="de/SECURITY.md">Deutsch</a> |
|
|
13
|
-
<a href="es/SECURITY.md">Español</a>
|
|
13
|
+
<a href="es/SECURITY.md">Español</a> |
|
|
14
|
+
<a href="fr/SECURITY.md">Français</a>
|
|
14
15
|
</h6>
|
|
15
16
|
</div>
|
|
16
17
|
|