generate-pw 1.5.14 โ 1.5.16
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 +25 -23
- package/dist/cli/index.min.js +21 -0
- package/dist/cli/lib/data.min.js +6 -0
- package/dist/cli/lib/language.min.js +6 -0
- package/dist/data/app.json +17 -0
- package/dist/data/messages.json +35 -0
- package/dist/generate-pw.min.js +1 -1
- package/docs/README.md +27 -23
- package/package.json +10 -6
- package/dist/cli.min.js +0 -26
package/README.md
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
<a id="top"></a>
|
|
2
|
+
|
|
1
3
|
<div align="right">
|
|
2
4
|
<h6>
|
|
3
5
|
<picture>
|
|
@@ -22,17 +24,17 @@
|
|
|
22
24
|
<a href="https://www.npmjs.com/package/generate-pw">
|
|
23
25
|
<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>
|
|
24
26
|
<a href="#%EF%B8%8F-mit-license">
|
|
25
|
-
<img height=31 src="https://img.shields.io/badge/License-MIT-
|
|
26
|
-
<a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.5.
|
|
27
|
-
<img height=31 src="https://img.shields.io/badge/Latest_Build-1.5.
|
|
27
|
+
<img height=31 src="https://img.shields.io/badge/License-MIT-orange.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
|
|
28
|
+
<a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.5.16">
|
|
29
|
+
<img height=31 src="https://img.shields.io/badge/Latest_Build-1.5.16-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
|
|
28
30
|
<a href="https://www.npmjs.com/package/generate-pw?activeTab=code">
|
|
29
31
|
<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>
|
|
30
|
-
<a href="https://github.com/adamlui/js-utils/blob/generate-pw-1.5.
|
|
31
|
-
<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.
|
|
32
|
+
<a href="https://github.com/adamlui/js-utils/blob/generate-pw-1.5.16/generate-pw/dist/generate-pw.min.js">
|
|
33
|
+
<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.16&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
|
|
32
34
|
<a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:generate-pw/src/generate-pw.js">
|
|
33
35
|
<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>
|
|
34
36
|
<a href="https://github.com/toolleeo/cli-apps#password-managers">
|
|
35
|
-
<img height=31 src="https://img.shields.io/badge/Mentioned_in-Awesome-
|
|
37
|
+
<img height=31 src="https://img.shields.io/badge/Mentioned_in-Awesome-ff69b4?logo=awesomelists&logoColor=white&labelColor=464646&style=for-the-badge"></a>
|
|
36
38
|
|
|
37
39
|
<br>
|
|
38
40
|
|
|
@@ -82,7 +84,7 @@ import pw from 'generate-pw';
|
|
|
82
84
|
#### CommonJS:
|
|
83
85
|
|
|
84
86
|
```js
|
|
85
|
-
const pw = require('generate-pw')
|
|
87
|
+
const pw = require('generate-pw')
|
|
86
88
|
```
|
|
87
89
|
|
|
88
90
|
###### _*Node.js version 14 or higher required_
|
|
@@ -92,23 +94,23 @@ const pw = require('generate-pw');
|
|
|
92
94
|
#### <> HTML script tag:
|
|
93
95
|
|
|
94
96
|
```html
|
|
95
|
-
<script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.
|
|
97
|
+
<script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.16/dist/generate-pw.min.js"></script>
|
|
96
98
|
```
|
|
97
99
|
|
|
98
100
|
#### ES6:
|
|
99
101
|
|
|
100
102
|
```js
|
|
101
103
|
(async () => {
|
|
102
|
-
await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.
|
|
104
|
+
await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.16/dist/generate-pw.min.js')
|
|
103
105
|
// Your code here...
|
|
104
|
-
})()
|
|
106
|
+
})()
|
|
105
107
|
```
|
|
106
108
|
|
|
107
109
|
### <img height=17 src="https://assets.js-utils.org/images/icons/platforms/tampermonkey/icon28.png?v=0d36e26"><img height=17.5 src="https://assets.js-utils.org/images/icons/platforms/violentmonkey/icon25.png?v=0d36e26"> Greasemonkey
|
|
108
110
|
|
|
109
111
|
```js
|
|
110
112
|
...
|
|
111
|
-
// @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.
|
|
113
|
+
// @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.16/dist/generate-pw.min.js
|
|
112
114
|
// ==/UserScript==
|
|
113
115
|
|
|
114
116
|
// Your code here...
|
|
@@ -116,7 +118,7 @@ const pw = require('generate-pw');
|
|
|
116
118
|
|
|
117
119
|
<br>
|
|
118
120
|
|
|
119
|
-
**๐ก Note:** To always import the latest version (not recommended in production!) remove the `@1.5.
|
|
121
|
+
**๐ก Note:** To always import the latest version (not recommended in production!) remove the `@1.5.16` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-pw/dist/generate-pw.min.js`
|
|
120
122
|
|
|
121
123
|
<br>
|
|
122
124
|
|
|
@@ -129,15 +131,15 @@ const pw = require('generate-pw');
|
|
|
129
131
|
Generates **one** password if `qty` option is not given, returning a string:
|
|
130
132
|
|
|
131
133
|
```js
|
|
132
|
-
const password = pw.generatePassword({ length: 11, numbers: true })
|
|
133
|
-
console.log(password)
|
|
134
|
+
const password = pw.generatePassword({ length: 11, numbers: true })
|
|
135
|
+
console.log(password) // sample output: 'bAsZm3mq6Qn'
|
|
134
136
|
```
|
|
135
137
|
|
|
136
138
|
...or **multiple** passwords if `qty` option is given, returning an array of strings:
|
|
137
139
|
|
|
138
140
|
```js
|
|
139
|
-
const passwords = pw.generatePassword({ qty: 5, length: 8, symbols: true })
|
|
140
|
-
console.log(passwords)
|
|
141
|
+
const passwords = pw.generatePassword({ qty: 5, length: 8, symbols: true })
|
|
142
|
+
console.log(passwords)
|
|
141
143
|
|
|
142
144
|
/* sample output:
|
|
143
145
|
|
|
@@ -159,8 +161,8 @@ See: [Available options](#available-options-for-generate-functions)
|
|
|
159
161
|
Generates **multiple** passwords based on `qty` given, returning an array of strings:
|
|
160
162
|
|
|
161
163
|
```js
|
|
162
|
-
const passwords = pw.generatePasswords(5, { length: 3, uppercase: false })
|
|
163
|
-
console.log(passwords)
|
|
164
|
+
const passwords = pw.generatePasswords(5, { length: 3, uppercase: false })
|
|
165
|
+
console.log(passwords)
|
|
164
166
|
|
|
165
167
|
/* sample output:
|
|
166
168
|
|
|
@@ -182,8 +184,8 @@ See: [Available options](#available-options-for-generate-functions)
|
|
|
182
184
|
Modifies `password` given to use at least one character of each `requiredCharTypes` element passed, returning a string:
|
|
183
185
|
|
|
184
186
|
```js
|
|
185
|
-
const strictPW = pw.strictify('abcdef', ['numbers', 'symbols'])
|
|
186
|
-
console.log(strictPW)
|
|
187
|
+
const strictPW = pw.strictify('abcdef', ['numbers', 'symbols'])
|
|
188
|
+
console.log(strictPW) // sample output: 'a!c2ef'
|
|
187
189
|
```
|
|
188
190
|
|
|
189
191
|
**๐ก Note:** If no `requiredCharTypes` array is passed, all available types will be required.
|
|
@@ -208,8 +210,8 @@ Validates the strength of a password, returning an object containing:
|
|
|
208
210
|
Example:
|
|
209
211
|
|
|
210
212
|
```js
|
|
211
|
-
const pwStrength = pw.validateStrength('Aa?idsE')
|
|
212
|
-
console.log(pwStrength)
|
|
213
|
+
const pwStrength = pw.validateStrength('Aa?idsE')
|
|
214
|
+
console.log(pwStrength)
|
|
213
215
|
|
|
214
216
|
/* outputs:
|
|
215
217
|
|
|
@@ -339,4 +341,4 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
|
|
|
339
341
|
|
|
340
342
|
<picture><source media="(prefers-color-scheme: dark)" srcset="https://assets.js-utils.org/images/icons/home/white/icon32x27.png?v=0d36e26"><img height=13 src="https://assets.js-utils.org/images/icons/home/dark-gray/icon32x27.png?v=0d36e26"></picture> <a href="https://js-utils.org">**More JavaScript utilities**</a> /
|
|
341
343
|
<a href="https://github.com/adamlui/js-utils/discussions">Discuss</a> /
|
|
342
|
-
<a href="
|
|
344
|
+
<a href="#top">Back to top โ</a>
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* ยฉ 2024โ2026 Adam Lui & contributors under the MIT license.
|
|
4
|
+
* Source: https://code.generatepw.org
|
|
5
|
+
* Documentation: https://docs.generatepw.org
|
|
6
|
+
*/
|
|
7
|
+
(async()=>{globalThis.env={devMode:__dirname.match(/[\\/]src/)};var e,s=require("node-clipboardy"),p=require("child_process").execSync,a=require("fs"),o=require(`../generate-pw${env.devMode?"":".min"}.js`).generatePassword,{getMsgs:r,getSysLang:n}=require(`./lib/language${env.devMode?"":".min"}.js`),i=require("path");globalThis.app=require(`../${env.devMode?"../":"./data/"}app.json`),app.urls.docs+="/#-command-line-usage",app.msgs=await r(n()),app.regex={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?$/},version:/^[~^>=]?\d+\.\d+\.\d+$/};let c={nc:"[0m",br:"[1;91m",by:"[1;33m",bg:"[1;92m",bw:"[1;97m",blk:"[30m",btBG:"[106m"};app.config={},process.argv.forEach(s=>{var e,p,a;s.startsWith("-")&&(e=Object.keys(app.regex.paramOptions).find(e=>app.regex.paramOptions[e].test(s)),a=Object.keys(app.regex.flags).find(e=>app.regex.flags[e].test(s)),p=Object.keys(app.regex.infoCmds).find(e=>app.regex.infoCmds[e].test(s)),a?app.config[a]=!0:e?(/=.+/.test(s)||(console.error(`
|
|
8
|
+
${c.br}${app.msgs.prefix_error}: Arg [--${s.replace(/-/g,"")}] ${app.msgs.error_noEqual}.`+c.nc),l(),process.exit(1)),a=s.split("=")[1],app.config[e]=parseInt(a)||a):p||(console.error(`
|
|
9
|
+
${c.br}${app.msgs.prefix_error}: Arg [${s}] ${app.msgs.error_notRecognized}.`+c.nc),console.info(`
|
|
10
|
+
${c.by}${app.msgs.info_validArgs}.`+c.nc),g(["paramOptions","flags","infoCmds"]),process.exit(1)))});for(e of["length","qty"])app.config[e]&&(isNaN(app.config[e])||app.config[e]<1)&&(console.error(`
|
|
11
|
+
${c.br}${app.msgs.prefix_error}: [${e}] ${app.msgs.error_nonPositiveNum}.`+c.nc),l(),process.exit(1));if(process.argv.some(e=>app.regex.infoCmds.help.test(e)))g();else if(process.argv.some(e=>app.regex.infoCmds.version.test(e))){r=p(`npm view ${JSON.stringify(app.name)} version`).toString().trim()||"none";let e,s=process.cwd();for(;"/"!=s;){var t=i.join(s,"package.json");if(a.existsSync(t)){t=require(t);e=(t.dependencies?.[app.name]||t.devDependencies?.[app.name])?.match(app.regex.version)?.[1]||"none";break}s=i.dirname(s)}console.info(`
|
|
12
|
+
${app.msgs.prefix_globalVer}: `+r),console.info(app.msgs.prefix_localVer+": "+e)}else{n=o({length:app.config.length||8,qty:app.config.qty||1,charset:app.config.charset,exclude:app.config.excludeChars,numbers:!!app.config.includeNums,symbols:!!app.config.includeSymbols,lowercase:!app.config.excludeLowerChars,uppercase:!app.config.excludeUpperChars,excludeSimilarChars:!!app.config.excludeSimilarChars,strict:!!app.config.strictMode,verbose:!app.config.quietMode});p=`
|
|
13
|
+
${app.msgs.info_copying}...`,app.config.quietMode||console.info(p),s.writeSync([].concat(n).join("\n"))}function l(){console.info(`
|
|
14
|
+
${app.msgs.info_moreHelp}, ${app.msgs.info_type} ${app.name} --help' ${app.msgs.info_or} ${app.msgs.info_visit}
|
|
15
|
+
`+c.bw+app.urls.docs+c.nc)}function g(e=["header","usage","paramOptions","flags","infoCmds"]){app.prefix=""+c.btBG+c.blk+`[30m ${app.name} ${c.nc} `;let s={header:[`
|
|
16
|
+
โ ${app.prefix}${app.msgs.appCopyright||`ยฉ ${app.copyrightYear} ${app.author} under the ${app.license} license`}.`,""+app.prefix+app.msgs.prefix_source+": "+app.urls.src],usage:[`
|
|
17
|
+
${c.bw}o ${app.msgs.helpSection_usage}:`+c.nc,` ${c.bw}ยป `+c.bg+app.cmdFormat+c.nc],paramOptions:[`
|
|
18
|
+
${c.bw}o ${app.msgs.helpSection_paramOptions}:`+c.nc,` --length=n ${app.msgs.optionDesc_length}.`,` --qty=n ${app.msgs.optionDesc_qty}.`,` --charset=chars ${app.msgs.optionDesc_charset}.`,` --exclude=chars ${app.msgs.optionDesc_exclude}.`],flags:[`
|
|
19
|
+
${c.bw}o ${app.msgs.helpSection_flags}:`+c.nc,` -n, --include-numbers ${app.msgs.optionDesc_includeNums}.`,` -y, --include-symbols ${app.msgs.optionDesc_includeSymbols}.`,` -L, --no-lowercase ${app.msgs.optionDesc_noLower}.`,` -U, --no-uppercase ${app.msgs.optionDesc_noUpper}.`,` -S, --no-similar ${app.msgs.optionDesc_noSimilar}.`,` -s, --strict ${app.msgs.optionDesc_strict}.`,` -q, --quiet ${app.msgs.optionDesc_quiet}.`],infoCmds:[`
|
|
20
|
+
${c.bw}o ${app.msgs.helpSection_infoCmds}:`+c.nc," -h, --help "+app.msgs.optionDesc_help,` -v, --version ${app.msgs.optionDesc_version}.`]};e.forEach(n=>s[n]?.forEach(s=>{{var r=/header|usage/.test(n)?1:29;let p=process.stdout.columns||80,a=[],e=s.match(/\S+|\s+/g),o="";e.forEach(e=>{var s=p-(a.length?r:0);o.length+"| ".length+e.length>s&&(a.push(a.length?o.trimStart():o),o=""),o+=e}),a.push(a.length?o.trimStart():o),a.forEach((e,s)=>console.info("| "+(0==s?e:" ".repeat(r)+e)))}})),console.info(`
|
|
21
|
+
${app.msgs.info_moreHelp}, ${app.msgs.info_visit}: `+c.bw+app.urls.docs+c.nc)}})();
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ยฉ 2024โ2026 Adam Lui & contributors under the MIT license.
|
|
3
|
+
* Source: https://code.generatepw.org
|
|
4
|
+
* Documentation: https://docs.generatepw.org
|
|
5
|
+
*/
|
|
6
|
+
module.exports={fetch(n){return new Promise((t,e)=>{var r=n.match(/^([^:]+):\/\//)[1];/^https?$/.test(r)||e(new Error(app.msgs.error_invalidURL+".")),require(r).get(n,e=>{let r="";e.on("data",e=>r+=e),e.on("end",()=>t({json:()=>JSON.parse(r)}))}).on("error",e)})},flatten(e,{key:r="message"}={}){var t,n={};for(t in e)n[t]="object"==typeof e[t]&&r in e[t]?e[t][r]:e[t];return n}};
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ยฉ 2024โ2026 Adam Lui & contributors under the MIT license.
|
|
3
|
+
* Source: https://code.generatepw.org
|
|
4
|
+
* Documentation: https://docs.generatepw.org
|
|
5
|
+
*/
|
|
6
|
+
module.exports={async getMsgs(r="en"){var e=require(`./data${env.devMode?"":".min"}.js`);let t=e.flatten(require(`../../${env.devMode?"../_locales/en/":"data/"}messages.json`),{key:"message"});if(!r.startsWith("en")){var n=`${app.urls.jsdelivr}@${app.commitHashes.locales}/${app.name}/_locales/`;let s=n+`${r?r.replace("-","_"):"en"}/`+"messages.json",a=0;for(;a<3;)try{t=e.flatten(await(await e.fetch(s)).json(),{key:"message"});break}catch(e){if(3==++a)break;s=r.includes("-")&&1==a?s.replace(/([^_]*)_[^/]*(\/.*)/,"$1$2"):n+"en/messages.json"}}return t},getSysLang(){var e;if("win32"!=process.platform)return((e=process.env).LANG||e.LANGUAGE||e.LC_ALL||e.LC_MESSAGES||e.LC_NAME||"en").split(".")[0];try{return require("child_process").execSync("(Get-Culture).TwoLetterISOLanguageName",{shell:"powershell",encoding:"utf-8"}).trim()}catch(e){return console.error("ERROR loading system language:",e.message),"en"}}};
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "generate-pw",
|
|
3
|
+
"author": "Adam Lui & contributors",
|
|
4
|
+
"license": "MIT",
|
|
5
|
+
"copyrightYear": "2024โ2026",
|
|
6
|
+
"cmdFormat": "generate-pw [options|commands]",
|
|
7
|
+
"urls": {
|
|
8
|
+
"docs": "https://github.com/adamlui/js-utils/tree/main/generate-pw/docs",
|
|
9
|
+
"github": "https://github.com/adamlui/js-utils",
|
|
10
|
+
"jsdelivr": "https://cdn.jsdelivr.net/gh/adamlui/js-utils",
|
|
11
|
+
"npm": "https://www.npmjs.com/package/generate-pw",
|
|
12
|
+
"src": "https://github.com/adamlui/js-utils/tree/main/generate-pw/src"
|
|
13
|
+
},
|
|
14
|
+
"commitHashes": {
|
|
15
|
+
"locales": "0e30af1"
|
|
16
|
+
}
|
|
17
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
{
|
|
2
|
+
"appName": { "message": "generate-pw" },
|
|
3
|
+
"appCopyright": { "message": "ยฉ 2024โ2026 Adam Lui & contributors under the MIT license" },
|
|
4
|
+
"prefix_error": { "message": "ERROR" },
|
|
5
|
+
"prefix_globalVer": { "message": "Global version" },
|
|
6
|
+
"prefix_localVer": { "message": "Local version" },
|
|
7
|
+
"prefix_source": { "message": "Source" },
|
|
8
|
+
"error_noEqual": { "message": "requires '=' followed by a value" },
|
|
9
|
+
"error_notRecognized": { "message": "not recognized" },
|
|
10
|
+
"error_nonPositiveNum": { "message": "argument can only be > 0" },
|
|
11
|
+
"error_invalidURL": { "message": "Invalid URL" },
|
|
12
|
+
"info_validArgs": { "message": "Valid arguments are below" },
|
|
13
|
+
"info_copying": { "message": "Copying to clipboard" },
|
|
14
|
+
"info_moreHelp": { "message": "For more help" },
|
|
15
|
+
"info_type": { "message": "type" },
|
|
16
|
+
"info_or": { "message": "or" },
|
|
17
|
+
"info_visit": { "message": "visit" },
|
|
18
|
+
"helpSection_usage": { "message": "Usage" },
|
|
19
|
+
"helpSection_paramOptions": { "message": "Parameter options" },
|
|
20
|
+
"helpSection_flags": { "message": "Boolean options" },
|
|
21
|
+
"helpSection_infoCmds": { "message": "Info commands" },
|
|
22
|
+
"optionDesc_length": { "message": "Generate password(s) of n length" },
|
|
23
|
+
"optionDesc_qty": { "message": "Generate n password(s)" },
|
|
24
|
+
"optionDesc_charset": { "message": "Only include chars in password(s)" },
|
|
25
|
+
"optionDesc_exclude": { "message": "Exclude chars from password(s)" },
|
|
26
|
+
"optionDesc_includeNums": { "message": "Allow numbers in password(s)" },
|
|
27
|
+
"optionDesc_includeSymbols": { "message": "Allow symbols in password(s)" },
|
|
28
|
+
"optionDesc_noLower": { "message": "Disallow lowercase letters in password(s)" },
|
|
29
|
+
"optionDesc_noUpper": { "message": "Disallow uppercase letters in password(s)" },
|
|
30
|
+
"optionDesc_noSimilar": { "message": "Exclude similar characters in password(s)" },
|
|
31
|
+
"optionDesc_strict": { "message": "Require at least one character from each allowed character set in password(s)" },
|
|
32
|
+
"optionDesc_quiet": { "message": "Suppress all logging except errors" },
|
|
33
|
+
"optionDesc_help": { "message": "Display help screen" },
|
|
34
|
+
"optionDesc_version": { "message": "Show version number" }
|
|
35
|
+
}
|
package/dist/generate-pw.min.js
CHANGED
|
@@ -3,4 +3,4 @@
|
|
|
3
3
|
* Source: https://code.generatepw.org
|
|
4
4
|
* Documentation: https://docs.generatepw.org
|
|
5
5
|
*/
|
|
6
|
-
let charsets={lower:"abcdefghijklmnopqrstuvwxyz",upper:"ABCDEFGHIJKLMNOPQRSTUVWXYZ",numbers:"0123456789",symbols:"!@#$%^&*()-_=+[]{}/\\|;:'\",.<>?"};function generatePassword(o={}){var e="generatePassword() ยป ",t={verbose:!0,length:8,qty:1,charset:"",exclude:"",numbers:!1,symbols:!1,lowercase:!0,uppercase:!0,excludeSimilarChars:!1,strict:!1};if(validateOptions(o,t,"https://docs.generatepw.org/#generatepasswordoptions","generatePassword({ verbose: false, numbers: true })")){if(1<(o={...t,...o}).qty){let{qty:e,...r}=o;return generatePasswords(e,r)}{var n,t="generatePasswords"==generatePassword.caller?.name;o.verbose&&!t&&console.info(e+"Initializing character set...");let r=o.charset?.toString()||(o.numbers?charsets.numbers:"")+(o.symbols?charsets.symbols:"")+(o.lowercase?charsets.lower:"")+(o.uppercase?charsets.upper:""),s=(""==r&&(r=charsets.lower+charsets.upper),o.exclude&&(o.verbose&&!t&&console.info(e+"Removing excluded characters..."),r=r.replace(new RegExp(`[${o.exclude}]`,"g"),"")),o.excludeSimilarChars&&(o.verbose&&!t&&console.info(e+"Excluding similar characters..."),r=r.replace(/[o0Oil1|]/g,"")),o.verbose&&!t&&console.info(e+"Generating password..."),"");for(let e=0;e<o.length;e++){var a=randomInt(0,r.length);s+=r[a]}return o.strict&&(o.verbose&&!t&&console.info(e+"Enforcing strict mode..."),n=["number","symbol","lower","upper"].filter(e=>o[e+"s"]||o[e+"case"]),s=strictify(s,n)),o.verbose&&!t&&(console.info(e+"Password generated!"),"undefined"!=typeof window)&&console.info(e+"Check returned string."),s}}}function generatePasswords(r,s={}){var e="https://docs.generatepw.org/#generatepasswordsqty-options",o="generatePasswords() ยป ",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(o+"ERROR: 1st arg <qty> can only be an integer > 0."),console.info(o+"For more help, please visit "+e);else if(validateOptions(s,t,e,"generatePasswords(3, { verbose: false, symbols: true })")){(s={...t,...s}).verbose&&console.info(o+`Generating password${1<r?"s":""}...`);var n=[];for(let e=0;e<r;e++)n.push(generatePassword(s));return s.verbose&&(console.info(o+`Password${1<r?"s":""} generated!`),"undefined"!=typeof window)&&console.info(o+"Check returned array."),n}}function strictify(n,a=["number","symbol","lower","upper"],e={}){var r="https://docs.generatepw.org/#strictifypassword-requiredchartypes-options",i={verbose:!0},l="strictify() ยป ";if("string"!=typeof n)console.error(l+"ERROR: 1st arg <password> must be a string."),console.info(l+"For more help, please visit "+r);else{var s,o=["number","symbol","lower","upper"];for(s of a=Array.isArray(a)?a:[a])if(!o.includes(s))return console.error(l+`ERROR: 2nd arg \`${s}\` is an invalid character type.`),console.info(l+`Valid character types: [ '${o.join("', '")}' ]`),console.info(l+"Pass one as a string or more as an array, or all types will be required."),void console.info(l+"For more help, please visit "+r);if(validateOptions(e,i,r,"strictify('pa55word', ['symbol', 'upper'], { verbose: false })")){e={...i,...e};let r={},s=[];a.forEach(e=>r[e]=!1);for(let e=0;e<n.length;e++)for(var c of a)(charsets[c]||charsets[c+"s"]).includes(n[e])&&(r[c]=!0,s.push(e));e.verbose&&console.info(l+"Strictifying password...");var d,p=Math.min(n.length,a.length);let o=0,t=n;for(d of a)if(o<p&&!r[d]){let e;for(;e=randomInt(0,n.length),s.includes(e););s.push(e);var f=charsets[d]||charsets[d+"s"];t=t.substring(0,e)+f[randomInt(0,f.length)]+t.substring(e+1),o++}return e.verbose&&(0<o?(console.info(l+"Password is now strict!"),console.info(l+"Check returned string.")):(console.info(l+`Password already includes ${a.join(" + ")} characters!`),console.info(l+"No modifications made."))),t}}}function validateStrength(r,s={}){var e="https://docs.generatepw.org/#validatestrengthpassword-options",o={minLength:8,minLower:1,minUpper:1,minNumber:1,minSymbol:1},t={verbose:!0},n="validateStrength() ยป ";if("string"!=typeof r)console.error(n+"ERROR: 1st arg <password> must be a string."),console.info(n+"For more help, please visit "+e);else if(validateOptions(s,t,e,"validateStrength('pa55word', { verbose: false })")){(s={...t,...s}).verbose&&console.info(n+"Validating password strength...");var a,i={lower:0,upper:0,number:0,symbol:0};for(a of r)for(var l of Object.keys(i))(charsets[l]||charsets[l+"s"]).includes(a)&&i[l]++;var c,d,p=[];r.length<o.minLength&&p.push(`Make it at least ${o.minLength} characters long.`);for(c of Object.keys(i))i[c]<o["min"+c[0].toUpperCase()+c.slice(1)]&&p.push("Include at least one "+c+`${["upper","lower"].includes(c)?"case letter":""}.`);let e=0;e+=r.length>=o.minLength?20:0;for(d of Object.keys(i))e+=i[d]>=o["min"+d[0].toUpperCase()+d.slice(1)]?20:0;return s.verbose&&(console.info(n+"Password strength validated!"),console.info(n+"Check returned object for score/recommendations.")),{strengthScore:e,recommendations:p,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,o){let t=JSON.stringify(r,void 0,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])),l=`${validateOptions.caller?.name||"validateOptions"}() ยป `;var c,d=o.split(",").findIndex(e=>e.trim().startsWith("{"))+1
|
|
6
|
+
let charsets={lower:"abcdefghijklmnopqrstuvwxyz",upper:"ABCDEFGHIJKLMNOPQRSTUVWXYZ",numbers:"0123456789",symbols:"!@#$%^&*()-_=+[]{}/\\|;:'\",.<>?"};function generatePassword(o={}){var e="generatePassword() ยป ",t={verbose:!0,length:8,qty:1,charset:"",exclude:"",numbers:!1,symbols:!1,lowercase:!0,uppercase:!0,excludeSimilarChars:!1,strict:!1};if(validateOptions(o,t,"https://docs.generatepw.org/#generatepasswordoptions","generatePassword({ verbose: false, numbers: true })")){if(1<(o={...t,...o}).qty){let{qty:e,...r}=o;return generatePasswords(e,r)}{var n,t="generatePasswords"==generatePassword.caller?.name;o.verbose&&!t&&console.info(e+"Initializing character set...");let r=o.charset?.toString()||(o.numbers?charsets.numbers:"")+(o.symbols?charsets.symbols:"")+(o.lowercase?charsets.lower:"")+(o.uppercase?charsets.upper:""),s=(""==r&&(r=charsets.lower+charsets.upper),o.exclude&&(o.verbose&&!t&&console.info(e+"Removing excluded characters..."),r=r.replace(new RegExp(`[${o.exclude}]`,"g"),"")),o.excludeSimilarChars&&(o.verbose&&!t&&console.info(e+"Excluding similar characters..."),r=r.replace(/[o0Oil1|]/g,"")),o.verbose&&!t&&console.info(e+"Generating password..."),"");for(let e=0;e<o.length;e++){var a=randomInt(0,r.length);s+=r[a]}return o.strict&&(o.verbose&&!t&&console.info(e+"Enforcing strict mode..."),n=["number","symbol","lower","upper"].filter(e=>o[e+"s"]||o[e+"case"]),s=strictify(s,n)),o.verbose&&!t&&(console.info(e+"Password generated!"),"undefined"!=typeof window)&&console.info(e+"Check returned string."),s}}}function generatePasswords(r,s={}){var e="https://docs.generatepw.org/#generatepasswordsqty-options",o="generatePasswords() ยป ",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(o+"ERROR: 1st arg <qty> can only be an integer > 0."),console.info(o+"For more help, please visit "+e);else if(validateOptions(s,t,e,"generatePasswords(3, { verbose: false, symbols: true })")){(s={...t,...s}).verbose&&console.info(o+`Generating password${1<r?"s":""}...`);var n=[];for(let e=0;e<r;e++)n.push(generatePassword(s));return s.verbose&&(console.info(o+`Password${1<r?"s":""} generated!`),"undefined"!=typeof window)&&console.info(o+"Check returned array."),n}}function strictify(n,a=["number","symbol","lower","upper"],e={}){var r="https://docs.generatepw.org/#strictifypassword-requiredchartypes-options",i={verbose:!0},l="strictify() ยป ";if("string"!=typeof n)console.error(l+"ERROR: 1st arg <password> must be a string."),console.info(l+"For more help, please visit "+r);else{var s,o=["number","symbol","lower","upper"];for(s of a=Array.isArray(a)?a:[a])if(!o.includes(s))return console.error(l+`ERROR: 2nd arg \`${s}\` is an invalid character type.`),console.info(l+`Valid character types: [ '${o.join("', '")}' ]`),console.info(l+"Pass one as a string or more as an array, or all types will be required."),void console.info(l+"For more help, please visit "+r);if(validateOptions(e,i,r,"strictify('pa55word', ['symbol', 'upper'], { verbose: false })")){e={...i,...e};let r={},s=[];a.forEach(e=>r[e]=!1);for(let e=0;e<n.length;e++)for(var c of a)(charsets[c]||charsets[c+"s"]).includes(n[e])&&(r[c]=!0,s.push(e));e.verbose&&console.info(l+"Strictifying password...");var d,p=Math.min(n.length,a.length);let o=0,t=n;for(d of a)if(o<p&&!r[d]){let e;for(;e=randomInt(0,n.length),s.includes(e););s.push(e);var f=charsets[d]||charsets[d+"s"];t=t.substring(0,e)+f[randomInt(0,f.length)]+t.substring(e+1),o++}return e.verbose&&(0<o?(console.info(l+"Password is now strict!"),console.info(l+"Check returned string.")):(console.info(l+`Password already includes ${a.join(" + ")} characters!`),console.info(l+"No modifications made."))),t}}}function validateStrength(r,s={}){var e="https://docs.generatepw.org/#validatestrengthpassword-options",o={minLength:8,minLower:1,minUpper:1,minNumber:1,minSymbol:1},t={verbose:!0},n="validateStrength() ยป ";if("string"!=typeof r)console.error(n+"ERROR: 1st arg <password> must be a string."),console.info(n+"For more help, please visit "+e);else if(validateOptions(s,t,e,"validateStrength('pa55word', { verbose: false })")){(s={...t,...s}).verbose&&console.info(n+"Validating password strength...");var a,i={lower:0,upper:0,number:0,symbol:0};for(a of r)for(var l of Object.keys(i))(charsets[l]||charsets[l+"s"]).includes(a)&&i[l]++;var c,d,p=[];r.length<o.minLength&&p.push(`Make it at least ${o.minLength} characters long.`);for(c of Object.keys(i))i[c]<o["min"+c[0].toUpperCase()+c.slice(1)]&&p.push("Include at least one "+c+`${["upper","lower"].includes(c)?"case letter":""}.`);let e=0;e+=r.length>=o.minLength?20:0;for(d of Object.keys(i))e+=i[d]>=o["min"+d[0].toUpperCase()+d.slice(1)]?20:0;return s.verbose&&(console.info(n+"Password strength validated!"),console.info(n+"Check returned object for score/recommendations.")),{strengthScore:e,recommendations:p,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,o){let t=JSON.stringify(r,void 0,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])),l=`${validateOptions.caller?.name||"validateOptions"}() ยป `;var c,d=o.split(",").findIndex(e=>e.trim().startsWith("{"))+1;function p(){console.info(l+`Valid options: [ ${n} ]`),console.info(l+"If omitted, default settings are: "+t)}function f(){console.info(l+"For more help, please visit "+s)}if(d+=["st","nd","rd"][d-1]||"th","object"!=typeof e)return console.error(l+`ERROR: ${"0th"==d?"[O":d+" arg [o"}ptions] can only be an object of key/values.`),console.info(l+"Example valid call: "+o),p(),f(),!1;for(c in e){if(!Object.prototype.hasOwnProperty.call(r,c))return console.error(l+`ERROR: \`${c}\` is an invalid option.`),p(),f(),!1;if(a.includes(c)&&"boolean"!=typeof e[c])return console.error(l+`ERROR: [${c}] option can only be \`true\` or \`false\`.`),f(),!1;if(i.includes(c)&&(e[c]=parseInt(e[c],10),isNaN(e[c])||e[c]<1))return console.error(l+`ERROR: [${c}] option can only be an integer > 0.`),f(),!1}return!0}let 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(let r in gpwAliases){try{gpwAliases[r].forEach(e=>module.exports[e]=module.exports[r])}catch(e){}try{gpwAliases[r].forEach(e=>window.pw[e]=window.pw[r])}catch(e){}}
|
package/docs/README.md
CHANGED
|
@@ -1,3 +1,7 @@
|
|
|
1
|
+
<a id="top"></a>
|
|
2
|
+
|
|
3
|
+
<a id="top"></a>
|
|
4
|
+
|
|
1
5
|
<div align="right">
|
|
2
6
|
<h6>
|
|
3
7
|
<picture>
|
|
@@ -22,17 +26,17 @@
|
|
|
22
26
|
<a href="https://www.npmjs.com/package/generate-pw">
|
|
23
27
|
<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>
|
|
24
28
|
<a href="#%EF%B8%8F-mit-license">
|
|
25
|
-
<img height=31 src="https://img.shields.io/badge/License-MIT-
|
|
26
|
-
<a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.5.
|
|
27
|
-
<img height=31 src="https://img.shields.io/badge/Latest_Build-1.5.
|
|
29
|
+
<img height=31 src="https://img.shields.io/badge/License-MIT-orange.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
|
|
30
|
+
<a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-1.5.16">
|
|
31
|
+
<img height=31 src="https://img.shields.io/badge/Latest_Build-1.5.16-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
|
|
28
32
|
<a href="https://www.npmjs.com/package/generate-pw?activeTab=code">
|
|
29
33
|
<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>
|
|
30
|
-
<a href="https://github.com/adamlui/js-utils/blob/generate-pw-1.5.
|
|
31
|
-
<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.
|
|
34
|
+
<a href="https://github.com/adamlui/js-utils/blob/generate-pw-1.5.16/generate-pw/dist/generate-pw.min.js">
|
|
35
|
+
<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.16&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
|
|
32
36
|
<a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:generate-pw/src/generate-pw.js">
|
|
33
37
|
<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>
|
|
34
38
|
<a href="https://github.com/toolleeo/cli-apps#password-managers">
|
|
35
|
-
<img height=31 src="https://img.shields.io/badge/Mentioned_in-Awesome-
|
|
39
|
+
<img height=31 src="https://img.shields.io/badge/Mentioned_in-Awesome-ff69b4?logo=awesomelists&logoColor=white&labelColor=464646&style=for-the-badge"></a>
|
|
36
40
|
|
|
37
41
|
<br>
|
|
38
42
|
|
|
@@ -82,7 +86,7 @@ import pw from 'generate-pw';
|
|
|
82
86
|
#### CommonJS:
|
|
83
87
|
|
|
84
88
|
```js
|
|
85
|
-
const pw = require('generate-pw')
|
|
89
|
+
const pw = require('generate-pw')
|
|
86
90
|
```
|
|
87
91
|
|
|
88
92
|
###### _*Node.js version 14 or higher required_
|
|
@@ -92,23 +96,23 @@ const pw = require('generate-pw');
|
|
|
92
96
|
#### <> HTML script tag:
|
|
93
97
|
|
|
94
98
|
```html
|
|
95
|
-
<script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.
|
|
99
|
+
<script src="https://cdn.jsdelivr.net/npm/generate-pw@1.5.16/dist/generate-pw.min.js"></script>
|
|
96
100
|
```
|
|
97
101
|
|
|
98
102
|
#### ES6:
|
|
99
103
|
|
|
100
104
|
```js
|
|
101
105
|
(async () => {
|
|
102
|
-
await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.
|
|
106
|
+
await import('https://cdn.jsdelivr.net/npm/generate-pw@1.5.16/dist/generate-pw.min.js')
|
|
103
107
|
// Your code here...
|
|
104
|
-
})()
|
|
108
|
+
})()
|
|
105
109
|
```
|
|
106
110
|
|
|
107
111
|
### <img height=17 src="https://assets.js-utils.org/images/icons/platforms/tampermonkey/icon28.png?v=0d36e26"><img height=17.5 src="https://assets.js-utils.org/images/icons/platforms/violentmonkey/icon25.png?v=0d36e26"> Greasemonkey
|
|
108
112
|
|
|
109
113
|
```js
|
|
110
114
|
...
|
|
111
|
-
// @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.
|
|
115
|
+
// @require https://cdn.jsdelivr.net/npm/generate-pw@1.5.16/dist/generate-pw.min.js
|
|
112
116
|
// ==/UserScript==
|
|
113
117
|
|
|
114
118
|
// Your code here...
|
|
@@ -116,7 +120,7 @@ const pw = require('generate-pw');
|
|
|
116
120
|
|
|
117
121
|
<br>
|
|
118
122
|
|
|
119
|
-
**๐ก Note:** To always import the latest version (not recommended in production!) remove the `@1.5.
|
|
123
|
+
**๐ก Note:** To always import the latest version (not recommended in production!) remove the `@1.5.16` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-pw/dist/generate-pw.min.js`
|
|
120
124
|
|
|
121
125
|
<br>
|
|
122
126
|
|
|
@@ -129,15 +133,15 @@ const pw = require('generate-pw');
|
|
|
129
133
|
Generates **one** password if `qty` option is not given, returning a string:
|
|
130
134
|
|
|
131
135
|
```js
|
|
132
|
-
const password = pw.generatePassword({ length: 11, numbers: true })
|
|
133
|
-
console.log(password)
|
|
136
|
+
const password = pw.generatePassword({ length: 11, numbers: true })
|
|
137
|
+
console.log(password) // sample output: 'bAsZm3mq6Qn'
|
|
134
138
|
```
|
|
135
139
|
|
|
136
140
|
...or **multiple** passwords if `qty` option is given, returning an array of strings:
|
|
137
141
|
|
|
138
142
|
```js
|
|
139
|
-
const passwords = pw.generatePassword({ qty: 5, length: 8, symbols: true })
|
|
140
|
-
console.log(passwords)
|
|
143
|
+
const passwords = pw.generatePassword({ qty: 5, length: 8, symbols: true })
|
|
144
|
+
console.log(passwords)
|
|
141
145
|
|
|
142
146
|
/* sample output:
|
|
143
147
|
|
|
@@ -159,8 +163,8 @@ See: [Available options](#available-options-for-generate-functions)
|
|
|
159
163
|
Generates **multiple** passwords based on `qty` given, returning an array of strings:
|
|
160
164
|
|
|
161
165
|
```js
|
|
162
|
-
const passwords = pw.generatePasswords(5, { length: 3, uppercase: false })
|
|
163
|
-
console.log(passwords)
|
|
166
|
+
const passwords = pw.generatePasswords(5, { length: 3, uppercase: false })
|
|
167
|
+
console.log(passwords)
|
|
164
168
|
|
|
165
169
|
/* sample output:
|
|
166
170
|
|
|
@@ -182,8 +186,8 @@ See: [Available options](#available-options-for-generate-functions)
|
|
|
182
186
|
Modifies `password` given to use at least one character of each `requiredCharTypes` element passed, returning a string:
|
|
183
187
|
|
|
184
188
|
```js
|
|
185
|
-
const strictPW = pw.strictify('abcdef', ['numbers', 'symbols'])
|
|
186
|
-
console.log(strictPW)
|
|
189
|
+
const strictPW = pw.strictify('abcdef', ['numbers', 'symbols'])
|
|
190
|
+
console.log(strictPW) // sample output: 'a!c2ef'
|
|
187
191
|
```
|
|
188
192
|
|
|
189
193
|
**๐ก Note:** If no `requiredCharTypes` array is passed, all available types will be required.
|
|
@@ -208,8 +212,8 @@ Validates the strength of a password, returning an object containing:
|
|
|
208
212
|
Example:
|
|
209
213
|
|
|
210
214
|
```js
|
|
211
|
-
const pwStrength = pw.validateStrength('Aa?idsE')
|
|
212
|
-
console.log(pwStrength)
|
|
215
|
+
const pwStrength = pw.validateStrength('Aa?idsE')
|
|
216
|
+
console.log(pwStrength)
|
|
213
217
|
|
|
214
218
|
/* outputs:
|
|
215
219
|
|
|
@@ -339,4 +343,4 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
|
|
|
339
343
|
|
|
340
344
|
<picture><source media="(prefers-color-scheme: dark)" srcset="https://assets.js-utils.org/images/icons/home/white/icon32x27.png?v=0d36e26"><img height=13 src="https://assets.js-utils.org/images/icons/home/dark-gray/icon32x27.png?v=0d36e26"></picture> <a href="https://js-utils.org">**More JavaScript utilities**</a> /
|
|
341
345
|
<a href="https://github.com/adamlui/js-utils/discussions">Discuss</a> /
|
|
342
|
-
<a href="
|
|
346
|
+
<a href="#top">Back to top โ</a>
|
package/package.json
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "generate-pw",
|
|
3
|
-
"version": "1.5.
|
|
3
|
+
"version": "1.5.16",
|
|
4
4
|
"description": "Randomly generate, strengthen, and validate cryptographically-secure passwords.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Adam Lui",
|
|
7
7
|
"email": "adam@kudoai.com",
|
|
8
8
|
"url": "https://github.com/adamlui"
|
|
9
9
|
},
|
|
10
|
-
"homepage": "https://
|
|
10
|
+
"homepage": "https://github.com/adamlui/js-utils",
|
|
11
11
|
"license": "MIT",
|
|
12
12
|
"funding": [
|
|
13
13
|
{
|
|
@@ -29,12 +29,13 @@
|
|
|
29
29
|
],
|
|
30
30
|
"main": "dist/generate-pw.min.js",
|
|
31
31
|
"files": [
|
|
32
|
+
"dist/",
|
|
32
33
|
"docs/",
|
|
33
34
|
"!docs/*/"
|
|
34
35
|
],
|
|
35
36
|
"bin": {
|
|
36
|
-
"generatepw": "dist/cli.min.js",
|
|
37
|
-
"generate-pw": "dist/cli.min.js"
|
|
37
|
+
"generatepw": "dist/cli/index.min.js",
|
|
38
|
+
"generate-pw": "dist/cli/index.min.js"
|
|
38
39
|
},
|
|
39
40
|
"directories": {
|
|
40
41
|
"lib": "./dist",
|
|
@@ -59,9 +60,12 @@
|
|
|
59
60
|
"cli"
|
|
60
61
|
],
|
|
61
62
|
"bugs": {
|
|
62
|
-
"url": "https://
|
|
63
|
+
"url": "https://github.com/adamlui/js-utils/issues"
|
|
63
64
|
},
|
|
64
65
|
"devDependencies": {
|
|
65
|
-
"@adamlui/minify.js": "^2.
|
|
66
|
+
"@adamlui/minify.js": "^2.1.3"
|
|
67
|
+
},
|
|
68
|
+
"dependencies": {
|
|
69
|
+
"node-clipboardy": "^1.0.3"
|
|
66
70
|
}
|
|
67
71
|
}
|
package/dist/cli.min.js
DELETED
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
/**
|
|
4
|
-
* ยฉ 2023โ2026 Adam Lui & contributors under the MIT license.
|
|
5
|
-
* Source: https://code.minify-js.org/node.js
|
|
6
|
-
* Documentation: https://docs.minify-js.org/node.js
|
|
7
|
-
*/
|
|
8
|
-
* ยฉ 2024โ2026 Adam Lui & contributors under the MIT license.
|
|
9
|
-
* Source: https://code.generatepw.org
|
|
10
|
-
* Documentation: https://docs.generatepw.org
|
|
11
|
-
*/
|
|
12
|
-
let pkgName="generate-pw",copyright="ยฉ 2024โ2026 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",latestLocaleCommitHash="0e30af1";(async()=>{let e=require(__dirname.match(/src/)?"./generate-pw":"./generate-pw.min").generatePassword,r=require("fs"),o=require("path"),{execSync:n,execFileSync:s}=require("child_process"),a="[0m",t="[1;91m",i="[1;97m",c="en";if("win32"==process.platform)try{c=n("(Get-Culture).TwoLetterISOLanguageName",{shell:"powershell",encoding:"utf-8"}).trim()}catch(e){console.error("ERROR loading system language: "+e.message)}else{var l=process.env;c=(l.LANG||l.LANGUAGE||l.LC_ALL||l.LC_MESSAGES||l.LC_NAME||"en").split(".")[0]}let p={};var m,d,u,l=new Promise((n,a)=>{let t=`https://cdn.jsdelivr.net/gh/adamlui/js-utils@dc9e824295950d84fd408949aede02ad7589d74d/${pkgName}/_locales/`;var e=`${c?c.replace("-","_"):"en"}/`;let i=t+e+"messages.json",l=0;$(i).then(async function s(r){try{let e=await r.json(),s={};for(var o in e)"object"==typeof e[o]&&"message"in e[o]&&(s[o]=e[o].message);n(s)}catch(e){if(3==++l)return n({});$(i=c.includes("-")&&1==l?i.replace(/([^_]*)_[^/]*(\/.*)/,"$1$2"):t+"en/messages.json").then(s).catch(a)}}).catch(a)});try{p=await l}catch(e){console.error("ERROR fetching messages: "+e.message)}let h={},g={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(g.paramOptions).find(e=>g.paramOptions[e].test(s)),o=Object.keys(g.flags).find(e=>g.flags[e].test(s)),r=Object.keys(g.infoCmds).find(e=>g.infoCmds[e].test(s)),o?h[o]=!0:e?(/=.+/.test(s)||(console.error(`
|
|
13
|
-
${t+(p.prefix_error||"ERROR")}: `+`Arg [--${s.replace(/-/g,"")}] `+`${p.error_noEqual||"requires '=' followed by a value"}.${a}`),_(),process.exit(1)),o=s.split("=")[1],h[e]=parseInt(o)||o):r||(console.error(`
|
|
14
|
-
${t+(p.prefix_error||"ERROR")}: `+`Arg [${s}] ${p.error_notRecognized||"not recognized"}.[0m`),console.info(`
|
|
15
|
-
${"[1;33m"+(p.info_validArgs||"Valid arguments are below")}.[0m`),w(["paramOptions","flags","infoCmds"]),process.exit(1)))});for(m of["length","qty"])h[m]&&(isNaN(h[m])||h[m]<1)&&(console.error(`
|
|
16
|
-
${t+(p.prefix_error||"ERROR")}: [${m}] `+`${p.error_nonPositiveNum||"argument can only be > 0"}.${a}`),_(),process.exit(1));if(process.argv.some(e=>g.infoCmds.help.test(e)))w();else if(process.argv.some(e=>g.infoCmds.version.test(e))){l=n(`npm view ${pkgName} version`).toString().trim()||"none";let e,s=process.cwd();for(;"/"!=s;){var f=o.join(s,"package.json");if(r.existsSync(f)){f=require(f);e=(f.dependencies?.[pkgName]||f.devDependencies?.[pkgName])?.match(/^[~^>=]?\d+\.\d+\.\d+$/)?.[1]||"none";break}s=o.dirname(s)}console.info(`
|
|
17
|
-
${p.prefix_globalVer||"Global version"}: `+l),console.info(`${p.prefix_localVer||"Local version"}: `+e)}else{l={length:h.length||8,qty:h.qty||1,charset:h.charset,exclude:h.excludeChars,numbers:!!h.includeNums,symbols:!!h.includeSymbols,lowercase:!h.excludeLowerChars,uppercase:!h.excludeUpperChars,excludeSimilarChars:!!h.excludeSimilarChars,strict:!!h.strictMode,verbose:!h.quietMode},l=e(l);u=`
|
|
18
|
-
${p.info_copying||"Copying to clipboard"}...`,h.quietMode||console.info(u),u=(u=Array.isArray(l)?l.join("\n"):l).replace(/"/g,'""'),d={darwin:{binPath:"/usr/bin/pbcopy",args:[]},linux:{binPath:"/usr/bin/xclip",args:["-selection","clipboard"]},win32:{binPath:o.join(process.env.SYSTEMROOT,"System32","WindowsPowerShell","v1.0","powershell.exe"),args:["-Command","Set-Clipboard -Value $input"]}},s(...Object.values(d[process.platform]),{input:u})}function $(o){return new Promise((r,e)=>{var s=o.match(/^([^:]+):\/\//)[1];/^https?$/.test(s)||e(new Error(`${p.error_invalidURL||"Invalid URL"}.`)),require(s).get(o,e=>{let s="";e.on("data",e=>s+=e),e.on("end",()=>r({json:()=>JSON.parse(s)}))}).on("error",e)})}function w(e=["header","usage","paramOptions","flags","infoCmds"]){var s=`[106m[30m ${pkgName} [0m `;let r={header:[`
|
|
19
|
-
โ `+s+(p.appCopyright||copyright),s+(p.prefix_source||"Source")+": "+srcURL],usage:[`
|
|
20
|
-
${i}o ${p.helpSection_usage||"Usage"}:[0m`,` ${i}ยป [1;92m${cmdFormat}[0m`],paramOptions:[`
|
|
21
|
-
${i}o ${p.helpSection_paramOptions||"Parameter options"}:[0m`,` --length=n ${p.optionDesc_length||"Generate password(s) of n length"}.`,` --qty=n ${p.optionDesc_qty||"Generate n password(s)"}.`,` --charset=chars ${p.optionDesc_charset||"Only include chars in password(s)"}.`,` --exclude=chars ${p.optionDesc_exclude||"Exclude chars from password(s)"}.`],flags:[`
|
|
22
|
-
${i}o ${p.helpSection_flags||"Boolean options"}:[0m`,` -n, --include-numbers ${p.optionDesc_includeNums||"Allow numbers in password(s)"}.`,` -y, --include-symbols ${p.optionDesc_includeSymbols||"Allow symbols in password(s)"}.`,` -L, --no-lowercase ${p.optionDesc_noLower||"Disallow lowercase letters in password(s)"}.`,` -U, --no-uppercase ${p.optionDesc_noUpper||"Disallow uppercase letters in password(s)"}.`,` -S, --no-similar ${p.optionDesc_noSimilar||"Exclude similar characters in password(s)"}.`,` -s, --strict ${p.optionDesc_strict||"Require at least one character from eachallowed character set in password(s)"}.`,` -q, --quiet ${p.optionDesc_quiet||"Suppress all logging except errors"}.`],infoCmds:[`
|
|
23
|
-
${i}o ${p.helpSection_infoCmds||"Info commands"}:[0m`," -h, --help "+(p.optionDesc_help||"Display help screen."),` -v, --version ${p.optionDesc_version||"Show version number"}.`]};e.forEach(t=>r[t]?.forEach(s=>{{var a=/header|usage/.test(t)?1:29;let r=process.stdout.columns||80,o=[],e=s.match(/\S+|\s+/g),n="";e.forEach(e=>{var s=r-(o.length?a:0);n.length+"| ".length+e.length>s&&(o.push(o.length?n.trimStart():n),n=""),n+=e}),o.push(o.length?n.trimStart():n),o.forEach((e,s)=>console.info("| "+(0==s?e:" ".repeat(a)+e)))}})),console.info(`
|
|
24
|
-
${p.info_moreHelp||"For more help"}, ${p.info_visit||"visit"}: ${i}${docURL}[0m`)}function _(){console.info(`
|
|
25
|
-
${p.info_moreHelp||"For more help"}, ${p.info_type||"type"} generate-pw --help' ${p.info_or||"or"} ${p.info_visit||"visit"}
|
|
26
|
-
${i}${docURL}[0m`)}})();
|