@terascope/ip-utils 2.3.2 → 2.4.0

package/dist/src/index.d.ts

@@ -1,3 +1,7 @@
+import { IPAddress } from './utils/ip-address.js';
+import { CIDRBlock } from './utils/cidr-block.js';
+import { IPRange } from './utils/ip-range.js';
+export { IPAddress, CIDRBlock, IPRange };
 export declare function isIP(input: unknown): input is string;
 /** Will throw if input is not a valid CIDR */
 export declare function isIPRangeOrThrow(input: unknown): string;
@@ -16,47 +20,40 @@ export declare function isRoutableIP(input: unknown): boolean;
 export declare function isNonRoutableIP(input: unknown): boolean;
 export declare function isCIDR(input: unknown): input is string;
 /**
- *
  * @param input ip address block in CIDR notation
  * @returns first IP address in the block
  * @deprecated use getFirstUsableIPInCIDR
  */
 export declare function getCIDRMin(input: unknown): string;
 /**
- *
  * @param input ip address block in CIDR notation
  * @returns last ip address in the block
  * @deprecated use getLastUsableIPInCIDR
  */
 export declare function getCIDRMax(input: unknown): string;
 /**
- *
  * @param input ip address block in CIDR notation, inclusive
  * @returns first IP address in the block
  */
 export declare function getFirstIPInCIDR(input: unknown): string;
 /**
- *
  * @param input ip address block in CIDR notation
  * @returns last ip address in the block, inclusive
  */
 export declare function getLastIPInCIDR(input: unknown): string;
 /**
- *
  * @param input ip address block in CIDR notation
  * @returns first usable ip address of the CIDR block
  */
 export declare function getFirstUsableIPInCIDR(input: unknown): string;
 /**
- *
  * @param input ip address block in CIDR notation
  * @returns last usable ip address of the CIDR block
  */
 export declare function getLastUsableIPInCIDR(input: unknown): string;
 /**
- *
  * @param input ip address
- * @returns IPv6 addresses are returned without leading 0's in a group or empty groups
+ * @returns IPv6 addresses are returned without leading 0's in a group or empty groups;
  *  ipv4 addresses are simply returned
  */
 export declare function shortenIPv6Address(input: unknown): string;
@@ -67,4 +64,9 @@ export declare function isNonZeroCidr(input: string): boolean;
 export declare function ipToInt(input: unknown): bigint;
 export declare function intToIP(input: unknown, ipVersion: string | number): string;
 export declare function reverseIP(input: unknown): string;
+/**
+ * Returns the smallest CIDR block that encloses both IP addresses.
+ * Both IPs must be the same version (both IPv4 or both IPv6).
+ */
+export declare function ipsToCIDR(ip1: unknown, ip2: unknown): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAeA,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEpD;AAED,8CAA8C;AAC9C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMvD;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMlD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9C;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQpD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUxD;AAED,wBAAgB,SAAS,CACrB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAsBT;AAwBD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIpD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIvD;AAuDD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMvD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMtD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,UAOpD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,UAOnD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,UAMhD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUvD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYrD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAMtE;AAuBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIpD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM9C;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAmB1E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUhD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAEzC,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEpD;AAED,8CAA8C;AAC9C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQvD;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQlD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9C;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGpD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQxD;AAED,wBAAgB,SAAS,CACrB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAoBT;AAsBD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGpD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGvD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQtD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ7D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ5D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMzD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASvD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASrD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAYtE;AAkBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM9C;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAiB1E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIhD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAK5D"}

package/dist/src/index.js

@@ -1,13 +1,10 @@
-import { toInteger, isNumberLike, toBigIntOrThrow, isNumber, isString, getTypeOf, isBoolean } from '@terascope/core-utils';
-import { isIP as _isIP, isIPv4 as _isIPv4, isIPv6 as _isIPv6, ipVersion as _ipVersion } from '@chainsafe/is-ip';
-import IPCIDR from 'ip-cidr';
-import isCidr from 'is-cidr';
-import ipaddr from 'ipaddr.js';
-import { parseIp, stringifyIp } from 'ip-bigint';
-import ip6addr from 'ip6addr';
-import { IpAddress } from 'cidr-calc';
+import { toInteger, isNumberLike, toBigIntOrThrow, isString, getTypeOf, isBoolean, } from '@terascope/core-utils';
+import { IPAddress } from './utils/ip-address.js';
+import { CIDRBlock } from './utils/cidr-block.js';
+import { IPRange } from './utils/ip-range.js';
+export { IPAddress, CIDRBlock, IPRange };
 export function isIP(input) {
-    return isString(input) && _isIP(input);
+    return isString(input) && IPAddress.isValid(input);
 }
 /** Will throw if input is not a valid CIDR */
 export function isIPRangeOrThrow(input) {
@@ -24,122 +21,73 @@ export function isIPOrThrow(input) {
     return input;
 }
 export function isIPv6(input) {
-    return isString(input) && _isIPv6(input);
+    return isString(input) && IPAddress.isIPv6(input);
 }
 export function isIPv4(input) {
-    return isString(input) && _isIPv4(input);
+    return isString(input) && IPAddress.isIPv4(input);
 }
 export function isMappedIPv4(input) {
-    if (isIPv6(input)) {
-        const parsed = ipaddr.parse(input);
-        return parsed.isIPv4MappedAddress();
-    }
-    return false;
+    if (!isIPv6(input))
+        return false;
+    return IPAddress.of(input).isMappedIPv4();
 }
 export function extractMappedIPv4(input) {
     if (isIPv6(input) && isMappedIPv4(input)) {
-        const parsed = ipaddr.parse(input);
-        const ipv4 = parsed.toIPv4Address();
-        return ipv4.octets.join('.');
+        return IPAddress.of(input)
+            .toMappedIPv4()
+            .toString();
     }
     throw Error('input must be an IPv4 address mapped to an IPv6 address');
 }
 export function inIPRange(input, args) {
     if (!isIP(input))
         return false;
-    const data = IpAddress.of(input).toString();
+    const ip = IPAddress.of(input);
     if (args.cidr != null) {
-        return isCIDR(args.cidr) && new IPCIDR(args.cidr).contains(data);
-    }
-    const ipType = _ipVersion(input);
-    // this should be refactored
-    const minValue = args.min || _assignMin(ipType);
-    const maxValue = args.max || _assignMax(ipType);
-    if (_validMinAndMax(minValue, maxValue)) {
-        const min = IpAddress.of(minValue).toString();
-        const max = IpAddress.of(maxValue).toString();
-        return ip6addr.createAddrRange(min, max).contains(data);
+        if (!isCIDR(args.cidr))
+            return false;
+        return CIDRBlock.of(args.cidr).contains(ip);
     }
-    return false;
+    const ipVersion = ip.version;
+    const minStr = args.min ?? _assignMin(ipVersion);
+    const maxStr = args.max ?? _assignMax(ipVersion);
+    if (!_validMinAndMax(minStr, maxStr))
+        return false;
+    const min = IPAddress.of(minStr);
+    const max = IPAddress.of(maxStr);
+    return ip.compare(min) >= 0 && ip.compare(max) <= 0;
 }
-function _assignMin(ipType, min) {
-    if (min)
-        return IpAddress.of(min).toString();
-    if (ipType === 4)
-        return '0.0.0.0';
-    return '::';
+function _assignMin(version) {
+    return version === 4 ? '0.0.0.0' : '::';
 }
-function _assignMax(ipType, max) {
-    if (max)
-        return IpAddress.of(max).toString();
-    if (ipType === 4)
-        return '255.255.255.255';
-    return 'ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff';
+function _assignMax(version) {
+    return version === 4
+        ? '255.255.255.255'
+        : 'ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff';
 }
 function _validMinAndMax(min, max) {
-    return isIP(min) && isIP(max)
-        && _ipVersion(min) === _ipVersion(max)
-        && ip6addr.compare(min, max) === -1;
+    if (!IPAddress.isValid(min) || !IPAddress.isValid(max))
+        return false;
+    const minIP = IPAddress.of(min);
+    const maxIP = IPAddress.of(max);
+    if (minIP.version !== maxIP.version)
+        return false;
+    return minIP.compare(maxIP) <= 0;
 }
 export function isRoutableIP(input) {
     if (!isIP(input))
         return false;
-    return !_isPrivateIP(input);
+    return IPAddress.of(input).isRoutable();
 }
 export function isNonRoutableIP(input) {
     if (!isIP(input))
         return false;
-    return _isPrivateIP(input);
-}
-function _isPrivateIP(input) {
-    const parsedIp = _parseIpAddress(input);
-    return _inPrivateIPRange(parsedIp.range()) || _inRestrictedIPRange(parsedIp);
-}
-function _parseIpAddress(input) {
-    if (isMappedIPv4(input)) {
-        return ipaddr.parse(extractMappedIPv4(input));
-    }
-    return ipaddr.parse(input);
-}
-function _inPrivateIPRange(ipRange) {
-    return [
-        'private',
-        'uniqueLocal',
-        'loopback',
-        'unspecified',
-        'carrierGradeNat',
-        'linkLocal',
-        'reserved',
-        'rfc6052',
-        'teredo',
-        '6to4',
-        'broadcast'
-    ].includes(ipRange);
-}
-// parse the ranges here
-// to avoid having to parse every time the function is called
-const ipv4RestrictedRanges = [
-    ipaddr.parseCIDR('192.31.196.0/24'),
-    ipaddr.parseCIDR('192.52.193.0/24'),
-    ipaddr.parseCIDR('192.175.48.0/24'),
-    ipaddr.parseCIDR('198.18.0.0/15'),
-    ipaddr.parseCIDR('224.0.0.0/8')
-];
-const ipv6RestrictedRanges = [
-    ipaddr.parseCIDR('64:ff9b:1::/48'),
-    ipaddr.parseCIDR('100::/64'),
-    ipaddr.parseCIDR('2001::/23'),
-    ipaddr.parseCIDR('2620:4f:8000::/48')
-];
-function _inRestrictedIPRange(parsedIp) {
-    const rangesToCheck = parsedIp.kind() === 'ipv4' ? ipv4RestrictedRanges : ipv6RestrictedRanges;
-    return rangesToCheck.some((ipRange) => parsedIp.match(ipRange));
+    return !IPAddress.of(input).isRoutable();
 }
 export function isCIDR(input) {
-    return isString(input) && IPCIDR.isValidCIDR(input);
+    return isString(input) && CIDRBlock.isValid(input);
 }
 /**
- *
  * @param input ip address block in CIDR notation
  * @returns first IP address in the block
  * @deprecated use getFirstUsableIPInCIDR
@@ -148,7 +96,6 @@ export function getCIDRMin(input) {
     return getFirstUsableIPInCIDR(input);
 }
 /**
- *
  * @param input ip address block in CIDR notation
  * @returns last ip address in the block
  * @deprecated use getLastUsableIPInCIDR
@@ -157,85 +104,87 @@ export function getCIDRMax(input) {
     return getLastUsableIPInCIDR(input);
 }
 /**
- *
  * @param input ip address block in CIDR notation, inclusive
  * @returns first IP address in the block
  */
 export function getFirstIPInCIDR(input) {
     if (isCIDR(input)) {
-        return shortenIPv6Address(new IPCIDR(input).start());
+        return CIDRBlock.of(input)
+            .first()
+            .toString();
     }
     throw Error('input must be a valid IP address in CIDR notation');
 }
 /**
- *
  * @param input ip address block in CIDR notation
  * @returns last ip address in the block, inclusive
  */
 export function getLastIPInCIDR(input) {
     if (isCIDR(input)) {
-        return shortenIPv6Address(new IPCIDR(input).end());
+        return CIDRBlock.of(input)
+            .last()
+            .toString();
     }
     throw Error('input must be a valid IP address in CIDR notation');
 }
 /**
- *
  * @param input ip address block in CIDR notation
  * @returns first usable ip address of the CIDR block
  */
 export function getFirstUsableIPInCIDR(input) {
     if (isCIDR(input)) {
-        return createCIDR(input).first()
+        return CIDRBlock.of(input)
+            .firstUsable()
             .toString();
     }
     throw Error('input must be a valid IP address in CIDR notation');
 }
 /**
- *
  * @param input ip address block in CIDR notation
  * @returns last usable ip address of the CIDR block
  */
 export function getLastUsableIPInCIDR(input) {
     if (isCIDR(input)) {
-        return createCIDR(input).last()
+        return CIDRBlock.of(input)
+            .lastUsable()
             .toString();
     }
     throw Error('input must be a valid IP address in CIDR notation');
 }
 /**
- *
  * @param input ip address
- * @returns IPv6 addresses are returned without leading 0's in a group or empty groups
+ * @returns IPv6 addresses are returned without leading 0's in a group or empty groups;
  *  ipv4 addresses are simply returned
  */
 export function shortenIPv6Address(input) {
     if (isIP(input)) {
-        return ipaddr.parse(input).toString();
+        return IPAddress.of(input).toString();
     }
     throw Error('input must be a valid address');
 }
 export function getCIDRBroadcast(input) {
     if (isCIDR(input)) {
-        const asCIDR = createCIDR(input);
-        if (isIPv4(asCIDR.address().toString())) {
-            return asCIDR.broadcast().toString();
+        const block = CIDRBlock.of(input);
+        if (block.version === 4) {
+            return block.broadcast().toString();
         }
     }
     throw Error('input must be a valid IPv4 address in CIDR notation');
 }
 export function getCIDRNetwork(input) {
     if (isCIDR(input)) {
-        const asCIDR = createCIDR(input);
-        const address = asCIDR.address().toString();
-        if (isIPv4(address)) {
-            return ipaddr.IPv4.networkAddressFromCIDR(input).octets.join('.');
+        const block = CIDRBlock.of(input);
+        if (block.version === 4) {
+            return block.network().toString();
         }
     }
     throw Error('input must be a valid IPv4 address in CIDR notation');
 }
 export function toCIDR(input, suffix) {
-    if (isIP(input) && _validSuffix(_ipVersion(input), suffix)) {
-        return createCIDR(input, toInteger(suffix)).toString();
+    if (isIP(input)
+        && _validSuffix(IPAddress.ipVersion(input), suffix)) {
+        const ip = IPAddress.of(input);
+        return CIDRBlock.from(ip, toInteger(suffix)).toString();
     }
     throw Error('input must be a valid IP address and suffix must be a value <= 32 for IPv4 or <= 128 for IPv6');
 }
@@ -253,21 +202,12 @@ function _validSuffix(ipVersion, suffix) {
     }
     return false;
 }
-function createCIDR(input, suffix) {
-    if (suffix != null) {
-        return ip6addr.createCIDR(input, suffix);
-    }
-    return ip6addr.createCIDR(input);
-}
 export function isNonZeroCidr(input) {
-    const cidrValue = isCidr(input);
-    if (isNumber(cidrValue) && cidrValue > 0)
-        return true;
-    return false;
+    return CIDRBlock.isCidr(input) > 0;
 }
 export function ipToInt(input) {
     if (isIP(input)) {
-        return toBigIntOrThrow(parseIp(input).number);
+        return toBigIntOrThrow(IPAddress.of(input).toInt());
     }
     throw Error('input must be a valid ip address');
 }
@@ -280,40 +220,22 @@ export function intToIP(input, ipVersion) {
         if (bigInt < 0n || bigInt > (versionAsInt === 4 ? maxIpV4 : maxIpV6)) {
             throw new Error(`Invalid IP input: ${bigInt}`);
         }
-        return stringifyIp({
-            number: bigInt,
-            version: versionAsInt,
-            ipv4mapped: false,
-            scopeid: undefined
-        });
+        return IPAddress.fromInt(bigInt, versionAsInt).toString();
     }
     throw Error('input should be a big int or string for large numbers. Version must be 4 or 6');
 }
 export function reverseIP(input) {
     if (!isIP(input))
         throw Error('input must be a valid ip address');
-    const parsedIp = ipaddr.parse(input);
-    if (parsedIp.kind() === 'ipv4') {
-        return parsedIp.octets.reverse().join('.');
-    }
-    return _reverseIPv6(parsedIp);
-}
-function _reverseIPv6(ip) {
-    return ip.toNormalizedString().split(':')
-        .reduce((parts, part) => {
-        parts.push(_expandIPv6Part(part));
-        return parts;
-    }, [])
-        .join('')
-        .split('')
-        .reverse()
-        .join('.');
+    return IPAddress.of(input).reverse();
 }
-function _expandIPv6Part(part) {
-    let expandedPart = part;
-    while (expandedPart.length < 4) {
-        expandedPart = `0${expandedPart}`;
-    }
-    return expandedPart;
+/**
+ * Returns the smallest CIDR block that encloses both IP addresses.
+ * Both IPs must be the same version (both IPv4 or both IPv6).
+ */
+export function ipsToCIDR(ip1, ip2) {
+    const a = IPAddress.of(isIPOrThrow(ip1));
+    const b = IPAddress.of(isIPOrThrow(ip2));
+    return CIDRBlock.enclosing(a, b).toString();
 }
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/cidr-block.d.ts

@@ -0,0 +1,60 @@
+import { IPAddress } from './ip-address.js';
+export declare class CIDRBlock {
+    private readonly _input;
+    private readonly _network;
+    private readonly _prefix;
+    readonly version: 4 | 6;
+    private constructor();
+    /** Parse "a.b.c.d/n" or "::1/128" CIDR notation. Throws if invalid. */
+    static of(cidr: string): CIDRBlock;
+    /** Build a CIDRBlock from an IPAddress and prefix length. */
+    static from(ip: IPAddress, prefix: number): CIDRBlock;
+    /**
+     * Return the smallest CIDR block that encloses both IP addresses.
+     * Both IPs must be the same version.
+     *
+     * NOTE: The result is network-aligned and may extend beyond the input IPs.
+     * For example, enclosing(192.198.0.1, 192.198.0.254) → 192.198.0.0/24,
+     * which includes 192.198.0.0 and 192.198.0.255. This is a CIDR/routing
+     * operation — use IPRange for arbitrary range containment checks.
+     */
+    static enclosing(ip1: IPAddress, ip2: IPAddress): CIDRBlock;
+    private static _parse;
+    static isValid(input: unknown): input is string;
+    static isCidr(input: string): 4 | 6 | 0;
+    toString(): string;
+    /** The original input address (may differ from network address). */
+    address(): IPAddress;
+    /** Network address — first IP in block (all host bits 0). */
+    first(): IPAddress;
+    /** Last IP in block (all host bits 1). */
+    last(): IPAddress;
+    /**
+     * First usable host address.
+     * IPv4: network + 1, except /32 (single host).
+     * IPv6: network + 1, except /128 (single host).
+     */
+    firstUsable(): IPAddress;
+    /**
+     * Last usable host address.
+     * IPv4: broadcast - 1, except /32 (returns broadcast).
+     * IPv6: same as last (no broadcast concept).
+     */
+    lastUsable(): IPAddress;
+    /**
+     * IPv4 broadcast address (last IP in block).
+     * Throws for IPv6 CIDRs.
+     */
+    broadcast(): IPAddress;
+    /**
+     * IPv4 network address (first IP in block).
+     * Throws for IPv6 CIDRs.
+     */
+    network(): IPAddress;
+    /**
+     * Returns true if the given IP is within this CIDR block.
+     * The IP version must match the CIDR version exactly.
+     */
+    contains(input: IPAddress | string): boolean;
+}
+//# sourceMappingURL=cidr-block.d.ts.map

package/dist/src/utils/cidr-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cidr-block.d.ts","sourceRoot":"","sources":["../../../src/utils/cidr-block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAiB5C,qBAAa,SAAS;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAExB,OAAO;IAWP,uEAAuE;IACvE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAUlC,6DAA6D;IAC7D,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS;IAYrD;;;;;;;;OAQG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,SAAS;IAe3D,OAAO,CAAC,MAAM,CAAC,MAAM;IAyBrB,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM;IAK/C,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;IAavC,QAAQ,IAAI,MAAM;IAIlB,oEAAoE;IACpE,OAAO,IAAI,SAAS;IAIpB,6DAA6D;IAC7D,KAAK,IAAI,SAAS;IAIlB,0CAA0C;IAC1C,IAAI,IAAI,SAAS;IAQjB;;;;OAIG;IACH,WAAW,IAAI,SAAS;IASxB;;;;OAIG;IACH,UAAU,IAAI,SAAS;IAUvB;;;OAGG;IACH,SAAS,IAAI,SAAS;IAQtB;;;OAGG;IACH,OAAO,IAAI,SAAS;IAUpB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO;CAY/C"}

package/dist/src/utils/cidr-block.js

@@ -0,0 +1,181 @@
+import { IPAddress } from './ip-address.js';
+const MAX4 = (1n << 32n) - 1n;
+const MAX6 = (1n << 128n) - 1n;
+function prefixMask(prefix, version) {
+    const total = version === 4 ? 32 : 128;
+    const hostBits = BigInt(total - prefix);
+    const maxVal = version === 4 ? MAX4 : MAX6;
+    return maxVal ^ ((1n << hostBits) - 1n);
+}
+// ---------------------------------------------------------------------------
+// CIDRBlock class
+// ---------------------------------------------------------------------------
+export class CIDRBlock {
+    _input; // original input address (may not be network addr)
+    _network; // network address (all host bits 0)
+    _prefix;
+    version;
+    constructor(input, prefix) {
+        this._input = input;
+        this._prefix = prefix;
+        this.version = input.version;
+        const mask = prefixMask(prefix, input.version);
+        this._network = IPAddress.fromInt(input.toInt() & mask, input.version);
+    }
+    // ---- Static factories --------------------------------------------------
+    /** Parse "a.b.c.d/n" or "::1/128" CIDR notation. Throws if invalid. */
+    static of(cidr) {
+        const result = CIDRBlock._parse(cidr);
+        if (result === null) {
+            throw new Error(`"${cidr}" is not a valid CIDR notation`);
+        }
+        return result;
+    }
+    /** Build a CIDRBlock from an IPAddress and prefix length. */
+    static from(ip, prefix) {
+        const maxPrefix = ip.version === 4 ? 32 : 128;
+        if (!Number.isInteger(prefix) || prefix < 0 || prefix > maxPrefix) {
+            throw new Error(`Invalid prefix length ${prefix} for IPv${ip.version}`);
+        }
+        return new CIDRBlock(ip, prefix);
+    }
+    /**
+     * Return the smallest CIDR block that encloses both IP addresses.
+     * Both IPs must be the same version.
+     *
+     * NOTE: The result is network-aligned and may extend beyond the input IPs.
+     * For example, enclosing(192.198.0.1, 192.198.0.254) → 192.198.0.0/24,
+     * which includes 192.198.0.0 and 192.198.0.255. This is a CIDR/routing
+     * operation — use IPRange for arbitrary range containment checks.
+     */
+    static enclosing(ip1, ip2) {
+        if (ip1.version !== ip2.version) {
+            throw new Error('Both IPs must be the same version to compute enclosing CIDR');
+        }
+        const xor = ip1.toInt() ^ ip2.toInt();
+        const totalBits = ip1.version === 4 ? 32 : 128;
+        const hostBits = xor === 0n ? 0 : xor.toString(2).length;
+        const prefix = totalBits - hostBits;
+        return CIDRBlock.from(ip1, prefix);
+    }
+    static _parse(cidr) {
+        if (typeof cidr !== 'string')
+            return null;
+        const slashIdx = cidr.lastIndexOf('/');
+        if (slashIdx < 0)
+            return null;
+        const ipStr = cidr.slice(0, slashIdx);
+        const prefixStr = cidr.slice(slashIdx + 1);
+        // Prefix must be a non-negative integer with no leading zeros (except "0")
+        if (!/^\d+$/.test(prefixStr))
+            return null;
+        if (prefixStr.length > 1 && prefixStr[0] === '0')
+            return null;
+        const prefix = parseInt(prefixStr, 10);
+        if (!IPAddress.isValid(ipStr))
+            return null;
+        const ip = IPAddress.of(ipStr);
+        const maxPrefix = ip.version === 4 ? 32 : 128;
+        if (prefix > maxPrefix)
+            return null;
+        return new CIDRBlock(ip, prefix);
+    }
+    // ---- Static validators -------------------------------------------------
+    static isValid(input) {
+        if (typeof input !== 'string')
+            return false;
+        return CIDRBlock._parse(input) !== null;
+    }
+    static isCidr(input) {
+        if (typeof input !== 'string')
+            return 0;
+        const block = CIDRBlock._parse(input);
+        if (block === null)
+            return 0;
+        if (block._prefix === 0)
+            return 0;
+        return block.version;
+    }
+    // ---- Instance methods --------------------------------------------------
+    toString() {
+        return `${this._network.toString()}/${this._prefix}`;
+    }
+    /** The original input address (may differ from network address). */
+    address() {
+        return this._input;
+    }
+    /** Network address — first IP in block (all host bits 0). */
+    first() {
+        return this._network;
+    }
+    /** Last IP in block (all host bits 1). */
+    last() {
+        const totalBits = this.version === 4 ? 32 : 128;
+        const hostBits = BigInt(totalBits - this._prefix);
+        const lastInt = this._network.toInt() | ((1n << hostBits) - 1n);
+        return IPAddress.fromInt(lastInt, this.version);
+    }
+    /**
+     * First usable host address.
+     * IPv4: network + 1, except /32 (single host).
+     * IPv6: network + 1, except /128 (single host).
+     */
+    firstUsable() {
+        const f = this.first();
+        const l = this.last();
+        if (f.toInt() === l.toInt())
+            return f;
+        return f.offset(1n);
+    }
+    /**
+     * Last usable host address.
+     * IPv4: broadcast - 1, except /32 (returns broadcast).
+     * IPv6: same as last (no broadcast concept).
+     */
+    lastUsable() {
+        const f = this.first();
+        const l = this.last();
+        if (f.toInt() === l.toInt())
+            return l;
+        if (this.version === 4)
+            return l.offset(-1n);
+        return l;
+    }
+    /**
+     * IPv4 broadcast address (last IP in block).
+     * Throws for IPv6 CIDRs.
+     */
+    broadcast() {
+        if (this.version !== 4) {
+            throw new Error('IPv6 addresses do not have a broadcast address');
+        }
+        return this.last();
+    }
+    /**
+     * IPv4 network address (first IP in block).
+     * Throws for IPv6 CIDRs.
+     */
+    network() {
+        if (this.version !== 4) {
+            throw new Error('IPv6 addresses do not have a network address in the IPv4 sense');
+        }
+        return this.first();
+    }
+    /**
+     * Returns true if the given IP is within this CIDR block.
+     * The IP version must match the CIDR version exactly.
+     */
+    contains(input) {
+        try {
+            const ip = typeof input === 'string' ? IPAddress.of(input) : input;
+            if (ip.version !== this.version)
+                return false;
+            const n = ip.toInt();
+            return n >= this._network.toInt() && n <= this.last().toInt();
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=cidr-block.js.map

package/dist/src/utils/cidr-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cidr-block.js","sourceRoot":"","sources":["../../../src/utils/cidr-block.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/ip-address.d.ts

@@ -0,0 +1,33 @@
+export declare class IPAddress {
+    readonly version: 4 | 6;
+    private readonly _int;
+    private readonly _scopeId;
+    /** True when parsed from ::a.b.c.d (deprecated IPv4-compatible) notation. */
+    private readonly _isIPv4Compat;
+    private constructor();
+    static of(input: string): IPAddress;
+    static fromInt(n: bigint, version: 4 | 6): IPAddress;
+    private static _parse;
+    static isValid(input: unknown): input is string;
+    static isIPv4(input: unknown): boolean;
+    static isIPv6(input: unknown): boolean;
+    static ipVersion(input: string): 4 | 6 | undefined;
+    toInt(): bigint;
+    toString(): string;
+    /** Normalized full-groups string (no :: compression). Used by reverseIP. */
+    toNormalizedString(): string;
+    compare(other: IPAddress): -1 | 0 | 1;
+    offset(n: bigint): IPAddress;
+    /**
+     * Returns true for ::ffff:a.b.c.d (IPv4-mapped) addresses.
+     * Note: ::a.b.c.d is rewritten to ::ffff:a.b.c.d during parsing,
+     * so those also return true (matching ipaddr.js behaviour).
+     */
+    isMappedIPv4(): boolean;
+    /** Extract the embedded IPv4 from an IPv4-mapped IPv6 address. */
+    toMappedIPv4(): IPAddress;
+    isRoutable(): boolean;
+    /** Returns DNS PTR reverse format. */
+    reverse(): string;
+}
+//# sourceMappingURL=ip-address.d.ts.map

package/dist/src/utils/ip-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip-address.d.ts","sourceRoot":"","sources":["../../../src/utils/ip-address.ts"],"names":[],"mappings":"AA0OA,qBAAa,SAAS;IAClB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IAExC,OAAO;IAcP,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAUnC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAIpD,OAAO,CAAC,MAAM,CAAC,MAAM;IAqBrB,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM;IAI/C,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAKtC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAOtC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS;IASlD,KAAK,IAAI,MAAM;IAIf,QAAQ,IAAI,MAAM;IAUlB,4EAA4E;IAC5E,kBAAkB,IAAI,MAAM;IAY5B,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAOrC,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS;IAI5B;;;;OAIG;IACH,YAAY,IAAI,OAAO;IAYvB,kEAAkE;IAClE,YAAY,IAAI,SAAS;IAUzB,UAAU,IAAI,OAAO;IAYrB,sCAAsC;IACtC,OAAO,IAAI,MAAM;CASpB"}

package/dist/src/utils/ip-address.js

@@ -0,0 +1,332 @@
+// ---------------------------------------------------------------------------
+// Parsing helpers
+// ---------------------------------------------------------------------------
+const IPV4_OCTET = '(?:25[0-5]|2[0-4]\\d|1\\d{2}|[1-9]\\d|\\d)';
+const IPV4_RE = new RegExp(`^${IPV4_OCTET}\\.${IPV4_OCTET}\\.${IPV4_OCTET}\\.${IPV4_OCTET}$`);
+/** Parse dotted-quad IPv4 string → BigInt. Returns null on failure. */
+function parseIPv4Int(input) {
+    if (!IPV4_RE.test(input))
+        return null;
+    const parts = input.split('.');
+    let n = 0n;
+    for (const p of parts) {
+        n = (n << 8n) | BigInt(parseInt(p, 10));
+    }
+    return n;
+}
+/** Convert 32-bit BigInt → dotted-quad string. */
+function intToIPv4String(n) {
+    return [
+        (n >> 24n) & 0xffn,
+        (n >> 16n) & 0xffn,
+        (n >> 8n) & 0xffn,
+        n & 0xffn,
+    ]
+        .map(String)
+        .join('.');
+}
+function parseIPv6Int(raw) {
+    // Strip scope ID
+    const scopeIdx = raw.indexOf('%');
+    const input = scopeIdx >= 0 ? raw.slice(0, scopeIdx) : raw;
+    const s = input.toLowerCase();
+    // Detect embedded IPv4 in last position
+    // Match optional leading groups + dotted-quad tail
+    const embeddedIPv4Re = /^(.*:)(\d+\.\d+\.\d+\.\d+)$/;
+    const embeddedMatch = s.match(embeddedIPv4Re);
+    let normalized = s;
+    if (embeddedMatch) {
+        const prefix = embeddedMatch[1]; // everything up to and including last ':'
+        const v4str = embeddedMatch[2];
+        const v4int = parseIPv4Int(v4str);
+        if (v4int === null)
+            return null;
+        const high16 = (v4int >> 16n) & 0xffffn;
+        const low16 = v4int & 0xffffn;
+        const v4hex = `${high16.toString(16)}:${low16.toString(16)}`;
+        normalized = `${prefix}${v4hex}`;
+    }
+    // Expand :: compression
+    const halves = normalized.split('::');
+    if (halves.length > 2)
+        return null; // multiple :: not allowed
+    let groups;
+    if (halves.length === 2) {
+        const left = halves[0] ? halves[0].split(':') : [];
+        const right = halves[1] ? halves[1].split(':') : [];
+        const missing = 8 - left.length - right.length;
+        if (missing <= 0)
+            return null;
+        groups = [...left, ...Array(missing).fill('0'), ...right];
+    }
+    else {
+        groups = normalized.split(':');
+    }
+    if (groups.length !== 8)
+        return null;
+    let n = 0n;
+    for (const g of groups) {
+        if (!/^[0-9a-f]{1,4}$/.test(g))
+            return null;
+        n = (n << 16n) | BigInt(parseInt(g, 16));
+    }
+    return n;
+}
+/**
+ * Detect IPv6 scope ID for preservation in toString.
+ */
+function extractScopeId(raw) {
+    const idx = raw.indexOf('%');
+    return idx >= 0 ? raw.slice(idx + 1) : undefined;
+}
+/** Convert 128-bit BigInt → compressed IPv6 string (RFC 5952). */
+function intToIPv6String(n) {
+    const groups = [];
+    for (let i = 7; i >= 0; i--) {
+        groups.push(Number((n >> BigInt(i * 16)) & 0xffffn));
+    }
+    const hex = groups.map((g) => g.toString(16));
+    // Find longest run of consecutive zero groups for :: compression
+    let bestStart = -1;
+    let bestLen = 0;
+    let curStart = -1;
+    let curLen = 0;
+    for (let i = 0; i < 8; i++) {
+        if (groups[i] === 0) {
+            if (curStart < 0) {
+                curStart = i;
+                curLen = 0;
+            }
+            curLen++;
+            if (curLen > bestLen) {
+                bestLen = curLen;
+                bestStart = curStart;
+            }
+        }
+        else {
+            curStart = -1;
+            curLen = 0;
+        }
+    }
+    if (bestLen < 2) {
+        return hex.join(':');
+    }
+    const left = hex.slice(0, bestStart).join(':');
+    const right = hex.slice(bestStart + bestLen).join(':');
+    return `${left}::${right}`;
+}
+function cidr4(a, b, c, d, prefix) {
+    const base = BigInt(((a * 256 + b) * 256 + c) * 256 + d);
+    const hostBits = BigInt(32 - prefix);
+    const mask = ((1n << 32n) - 1n) ^ ((1n << hostBits) - 1n);
+    return { lo: base & mask, hi: (base & mask) | ((1n << hostBits) - 1n) };
+}
+// All IPv4 ranges considered non-routable
+const NON_ROUTABLE_IPV4 = [
+    cidr4(0, 0, 0, 0, 8), // unspecified
+    cidr4(10, 0, 0, 0, 8), // private
+    cidr4(100, 64, 0, 0, 10), // carrier-grade NAT
+    cidr4(127, 0, 0, 0, 8), // loopback
+    cidr4(169, 254, 0, 0, 16), // link-local
+    cidr4(172, 16, 0, 0, 12), // private
+    cidr4(192, 0, 0, 0, 24), // reserved (IETF protocol)
+    cidr4(192, 0, 2, 0, 24), // documentation (TEST-NET-1)
+    cidr4(192, 31, 196, 0, 24), // AS112-v4 (RFC 7534)
+    cidr4(192, 52, 193, 0, 24), // AMT (RFC 7450)
+    cidr4(192, 88, 99, 0, 24), // 6to4 relay anycast (deprecated)
+    cidr4(192, 168, 0, 0, 16), // private
+    cidr4(192, 175, 48, 0, 24), // AS112-v4 (RFC 7535)
+    cidr4(198, 18, 0, 0, 15), // benchmarking
+    cidr4(198, 51, 100, 0, 24), // documentation (TEST-NET-2)
+    cidr4(203, 0, 113, 0, 24), // documentation (TEST-NET-3)
+    cidr4(224, 0, 0, 0, 8), // multicast (restricted block)
+    cidr4(240, 0, 0, 0, 4), // reserved (class E)
+    cidr4(255, 255, 255, 255, 32), // broadcast
+];
+function cidr6(groups, prefix) {
+    let base = 0n;
+    for (const g of groups) {
+        base = (base << 16n) | BigInt(g);
+    }
+    const hostBits = BigInt(128 - prefix);
+    const mask = ((1n << 128n) - 1n) ^ ((1n << hostBits) - 1n);
+    return { lo: base & mask, hi: (base & mask) | ((1n << hostBits) - 1n) };
+}
+// All IPv6 ranges considered non-routable
+const NON_ROUTABLE_IPV6 = [
+    cidr6([0, 0, 0, 0, 0, 0, 0, 0], 128), // unspecified ::
+    cidr6([0, 0, 0, 0, 0, 0, 0, 1], 128), // loopback ::1
+    cidr6([0x64, 0xff9b, 0, 0, 0, 0, 0, 0], 96), // RFC 6052 NAT64
+    cidr6([0x64, 0xff9b, 1, 0, 0, 0, 0, 0], 48), // RFC 8215 local NAT64
+    cidr6([0x100, 0, 0, 0, 0, 0, 0, 0], 64), // discard (RFC 6666)
+    cidr6([0xfc00, 0, 0, 0, 0, 0, 0, 0], 7), // unique local (fc00::/7)
+    cidr6([0xfe80, 0, 0, 0, 0, 0, 0, 0], 10), // link-local
+    cidr6([0xff00, 0, 0, 0, 0, 0, 0, 0], 8), // multicast
+    cidr6([0, 0, 0, 0, 0, 0xffff, 0, 0], 96), // IPv4-mapped (::ffff:0:0/96)
+    cidr6([0x2001, 0, 0, 0, 0, 0, 0, 0], 23), // IANA special (includes teredo, benchmarking, etc.)
+    cidr6([0x2001, 0x0db8, 0, 0, 0, 0, 0, 0], 32), // documentation (RFC 3849)
+    cidr6([0x2002, 0, 0, 0, 0, 0, 0, 0], 16), // 6to4
+    cidr6([0x2620, 0x4f, 0x8000, 0, 0, 0, 0, 0], 48), // AS112-v6
+];
+function isInRange(n, ranges) {
+    for (const r of ranges) {
+        if (n >= r.lo && n <= r.hi)
+            return true;
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// IPAddress class
+// ---------------------------------------------------------------------------
+/** Matches ::a.b.c.d (deprecated IPv4-compatible) — no ffff groups. */
+const IPV4_COMPAT_RE = /^::(\d+\.\d+\.\d+\.\d+)(%.*)?$/i;
+export class IPAddress {
+    version;
+    _int;
+    _scopeId;
+    /** True when parsed from ::a.b.c.d (deprecated IPv4-compatible) notation. */
+    _isIPv4Compat;
+    constructor(int, version, scopeId, isIPv4Compat = false) {
+        this._int = int;
+        this.version = version;
+        this._scopeId = scopeId;
+        this._isIPv4Compat = isIPv4Compat;
+    }
+    // ---- Static factories --------------------------------------------------
+    static of(input) {
+        const result = IPAddress._parse(input);
+        if (result === null) {
+            throw new TypeError(`"${input}" is not a valid IP address`);
+        }
+        return result;
+    }
+    static fromInt(n, version) {
+        return new IPAddress(n, version);
+    }
+    static _parse(input) {
+        if (typeof input !== 'string')
+            return null;
+        // Try IPv4 first (no colon present)
+        if (!input.includes(':')) {
+            const n = parseIPv4Int(input);
+            return n !== null ? new IPAddress(n, 4) : null;
+        }
+        // IPv6 (may have embedded IPv4, scope ID)
+        const scopeId = extractScopeId(input);
+        const n = parseIPv6Int(input);
+        if (n === null)
+            return null;
+        const isIPv4Compat = IPV4_COMPAT_RE.test(input);
+        return new IPAddress(n, 6, scopeId, isIPv4Compat);
+    }
+    // ---- Static validators -------------------------------------------------
+    static isValid(input) {
+        return typeof input === 'string' && IPAddress._parse(input) !== null;
+    }
+    static isIPv4(input) {
+        if (typeof input !== 'string')
+            return false;
+        return parseIPv4Int(input) !== null;
+    }
+    static isIPv6(input) {
+        if (typeof input !== 'string')
+            return false;
+        if (!input.includes(':'))
+            return false;
+        return parseIPv6Int(input) !== null;
+    }
+    static ipVersion(input) {
+        if (IPAddress.isIPv4(input))
+            return 4;
+        if (IPAddress.isIPv6(input))
+            return 6;
+        return undefined;
+    }
+    // ---- Instance methods --------------------------------------------------
+    toInt() {
+        return this._int;
+    }
+    toString() {
+        if (this.version === 4) {
+            return intToIPv4String(this._int);
+        }
+        const base = intToIPv6String(this._int);
+        return this._scopeId ? `${base}%${this._scopeId}` : base;
+    }
+    /** Normalized full-groups string (no :: compression). Used by reverseIP. */
+    toNormalizedString() {
+        if (this.version === 4)
+            return this.toString();
+        const groups = [];
+        for (let i = 7; i >= 0; i--) {
+            groups.push(((this._int >> BigInt(i * 16)) & 0xffffn).toString(16));
+        }
+        return groups.join(':');
+    }
+    compare(other) {
+        if (this._int < other._int)
+            return -1;
+        if (this._int > other._int)
+            return 1;
+        return 0;
+    }
+    offset(n) {
+        return new IPAddress(this._int + n, this.version);
+    }
+    /**
+     * Returns true for ::ffff:a.b.c.d (IPv4-mapped) addresses.
+     * Note: ::a.b.c.d is rewritten to ::ffff:a.b.c.d during parsing,
+     * so those also return true (matching ipaddr.js behaviour).
+     */
+    isMappedIPv4() {
+        if (this.version !== 6)
+            return false;
+        // ::a.b.c.d (IPv4-compatible, deprecated) — treated as mapped per ipaddr.js
+        if (this._isIPv4Compat)
+            return true;
+        // IPv4-mapped range: ::ffff:0:0/96
+        // First 80 bits must be 0, next 16 bits must be 0xffff
+        const high80 = this._int >> 48n;
+        const ffff = (this._int >> 32n) & 0xffffn;
+        return high80 === 0n && ffff === 0xffffn;
+    }
+    /** Extract the embedded IPv4 from an IPv4-mapped IPv6 address. */
+    toMappedIPv4() {
+        if (!this.isMappedIPv4()) {
+            throw new Error('input must be an IPv4 address mapped to an IPv6 address');
+        }
+        return new IPAddress(this._int & 0xffffffffn, 4);
+    }
+    isRoutable() {
+        if (this.version === 4) {
+            return !isInRange(this._int, NON_ROUTABLE_IPV4);
+        }
+        // For IPv6, if it's IPv4-mapped, classify the embedded IPv4
+        if (this.isMappedIPv4()) {
+            return !isInRange(this._int & 0xffffffffn, NON_ROUTABLE_IPV4);
+        }
+        return !isInRange(this._int, NON_ROUTABLE_IPV6);
+    }
+    /** Returns DNS PTR reverse format. */
+    reverse() {
+        if (this.version === 4) {
+            return intToIPv4String(this._int)
+                .split('.')
+                .reverse()
+                .join('.');
+        }
+        return _reverseIPv6(this);
+    }
+}
+function _reverseIPv6(ip) {
+    // Expand to full 32 hex nibbles, then reverse with dots
+    return ip
+        .toNormalizedString()
+        .split(':')
+        .map((g) => g.padStart(4, '0'))
+        .join('')
+        .split('')
+        .reverse()
+        .join('.');
+}
+//# sourceMappingURL=ip-address.js.map

package/dist/src/utils/ip-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip-address.js","sourceRoot":"","sources":["../../../src/utils/ip-address.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/ip-range.d.ts

@@ -0,0 +1,27 @@
+import { IPAddress } from './ip-address.js';
+import { CIDRBlock } from './cidr-block.js';
+export declare class IPRange {
+    readonly minValue: IPAddress;
+    readonly maxValue: IPAddress;
+    readonly version: 4 | 6;
+    private constructor();
+    /**
+     * Build an IPRange from two IPAddress boundary values (inclusive).
+     * Both must be the same IP version and min must be <= max.
+     */
+    static from(min: IPAddress, max: IPAddress): IPRange;
+    toString(): string;
+    /**
+     * Returns true if the given IP address falls within this range (inclusive).
+     * The IP version must match the range version exactly.
+     */
+    contains(input: IPAddress | string): boolean;
+    /**
+     * Returns true if the given CIDR block is fully contained within this range.
+     * Both the CIDR's network address (first) and broadcast address (last) must
+     * fall within [minValue, maxValue]. This ensures exclusive range bounds are
+     * respected for the entire CIDR, not just the usable host addresses.
+     */
+    containsCIDR(cidr: CIDRBlock): boolean;
+}
+//# sourceMappingURL=ip-range.d.ts.map

package/dist/src/utils/ip-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip-range.d.ts","sourceRoot":"","sources":["../../../src/utils/ip-range.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,qBAAa,OAAO;IAChB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAExB,OAAO;IAQP;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO;IAiBpD,QAAQ,IAAI,MAAM;IAIlB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO;IAY5C;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;CAQzC"}

package/dist/src/utils/ip-range.js

@@ -0,0 +1,58 @@
+import { IPAddress } from './ip-address.js';
+export class IPRange {
+    minValue;
+    maxValue;
+    version;
+    constructor(min, max) {
+        this.minValue = min;
+        this.maxValue = max;
+        this.version = min.version;
+    }
+    // ---- Static factories --------------------------------------------------
+    /**
+     * Build an IPRange from two IPAddress boundary values (inclusive).
+     * Both must be the same IP version and min must be <= max.
+     */
+    static from(min, max) {
+        if (min.version !== max.version) {
+            throw new Error(`IPRange boundaries must be the same version: got IPv${min.version} and IPv${max.version}`);
+        }
+        if (min.toInt() > max.toInt()) {
+            throw new Error(`IPRange min (${min.toString()}) must be <= max (${max.toString()})`);
+        }
+        return new IPRange(min, max);
+    }
+    // ---- Instance methods --------------------------------------------------
+    toString() {
+        return `${this.minValue.toString()} - ${this.maxValue.toString()}`;
+    }
+    /**
+     * Returns true if the given IP address falls within this range (inclusive).
+     * The IP version must match the range version exactly.
+     */
+    contains(input) {
+        try {
+            const ip = typeof input === 'string' ? IPAddress.of(input) : input;
+            if (ip.version !== this.version)
+                return false;
+            const n = ip.toInt();
+            return n >= this.minValue.toInt() && n <= this.maxValue.toInt();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Returns true if the given CIDR block is fully contained within this range.
+     * Both the CIDR's network address (first) and broadcast address (last) must
+     * fall within [minValue, maxValue]. This ensures exclusive range bounds are
+     * respected for the entire CIDR, not just the usable host addresses.
+     */
+    containsCIDR(cidr) {
+        if (cidr.version !== this.version)
+            return false;
+        return (cidr.first().toInt() >= this.minValue.toInt()
+            && cidr.last().toInt() <= this.maxValue.toInt());
+    }
+}
+//# sourceMappingURL=ip-range.js.map

package/dist/src/utils/ip-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip-range.js","sourceRoot":"","sources":["../../../src/utils/ip-range.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,MAAM,OAAO,OAAO;IACP,QAAQ,CAAY;IACpB,QAAQ,CAAY;IACpB,OAAO,CAAQ;IAExB,YAAoB,GAAc,EAAE,GAAc;QAC9C,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;QACpB,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED,2EAA2E;IAE3E;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,GAAc,EAAE,GAAc;QACtC,IAAI,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACX,uDAAuD,GAAG,CAAC,OAAO,WAAW,GAAG,CAAC,OAAO,EAAE,CAC7F,CAAC;QACN,CAAC;QACD,IAAI,GAAG,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACX,gBAAgB,GAAG,CAAC,QAAQ,EAAE,qBAAqB,GAAG,CAAC,QAAQ,EAAE,GAAG,CACvE,CAAC;QACN,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,2EAA2E;IAE3E,QAAQ;QACJ,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;IACvE,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAyB;QAC9B,IAAI,CAAC;YACD,MAAM,EAAE,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACnE,IAAI,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO;gBAAE,OAAO,KAAK,CAAC;YAE9C,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,IAAe;QACxB,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAEhD,OAAO,CACH,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;eAC1C,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAClD,CAAC;IACN,CAAC;CACJ"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@terascope/ip-utils",
   "displayName": "IP Utils",
-  "version": "2.3.2",
+  "version": "2.4.0",
   "description": "A collection of Teraslice IP Utilities",
   "homepage": "https://github.com/terascope/teraslice/tree/master/packages/ip-utils#readme",
   "bugs": {
@@ -18,19 +18,9 @@
     "dist/src/**/*"
   ],
   "dependencies": {
-    "@chainsafe/is-ip": "~2.1.0",
-    "cidr-calc": "^1.0.4",
-    "ip-bigint": "~8.2.7",
-    "ip-cidr": "~4.0.2",
-    "ip6addr": "~0.2.5",
-    "ipaddr.js": "~2.3.0",
-    "is-cidr": "~6.0.3",
     "@terascope/core-utils": "~2.3.2",
     "@terascope/types": "~2.3.1"
   },
-  "devDependencies": {
-    "@types/ip6addr": "~0.2.6"
-  },
   "engines": {
     "node": ">=22.0.0",
     "pnpm": ">=10.25.0"