@pfeiferio/ipv4 1.0.0

package/README.md

@@ -0,0 +1,154 @@
+# @pfeiferio/ipv4
+
+![npm](https://img.shields.io/npm/v/@pfeiferio/ipv4)
+![types](https://img.shields.io/npm/types/@pfeiferio/ipv4)
+![license](https://img.shields.io/npm/l/@pfeiferio/ipv4)
+![downloads](https://img.shields.io/npm/dm/@pfeiferio/ipv4)
+![node](https://img.shields.io/node/v/@pfeiferio/ipv4)
+
+Strict and well-tested IPv4 address and network utilities for Node.js.
+
+* ESM only
+* Node.js ≥ 18
+* TypeScript-first
+* No dependencies
+* Full test coverage
+
+---
+
+## Installation
+
+```bash
+npm install @pfeiferio/ipv4
+```
+
+---
+
+## Basic Usage
+
+```js
+import { ipV4 } from '@pfeiferio/ipv4'
+
+const ip = ipV4('192.168.1.10/24')
+
+ip.address            // "192.168.1.10"
+ip.prefix             // 24
+ip.addressWithCidr    // "192.168.1.10/24"
+ip.toInteger()        // 3232235786
+```
+
+Default prefix is `/32`.
+
+---
+
+## IPv4Address examples
+
+### Create addresses
+
+```js
+ipV4('1.1.1.1')
+ipV4('1.1.1.1/32')
+ipV4(3232235777)
+```
+
+### Prefix handling (immutable)
+
+```js
+const ip = ipV4('10.0.0.1')
+const withPrefix = ip.withPrefix(16)
+
+ip.addressWithCidr        // "10.0.0.1/32"
+withPrefix.addressWithCidr // "10.0.0.1/16"
+```
+
+### Address comparison
+
+```js
+ip.equals(ipV4('10.0.0.1/32'))        // true
+ip.isSameAddress(ipV4('10.0.0.1/8'))  // true
+```
+
+### Navigation
+
+```js
+ipV4('1.1.1.1').next().address   // "1.1.1.2"
+ipV4('1.1.1.1').prev().address   // "1.1.1.0"
+```
+
+---
+
+## IPv4Network examples
+
+### Create networks
+
+```js
+const net = ipV4('192.168.1.10/24').network()
+
+net.addressWithCidr   // "192.168.1.0/24"
+net.size              // 256
+net.hostCount         // 254
+```
+
+### Network helpers
+
+```js
+net.firstHost.address   // "192.168.1.1"
+net.lastHost.address    // "192.168.1.254"
+net.broadcast.address   // "192.168.1.255"
+```
+
+### Containment & relations
+
+```js
+net.contains('192.168.1.42')                 // true
+net.overlaps('192.168.1.128/25')             // true
+net.containsNetwork('192.168.1.128/25')      // true
+net.isSubnetOf('192.168.0.0/16')              // true
+net.isSupernetOf('192.168.1.128/25')          // true
+```
+
+---
+
+## Iteration
+
+### Usable hosts
+
+```js
+for (const host of net.hosts()) {
+  console.log(host.address)
+}
+```
+
+### All addresses
+
+```js
+for (const addr of net.addresses()) {
+  console.log(addr.address)
+}
+```
+
+---
+
+## Utilities
+
+```js
+import { ipToInt, intToIp } from '@pfeiferio/ipv4'
+
+ipToInt('192.168.1.1')   // 3232235777
+intToIp(3232235777)      // "192.168.1.1"
+```
+
+---
+
+## Design notes
+
+* Prefix defaults to `/32`
+* Network addresses are always normalized
+* No implicit magic
+* `/0`, `/31`, `/32` handled correctly
+
+---
+
+## License
+
+MIT

package/dist/IPv4Address.d.ts

@@ -0,0 +1,38 @@
+import { IPv4Network } from "./IPv4Network.js";
+import type { IPv4Input, IPv4AddressAsString, IPv4AddressInAddrArpa, IPv4AddressWithCidrAsString } from "./types.js";
+type IpV4Options = {
+    allowZeroOctet?: boolean;
+};
+export declare class IPv4Address {
+    #private;
+    static fromInteger: (value: number, prefix?: number) => IPv4Address;
+    static fromString: (value: string) => IPv4Address;
+    static isValid: (value: IPv4Input) => boolean;
+    static private: () => IPv4Address[];
+    static rfc1918: () => IPv4Address[];
+    constructor(ipv4Address: IPv4Input, prefixOverride?: number | null, { allowZeroOctet }?: IpV4Options);
+    get prefix(): number;
+    get address(): IPv4AddressAsString;
+    get addressWithCidr(): IPv4AddressWithCidrAsString;
+    network(): IPv4Network;
+    isInSubnet(subnet: IPv4Input): boolean;
+    toString(): IPv4AddressAsString;
+    toInteger(): number;
+    equals(other: IPv4Input): boolean;
+    isSameAddress(other: IPv4Input): boolean;
+    next(): IPv4Address | null;
+    prev(): IPv4Address | null;
+    withPrefix(prefix: number): IPv4Address;
+    isPrivate(): boolean;
+    isPublic(): boolean;
+    isLoopback(): boolean;
+    isLinkLocal(): boolean;
+    isMulticast(): boolean;
+    isReserved(): boolean;
+    reversePointer(): IPv4AddressInAddrArpa;
+    toBinary(): string;
+    toBinaryAddress(): string;
+    toHex(): string;
+}
+export {};
+//# sourceMappingURL=IPv4Address.d.ts.map

package/dist/IPv4Address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPv4Address.d.ts","sourceRoot":"","sources":["../src/IPv4Address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EACV,SAAS,EACT,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAEpB,KAAK,WAAW,GAAG;IACjB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAED,qBAAa,WAAW;;IAMtB,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC;IACpE,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,WAAW,CAAC;IAClD,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC;IAC9C,MAAM,CAAC,OAAO,EAAE,MAAM,WAAW,EAAE,CAAC;IACpC,MAAM,CAAC,OAAO,EAAE,MAAM,WAAW,EAAE,CAAC;gBAGlC,WAAW,EAAE,SAAS,EACtB,cAAc,GAAE,MAAM,GAAG,IAAW,EACpC,EAAC,cAAsB,EAAC,GAAE,WAAgB;IA2B5C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,OAAO,IAAI,mBAAmB,CAEjC;IAED,IAAI,eAAe,IAAI,2BAA2B,CAEjD;IAgBD,OAAO,IAAI,WAAW;IAItB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAItC,QAAQ,IAAI,mBAAmB;IAI/B,SAAS,IAAI,MAAM;IAInB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAMjC,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAIxC,IAAI,IAAI,WAAW,GAAG,IAAI;IAK1B,IAAI,IAAI,WAAW,GAAG,IAAI;IAK1B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW;IAIvC,SAAS,IAAI,OAAO;IAWpB,QAAQ,IAAI,OAAO;IAKnB,UAAU,IAAI,OAAO;IAKrB,WAAW,IAAI,OAAO;IAKtB,WAAW,IAAI,OAAO;IAKtB,UAAU,IAAI,OAAO;IAKrB,cAAc,IAAI,qBAAqB;IAKvC,QAAQ,IAAI,MAAM;IAMlB,eAAe,IAAI,MAAM;IAKzB,KAAK,IAAI,MAAM;CAGhB"}

package/dist/IPv4Address.js

@@ -0,0 +1,157 @@
+import { IPv4Network } from "./IPv4Network.js";
+import { ipV4, parseNumberToIp, parseStringToIp } from "./utils.js";
+export class IPv4Address {
+    #addressAsInteger = 0;
+    #prefix;
+    #address;
+    #network = null;
+    static fromInteger;
+    static fromString;
+    static isValid;
+    static private;
+    static rfc1918;
+    constructor(ipv4Address, prefixOverride = null, { allowZeroOctet = false } = {}) {
+        if (typeof ipv4Address === 'string') {
+            const { address, prefix, addressAsInteger } = parseStringToIp(ipv4Address, prefixOverride);
+            this.#addressAsInteger = addressAsInteger;
+            this.#prefix = prefix;
+            this.#address = address;
+            // Validate zero octet only for string input
+            if (!allowZeroOctet) {
+                this.#validateZeroOctet();
+            }
+        }
+        else if (typeof ipv4Address === 'number') {
+            const { address, prefix, addressAsInteger } = parseNumberToIp(ipv4Address);
+            this.#addressAsInteger = addressAsInteger;
+            this.#prefix = prefixOverride ?? prefix;
+            this.#address = address;
+        }
+        else if (ipv4Address instanceof IPv4Address) {
+            this.#prefix = prefixOverride ?? ipv4Address.#prefix;
+            this.#address = ipv4Address.#address;
+            this.#addressAsInteger = ipv4Address.#addressAsInteger;
+        }
+        else {
+            throw new Error(`Invalid IPv4 address type: ${typeof ipv4Address}`);
+        }
+    }
+    get prefix() {
+        return this.#prefix;
+    }
+    get address() {
+        return this.#address;
+    }
+    get addressWithCidr() {
+        return `${this.address}/${this.prefix}`;
+    }
+    #validateZeroOctet() {
+        const firstOctet = (this.#addressAsInteger >>> 24) & 0xFF;
+        if (firstOctet !== 0) {
+            return;
+        }
+        if (this.#addressAsInteger === 0 && [0, 8, 32].includes(this.#prefix)) {
+            return;
+        }
+        throw new Error('First octet cannot be 0 (except 0.0.0.0 with /0, /8, or /32)');
+    }
+    network() {
+        return this.#network ??= new IPv4Network(this);
+    }
+    isInSubnet(subnet) {
+        return new IPv4Network(subnet).contains(this);
+    }
+    toString() {
+        return this.#address;
+    }
+    toInteger() {
+        return this.#addressAsInteger;
+    }
+    equals(other) {
+        other = ipV4(other);
+        return this.toInteger() === other.toInteger() &&
+            this.prefix === other.prefix;
+    }
+    isSameAddress(other) {
+        return this.toInteger() === ipV4(other).toInteger();
+    }
+    next() {
+        if (this.toInteger() >= 0xFFFFFFFF)
+            return null;
+        return new IPv4Address(this.toInteger() + 1, this.prefix);
+    }
+    prev() {
+        if (this.toInteger() <= 0)
+            return null;
+        return new IPv4Address(this.toInteger() - 1, this.prefix);
+    }
+    withPrefix(prefix) {
+        return new IPv4Address(this.#addressAsInteger, prefix);
+    }
+    isPrivate() {
+        const int = this.#addressAsInteger;
+        // 10.0.0.0/8
+        if ((int & 0xFF000000) === 0x0A000000)
+            return true;
+        // 172.16.0.0/12
+        if (((int & 0xFFF00000) >>> 0) === 0xAC100000)
+            return true;
+        // 192.168.0.0/16
+        if (((int & 0xFFFF0000) >>> 0) === 0xC0A80000)
+            return true;
+        return false;
+    }
+    isPublic() {
+        return !this.isPrivate() && !this.isLoopback() && !this.isLinkLocal()
+            && !this.isMulticast() && !this.isReserved();
+    }
+    isLoopback() {
+        // 127.0.0.0/8
+        return (this.#addressAsInteger & 0xFF000000) === 0x7F000000;
+    }
+    isLinkLocal() {
+        // 169.254.0.0/16
+        return ((this.#addressAsInteger & 0xFFFF0000) >>> 0) === 0xA9FE0000;
+    }
+    isMulticast() {
+        // 224.0.0.0/4 (224-239.x.x.x)
+        return ((this.#addressAsInteger & 0xF0000000) >>> 0) === 0xE0000000;
+    }
+    isReserved() {
+        // 240.0.0.0/4 (240-255.x.x.x)
+        return ((this.#addressAsInteger & 0xF0000000) >>> 0) === 0xF0000000;
+    }
+    reversePointer() {
+        const octets = this.#address.split('.');
+        return `${octets[3]}.${octets[2]}.${octets[1]}.${octets[0]}.in-addr.arpa`;
+    }
+    toBinary() {
+        const format = (len, fill = true) => ((this.#addressAsInteger >>> len) & 0xFF).toString(2).padStart(fill ? 8 : 0, '0');
+        return `${format(24, false)}${format(16)}${format(8)}${format(0)}`;
+    }
+    toBinaryAddress() {
+        const format = (len) => ((this.#addressAsInteger >>> len) & 0xFF).toString(2).padStart(8, '0');
+        return `${format(24)}.${format(16)}.${format(8)}.${format(0)}`;
+    }
+    toHex() {
+        return this.#addressAsInteger.toString(16).toUpperCase().padStart(8, '0');
+    }
+}
+IPv4Address.fromInteger = (value, prefix = 32) => new IPv4Address(value, prefix);
+IPv4Address.fromString = (value) => ipV4(value);
+IPv4Address.isValid = (value) => {
+    try {
+        new IPv4Address(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+IPv4Address.private = () => [
+    new IPv4Address('10.0.0.0/8'),
+    new IPv4Address('172.16.0.0/12'),
+    new IPv4Address('192.168.0.0/16')
+];
+IPv4Address.rfc1918 = () => IPv4Address.private();
+//# sourceMappingURL=IPv4Address.js.map

package/dist/IPv4Address.js.map

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

package/dist/IPv4Network.d.ts

@@ -0,0 +1,27 @@
+import { IPv4Address } from "./IPv4Address.js";
+import type { IPv4AddressAsString, IPv4AddressWithCidrAsString, IPv4Input, IPv4NetworkInput } from "./types.js";
+export declare class IPv4Network {
+    #private;
+    constructor(address: IPv4NetworkInput);
+    get addressWithCidr(): IPv4AddressWithCidrAsString;
+    get address(): IPv4AddressAsString;
+    get prefix(): number;
+    get size(): number;
+    get firstHost(): IPv4Address | null;
+    get lastHost(): IPv4Address | null;
+    get broadcast(): IPv4Address;
+    get netmask(): IPv4Address;
+    get hostmask(): IPv4Address;
+    get hostCount(): number;
+    contains(other: IPv4Input): boolean;
+    overlaps(other: IPv4NetworkInput): boolean;
+    containsNetwork(other: IPv4NetworkInput): boolean;
+    isSubnetOf(other: IPv4NetworkInput): boolean;
+    isSupernetOf(other: IPv4NetworkInput): boolean;
+    toInteger(): number;
+    toString(): string;
+    equals(other: IPv4Input): boolean;
+    hosts(keepPrefix?: boolean): Generator<IPv4Address, void | IPv4Address, undefined | IPv4Address>;
+    addresses(keepPrefix?: boolean): Generator<IPv4Address, void | IPv4Address, undefined | IPv4Address>;
+}
+//# sourceMappingURL=IPv4Network.d.ts.map

package/dist/IPv4Network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPv4Network.d.ts","sourceRoot":"","sources":["../src/IPv4Network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAC,mBAAmB,EAAE,2BAA2B,EAAE,SAAS,EAAE,gBAAgB,EAAC,MAAM,YAAY,CAAC;AAE9G,qBAAa,WAAW;;gBAMV,OAAO,EAAE,gBAAgB;IAerC,IAAI,eAAe,IAAI,2BAA2B,CAEjD;IAED,IAAI,OAAO,IAAI,mBAAmB,CAEjC;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,SAAS,IAAI,WAAW,GAAG,IAAI,CAGlC;IAED,IAAI,QAAQ,IAAI,WAAW,GAAG,IAAI,CAGjC;IAED,IAAI,SAAS,IAAI,WAAW,CAE3B;IAED,IAAI,OAAO,IAAI,WAAW,CAGzB;IAED,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAED,IAAI,SAAS,IAAI,MAAM,CAGtB;IAED,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAYnC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO;IAc1C,eAAe,CAAC,KAAK,EAAE,gBAAgB;IAcvC,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO;IAO5C,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO;IAI9C,SAAS,IAAI,MAAM;IAInB,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAM/B,KAAK,CAAC,UAAU,GAAE,OAAe,GAAG,SAAS,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,EAAE,SAAS,GAAG,WAAW,CAAC;IAWvG,SAAS,CAAC,UAAU,GAAE,OAAe,GAAG,SAAS,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,EAAE,SAAS,GAAG,WAAW,CAAC;CAO9G"}

package/dist/IPv4Network.js

@@ -0,0 +1,122 @@
+import { IPv4Address } from "./IPv4Address.js";
+import { intToIp, ipV4, networkAddressFromInt } from "./utils.js";
+export class IPv4Network {
+    #addressAsInteger;
+    #prefix;
+    #address;
+    constructor(address) {
+        if (address instanceof IPv4Network) {
+            this.#address = address.#address;
+            this.#addressAsInteger = address.#addressAsInteger;
+            this.#prefix = address.#prefix;
+            return;
+        }
+        else if (!(address instanceof IPv4Address)) {
+            address = new IPv4Address(address);
+        }
+        this.#addressAsInteger = networkAddressFromInt(address.toInteger(), address.prefix);
+        this.#address = intToIp(this.#addressAsInteger);
+        this.#prefix = address.prefix;
+    }
+    get addressWithCidr() {
+        return `${this.address}/${this.prefix}`;
+    }
+    get address() {
+        return this.#address;
+    }
+    get prefix() {
+        return this.#prefix;
+    }
+    get size() {
+        return 2 ** (32 - this.prefix);
+    }
+    get firstHost() {
+        if (this.prefix >= 31)
+            return null;
+        return new IPv4Address(this.toInteger() + 1);
+    }
+    get lastHost() {
+        if (this.prefix >= 31)
+            return null;
+        return new IPv4Address(this.toInteger() + this.size - 2);
+    }
+    get broadcast() {
+        return new IPv4Address(this.toInteger() + this.size - 1);
+    }
+    get netmask() {
+        const mask = (0xFFFFFFFF << (32 - this.prefix)) >>> 0;
+        return new IPv4Address(mask);
+    }
+    get hostmask() {
+        return new IPv4Address((2 ** (32 - this.prefix)) - 1, null, { allowZeroOctet: true });
+    }
+    get hostCount() {
+        const s = this.size;
+        return s <= 2 ? 0 : s - 2;
+    }
+    contains(other) {
+        other = ipV4(other);
+        const prefix = this.prefix;
+        const mask = prefix === 0
+            ? 0
+            : (0xFFFFFFFF << (32 - prefix)) >>> 0;
+        return ((other.toInteger() & mask) >>> 0) === this.toInteger();
+    }
+    overlaps(other) {
+        if (!(other instanceof IPv4Network)) {
+            other = new IPv4Network(other);
+        }
+        const startA = this.toInteger();
+        const endA = startA + this.size - 1;
+        const startB = other.toInteger();
+        const endB = startB + other.size - 1;
+        return startA <= endB && startB <= endA;
+    }
+    containsNetwork(other) {
+        if (!(other instanceof IPv4Network)) {
+            other = new IPv4Network(other);
+        }
+        const startA = this.toInteger();
+        const endA = startA + this.size - 1;
+        const startB = other.toInteger();
+        const endB = startB + other.size - 1;
+        return startA <= startB && endB <= endA;
+    }
+    isSubnetOf(other) {
+        if (!(other instanceof IPv4Network)) {
+            other = new IPv4Network(other);
+        }
+        return other.containsNetwork(this);
+    }
+    isSupernetOf(other) {
+        return this.containsNetwork(other);
+    }
+    toInteger() {
+        return this.#addressAsInteger;
+    }
+    toString() {
+        return this.addressWithCidr;
+    }
+    equals(other) {
+        other = ipV4(other);
+        return this.toInteger() === other.toInteger() &&
+            this.prefix === other.prefix;
+    }
+    *hosts(keepPrefix = false) {
+        if (this.prefix >= 31)
+            return;
+        const start = this.toInteger() + 1;
+        const end = this.toInteger() + this.size - 1;
+        for (let i = start; i < end; i++) {
+            yield new IPv4Address(i, keepPrefix ? this.prefix : 32);
+        }
+    }
+    *addresses(keepPrefix = false) {
+        const start = this.toInteger();
+        const end = start + this.size;
+        for (let i = start; i < end; i++) {
+            yield new IPv4Address(i, keepPrefix ? this.prefix : 32);
+        }
+    }
+}
+//# sourceMappingURL=IPv4Network.js.map

package/dist/IPv4Network.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { ipV4 } from "./utils.js";
+export { IPv4Address } from './IPv4Address.js';
+export { IPv4Network } from './IPv4Network.js';
+export { ipToInt, intToIp, networkAddressFromInt } from './utils.js';
+export type { IPv4Input, IPv4NetworkInput } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,IAAI,EAAC,MAAM,YAAY,CAAC;AAGhC,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAA;AAG5C,OAAO,EACL,OAAO,EACP,OAAO,EACP,qBAAqB,EACtB,MAAM,YAAY,CAAA;AAGnB,YAAY,EACV,SAAS,EACT,gBAAgB,EACjB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// core
+export { ipV4 } from "./utils.js";
+// classes
+export { IPv4Address } from './IPv4Address.js';
+export { IPv4Network } from './IPv4Network.js';
+// utils
+export { ipToInt, intToIp, networkAddressFromInt } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,EAAC,IAAI,EAAC,MAAM,YAAY,CAAC;AAEhC,UAAU;AACV,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAA;AAE5C,QAAQ;AACR,OAAO,EACL,OAAO,EACP,OAAO,EACP,qBAAqB,EACtB,MAAM,YAAY,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,13 @@
+import type { IPv4Address } from "./IPv4Address.js";
+import type { IPv4Network } from "./IPv4Network.js";
+export type IPv4Input = IPv4Address | string | number;
+export type IPv4NetworkInput = IPv4Input | IPv4Network;
+export type ParserResult = {
+    address: string;
+    addressAsInteger: number;
+    prefix: number;
+};
+export type IPv4AddressAsString = string;
+export type IPv4AddressWithCidrAsString = string;
+export type IPv4AddressInAddrArpa = string;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAElD,MAAM,MAAM,SAAS,GACnB,WAAW,GAAG,MAAM,GAAG,MAAM,CAAA;AAE/B,MAAM,MAAM,gBAAgB,GAC1B,SAAS,GAAG,WAAW,CAAA;AAEzB,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAA;AACxC,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAAA;AAChD,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,9 @@
+import { IPv4Address } from "./IPv4Address.js";
+import type { IPv4Input, ParserResult } from "./types.js";
+export declare const intToIp: (value: number) => string;
+export declare const ipV4: (address: IPv4Input) => IPv4Address;
+export declare const ipToInt: (ipv4Address: string) => number;
+export declare const parseStringToIp: (ipv4Address: string, prefixOverride?: number | null) => ParserResult;
+export declare const parseNumberToIp: (ipv4Address: number) => ParserResult;
+export declare const networkAddressFromInt: (ip: number, prefix: number) => number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAC,SAAS,EAAE,YAAY,EAAC,MAAM,YAAY,CAAC;AAExD,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,KAAG,MAWvC,CAAA;AAED,eAAO,MAAM,IAAI,GAAI,SAAS,SAAS,KAAG,WAAuC,CAAA;AAEjF,eAAO,MAAM,OAAO,GAAI,aAAa,MAAM,KAAG,MA0B7C,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,aAAa,MAAM,EAAE,iBAAgB,MAAM,GAAG,IAAW,KAAG,YA2B3F,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,aAAa,MAAM,KAAG,YAMrD,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,IAAI,MAAM,EAAE,QAAQ,MAAM,KAAG,MAelE,CAAA"}

package/dist/utils.js

@@ -0,0 +1,74 @@
+import { IPv4Address } from "./IPv4Address.js";
+export const intToIp = (value) => {
+    if (!Number.isInteger(value) || value < 0 || value > 0xFFFFFFFF) {
+        throw new Error('Invalid IPv4 integer');
+    }
+    return [
+        (value >>> 24) & 0xFF,
+        (value >>> 16) & 0xFF,
+        (value >>> 8) & 0xFF,
+        value & 0xFF
+    ].join('.');
+};
+export const ipV4 = (address) => new IPv4Address(address);
+export const ipToInt = (ipv4Address) => {
+    const parts = ipv4Address.split('/');
+    if (parts.length > 2) {
+        throw new Error('Invalid IPv4 address format: too many "/" separators');
+    }
+    return parts[0].split('.').reduce((acc, part, _idx, arr) => {
+        if (arr.length !== 4) {
+            throw new Error('IPv4 address must have exactly 4 octets');
+        }
+        const num = Number(part);
+        if (!Number.isInteger(num)) {
+            throw new Error(`Octet "${part}" is not a valid integer`);
+        }
+        if (num < 0 || num > 255) {
+            throw new Error(`Octet ${num} is out of range (0-255)`);
+        }
+        return ((acc << 8) | num) >>> 0;
+    }, 0);
+};
+export const parseStringToIp = (ipv4Address, prefixOverride = null) => {
+    const parts = ipv4Address.split('/');
+    if (parts.length > 2) {
+        throw new Error('Invalid IPv4 address format: too many "/" separators');
+    }
+    let [address, prefixValue = 32] = parts;
+    const prefix = prefixOverride ?? Number(prefixValue);
+    if (!Number.isInteger(prefix)) {
+        throw new Error(`Prefix "${prefixValue}" is not a valid integer`);
+    }
+    if (prefix < 0 || prefix > 32) {
+        throw new Error(`Prefix ${prefix} is out of range (0-32)`);
+    }
+    const addressAsInteger = ipToInt(address);
+    address = intToIp(addressAsInteger);
+    return {
+        address,
+        addressAsInteger,
+        prefix
+    };
+};
+export const parseNumberToIp = (ipv4Address) => {
+    return {
+        address: intToIp(ipv4Address),
+        addressAsInteger: ipv4Address,
+        prefix: 32
+    };
+};
+export const networkAddressFromInt = (ip, prefix) => {
+    if (!Number.isInteger(ip) || ip < 0 || ip > 0xFFFFFFFF) {
+        throw new Error('Invalid IPv4 integer');
+    }
+    if (!Number.isInteger(prefix) || prefix < 0 || prefix > 32) {
+        throw new Error('Invalid prefix');
+    }
+    if (prefix === 0) {
+        return 0;
+    }
+    const mask = (0xFFFFFFFF << (32 - prefix)) >>> 0;
+    return (ip & mask) >>> 0;
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@pfeiferio/ipv4",
+  "version": "1.0.0",
+  "description": "A strict, well-tested IPv4 address and network utility library for Node.js",
+  "license": "MIT",
+  "author": "Pascal Pfeifer <pascal@pfeifer.zone>",
+  "sideEffects": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "ipv4",
+    "network",
+    "cidr",
+    "subnet",
+    "ip",
+    "networking",
+    "nodejs",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pfeiferio/ipv4.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pfeiferio/ipv4/issues"
+  },
+  "homepage": "https://github.com/pfeiferio/ipv4#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc",
+    "test": "npm run build && node --test",
+    "test:coverage": "npm run build && node --test --experimental-test-coverage",
+    "test:watch": "node --test --watch",
+    "prepublishOnly": "npm run clean && npm test"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.9",
+    "typescript": "^5.9.3"
+  }
+}