generate-ip 2.2.9 → 2.2.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
@@ -3,9 +3,9 @@
3
3
  ### Randomly generate, format, and validate IPv4/IPv6 addresses.
4
4
 
5
5
  <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>
6
- <a href="https://github.com/adamlui/js-utils/releases/tag/generate-ip-2.2.9"><img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.9-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
6
+ <a href="https://github.com/adamlui/js-utils/releases/tag/generate-ip-2.2.11"><img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.11-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
7
7
  <a href="https://www.npmjs.com/package/generate-ip?activeTab=code"><img height=31 src="https://img.shields.io/npm/unpacked-size/generate-ip?style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
8
- <a href="https://github.com/adamlui/js-utils/blob/generate-ip-2.2.9/generate-ip/dist/generate-ip.min.js"><img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-ip/dist/generate-ip.min.js?branch=generate-ip-2.2.9&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
8
+ <a href="https://github.com/adamlui/js-utils/blob/generate-ip-2.2.11/generate-ip/dist/generate-ip.min.js"><img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-ip/dist/generate-ip.min.js?branch=generate-ip-2.2.11&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
9
9
  <a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:generate-ip/src/generate-ip.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-ip%2Fsrc%2Fgenerate-ip.js%26metricKeys%3Dvulnerabilities&query=%24.component.measures.0.value&style=for-the-badge&logo=sonarcloud&logoColor=white&labelColor=464646&label=Vulnerabilities&color=gold"></a>
10
10
  <a href="https://github.com/toolleeo/cli-apps#networking"><img height=31 src="https://img.shields.io/badge/Mentioned_in-Awesome-c4a2bd?logo=awesomelists&logoColor=white&labelColor=464646&style=for-the-badge"></a>
11
11
  <a href="https://www.jsdelivr.com/package/npm/generate-ip?tab=stats"><img height=31 src="https://img.shields.io/jsdelivr/npm/hm/generate-ip?style=for-the-badge&logo=jsdelivr&logoColor=white&label=jsDelivr%20Hits&labelColor=464646&color=49c5d8"></a>
@@ -72,14 +72,14 @@ const { ipv4, ipv6 } = require('generate-ip');
72
72
  #### <> HTML script tag:
73
73
 
74
74
  ```html
75
- <script src="https://cdn.jsdelivr.net/npm/generate-ip@2.2.9/dist/generate-ip.min.js"></script>
75
+ <script src="https://cdn.jsdelivr.net/npm/generate-ip@2.2.11/dist/generate-ip.min.js"></script>
76
76
  ```
77
77
 
78
78
  #### ES6:
79
79
 
80
80
  ```js
81
81
  (async () => {
82
- await import('https://cdn.jsdelivr.net/npm/generate-ip@2.2.9/dist/generate-ip.min.js');
82
+ await import('https://cdn.jsdelivr.net/npm/generate-ip@2.2.11/dist/generate-ip.min.js');
83
83
  // Your code here...
84
84
  })();
85
85
  ```
@@ -88,7 +88,7 @@ const { ipv4, ipv6 } = require('generate-ip');
88
88
 
89
89
  ```js
90
90
  ...
91
- // @require https://cdn.jsdelivr.net/npm/generate-ip@2.2.9/dist/generate-ip.min.js
91
+ // @require https://cdn.jsdelivr.net/npm/generate-ip@2.2.11/dist/generate-ip.min.js
92
92
  // ==/UserScript==
93
93
 
94
94
  // Your code here...
@@ -96,7 +96,7 @@ const { ipv4, ipv6 } = require('generate-ip');
96
96
 
97
97
  <br>
98
98
 
99
- 📝 **Note:** To always import the latest version (not recommended in production!) remove the `@2.2.9` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js`
99
+ 📝 **Note:** To always import the latest version (not recommended in production!) remove the `@2.2.11` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js`
100
100
 
101
101
  <br>
102
102
 
@@ -129,7 +129,7 @@ console.log(ips);
129
129
 
130
130
  ipv4.generate() » Generating IPv4 addresses...
131
131
  ipv4.generate() » IPv4 addresses generated!
132
- ipv4.generate() » Check returned array.
132
+ ipv4.generate() » 194.84.176.172, 192.186.53.120, 50.191.111.87
133
133
  [ '194.84.176.172', '192.186.53.120', '50.191.111.87' ]
134
134
  */
135
135
  ```
@@ -192,7 +192,7 @@ console.log(ips);
192
192
 
193
193
  ipv6.generate() » Generating IPv6 addresses...
194
194
  ipv6.generate() » IPv6 addresses generated!
195
- ipv6.generate() » Check returned array.
195
+ ipv6.generate() » 8218:19b9:7709:4282:65e1:7ee:319e:32ef, e940:754d:ae46:ae18:94dd:b43c:583:68c2, b570:b4f8:68f:62e2:99cb:ad0f:6237:9d51, 98a7:f4e5:2f4e:8a2d:56bb:dc28:f94a:46a8, ca59:590a:9b6c:ea25:94fa:37d6:9bac:7ff6
196
196
  [
197
197
  '8218:19b9:7709:4282:65e1:7ee:319e:32ef',
198
198
  'e940:754d:ae46:ae18:94dd:b43c:583:68c2',
package/dist/cli.min.js CHANGED
@@ -4,16 +4,17 @@
4
4
  * Source: https://code.js-utils.com/generate-ip
5
5
  * Documentation: https://docs.js-utils.com/generate-ip
6
6
  */
7
- const pkgName="generate-ip",copyright="© 2024 Adam Lui & contributors under the MIT license.",cmdFormat="generate-ip [options|commands]",srcURL="https://code.js-utils.com/generate-ip",docURL="https://docs.js-utils.com/generate-ip/#-command-line-usage",ipv4=require(__dirname.match(/src/)?"./generate-ip":"./generate-ip.min")["ipv4"],fs=require("fs"),path=require("path"),execSync=require("child_process")["execSync"],nc="",br="",by="",bg="",bw="",config={},argRegex={paramOptions:{qty:/^--?qu?a?n?ti?t?y(?:=.*|$)/},flags:{quietMode:/^--?q(?:uiet)?(?:-?mode)?$/},infoCmds:{help:/^--?h(?:elp)?$/,version:/^--?ve?r?s?i?o?n?$/}};if(process.argv.forEach(o=>{var e,n,r;o.startsWith("-")&&(e=Object.keys(argRegex.paramOptions).find(e=>argRegex.paramOptions[e].test(o)),r=Object.keys(argRegex.flags).find(e=>argRegex.flags[e].test(o)),n=Object.keys(argRegex.infoCmds).find(e=>argRegex.infoCmds[e].test(o)),r?config[r]=!0:e?(o.includes("=")||(console.error(`
8
- ${br}ERROR: Arg [--${o.replace(/-/g,"")}] requires '=' followed by a value.`+nc),printHelpCmdAndDocURL(),process.exit(1)),r=o.split("=")[1],config[e]=parseInt(r)||r):n||(console.error(`
9
- ${br}ERROR: Arg [${o}] not recognized.`+nc),console.info(`
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,r=process.cwd();for(;"/"!=r;){const n=path.join(r,"package.json");if(fs.existsSync(n)){const o=require(n);e=(o.dependencies?.[pkgName]||o.devDependencies?.[pkgName])?.match(/(\d+\.\d+\.\d+)/)[0]||"none";break}r=path.dirname(r)}console.info(`
11
- Global version: `+k),console.info("Local version: "+e)}else{config.qty&&(isNaN(config.qty)||config.qty<1)&&(console.error(`
12
- ${br}Error: [qty] argument can only be > 0.`+nc),printHelpCmdAndDocURL(),process.exit(1));const p=ipv4.generate({qty:config.qty||1,verbose:!config.quietMode});config.quietMode||(1<config.qty&&console.info(`[ ${p.join(", ")} ]`),console.info("\nCopying to clipboard...")),copyToClipboard(Array.isArray(p)?p.join("\n"):p)}function printHelpSections(e=["header","usage","paramOptions","flags","infoCmds"]){var o=` ${pkgName} ${nc} `;const n={header:[`
13
- `+o+copyright,o+"Source: "+srcURL,o+"Doc: "+docURL],usage:[`
14
- ${bw}o Usage:`+nc,` ${bw}»${nc} `+(bg+cmdFormat+nc)],paramOptions:[`
15
- ${bw}o ${bw}Parameter options:`+nc," --qty=n Generate n IP address(es)."],flags:[`
16
- ${bw}o ${bw}Boolean options:`+nc," -q, --quiet Suppress all logging except errors."],infoCmds:[`
17
- ${bw}o ${bw}Info commands:`+nc," -h, --help Display help screen."," -v, --version Show version number."]};e.forEach(t=>{n[t]?.forEach(e=>{{var r=/header|usage/.test(t)?1:29;const s=process.stdout.columns||80,i=[],o=e.match(/\S+|\s+/g);let n="";o.forEach(e=>{var o=s-(0==i.length?0:r);n.length+"| ".length+e.length>o&&(i.push(0==i.length?n:n.trimStart()),n=""),n+=e}),i.push(0==i.length?n:n.trimStart()),i.forEach((e,o)=>console.info("| "+(0==o?e:" ".repeat(r)+e)))}})})}function printHelpCmdAndDocURL(){console.info(`
18
- ${by}For more help, type 'generate-ip --help' or visit
19
- `+(docURL+nc))}function copyToClipboard(e){e=e.replace(/\s+$/,"").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"})}
7
+ const pkgName="generate-ip",copyright="© 2024 Adam Lui & contributors under the MIT license.",cmdFormat="generate-ip [options|commands]",srcURL="https://code.js-utils.com/generate-ip",docURL="https://docs.js-utils.com/generate-ip/#-command-line-usage";(async()=>{const e=require(__dirname.match(/src/)?"./generate-ip":"./generate-ip.min")["ipv4"],r=require("fs"),s=require("path"),n=require("child_process")["execSync"],t="",i="",a="";let l;l="win32"==process.platform?n("(Get-Culture).TwoLetterISOLanguageName",{shell:"powershell",encoding:"utf-8"}).trim():((c=process.env).LANG||c.LANGUAGE||c.LC_ALL||c.LC_MESSAGES||c.LC_NAME)?.split(".")[0];var o,c=new Promise((t,i)=>{const a="https://raw.githubusercontent.com/adamlui/js-utils/main/generate-ip/_locales/",e=(l?l.replace("-","_"):"en")+"/";let c=a+e+"messages.json",p=0;f(c).then(async function o(e){try{const r=await e.json(),s={};for(const n in r)"object"==typeof r[n]&&null!==r[n]&&"message"in r[n]&&(s[n]=r[n].message);t(s)}catch(e){3!=++p&&f(c=l.includes("-")&&1===p?c.replace(/([^_]*)_[^/]*(\/.*)/,"$1$2"):a+"en/messages.json").then(o).catch(i)}}).catch(i)});let p={};try{p=await c}catch(e){}const m={},g={paramOptions:{qty:/^--?qu?a?n?ti?t?y(?:=.*|$)/},flags:{quietMode:/^--?q(?:uiet)?(?:-?mode)?$/},infoCmds:{help:/^--?h(?:elp)?$/,version:/^--?ve?r?s?i?o?n?$/}};if(process.argv.forEach(o=>{var e,r,s;o.startsWith("-")&&(e=Object.keys(g.paramOptions).find(e=>g.paramOptions[e].test(o)),s=Object.keys(g.flags).find(e=>g.flags[e].test(o)),r=Object.keys(g.infoCmds).find(e=>g.infoCmds[e].test(o)),s?m[s]=!0:e?(o.includes("=")||(console.error(`
8
+ ${i+(p.prefix_error||"ERROR")}: `+`Arg [--${o.replace(/-/g,"")}] `+`${p.error_noEqual||"requires '=' followed by a value"}.${t}`),u(),process.exit(1)),s=o.split("=")[1],m[e]=parseInt(s)||s):r||(console.error(`
9
+ ${i+(p.prefix_error||"ERROR")}: `+`Arg [${o}] ${p.error_notRecognized||"not recognized"}.`),console.info(`
10
+ ${""+(p.info_validArgs||"Valid arguments are below")}.`),h(["paramOptions","flags","infoCmds"]),process.exit(1)))}),process.argv.some(e=>g.infoCmds.help.test(e)))h();else if(process.argv.some(e=>g.infoCmds.version.test(e))){c=n(`npm view ${pkgName} version`).toString().trim()||"none";let e,o=process.cwd();for(;"/"!=o;){var d=s.join(o,"package.json");if(r.existsSync(d)){d=require(d);e=(d.dependencies?.[pkgName]||d.devDependencies?.[pkgName])?.match(/(\d+\.\d+\.\d+)/)[0]||"none";break}o=s.dirname(o)}console.info(`
11
+ ${p.prefix_globalVer||"Global version"}: `+c),console.info(`${p.prefix_localVer||"Local version"}: `+e)}else{m.qty&&(isNaN(m.qty)||m.qty<1)&&(console.error(`
12
+ ${i+(p.prefix_error||"ERROR")}: [qty] `+`${p.error_nonPositiveNum||"argument can only be > 0"}.${t}`),u(),process.exit(1));c=e.generate({qty:m.qty||1,verbose:!m.quietMode});o=`
13
+ ${p.info_copying||"Copying to clipboard"}...`,m.quietMode||console.info(o),o=(o=Array.isArray(c)?c.join("\n"):c).replace(/\s+$/,"").replace(/"/g,'""'),"darwin"==process.platform?n(`printf "${o}" | pbcopy`):"linux"==process.platform?n(`printf "${o}" | xclip -selection clipboard`):"win32"==process.platform&&n(`Set-Clipboard -Value "${o}"`,{shell:"powershell"})}function f(s){return new Promise((r,e)=>{var o=s.match(/^([^:]+):\/\//)[1];/^https?$/.test(o)||e(new Error(`${p.error_invalidURL||"Invalid URL"}.`)),require(o).get(s,e=>{let o="";e.on("data",e=>o+=e),e.on("end",()=>r({json:()=>JSON.parse(o)}))}).on("error",e)})}function h(e=["header","usage","paramOptions","flags","infoCmds"]){var o=` ${pkgName}  `;const r={header:["\n├ "+o+(p.appCopyright||copyright),o+(p.prefix_source||"Source")+": "+srcURL],usage:[`
14
+ ${a}o ${p.helpSection_usage||"Usage"}:`," » "+cmdFormat+t],paramOptions:[`
15
+ ${a}o ${p.helpSection_paramOptions||"Parameter options"}:`,` --qty=n ${p.optionDesc_qty||"Generate n IP address(es)"}.`],flags:[`
16
+ ${a}o ${p.helpSection_flags||"Boolean options"}:`,` -q, --quiet ${p.optionDesc_quiet||"Suppress all logging except errors"}.`],infoCmds:[`
17
+ ${a}o ${p.helpSection_infoCmds||"Info commands"}:`," -h, --help "+(p.optionDesc_help||"Display help screen."),` -v, --version ${p.optionDesc_version||"Show version number"}.`]};e.forEach(i=>{r[i]?.forEach(e=>{{var s=/header|usage/.test(i)?1:29;const n=process.stdout.columns||80,t=[],o=e.match(/\S+|\s+/g);let r="";o.forEach(e=>{var o=n-(0==t.length?0:s);r.length+"| ".length+e.length>o&&(t.push(0==t.length?r:r.trimStart()),r=""),r+=e}),t.push(0==t.length?r:r.trimStart()),t.forEach((e,o)=>console.info("| "+(0==o?e:" ".repeat(s)+e)))}})}),console.info(`
18
+ ${p.info_moreHelp||"For more help"}, ${p.info_visit||"visit"}: `+a+docURL+t)}function u(){console.info(`
19
+ For more help, type 'generate-ip --help' or visit
20
+ `+a+docURL+t)}})();
@@ -3,4 +3,4 @@
3
3
  * Source: https://code.js-utils.com/generate-ip
4
4
  * Documentation: https://docs.js-utils.com/generate-ip
5
5
  */
6
- let randomInt;try{({randomInt}=require("crypto"))}catch(e){const b=window.crypto||window.msCrypto;randomInt=(e,o)=>{var t=b?.getRandomValues(new Uint32Array(1))[0]/4294967295||Math.random();return Math.floor(t*(o-e))+e}}const ipv4={generate:function(o={}){var e={verbose:!0,qty:1};if(validateOptions(o,e,"https://docs.js-utils.com/generate-ip/#ipv4generateoptions","ipv4.generate({ verbose: false, qty: 3 })")){(o={...e,...o}).verbose&&console.info(`ipv4.generate() » Generating IPv4 address${1<o.qty?"es":""}...`);var t=[];if(1<o.qty)for(let e=0;e<o.qty;e++)t.push(this.generate({...o,qty:1,verbose:!1}));else{var i=[];for(let e=0;e<4;e++)i.push(randomInt(0,256));t.push(i.join("."))}e=1<o.qty?t:t[0];return o.verbose&&(console.info(`ipv4.generate() » IPv4 address${1<o.qty?"es":""} generated!`),1==o.qty?console.info("ipv4.generate() » "+e):"undefined"!=typeof require&&/cli(?:\.min)?\.js$/.test(require.main.filename)||console.info("ipv4.generate() » Check returned array.")),e}},validate:function(e,o={}){var t="https://docs.js-utils.com/generate-ip/#ipv4validateaddress-options",i={verbose:!0};if("string"!=typeof e)console.error("ipv4.validate() » ERROR: 1st arg <address> must be a string."),console.info("ipv4.validate() » For more help, please visit "+t);else if(validateOptions(o,i,t,"ipv4.validate('0.0.255.255', { verbose: false })"))return(o={...i,...o}).verbose&&console.info("ipv4.validate() » Validating IPv4 address..."),i=!(4!=(t=e.split(".")).length||t.some(e=>!/^\d+$/.test(e)||parseInt(e,10)<0||255<parseInt(e,10))),o.verbose&&console.info(`ipv4.validate() » IP is ${i?"":"in"}valid IPv4 address!`),i}},ipv6={generate:function(o={}){var e={verbose:!0,qty:1,leadingZeros:!1,doubleColon:!0};if(validateOptions(o,e,"https://docs.js-utils.com/generate-ip/#ipv6generateoptions","ipv6.generate({ leadingZeros: true, qty: 5 })")){(o={...e,...o}).verbose&&console.info(`ipv6.generate() » Generating IPv6 address${1<o.qty?"es":""}...`);var t=[];if(1<o.qty)for(let e=0;e<o.qty;e++)t.push(this.generate({...o,qty:1,verbose:!1}));else{const i=[],{qty:r,...s}=o;for(let e=0;e<8;e++){let o="";for(let e=0;e<4;e++)o+=randomInt(0,16).toString(16);i.push(o)}t.push(this.format(i.join(":"),{...s,verbose:!1}))}e=1<o.qty?t:t[0];return o.verbose&&(console.info(`ipv6.generate() » IPv6 address${1<o.qty?"es":""} generated!`),console.info(1==o.qty?"ipv6.generate() » "+e:"ipv6.generate() » Check returned array.")),e}},format:function(o,t={}){var i,e="https://docs.js-utils.com/generate-ip/#ipv6formatipv6address-options",r={verbose:!0,leadingZeros:!1,doubleColon:!0};if("string"!=typeof o)console.error("ipv6.format() » ERROR: 1st arg <ipv6address> must be a string."),console.info("ipv6.format() » For more help, please visit "+e);else if(this.validate(o,{verbose:!1})){if(validateOptions(t,r,e,"ipv6.format('0d::ffff:192.1.56.10/96', { leadingZeros: true, doubleColon: false })")){t={...r,...t};let e=o;if(e=t.doubleColon?(t.verbose&&console.info("ipv6.format() » Replacing zero series w/ '::'..."),e.replace(/:(?:0+:)+/,"::")):(t.verbose&&console.info("ipv6.format() » Expanding '::' into zero series..."),r=e.split(":").filter(Boolean).length,i=t.leadingZeros?"0000":"0",r=Array(8-r).fill(i).join(":"),e.replace("::",`:${r}:`)),t.leadingZeros){t.verbose&&console.info("ipv6.format() » Adding leading zeros...");var s=e.split(":");for(let e=0;e<s.length;e++)for(;s[e].length<4;)s[e]="0"+s[e];e=s.join(":")}else t.verbose&&console.info("ipv6.format() » Stripping leading zeros..."),e=o.replace(/(^|(?<=:))0+(?!:)/g,"$1");return t.verbose&&(e!=o?console.info("ipv6.format() » IP formatted successfully!"):console.info("ipv6.format() » IP already formatted to specs."),console.info("ipv6.format() » "+e)),e}}else console.error(`ipv6.format() » ERROR: ${o} is not a valid IPv6 address.`),console.info("ipv6.format() » For more help, please visit "+e)},validate:function(e,o={}){var t="https://docs.js-utils.com/generate-ip/#ipv6validateaddress-options",i={verbose:!0};if("string"!=typeof e)console.error("ipv6.validate() » ERROR: 1st arg <address> must be a string."),console.info("ipv6.validate() » For more help, please visit "+t);else if(validateOptions(o,i,t,"ipv6.validate('0:0:0:0:0:ffff:192.1.56.10/96', { verbose: false })")){(o={...i,...o}).verbose&&console.info("ipv6.validate() » Validating IPv6 address...");const r=e.split(/::?/),s=r[r.length-1];t=!(e.includes("::")&&2<e.split("::").length||/:{3,}/g.test(e)||r.length<2||8<r.length||r.some(e=>!(/^[\dA-Fa-f]{1,4}$/.test(e)||e==s&&ipv4.validate(s.replace(/\/(?:0|(?:[1-2]?\d)|32|96)$/,""),{verbose:!1}))));return o.verbose&&console.info(`ipv6.validate() » IP is ${t?"":"in"}valid IPv6 address!`),t}}};function validateOptions(e,o,t,i){const r=JSON.stringify(o,null,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," "),s=Object.keys(o).join(", "),n=Object.keys(o).filter(e=>"boolean"==typeof o[e]),a=Object.keys(o).filter(e=>Number.isInteger(o[e]));let l="validateOptions() » ";try{l=validateOptions.caller?.name+"() » "}catch(e){}var p=i.split(",").findIndex(e=>e.trim().startsWith("{"))+1,v=(p+=["st","nd","rd"][p-1]||"th",()=>{console.info(`${l}Valid options: [ ${s} ]`),console.info(l+"If omitted, default settings are: "+r)}),d=()=>{console.info(l+"For more help, please visit "+t)};if("object"!=typeof e)return console.error(l+`ERROR: ${"0th"==p?"[O":p+" arg [o"}ptions] can only be an object of key/values.`),console.info(l+"Example valid call: "+i),v(),d(),!1;for(const f in e){if(!Object.prototype.hasOwnProperty.call(o,f))return console.error(`${l}ERROR: \`${f}\` is an invalid option.`),v(),d(),!1;if(n.includes(f)&&"boolean"!=typeof e[f])return console.error(`${l}ERROR: [${f}] option can only be \`true\` or \`false\`.`),d(),!1;if(a.includes(f)&&(e[f]=parseInt(e[f],10),isNaN(e[f])||e[f]<1))return console.error(`${l}ERROR: [${f}] option can only be an integer > 0.`),d(),!1}return!0}const apiAliases={ipv4:["IPV4","IPv4","ipV4"],ipv6:["IPV6","IPv6","ipV6"]};try{module.exports={ipv4:ipv4,ipv6:ipv6}}catch(e){}try{window.ipv4=ipv4,window.ipv6=ipv6}catch(e){}for(const ua in apiAliases)apiAliases[ua].forEach(e=>{try{module.exports[e]=module.exports[ua]}catch(e){}try{window[e]=window[ua]}catch(e){}});
6
+ const ipv4={generate:function(o={}){var e={verbose:!0,qty:1};if(validateOptions(o,e,"https://docs.js-utils.com/generate-ip/#ipv4generateoptions","ipv4.generate({ verbose: false, qty: 3 })")){(o={...e,...o}).verbose&&console.info(`ipv4.generate() » Generating IPv4 address${1<o.qty?"es":""}...`);var t=[];if(1<o.qty)for(let e=0;e<o.qty;e++)t.push(this.generate({...o,qty:1,verbose:!1}));else{var i=[];for(let e=0;e<4;e++)i.push(randomInt(0,256));t.push(i.join("."))}e=1<o.qty?t:t[0];return o.verbose&&(console.info(`ipv4.generate() » IPv4 address${1<o.qty?"es":""} generated!`),console.info("ipv4.generate() » "+(1==o.qty?e:e.join(", ")))),e}},validate:function(e,o={}){var t="https://docs.js-utils.com/generate-ip/#ipv4validateaddress-options",i={verbose:!0};if("string"!=typeof e)console.error("ipv4.validate() » ERROR: 1st arg <address> must be a string."),console.info("ipv4.validate() » For more help, please visit "+t);else if(validateOptions(o,i,t,"ipv4.validate('0.0.255.255', { verbose: false })"))return(o={...i,...o}).verbose&&console.info("ipv4.validate() » Validating IPv4 address..."),i=!(4!=(t=e.split(".")).length||t.some(e=>!/^\d+$/.test(e)||parseInt(e,10)<0||255<parseInt(e,10))),o.verbose&&console.info(`ipv4.validate() » IP is ${i?"":"in"}valid IPv4 address!`),i}},ipv6={generate:function(o={}){var e={verbose:!0,qty:1,leadingZeros:!1,doubleColon:!0};if(validateOptions(o,e,"https://docs.js-utils.com/generate-ip/#ipv6generateoptions","ipv6.generate({ leadingZeros: true, qty: 5 })")){(o={...e,...o}).verbose&&console.info(`ipv6.generate() » Generating IPv6 address${1<o.qty?"es":""}...`);var t=[];if(1<o.qty)for(let e=0;e<o.qty;e++)t.push(this.generate({...o,qty:1,verbose:!1}));else{const i=[],{qty:s,...r}=o;for(let e=0;e<8;e++){let o="";for(let e=0;e<4;e++)o+=randomInt(0,16).toString(16);i.push(o)}t.push(this.format(i.join(":"),{...r,verbose:!1}))}e=1<o.qty?t:t[0];return o.verbose&&(console.info(`ipv6.generate() » IPv6 address${1<o.qty?"es":""} generated!`),console.info("ipv6.generate() » "+(1==o.qty?e:e.join(", ")))),e}},format:function(o,t={}){var i,e="https://docs.js-utils.com/generate-ip/#ipv6formatipv6address-options",s={verbose:!0,leadingZeros:!1,doubleColon:!0};if("string"!=typeof o)console.error("ipv6.format() » ERROR: 1st arg <ipv6address> must be a string."),console.info("ipv6.format() » For more help, please visit "+e);else if(this.validate(o,{verbose:!1})){if(validateOptions(t,s,e,"ipv6.format('0d::ffff:192.1.56.10/96', { leadingZeros: true, doubleColon: false })")){t={...s,...t};let e=o;if(e=t.doubleColon?(t.verbose&&console.info("ipv6.format() » Replacing zero series w/ '::'..."),e.replace(/:(?:0+:)+/,"::")):(t.verbose&&console.info("ipv6.format() » Expanding '::' into zero series..."),s=e.split(":").filter(Boolean).length,i=t.leadingZeros?"0000":"0",s=Array(8-s).fill(i).join(":"),e.replace("::",`:${s}:`)),t.leadingZeros){t.verbose&&console.info("ipv6.format() » Adding leading zeros...");var r=e.split(":");for(let e=0;e<r.length;e++)for(;r[e].length<4;)r[e]="0"+r[e];e=r.join(":")}else t.verbose&&console.info("ipv6.format() » Stripping leading zeros..."),e=o.replace(/(^|(?<=:))0+(?!:)/g,"$1");return t.verbose&&(e!=o?console.info("ipv6.format() » IP formatted successfully!"):console.info("ipv6.format() » IP already formatted to specs."),console.info("ipv6.format() » "+e)),e}}else console.error(`ipv6.format() » ERROR: ${o} is not a valid IPv6 address.`),console.info("ipv6.format() » For more help, please visit "+e)},validate:function(e,o={}){var t="https://docs.js-utils.com/generate-ip/#ipv6validateaddress-options",i={verbose:!0};if("string"!=typeof e)console.error("ipv6.validate() » ERROR: 1st arg <address> must be a string."),console.info("ipv6.validate() » For more help, please visit "+t);else if(validateOptions(o,i,t,"ipv6.validate('0:0:0:0:0:ffff:192.1.56.10/96', { verbose: false })")){(o={...i,...o}).verbose&&console.info("ipv6.validate() » Validating IPv6 address...");const s=e.split(/::?/),r=s[s.length-1];t=!(e.includes("::")&&2<e.split("::").length||/:{3,}/g.test(e)||s.length<2||8<s.length||s.some(e=>!(/^[\dA-Fa-f]{1,4}$/.test(e)||e==r&&ipv4.validate(r.replace(/\/(?:0|(?:[1-2]?\d)|32|96)$/,""),{verbose:!1}))));return o.verbose&&console.info(`ipv6.validate() » IP is ${t?"":"in"}valid IPv6 address!`),t}}};function randomInt(e,o){var t;return"undefined"==typeof require?(t=(window.crypto||window.msCrypto)?.getRandomValues(new Uint32Array(1))[0]/4294967295||Math.random(),Math.floor(t*(o-e))+e):require("crypto").randomInt(e,o)}function validateOptions(e,o,t,i){const s=JSON.stringify(o,null,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," "),r=Object.keys(o).join(", "),n=Object.keys(o).filter(e=>"boolean"==typeof o[e]),a=Object.keys(o).filter(e=>Number.isInteger(o[e]));let l="validateOptions() » ";try{l=validateOptions.caller?.name+"() » "}catch(e){}var p=i.split(",").findIndex(e=>e.trim().startsWith("{"))+1,v=(p+=["st","nd","rd"][p-1]||"th",()=>{console.info(`${l}Valid options: [ ${r} ]`),console.info(l+"If omitted, default settings are: "+s)}),d=()=>{console.info(l+"For more help, please visit "+t)};if("object"!=typeof e)return console.error(l+`ERROR: ${"0th"==p?"[O":p+" arg [o"}ptions] can only be an object of key/values.`),console.info(l+"Example valid call: "+i),v(),d(),!1;for(const f in e){if(!Object.prototype.hasOwnProperty.call(o,f))return console.error(`${l}ERROR: \`${f}\` is an invalid option.`),v(),d(),!1;if(n.includes(f)&&"boolean"!=typeof e[f])return console.error(`${l}ERROR: [${f}] option can only be \`true\` or \`false\`.`),d(),!1;if(a.includes(f)&&(e[f]=parseInt(e[f],10),isNaN(e[f])||e[f]<1))return console.error(`${l}ERROR: [${f}] option can only be an integer > 0.`),d(),!1}return!0}const apiAliases={ipv4:["IPV4","IPv4","ipV4"],ipv6:["IPV6","IPv6","ipV6"]};try{module.exports={ipv4:ipv4,ipv6:ipv6}}catch(e){}try{window.ipv4=ipv4,window.ipv6=ipv6}catch(e){}for(const ta in apiAliases)apiAliases[ta].forEach(e=>{try{module.exports[e]=module.exports[ta]}catch(e){}try{window[e]=window[ta]}catch(e){}});
package/docs/README.md CHANGED
@@ -3,9 +3,9 @@
3
3
  ### Randomly generate, format, and validate IPv4/IPv6 addresses.
4
4
 
5
5
  <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>
6
- <a href="https://github.com/adamlui/js-utils/releases/tag/generate-ip-2.2.9"><img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.9-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
6
+ <a href="https://github.com/adamlui/js-utils/releases/tag/generate-ip-2.2.11"><img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.11-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
7
7
  <a href="https://www.npmjs.com/package/generate-ip?activeTab=code"><img height=31 src="https://img.shields.io/npm/unpacked-size/generate-ip?style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
8
- <a href="https://github.com/adamlui/js-utils/blob/generate-ip-2.2.9/generate-ip/dist/generate-ip.min.js"><img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-ip/dist/generate-ip.min.js?branch=generate-ip-2.2.9&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
8
+ <a href="https://github.com/adamlui/js-utils/blob/generate-ip-2.2.11/generate-ip/dist/generate-ip.min.js"><img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-ip/dist/generate-ip.min.js?branch=generate-ip-2.2.11&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
9
9
  <a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:generate-ip/src/generate-ip.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-ip%2Fsrc%2Fgenerate-ip.js%26metricKeys%3Dvulnerabilities&query=%24.component.measures.0.value&style=for-the-badge&logo=sonarcloud&logoColor=white&labelColor=464646&label=Vulnerabilities&color=gold"></a>
10
10
  <a href="https://github.com/toolleeo/cli-apps#networking"><img height=31 src="https://img.shields.io/badge/Mentioned_in-Awesome-c4a2bd?logo=awesomelists&logoColor=white&labelColor=464646&style=for-the-badge"></a>
11
11
  <a href="https://www.jsdelivr.com/package/npm/generate-ip?tab=stats"><img height=31 src="https://img.shields.io/jsdelivr/npm/hm/generate-ip?style=for-the-badge&logo=jsdelivr&logoColor=white&label=jsDelivr%20Hits&labelColor=464646&color=49c5d8"></a>
@@ -72,14 +72,14 @@ const { ipv4, ipv6 } = require('generate-ip');
72
72
  #### <> HTML script tag:
73
73
 
74
74
  ```html
75
- <script src="https://cdn.jsdelivr.net/npm/generate-ip@2.2.9/dist/generate-ip.min.js"></script>
75
+ <script src="https://cdn.jsdelivr.net/npm/generate-ip@2.2.11/dist/generate-ip.min.js"></script>
76
76
  ```
77
77
 
78
78
  #### ES6:
79
79
 
80
80
  ```js
81
81
  (async () => {
82
- await import('https://cdn.jsdelivr.net/npm/generate-ip@2.2.9/dist/generate-ip.min.js');
82
+ await import('https://cdn.jsdelivr.net/npm/generate-ip@2.2.11/dist/generate-ip.min.js');
83
83
  // Your code here...
84
84
  })();
85
85
  ```
@@ -88,7 +88,7 @@ const { ipv4, ipv6 } = require('generate-ip');
88
88
 
89
89
  ```js
90
90
  ...
91
- // @require https://cdn.jsdelivr.net/npm/generate-ip@2.2.9/dist/generate-ip.min.js
91
+ // @require https://cdn.jsdelivr.net/npm/generate-ip@2.2.11/dist/generate-ip.min.js
92
92
  // ==/UserScript==
93
93
 
94
94
  // Your code here...
@@ -96,7 +96,7 @@ const { ipv4, ipv6 } = require('generate-ip');
96
96
 
97
97
  <br>
98
98
 
99
- 📝 **Note:** To always import the latest version (not recommended in production!) remove the `@2.2.9` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js`
99
+ 📝 **Note:** To always import the latest version (not recommended in production!) remove the `@2.2.11` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js`
100
100
 
101
101
  <br>
102
102
 
@@ -129,7 +129,7 @@ console.log(ips);
129
129
 
130
130
  ipv4.generate() » Generating IPv4 addresses...
131
131
  ipv4.generate() » IPv4 addresses generated!
132
- ipv4.generate() » Check returned array.
132
+ ipv4.generate() » 194.84.176.172, 192.186.53.120, 50.191.111.87
133
133
  [ '194.84.176.172', '192.186.53.120', '50.191.111.87' ]
134
134
  */
135
135
  ```
@@ -192,7 +192,7 @@ console.log(ips);
192
192
 
193
193
  ipv6.generate() » Generating IPv6 addresses...
194
194
  ipv6.generate() » IPv6 addresses generated!
195
- ipv6.generate() » Check returned array.
195
+ ipv6.generate() » 8218:19b9:7709:4282:65e1:7ee:319e:32ef, e940:754d:ae46:ae18:94dd:b43c:583:68c2, b570:b4f8:68f:62e2:99cb:ad0f:6237:9d51, 98a7:f4e5:2f4e:8a2d:56bb:dc28:f94a:46a8, ca59:590a:9b6c:ea25:94fa:37d6:9bac:7ff6
196
196
  [
197
197
  '8218:19b9:7709:4282:65e1:7ee:319e:32ef',
198
198
  'e940:754d:ae46:ae18:94dd:b43c:583:68c2',
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "generate-ip",
3
- "version": "2.2.9",
3
+ "version": "2.2.11",
4
4
  "description": "Randomly generate, format, and validate IPv4/IPv6 addresses.",
5
5
  "author": {
6
6
  "name": "Adam Lui",
@@ -56,6 +56,6 @@
56
56
  "url": "https://github.com/sponsors/adamlui"
57
57
  },
58
58
  "devDependencies": {
59
- "@adamlui/minify.js": "^1.5.5"
59
+ "@adamlui/minify.js": "^1.5.7"
60
60
  }
61
61
  }