ip-utilties 3.5.2 → 3.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ip-utilties",
-  "version": "3.5.2",
+  "version": "3.6.0",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -44,7 +44,7 @@
     "browser-ava": "^2.3.66",
     "c8": "^11.0.0",
     "documentation": "^14.0.3",
-    "semantic-release": "^25.0.5",
+    "semantic-release": "^25.0.6",
     "typescript": "^7.0.2"
   },
   "overrides": {

package/src/ip.mjs

@@ -26,17 +26,19 @@ const ipv4 = {
   // https://www.geeksforgeeks.org/computer-networks/subnet-cheat-sheet/
   wellKnownAddresses: [
     [new Uint8Array([0, 0, 0, 0]), 8], // This network
-    [new Uint8Array([10, 0, 0, 0]), 8], // Private Address Block
-    [new Uint8Array([100, 64, 0, 0]), 10], // Carrier-grade NAT
+    [new Uint8Array([10, 0, 0, 0]), 8], // Private network (RFC 1918)
+    [new Uint8Array([100, 64, 0, 0]), 10], // Carrier-grade NAT / Shared address space (CGN)
     [new Uint8Array([127, 0, 0, 0]), 8], // Loopback
     [new Uint8Array([127, 0, 53, 53]), 0], // Name collision occurrence
-    [new Uint8Array([169, 254, 0, 0]), 16], // Link local
-    [new Uint8Array([172, 16, 0, 0]), 12], // Private Address Block
+    [new Uint8Array([169, 254, 0, 0]), 16], // Link-local address (Autoconfiguration)
+    [new Uint8Array([172, 16, 0, 0]), 12], // Private network (RFC 1918)
     [new Uint8Array([192, 0, 0, 0]), 24], // IETF protocol assignments
     [new Uint8Array([192, 0, 2, 0]), 24], // TEST-NET-1
-    [new Uint8Array([192, 168, 0, 0]), 16], // Private Address Block
+    [new Uint8Array([192, 168, 0, 0]), 16], // Private network (RFC 1918)
     [new Uint8Array([198, 18, 0, 0]), 15], // Network benchmark testing
     [new Uint8Array([198, 51, 100, 0]), 24], // TEST-NET-2
+    [new Uint8Array([203, 0, 113, 0]), 24], // Reserved address space used for documentation
+    [new Uint8Array([240, 0, 0, 0]), 4], // Reserved for future use or experimental purposes
     [new Uint8Array([255, 255, 255, 255]), 0] // Limited Broadcast address
   ]
 };
@@ -248,6 +250,11 @@ export function prefixIP(address, length) {
   return _decode(family, _prefix(family, address, length));
 }
 
+export function prefixOnlyIP(address, length) {
+  const family = _family(address);
+  return _decode(family, _prefix(family, address, length), length);
+}
+
 function _prefix(family, address, length) {
   return (
     _asBigInt(family, address) & (-1n << BigInt(family.bitLength - length))

package/types/ip.d.mts

@@ -37,6 +37,7 @@ export declare function isIPv6(address: any): boolean;
 export declare function familyIP(address: string | Uint8Array | Uint16Array): string | undefined;
 export declare function asBigInt(address: any): any;
 export declare function prefixIP(address: any, length: any): string;
+export declare function prefixOnlyIP(address: any, length: any): string;
 export declare function rangeIP(address: any, prefix: any, lowerAdd?: number, upperReduce?: number): any[];
 export declare function matchPrefixIP(prefix: any, length: any, address: any): boolean;
 export declare function normalizeCIDR(address: any): {