ip-utilties 1.1.1 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ip-utilties",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "publishConfig": {
     "access": "public",
     "provenance": true

package/src/ip.mjs

@@ -1,4 +1,5 @@
 const ipv4 = {
+  name: "IPv4",
   factory: Uint8Array,
   normalize(address) {
     return address;
@@ -12,6 +13,7 @@ const ipv4 = {
 };
 
 const ipv6 = {
+  name: "IPv6",
   factory: Uint16Array,
   normalize(address) {
     const parts = address.split(":");
@@ -140,6 +142,15 @@ export function isIPv6(address) {
   return _is(ipv6, address);
 }
 
+/**
+ * IP address family for a given address.
+ * @param {string|Uint8Array|Uint16Array} address
+ * @return {string|undefined}
+ */
+export function familyIP(address) {
+  return _family(address)?.name
+}
+
 function _family(address) {
   return [ipv4, ipv6].find(d => _is(d, address));
 }

package/types/ip.d.mts

@@ -6,6 +6,12 @@ export function decodeIPv4(address: any, length: any): string;
 export function decodeIP(address: any, length: any): string;
 export function isIPv4(address: any): boolean;
 export function isIPv6(address: any): boolean;
+/**
+ * IP address family for a given address.
+ * @param {string|Uint8Array|Uint16Array} address
+ * @return {string|undefined}
+ */
+export function familyIP(address: string | Uint8Array | Uint16Array): string | undefined;
 export function asBigInt(address: any): any;
 export function prefixIP(address: any, length: any): string;
 export function rangeIP(address: any, prefix: any, lowerAdd?: number, upperReduce?: number): any[];