generate-ip 2.2.3 → 2.2.5

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.3"><img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.3-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.5"><img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.5-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.3/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.3&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.5/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.5&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.3/dist/generate-ip.min.js"></script>
75
+ <script src="https://cdn.jsdelivr.net/npm/generate-ip@2.2.5/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.3/dist/generate-ip.min.js');
82
+ await import('https://cdn.jsdelivr.net/npm/generate-ip@2.2.5/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.3/dist/generate-ip.min.js
91
+ // @require https://cdn.jsdelivr.net/npm/generate-ip@2.2.5/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.3` 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.5` 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
 
package/dist/cli.min.js CHANGED
@@ -1,9 +1,15 @@
1
1
  #!/usr/bin/env node
2
- const docURL="https://github.com/adamlui/js-utils/tree/main/generate-ip#-command-line-usage",ipv4=require(__dirname.match(/src/)?"./generate-ip":"./generate-ip.min")["ipv4"],execSync=require("child_process")["execSync"],nc="",br="",by="",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(arg=>{var matchedParamOption,matchedInfoCmd,matchedFlag;arg.startsWith("-")&&(matchedParamOption=Object.keys(argRegex.paramOptions).find(option=>argRegex.paramOptions[option].test(arg)),matchedFlag=Object.keys(argRegex.flags).find(flag=>argRegex.flags[flag].test(arg)),matchedInfoCmd=Object.keys(argRegex.infoCmds).find(cmd=>argRegex.infoCmds[cmd].test(arg)),matchedFlag?config[matchedFlag]=!0:matchedParamOption?(arg.includes("=")||(console.error(`
3
- ${br}ERROR: Arg [--${arg.replace(/-/g,"")}] requires '=' followed by a value.`+nc),printHelpCmdAndDocURL(),process.exit(1)),matchedFlag=arg.split("=")[1],config[matchedParamOption]=parseInt(matchedFlag)||matchedFlag):matchedInfoCmd||(console.error(`
4
- ${br}ERROR: Arg [${arg}] not recognized.`+nc),console.info(`
5
- ${by}Valid arguments are below.`+nc),printHelpSections(["paramOptions","flags","infoCmds"]),printHelpCmdAndDocURL(),process.exit(1)))}),process.argv.some(arg=>argRegex.infoCmds.help.test(arg)))printHelpSections();else if(process.argv.some(arg=>argRegex.infoCmds.version.test(arg)))console.info("v"+require("./package.json").version);else{config.qty&&(isNaN(config.qty)||config.qty<1)&&(console.error(`
6
- ${br}Error: [qty] argument can only be > 0.`+nc),printHelpCmdAndDocURL(),process.exit(1));const ipResult=ipv4.generate({qty:config.qty||1,verbose:!config.quietMode});config.quietMode||(1<config.qty&&console.info(`[ ${ipResult.join(", ")} ]`),console.info("\nCopying to clipboard...")),copyToClipboard(Array.isArray(ipResult)?ipResult.join("\n"):ipResult)}function printHelpSections(includeSections=["cmdFormat","paramOptions","flags","infoCmds"]){const helpSections={cmdFormat:[`
7
- ${by}generate-ip [options|commands]`+nc],paramOptions:["\nParameter options:"," --qty=n Generate n IP address(es)."],flags:["\nBoolean options:"," -q, --quiet Suppress all logging except errors."],infoCmds:["\nInfo commands:"," -h, --help Display help screen."," -v, --version Show version number."]};includeSections.forEach(section=>{helpSections[section]?.forEach(line=>{{const terminalWidth=process.stdout.columns||80,lines=[],words=line.match(/\S+|\s+/g);let currentLine="";words.forEach(word=>{var lineLength=terminalWidth-(0===lines.length?0:29);currentLine.length+word.length>lineLength&&(lines.push(0===lines.length?currentLine:currentLine.trimStart()),currentLine=""),currentLine+=word}),lines.push(0===lines.length?currentLine:currentLine.trimStart()),lines.forEach((line,index)=>console.info(0===index?line:" ".repeat(29)+line))}})})}function printHelpCmdAndDocURL(){console.info(`
2
+ /**
3
+ * © 2024 Adam Lui & contributors under the MIT license.
4
+ * Source: https://github.js-utils.com/tree/main/generate-ip/src
5
+ * Documentation: https://github.js-utils.com/tree/main/generate-ip/docs
6
+ */
7
+ const pkgName="generate-ip",docURL="https://github.com/adamlui/js-utils/tree/main/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="",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=["cmdFormat","paramOptions","flags","infoCmds"]){const o={cmdFormat:[`
13
+ ${by}generate-ip [options|commands]`+nc],paramOptions:["\nParameter options:"," --qty=n Generate n IP address(es)."],flags:["\nBoolean options:"," -q, --quiet Suppress all logging except errors."],infoCmds:["\nInfo commands:"," -h, --help Display help screen."," -v, --version Show version number."]};e.forEach(e=>{o[e]?.forEach(e=>{{const r=process.stdout.columns||80,s=[],o=e.match(/\S+|\s+/g);let n="";o.forEach(e=>{var o=r-(0==s.length?0:29);n.length+e.length>o&&(s.push(0==s.length?n:n.trimStart()),n=""),n+=e}),s.push(0==s.length?n:n.trimStart()),s.forEach((e,o)=>console.info(0==o?e:" ".repeat(29)+e))}})})}function printHelpCmdAndDocURL(){console.info(`
8
14
  ${by}For more help, type 'generate-ip --help' or visit
9
- `+(docURL+nc))}function copyToClipboard(data){data=data.replace(/\s+$/,"").replace(/"/g,'""'),"darwin"===process.platform?execSync(`printf "${data}" | pbcopy`):"linux"===process.platform?execSync(`printf "${data}" | xclip -selection clipboard`):"win32"===process.platform&&execSync(`Set-Clipboard -Value "${data}"`,{shell:"powershell"})}
15
+ `+(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"})}
@@ -1 +1,6 @@
1
- let randomInt;try{({randomInt}=require("crypto"))}catch(err){const browserCrypto=window.crypto||window.msCrypto;randomInt=(min,max)=>{var randomVal=browserCrypto?.getRandomValues(new Uint32Array(1))[0]/4294967295||Math.random();return Math.floor(randomVal*(max-min))+min}}const ipv4={generate:function(options={}){var defaultOptions={verbose:!0,qty:1};if(validateOptions(options,defaultOptions,"https://github.com/adamlui/js-utils/tree/main/generate-ip#ipv4generateoptions","ipv4.generate({ verbose: false, qty: 3 })")){(options={...defaultOptions,...options}).verbose&&console.info(`ipv4.generate() » Generating IPv4 address${1<options.qty?"es":""}...`);var ips=[];if(1<options.qty)for(let i=0;i<options.qty;i++)ips.push(this.generate({...options,qty:1,verbose:!1}));else{var segments=[];for(let i=0;i<4;i++)segments.push(randomInt(0,256));ips.push(segments.join("."))}defaultOptions=1<options.qty?ips:ips[0];return options.verbose&&(console.info(`ipv4.generate() » IPv4 address${1<options.qty?"es":""} generated!`),1===options.qty?console.info("ipv4.generate() » "+defaultOptions):"undefined"!=typeof require&&require.main.filename.endsWith("cli.js")||console.info("ipv4.generate() » Check returned array.")),defaultOptions}},validate:function(address,options={}){var docURL="https://github.com/adamlui/js-utils/tree/main/generate-ip#ipv4validateaddress-options",defaultOptions={verbose:!0};if("string"!=typeof address)console.error("ipv4.validate() » ERROR: 1st arg <address> must be a string."),console.info("ipv4.validate() » For more help, please visit "+docURL);else if(validateOptions(options,defaultOptions,docURL,"ipv4.validate('0.0.255.255', { verbose: false })"))return(options={...defaultOptions,...options}).verbose&&console.info("ipv4.validate() » Validating IPv4 address..."),defaultOptions=!(4!==(docURL=address.split(".")).length||docURL.some(segment=>!/^\d+$/.test(segment)||parseInt(segment,10)<0||255<parseInt(segment,10))),options.verbose&&console.info(`ipv4.validate() » IP is ${defaultOptions?"":"in"}valid IPv4 address!`),defaultOptions}},ipv6={generate:function(options={}){var defaultOptions={verbose:!0,qty:1,leadingZeros:!1,doubleColon:!0};if(validateOptions(options,defaultOptions,"https://github.com/adamlui/js-utils/tree/main/generate-ip#ipv6generateoptions","ipv6.generate({ leadingZeros: true, qty: 5 })")){(options={...defaultOptions,...options}).verbose&&console.info(`ipv6.generate() » Generating IPv6 address${1<options.qty?"es":""}...`);var ips=[];if(1<options.qty)for(let i=0;i<options.qty;i++)ips.push(this.generate({...options,qty:1,verbose:!1}));else{const pieces=[],{qty,...nonQtyOptions}=options;for(let i=0;i<8;i++){let hex="";for(let j=0;j<4;j++)hex+=randomInt(0,16).toString(16);pieces.push(hex)}ips.push(this.format(pieces.join(":"),{...nonQtyOptions,verbose:!1}))}defaultOptions=1<options.qty?ips:ips[0];return options.verbose&&(console.info(`ipv6.generate() » IPv6 address${1<options.qty?"es":""} generated!`),console.info(1===options.qty?"ipv6.generate() » "+defaultOptions:"ipv6.generate() » Check returned array.")),defaultOptions}},format:function(address,options={}){var zeroSegment,docURL="https://github.com/adamlui/js-utils/tree/main/generate-ip#ipv6formataddress-options",defaultOptions={verbose:!0,leadingZeros:!1,doubleColon:!0};if("string"!=typeof address)console.error("ipv6.format() » ERROR: 1st arg <address> must be a string."),console.info("ipv6.format() » For more help, please visit "+docURL);else if(this.validate(address,{verbose:!1})){if(validateOptions(options,defaultOptions,docURL,"ipv6.format('0d::ffff:192.1.56.10/96', { leadingZeros: true, doubleColon: false })")){options={...defaultOptions,...options};let formattedAddress=address;if(formattedAddress=options.doubleColon?(options.verbose&&console.info("ipv6.format() » Replacing zero series w/ '::'..."),formattedAddress.replace(/:(?:0+:)+/,"::")):(options.verbose&&console.info("ipv6.format() » Expanding '::' into zero series..."),defaultOptions=formattedAddress.split(":").filter(Boolean).length,zeroSegment=options.leadingZeros?"0000":"0",defaultOptions=Array(8-defaultOptions).fill(zeroSegment).join(":"),formattedAddress.replace("::",`:${defaultOptions}:`)),options.leadingZeros){options.verbose&&console.info("ipv6.format() » Adding leading zeros...");var pieces=formattedAddress.split(":");for(let i=0;i<pieces.length;i++)for(;pieces[i].length<4;)pieces[i]="0"+pieces[i];formattedAddress=pieces.join(":")}else options.verbose&&console.info("ipv6.format() » Stripping leading zeros..."),formattedAddress=address.replace(/(^|(?<=:))0+(?!:)/g,"$1");return options.verbose&&(formattedAddress!==address?console.info("ipv6.format() » IP formatted successfully!"):console.info("ipv6.format() » IP already formatted to specs."),console.info("ipv6.format() » "+formattedAddress)),formattedAddress}}else console.error(`ipv6.format() » ERROR: ${address} is not a valid IPv6 address.`),console.info("ipv6.format() » For more help, please visit "+docURL)},validate:function(address,options={}){var docURL="https://github.com/adamlui/js-utils/tree/main/generate-ip#ipv6validateaddress-options",defaultOptions={verbose:!0};if("string"!=typeof address)console.error("ipv6.validate() » ERROR: 1st arg <address> must be a string."),console.info("ipv6.validate() » For more help, please visit "+docURL);else if(validateOptions(options,defaultOptions,docURL,"ipv6.validate('0:0:0:0:0:ffff:192.1.56.10/96', { verbose: false })")){(options={...defaultOptions,...options}).verbose&&console.info("ipv6.validate() » Validating IPv6 address...");const pieces=address.split(/::?/),lastPiece=pieces[pieces.length-1];docURL=!(address.includes("::")&&2<address.split("::").length||/:{3,}/g.test(address)||pieces.length<2||8<pieces.length||pieces.some(piece=>!(/^[\dA-Fa-f]{1,4}$/.test(piece)||piece===lastPiece&&ipv4.validate(lastPiece.replace(/\/(?:0|(?:[1-2]?\d)|32|96)$/,""),{verbose:!1}))));return options.verbose&&console.info(`ipv6.validate() » IP is ${docURL?"":"in"}valid IPv6 address!`),docURL}}};function validateOptions(options,defaultOptions,docURL,exampleCall){const strDefaultOptions=JSON.stringify(defaultOptions,null,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," "),strValidOptions=Object.keys(defaultOptions).join(", "),booleanOptions=Object.keys(defaultOptions).filter(key=>"boolean"==typeof defaultOptions[key]),integerOptions=Object.keys(defaultOptions).filter(key=>Number.isInteger(defaultOptions[key])),logPrefix=(validateOptions.caller?.name||"validateOptions")+"() » ";var printValidOptions=()=>{console.info(logPrefix+`Valid options: [ ${strValidOptions} ]`),console.info(logPrefix+"If omitted, default settings are: "+strDefaultOptions)},printDocURL=()=>{console.info(logPrefix+"For more help, please visit "+docURL)};if("object"!=typeof options)return console.error(logPrefix+"ERROR: [options] can only be an object of key/values."),console.info(logPrefix+"Example valid call: "+exampleCall),printValidOptions(),printDocURL(),!1;for(const key in options){if(!Object.prototype.hasOwnProperty.call(defaultOptions,key))return console.error(logPrefix+`ERROR: \`${key}\` is an invalid option.`),printValidOptions(),printDocURL(),!1;if(booleanOptions.includes(key)&&"boolean"!=typeof options[key])return console.error(logPrefix+`ERROR: [${key}] option can only be \`true\` or \`false\`.`),printDocURL(),!1;if(integerOptions.includes(key)&&(options[key]=parseInt(options[key],10),isNaN(options[key])||options[key]<1))return console.error(logPrefix+`ERROR: [${key}] option can only be an integer > 0.`),printDocURL(),!1}return!0}try{module.exports={ipv4:ipv4,ipv6:ipv6}}catch(err){}try{window.ipv4=ipv4,window.ipv6=ipv6}catch(err){}
1
+ /**
2
+ * © 2024 Adam Lui & contributors under the MIT license.
3
+ * Source: https://github.js-utils.com/tree/main/generate-ip/src
4
+ * Documentation: https://github.js-utils.com/tree/main/generate-ip/docs
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://github.com/adamlui/js-utils/tree/main/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://github.com/adamlui/js-utils/tree/main/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://github.com/adamlui/js-utils/tree/main/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,...n}=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(":"),{...n,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://github.com/adamlui/js-utils/tree/main/generate-ip#ipv6formataddress-options",r={verbose:!0,leadingZeros:!1,doubleColon:!0};if("string"!=typeof o)console.error("ipv6.format() » ERROR: 1st arg <address> 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 n=e.split(":");for(let e=0;e<n.length;e++)for(;n[e].length<4;)n[e]="0"+n[e];e=n.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://github.com/adamlui/js-utils/tree/main/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(/::?/),n=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==n&&ipv4.validate(n.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," "),n=Object.keys(o).join(", "),s=Object.keys(o).filter(e=>"boolean"==typeof o[e]),a=Object.keys(o).filter(e=>Number.isInteger(o[e])),l=(validateOptions.caller?.name||"validateOptions")+"() » ";var v=()=>{console.info(l+`Valid options: [ ${n} ]`),console.info(l+"If omitted, default settings are: "+r)},p=()=>{console.info(l+"For more help, please visit "+t)};if("object"!=typeof e)return console.error(l+"ERROR: [options] can only be an object of key/values."),console.info(l+"Example valid call: "+i),v(),p(),!1;for(const d in e){if(!Object.prototype.hasOwnProperty.call(o,d))return console.error(l+`ERROR: \`${d}\` is an invalid option.`),v(),p(),!1;if(s.includes(d)&&"boolean"!=typeof e[d])return console.error(l+`ERROR: [${d}] option can only be \`true\` or \`false\`.`),p(),!1;if(a.includes(d)&&(e[d]=parseInt(e[d],10),isNaN(e[d])||e[d]<1))return console.error(l+`ERROR: [${d}] option can only be an integer > 0.`),p(),!1}return!0}try{module.exports={ipv4:ipv4,ipv6:ipv6}}catch(e){}try{window.ipv4=ipv4,window.ipv6=ipv6}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.3"><img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.3-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.5"><img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.5-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.3/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.3&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.5/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.5&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.3/dist/generate-ip.min.js"></script>
75
+ <script src="https://cdn.jsdelivr.net/npm/generate-ip@2.2.5/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.3/dist/generate-ip.min.js');
82
+ await import('https://cdn.jsdelivr.net/npm/generate-ip@2.2.5/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.3/dist/generate-ip.min.js
91
+ // @require https://cdn.jsdelivr.net/npm/generate-ip@2.2.5/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.3` 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.5` 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
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "generate-ip",
3
- "version": "2.2.3",
3
+ "version": "2.2.5",
4
4
  "description": "Randomly generate, format, and validate IPv4/IPv6 addresses.",
5
5
  "author": {
6
6
  "name": "Adam Lui",
@@ -19,12 +19,12 @@
19
19
  "generate-ip": "dist/cli.min.js"
20
20
  },
21
21
  "directories": {
22
- "lib": "./src",
22
+ "lib": "./dist",
23
23
  "doc": "./docs"
24
24
  },
25
25
  "scripts": {
26
26
  "test": "echo \"Error: no test specified\" && exit 1",
27
- "build": "minify-js src dist --no-mangle",
27
+ "build": "bash utils/build.sh",
28
28
  "bump:patch": "bash utils/bump.sh patch",
29
29
  "bump:minor": "bash utils/bump.sh minor",
30
30
  "bump:major": "bash utils/bump.sh major",
@@ -56,6 +56,6 @@
56
56
  "url": "https://github.com/sponsors/adamlui"
57
57
  },
58
58
  "devDependencies": {
59
- "@adamlui/minify.js": "^1.5.0"
59
+ "@adamlui/minify.js": "^1.5.3"
60
60
  }
61
61
  }