ztimson/utils
1
0
Fork 0
Code Issues Pull Requests Actions Packages Releases Wiki Activity

Added type helpers to isReserved
All checks were successful
Build / Publish Docs (push) Successful in 35s
Details
Build / Build NPM Project (push) Successful in 39s
Details
Build / Tag Version (push) Successful in 9s
Details

Browse Source
This commit is contained in:
Zakary Timson
2026-08-08 10:51:56 -04:00
parent af5054192e
commit 4dfd70f6a7
2 changed files with 6 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
package.json
View File

@@ -1,6 +1,6 @@
{
"name": "@ztimson/utils",
"version": "0.30.5",
"version": "0.30.6",
"description": "Utility library",
"author": "Zak Timson",
"license": "MIT",

10
src/ip.ts
View File

@@ -45,18 +45,18 @@ export function reservedIp(ip: string): boolean {
/**
* Check if IP is within a reserved range
* @param {string} ip
* @returns {string | null}
* @returns {null | 'Invalid' | 'Host' | 'Loopback' | 'Private (Class A)' | 'Private (Class B)' | 'Link-Local' | 'IETF Protocol Assignments' | 'Documentation (TEST-NET-1)' | 'Benchmarking' | 'Documentation (TEST-NET-2)' | 'Documentation (TEST-NET-3)' | 'Multicast' | 'Reserved (Class E)'} null if public, class name if reserved
*/
export function isReserved(ip: string) {
export function isReserved(ip: string): null | 'Invalid' | 'Host' | 'Loopback' | 'Private (Class A)' | 'Private (Class B)' | 'Link-Local' | 'IETF Protocol Assignments' | 'Documentation (TEST-NET-1)' | 'Benchmarking' | 'Documentation (TEST-NET-2)' | 'Documentation (TEST-NET-3)' | 'Multicast' | 'Reserved (Class E)' {
const ipToNumber = (ip: string) => {
return ip.split('.').reduce((acc: number, octet: string) => (acc << 8) + parseInt(octet, 10), 0) >>> 0;
};
const ipNum = ipToNumber(ip);
if (ipNum === null) return 'invalid';
if (ipNum === null) return 'Invalid';
const reserved = [
{ name: "This host", start: ipToNumber("0.0.0.0"), end: ipToNumber("0.255.255.255") },
{ name: "Host", start: ipToNumber("0.0.0.0"), end: ipToNumber("0.255.255.255") },
{ name: "Loopback", start: ipToNumber("127.0.0.0"), end: ipToNumber("127.255.255.255") },
{ name: "Private (Class A)", start: ipToNumber("10.0.0.0"), end: ipToNumber("10.255.255.255") },
{ name: "CGNAT", start: ipToNumber("100.64.0.0"), end: ipToNumber("100.127.255.255") },
@@ -73,5 +73,5 @@ export function isReserved(ip: string) {
];
const match = reserved.find(r => ipNum >= r.start && ipNum <= r.end);
return match ? match.name : null;
return match ? <any>match.name : null;
}