ip-utilties 3.4.0 → 3.5.1

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "ip-utilties",
-  "version": "3.4.0",
+  "version": "3.5.1",
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
-  "packageManager": "npm@11.16.0",
+  "packageManager": "npm@11.18.0",
   "exports": {
     ".": {
       "default": "./src/ip.mjs"
@@ -41,7 +41,7 @@
   },
   "devDependencies": {
     "ava": "^8.0.1",
-    "browser-ava": "^2.3.64",
+    "browser-ava": "^2.3.65",
     "c8": "^11.0.0",
     "documentation": "^14.0.3",
     "semantic-release": "^25.0.5",

package/src/ip.mjs

@@ -21,7 +21,12 @@ const ipv4 = {
   linkLocalPrefix: new Uint8Array([169, 254]),
   linkLocalPrefixLength: 16,
   localHost: new Uint8Array([127, 0, 0, 1]),
-  localHostPrefixLenth: 8
+  localHostPrefixLenth: 8,
+  wellKnownClasses: [
+    [new Uint8Array([10]), 8],
+    [new Uint8Array([172, 16]), 16],
+    [new Uint8Array([192, 168]), 24]
+  ]
 };
 
 const ipv6 = {
@@ -266,7 +271,7 @@ export function normalizeCIDR(address) {
     const n = _prefix(family, address, prefixLength);
     prefix = _decode(family, n, prefixLength);
 
-    if (family == ipv6) {
+    if (family === ipv6) {
       if (!prefix.endsWith("::")) {
         // TODO
         prefix += prefix.endsWith(":") ? ":" : "::";
@@ -346,7 +351,6 @@ export function isLocalhost(address) {
   if (family) {
     return _equal(family.localHost, _encode(family, address));
   }
-
   return false;
 }
 
@@ -367,8 +371,41 @@ export function isUniqueLocal(address) {
   return eaddr?.[0] >> 9 === 126 ? true : false;
 }
 
+export function _isUniqueLocal(eaddr) {
+  return eaddr?.[0] >> 9 === 126 ? true : false;
+}
+
 export function hasWellKnownSubnet(address) {
-  return isLocalhost(address) || isLinkLocal(address) || isUniqueLocal(address);
+  return wellKnownSubnet(address) !== undefined;
+}
+
+export function wellKnownSubnet(address) {
+  const family = _family(address);
+  if (family) {
+    return _wellKnownSubnet(family, address);
+  }
+}
+
+export function _wellKnownSubnet(family, address) {
+  const encoded = _encode(family, address);
+
+  if (_equal(family.localHost, encoded)) {
+    return [family.localHost, family.localHostPrefixLenth];
+  }
+  if (_equal(family.linkLocalPrefix, encoded)) {
+    return [family.linkLocalPrefix, family.linkLocalPrefixLength];
+  }
+  if (_isUniqueLocal(encoded)) {
+    return [encoded[0], 64];
+  }
+
+  if (family === ipv4) {
+    for (const c of family.wellKnownClasses) {
+      if (_equal(c[0], encoded)) {
+        return c;
+      }
+    }
+  }
 }
 
 /*

package/types/ip.d.mts

@@ -44,7 +44,10 @@ export function isLocalhost(address: any): boolean;
 export function isLinkLocal(address: any): boolean;
 export function _isLinkLocal(family: any, address: any): boolean;
 export function isUniqueLocal(address: any): boolean;
+export function _isUniqueLocal(eaddr: any): boolean;
 export function hasWellKnownSubnet(address: any): boolean;
+export function wellKnownSubnet(address: any): any;
+export function _wellKnownSubnet(family: any, address: any): any;
 /**
  * Address familiy IPv4
  */