node-ip-ts 1.0.0 → 1.2.0

package/dist/esm/core.js

@@ -0,0 +1,372 @@
+// Pure IP utility functions — no Node.js built-in dependencies.
+// Safe to use in any environment: Node.js, browser, Deno, edge runtimes.
+// ─── Internal helpers ─────────────────────────────────────────────────────────
+export function normalizeFamily(family) {
+    if (family === 4)
+        return 'ipv4';
+    if (family === 6)
+        return 'ipv6';
+    return family ? family.toLowerCase() : 'ipv4';
+}
+// ─── Buffer ↔ String conversion ───────────────────────────────────────────────
+/**
+ * Convert an IP address string to a Buffer.
+ * Optionally write into an existing buffer at a given offset.
+ */
+export function toBuffer(ip, buff, offset) {
+    const off = offset !== undefined ? ~~offset : 0;
+    let result;
+    if (isV4Format(ip)) {
+        result = buff ?? Buffer.alloc(off + 4);
+        let pos = off;
+        for (const byte of ip.split('.')) {
+            result[pos++] = parseInt(byte, 10) & 0xff;
+        }
+        return result;
+    }
+    if (isV6Format(ip)) {
+        const sections = ip.split(':', 8);
+        for (let i = 0; i < sections.length; i++) {
+            if (isV4Format(sections[i])) {
+                const v4buf = toBuffer(sections[i]);
+                sections[i] = v4buf.subarray(0, 2).toString('hex');
+                if (++i < 8) {
+                    sections.splice(i, 0, v4buf.subarray(2, 4).toString('hex'));
+                }
+            }
+        }
+        // Expand ::
+        if (sections[0] === '') {
+            while (sections.length < 8)
+                sections.unshift('0');
+        }
+        else if (sections[sections.length - 1] === '') {
+            while (sections.length < 8)
+                sections.push('0');
+        }
+        else if (sections.length < 8) {
+            let emptyIdx = 0;
+            for (; emptyIdx < sections.length && sections[emptyIdx] !== ''; emptyIdx++)
+                ;
+            const toInsert = 9 - sections.length;
+            sections.splice(emptyIdx, 1, ...Array(toInsert).fill('0'));
+        }
+        result = buff ?? Buffer.alloc(off + 16);
+        let pos = off;
+        for (const section of sections) {
+            const word = parseInt(section, 16);
+            result[pos++] = (word >> 8) & 0xff;
+            result[pos++] = word & 0xff;
+        }
+        return result;
+    }
+    throw new Error(`Invalid ip address: ${ip}`);
+}
+/**
+ * Convert a Buffer back to an IP address string.
+ */
+export function toString(buff, offset = 0, length) {
+    const len = length ?? buff.length - offset;
+    if (len === 4) {
+        const parts = [];
+        for (let i = 0; i < 4; i++)
+            parts.push(buff[offset + i]);
+        return parts.join('.');
+    }
+    if (len === 16) {
+        const parts = [];
+        for (let i = 0; i < 16; i += 2) {
+            parts.push(buff.readUInt16BE(offset + i).toString(16));
+        }
+        let result = parts.join(':');
+        result = result.replace(/(^|:)0(:0)*:0(:|$)/, '$1::$3');
+        result = result.replace(/:{3,4}/, '::');
+        return result;
+    }
+    return '';
+}
+// ─── Format detection ─────────────────────────────────────────────────────────
+const IPV4_REGEX = /^(\d{1,3}\.){3}\d{1,3}$/;
+const IPV6_REGEX = /^(::)?(((\d{1,3}\.){3}(\d{1,3}){1})?([0-9a-f]){0,4}:{0,2}){1,8}(::)?$/i;
+export function isV4Format(ip) {
+    return IPV4_REGEX.test(ip);
+}
+export function isV6Format(ip) {
+    return IPV6_REGEX.test(ip);
+}
+// ─── Mask / CIDR utilities ───────────────────────────────────────────────────
+/**
+ * Create a subnet mask from a prefix length.
+ */
+export function fromPrefixLen(prefixlen, family) {
+    const fam = prefixlen > 32 ? 'ipv6' : normalizeFamily(family);
+    const len = fam === 'ipv6' ? 16 : 4;
+    const buff = Buffer.alloc(len);
+    let remaining = prefixlen;
+    for (let i = 0; i < len; i++) {
+        const bits = Math.min(remaining, 8);
+        remaining -= bits;
+        buff[i] = ~(0xff >> bits) & 0xff;
+    }
+    return toString(buff);
+}
+/**
+ * Apply a subnet mask to an address.
+ */
+export function mask(addr, maskStr) {
+    const addrBuf = toBuffer(addr);
+    const maskBuf = toBuffer(maskStr);
+    const result = Buffer.alloc(Math.max(addrBuf.length, maskBuf.length));
+    if (addrBuf.length === maskBuf.length) {
+        for (let i = 0; i < addrBuf.length; i++) {
+            result[i] = addrBuf[i] & maskBuf[i];
+        }
+    }
+    else if (maskBuf.length === 4) {
+        // IPv6 address, IPv4 mask → mask low 4 bytes
+        for (let i = 0; i < maskBuf.length; i++) {
+            result[i] = addrBuf[addrBuf.length - 4 + i] & maskBuf[i];
+        }
+    }
+    else {
+        // IPv6 mask, IPv4 address → embed as ::ffff:ipv4
+        for (let i = 0; i < result.length - 6; i++)
+            result[i] = 0;
+        result[10] = 0xff;
+        result[11] = 0xff;
+        for (let i = 0; i < addrBuf.length; i++) {
+            result[i + 12] = addrBuf[i] & maskBuf[i + 12];
+        }
+    }
+    return toString(result);
+}
+/**
+ * Return the network address for a CIDR string (e.g. "192.168.1.1/24").
+ */
+export function cidr(cidrString) {
+    const [addr, prefixStr] = cidrString.split('/');
+    if (!prefixStr)
+        throw new Error(`invalid CIDR subnet: ${cidrString}`);
+    return mask(addr, fromPrefixLen(parseInt(prefixStr, 10)));
+}
+/**
+ * Compute full subnet information from address + mask.
+ */
+export function subnet(addr, subnetMask) {
+    const networkAddress = toLong(mask(addr, subnetMask));
+    const maskBuf = toBuffer(subnetMask);
+    let maskLength = 0;
+    for (const byte of maskBuf) {
+        if (byte === 0xff) {
+            maskLength += 8;
+        }
+        else {
+            let octet = byte & 0xff;
+            while (octet) {
+                octet = (octet << 1) & 0xff;
+                maskLength++;
+            }
+        }
+    }
+    const numberOfAddresses = 2 ** (32 - maskLength);
+    return {
+        networkAddress: fromLong(networkAddress),
+        firstAddress: numberOfAddresses <= 2
+            ? fromLong(networkAddress)
+            : fromLong(networkAddress + 1),
+        lastAddress: numberOfAddresses <= 2
+            ? fromLong(networkAddress + numberOfAddresses - 1)
+            : fromLong(networkAddress + numberOfAddresses - 2),
+        broadcastAddress: fromLong(networkAddress + numberOfAddresses - 1),
+        subnetMask,
+        subnetMaskLength: maskLength,
+        numHosts: numberOfAddresses <= 2 ? numberOfAddresses : numberOfAddresses - 2,
+        length: numberOfAddresses,
+        contains(other) {
+            return networkAddress === toLong(mask(other, subnetMask));
+        },
+    };
+}
+/**
+ * Compute full subnet information from a CIDR string.
+ */
+export function cidrSubnet(cidrString) {
+    const [addr, prefixStr] = cidrString.split('/');
+    if (!prefixStr)
+        throw new Error(`invalid CIDR subnet: ${cidrString}`);
+    return subnet(addr, fromPrefixLen(parseInt(prefixStr, 10)));
+}
+// ─── Bitwise operations ───────────────────────────────────────────────────────
+/** Bitwise NOT of an IP address. */
+export function not(addr) {
+    const buff = toBuffer(addr);
+    for (let i = 0; i < buff.length; i++)
+        buff[i] ^= 0xff;
+    return toString(buff);
+}
+/** Bitwise OR of two IP addresses (supports mixed protocol). */
+export function or(a, b) {
+    let bufA = toBuffer(a);
+    let bufB = toBuffer(b);
+    if (bufA.length === bufB.length) {
+        for (let i = 0; i < bufA.length; i++)
+            bufA[i] |= bufB[i];
+        return toString(bufA);
+    }
+    // Ensure bufLong is the longer buffer
+    let bufLong = bufA.length > bufB.length ? bufA : bufB;
+    const bufShort = bufA.length > bufB.length ? bufB : bufA;
+    bufLong = Buffer.from(bufLong); // avoid mutating original ref
+    const offset = bufLong.length - bufShort.length;
+    for (let i = offset; i < bufLong.length; i++) {
+        bufLong[i] |= bufShort[i - offset];
+    }
+    return toString(bufLong);
+}
+/** Deep equality check for two IP addresses (supports mixed IPv4/IPv6). */
+export function isEqual(a, b) {
+    let bufA = toBuffer(a);
+    let bufB = toBuffer(b);
+    if (bufA.length === bufB.length) {
+        for (let i = 0; i < bufA.length; i++) {
+            if (bufA[i] !== bufB[i])
+                return false;
+        }
+        return true;
+    }
+    // Ensure bufA is IPv4 (shorter)
+    if (bufB.length === 4) {
+        const tmp = bufB;
+        bufB = bufA;
+        bufA = tmp;
+    }
+    for (let i = 0; i < 10; i++) {
+        if (bufB[i] !== 0)
+            return false;
+    }
+    const word = bufB.readUInt16BE(10);
+    if (word !== 0 && word !== 0xffff)
+        return false;
+    for (let i = 0; i < 4; i++) {
+        if (bufA[i] !== bufB[i + 12])
+            return false;
+    }
+    return true;
+}
+// ─── Address classification ───────────────────────────────────────────────────
+/** Returns true if the address is a loopback address. */
+export function isLoopback(addr) {
+    // Plain long integer (no dots or colons) → convert to dotted decimal
+    if (!/\./.test(addr) && !/:/.test(addr)) {
+        addr = fromLong(Number(addr));
+    }
+    return (/^(::f{4}:)?127\.([0-9]{1,3})\.([0-9]{1,3})\.([0-9]{1,3})/.test(addr) ||
+        /^0177\./.test(addr) ||
+        /^0x7f\./i.test(addr) ||
+        /^fe80::1$/i.test(addr) ||
+        /^::1$/.test(addr) ||
+        /^::$/.test(addr));
+}
+/** Returns true if the address is a private (RFC 1918 / ULA) address. */
+export function isPrivate(addr) {
+    if (isLoopback(addr))
+        return true;
+    // For IPv4-only addresses, normalize first
+    if (!isV6Format(addr)) {
+        const ipl = normalizeToLong(addr);
+        if (ipl < 0)
+            throw new Error('invalid ipv4 address');
+        addr = fromLong(ipl);
+    }
+    return (/^(::f{4}:)?10\.([0-9]{1,3})\.([0-9]{1,3})\.([0-9]{1,3})$/i.test(addr) ||
+        /^(::f{4}:)?192\.168\.([0-9]{1,3})\.([0-9]{1,3})$/i.test(addr) ||
+        /^(::f{4}:)?172\.(1[6-9]|2\d|30|31)\.([0-9]{1,3})\.([0-9]{1,3})$/i.test(addr) ||
+        /^(::f{4}:)?169\.254\.([0-9]{1,3})\.([0-9]{1,3})$/i.test(addr) ||
+        /^f[cd][0-9a-f]{2}:/i.test(addr) ||
+        /^fe80:/i.test(addr) ||
+        /^::1$/.test(addr) ||
+        /^::$/.test(addr));
+}
+/** Returns true if the address is a publicly routable address. */
+export function isPublic(addr) {
+    return !isPrivate(addr);
+}
+// ─── Loopback & address resolution ───────────────────────────────────────────
+/** Return the loopback address for the given IP family. */
+export function loopback(family) {
+    const fam = normalizeFamily(family);
+    if (fam !== 'ipv4' && fam !== 'ipv6') {
+        throw new Error('family must be ipv4 or ipv6');
+    }
+    return fam === 'ipv4' ? '127.0.0.1' : 'fe80::1';
+}
+/**
+ * Return a network interface address.
+ * - `name`: interface name, `'public'`, `'private'`, or `undefined` (any private)
+ * - `family`: `'ipv4'` (default) or `'ipv6'`
+ */
+// ─── Long integer conversion ──────────────────────────────────────────────────
+/** Convert a dotted-decimal IPv4 address to a 32-bit unsigned integer. */
+export function toLong(ip) {
+    let ipl = 0;
+    for (const octet of ip.split('.')) {
+        ipl = (ipl << 8) + parseInt(octet, 10);
+    }
+    return ipl >>> 0;
+}
+/** Convert a 32-bit unsigned integer to a dotted-decimal IPv4 address. */
+export function fromLong(ipl) {
+    return [
+        (ipl >>> 24) & 255,
+        (ipl >>> 16) & 255,
+        (ipl >>> 8) & 255,
+        ipl & 255,
+    ].join('.');
+}
+/**
+ * Normalize an IPv4 address (supports decimal, octal, hex, and compact notations)
+ * and return it as a 32-bit unsigned long. Returns -1 on error.
+ */
+export function normalizeToLong(addr) {
+    const parts = addr.split('.').map((part) => {
+        if (part.startsWith('0x') || part.startsWith('0X')) {
+            const v = parseInt(part, 16);
+            return Number.isNaN(v) ? NaN : v;
+        }
+        if (part.startsWith('0') && part !== '0' && /^[0-7]+$/.test(part)) {
+            return parseInt(part, 8);
+        }
+        if (/^[1-9]\d*$/.test(part) || part === '0') {
+            return parseInt(part, 10);
+        }
+        return NaN;
+    });
+    if (parts.some(Number.isNaN))
+        return -1;
+    const n = parts.length;
+    let val = 0;
+    switch (n) {
+        case 1:
+            val = parts[0];
+            break;
+        case 2:
+            if (parts[0] > 0xff || parts[1] > 0xffffff)
+                return -1;
+            val = (parts[0] << 24) | (parts[1] & 0xffffff);
+            break;
+        case 3:
+            if (parts[0] > 0xff || parts[1] > 0xff || parts[2] > 0xffff)
+                return -1;
+            val = (parts[0] << 24) | (parts[1] << 16) | (parts[2] & 0xffff);
+            break;
+        case 4:
+            if (parts.some((p) => p > 0xff))
+                return -1;
+            val = (parts[0] << 24) | (parts[1] << 16) | (parts[2] << 8) | parts[3];
+            break;
+        default:
+            return -1;
+    }
+    return val >>> 0;
+}
+//# sourceMappingURL=core.js.map

package/dist/esm/core.js.map

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

package/dist/esm/index.browser.js

@@ -0,0 +1,13 @@
+// Browser entry point — zero Node.js built-in dependencies.
+// Vite/esbuild/webpack use this file instead of index.ts via
+// the "browser" field in package.json, avoiding any import of `os`.
+export { toBuffer, toString, isV4Format, isV6Format, fromPrefixLen, mask, cidr, subnet, cidrSubnet, not, or, isEqual, isLoopback, isPrivate, isPublic, loopback, toLong, fromLong, normalizeToLong, } from './core.js';
+/**
+ * Not available in browser environments.
+ * Obtain the IP server-side and pass it to the client, or use `loopback()` as a fallback.
+ */
+export function address(_name, _family) {
+    throw new Error('[node-ip-ts] ip.address() uses the Node.js `os` module and cannot run in a browser. ' +
+        'Use ip.loopback() as a fallback, or pass the IP from the server.');
+}
+//# sourceMappingURL=index.browser.js.map

package/dist/esm/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../../src/index.browser.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,6DAA6D;AAC7D,oEAAoE;AAEpE,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,EACV,aAAa,EACb,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,UAAU,EACV,GAAG,EACH,EAAE,EACF,OAAO,EACP,UAAU,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,eAAe,GAChB,MAAM,WAAW,CAAC;AAInB;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,OAAyB;IAC/D,MAAM,IAAI,KAAK,CACb,sFAAsF;QACpF,kEAAkE,CACrE,CAAC;AACJ,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,39 @@
+// Node.js entry point.
+// Exports all pure functions from core.ts plus address() which uses the `os` module.
+// Browser bundlers (Vite/esbuild/webpack) are redirected to index.browser.ts
+// via the "browser" field in package.json, which never imports `os`.
+import { networkInterfaces as _getNetworkInterfaces } from 'os';
+import { normalizeFamily, isLoopback, isPublic, isPrivate, loopback, } from './core.js';
+export { toBuffer, toString, isV4Format, isV6Format, fromPrefixLen, mask, cidr, subnet, cidrSubnet, not, or, isEqual, isLoopback, isPrivate, isPublic, loopback, toLong, fromLong, normalizeToLong, } from './core.js';
+/**
+ * Return a network interface address.
+ * - `name`: interface name, `'public'`, `'private'`, or `undefined` (any private)
+ * - `family`: `'ipv4'` (default) or `'ipv6'`
+ */
+export function address(name, family) {
+    const ifaces = _getNetworkInterfaces();
+    const fam = normalizeFamily(family);
+    if (name && name !== 'private' && name !== 'public') {
+        const iface = ifaces[name];
+        if (!iface)
+            return loopback(fam);
+        const match = iface.filter((d) => normalizeFamily(d.family) === fam);
+        return match.length ? match[0].address : loopback(fam);
+    }
+    const all = Object.values(ifaces)
+        .flat()
+        .filter((d) => {
+        if (!d)
+            return false;
+        if (normalizeFamily(d.family) !== fam)
+            return false;
+        if (isLoopback(d.address))
+            return false;
+        if (!name)
+            return true;
+        return name === 'public' ? isPublic(d.address) : isPrivate(d.address);
+    })
+        .map((d) => d.address);
+    return all.length ? all[0] : loopback(fam);
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,qFAAqF;AACrF,6EAA6E;AAC7E,qEAAqE;AACrE,OAAO,EAAE,iBAAiB,IAAI,qBAAqB,EAAE,MAAM,IAAI,CAAC;AAEhE,OAAO,EACL,eAAe,EACf,UAAU,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,EACV,aAAa,EACb,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,UAAU,EACV,GAAG,EACH,EAAE,EACF,OAAO,EACP,UAAU,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,eAAe,GAChB,MAAM,WAAW,CAAC;AAInB;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,IAAa,EAAE,MAAwB;IAC7D,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAEpC,IAAI,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;QACrE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;SAC9B,IAAI,EAAE;SACN,MAAM,CAAC,CAAC,CAAC,EAA8B,EAAE;QACxC,IAAI,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QACrB,IAAI,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;QACpD,IAAI,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACxE,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAEzB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC7C,CAAC"}

package/dist/types/core.d.ts

@@ -0,0 +1,73 @@
+export type IPFamily = 'ipv4' | 'ipv6';
+export interface SubnetInfo {
+    networkAddress: string;
+    firstAddress: string;
+    lastAddress: string;
+    broadcastAddress: string;
+    subnetMask: string;
+    subnetMaskLength: number;
+    numHosts: number;
+    length: number;
+    contains(other: string): boolean;
+}
+export declare function normalizeFamily(family?: number | string): IPFamily;
+/**
+ * Convert an IP address string to a Buffer.
+ * Optionally write into an existing buffer at a given offset.
+ */
+export declare function toBuffer(ip: string, buff?: Buffer, offset?: number): Buffer;
+/**
+ * Convert a Buffer back to an IP address string.
+ */
+export declare function toString(buff: Buffer, offset?: number, length?: number): string;
+export declare function isV4Format(ip: string): boolean;
+export declare function isV6Format(ip: string): boolean;
+/**
+ * Create a subnet mask from a prefix length.
+ */
+export declare function fromPrefixLen(prefixlen: number, family?: number | string): string;
+/**
+ * Apply a subnet mask to an address.
+ */
+export declare function mask(addr: string, maskStr: string): string;
+/**
+ * Return the network address for a CIDR string (e.g. "192.168.1.1/24").
+ */
+export declare function cidr(cidrString: string): string;
+/**
+ * Compute full subnet information from address + mask.
+ */
+export declare function subnet(addr: string, subnetMask: string): SubnetInfo;
+/**
+ * Compute full subnet information from a CIDR string.
+ */
+export declare function cidrSubnet(cidrString: string): SubnetInfo;
+/** Bitwise NOT of an IP address. */
+export declare function not(addr: string): string;
+/** Bitwise OR of two IP addresses (supports mixed protocol). */
+export declare function or(a: string, b: string): string;
+/** Deep equality check for two IP addresses (supports mixed IPv4/IPv6). */
+export declare function isEqual(a: string, b: string): boolean;
+/** Returns true if the address is a loopback address. */
+export declare function isLoopback(addr: string): boolean;
+/** Returns true if the address is a private (RFC 1918 / ULA) address. */
+export declare function isPrivate(addr: string): boolean;
+/** Returns true if the address is a publicly routable address. */
+export declare function isPublic(addr: string): boolean;
+/** Return the loopback address for the given IP family. */
+export declare function loopback(family?: number | string): string;
+/**
+ * Return a network interface address.
+ * - `name`: interface name, `'public'`, `'private'`, or `undefined` (any private)
+ * - `family`: `'ipv4'` (default) or `'ipv6'`
+ */
+/** Convert a dotted-decimal IPv4 address to a 32-bit unsigned integer. */
+export declare function toLong(ip: string): number;
+/** Convert a 32-bit unsigned integer to a dotted-decimal IPv4 address. */
+export declare function fromLong(ipl: number): string;
+/**
+ * Normalize an IPv4 address (supports decimal, octal, hex, and compact notations)
+ * and return it as a 32-bit unsigned long. Returns -1 on error.
+ */
+export declare function normalizeToLong(addr: string): number;
+//# sourceMappingURL=core.d.ts.map

package/dist/types/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAID,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAIlE;AAID;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAiD3E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAqB1E;AAQD,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9C;AAID;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAajF;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAyB1D;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,CAsCnE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAIzD;AAID,oCAAoC;AACpC,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxC;AAED,gEAAgE;AAChE,wBAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAoB/C;AAED,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CA8BrD;AAID,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAchD;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAoB/C;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9C;AAKD,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAMzD;AAED;;;;GAIG;AAIH,0EAA0E;AAC1E,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMzC;AAED,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyCpD"}

package/dist/types/index.browser.d.ts

@@ -0,0 +1,8 @@
+export { toBuffer, toString, isV4Format, isV6Format, fromPrefixLen, mask, cidr, subnet, cidrSubnet, not, or, isEqual, isLoopback, isPrivate, isPublic, loopback, toLong, fromLong, normalizeToLong, } from './core.js';
+export type { IPFamily, SubnetInfo } from './core.js';
+/**
+ * Not available in browser environments.
+ * Obtain the IP server-side and pass it to the client, or use `loopback()` as a fallback.
+ */
+export declare function address(_name?: string, _family?: number | string): string;
+//# sourceMappingURL=index.browser.d.ts.map

package/dist/types/index.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../../src/index.browser.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,EACV,aAAa,EACb,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,UAAU,EACV,GAAG,EACH,EAAE,EACF,OAAO,EACP,UAAU,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,eAAe,GAChB,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAKzE"}

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+export { toBuffer, toString, isV4Format, isV6Format, fromPrefixLen, mask, cidr, subnet, cidrSubnet, not, or, isEqual, isLoopback, isPrivate, isPublic, loopback, toLong, fromLong, normalizeToLong, } from './core.js';
+export type { IPFamily, SubnetInfo } from './core.js';
+/**
+ * Return a network interface address.
+ * - `name`: interface name, `'public'`, `'private'`, or `undefined` (any private)
+ * - `family`: `'ipv4'` (default) or `'ipv6'`
+ */
+export declare function address(name?: string, family?: number | string): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,EACV,aAAa,EACb,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,UAAU,EACV,GAAG,EACH,EAAE,EACF,OAAO,EACP,UAAU,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,eAAe,GAChB,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAuBvE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-ip-ts",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "author": "Deni Irawan Nugraha <deni.irawan40563@gmail.com>",
   "license": "MIT",
   "homepage": "https://github.com/denycode-dev/node-ip-ts",
@@ -10,31 +10,48 @@
     "directory": "packages/node-ip-ts"
   },
   "keywords": [
-    "ip",
     "ip address",
     "ip address library",
     "ip address parser",
     "ip address validator",
     "ip address converter",
     "ip address to buffer",
-    "buffer to ip address"
+    "buffer to ip address",
+    "ip",
+    "address",
+    "ipv4",
+    "ipv6",
+    "subnet",
+    "cidr",
+    "network",
+    "typescript"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
-  "description": "Modern TypeScript IP address library",
+  "sideEffects": false,
+  "description": "Modern TypeScript IP address utility library — ESM, CJS, and browser ready",
   "type": "module",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
+  "browser": "./dist/esm/index.browser.js",
   "types": "./dist/types/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/types/index.d.ts",
+      "browser": "./dist/esm/index.browser.js",
       "import": "./dist/esm/index.js",
       "require": "./dist/cjs/index.js",
-      "types": "./dist/types/index.d.ts"
+      "default": "./dist/esm/index.js"
     }
   },
   "scripts": {
     "build": "tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json && tsc -p tsconfig.types.json",
     "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
-    "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch"
+    "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch",
+    "prepublishOnly": "npm run build && npm test"
   },
   "devDependencies": {
     "@types/jest": "^29.5.12",

package/jest.config.js

@@ -1,22 +0,0 @@
-/** @type {import('jest').Config} */
-export default {
-  preset: 'ts-jest/presets/default-esm',
-  extensionsToTreatAsEsm: ['.ts'],
-  testEnvironment: 'node',
-  moduleNameMapper: {
-    '^(\\.{1,2}/.*)\\.js$': '$1',
-  },
-  transform: {
-    '^.+\\.tsx?$': [
-      'ts-jest',
-      {
-        useESM: true,
-        tsconfig: {
-          module: 'ES2020',
-          moduleResolution: 'bundler',
-        },
-      },
-    ],
-  },
-  testMatch: ['**/*.test.ts'],
-};