cidr-block 1.0.0 → 1.3.0

package/README.md

@@ -1,2 +1,71 @@
 # cidr-block
-npm package for calculating CIDR range blocks
+
+ipv4 and ipv6 address and cidr range utilities
+
+## WARNING
+
+This package is still in _very_ early stages and should **NOT** be used in production code!
+
+## Installation
+
+To install npm package, run the following in your project:
+
+```bash
+npm install cidr-block
+```
+
+or if you're using yarn instead of npm
+
+```bash
+yarn add cidr-block
+```
+
+The package is written completely in TypeScript and exports all of it's types automatically,
+meaning you don't need to install any additional `@types` typings.
+
+## Getting Started
+
+Start by defining a cidr range
+
+```typescript
+import { ipv4 as ip } from 'cidr-block'
+
+const myCidr = ip.cidr('10.0.0.0/24')
+```
+
+To get the next logical cidr block
+
+```typescript
+console.log(myCidr.nextBlock().toString()) // 10.0.1.0/24
+```
+
+All `cidr-block` functions and methods are immutable, meaning a new instance will always be
+returned instead of trying to modify the current value.
+
+Once you have a cidr, you have access to all of it's related utilities:
+
+```typescript
+myCidr.netmask // 255.255.255.0
+myCidr.firstUsableIp // 10.0.0.0 (remember that methods act immutable, so this is still at 10.0.0.0)
+myCidr.lastUsableIp // 10.0.0.254
+myCidr.includes(ip.address('10.0.0.128')) // true
+```
+
+## Documentation and API Reference
+
+The full documentation and API reference can be found at https://cidr-block.com
+
+## FAQ
+
+Q: Why are the imports in all the example code like that?
+
+A: The imports in all example code are formatted as the following:
+
+```typescript
+import { ipv4 as ip } from 'cidr-block'
+// or commonjs-style
+const { ipv4: ip } = require('cidr-block')
+```
+
+While you don't have to follow this convention, the API is design like this on purpose to help speed
+up a refactoring of ipv4 to ipv6, as you would only need to change the number on the import.

package/build/cidr/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class InvalidIpAddressError extends Error {
+    constructor(badIp: string);
+}
+export declare class InvalidCidrBlockError extends Error {
+    constructor(badCidr: string);
+}

package/build/cidr/ipv4/constants.d.ts

@@ -0,0 +1,4 @@
+/**
+ * The numerical maximum size an IPv4 address can be
+ */
+export declare const MAX: number;

package/build/cidr/ipv4/index.d.ts

@@ -0,0 +1,4 @@
+export * from './ipv4-address';
+export * from './ipv4-cidr';
+export * from './constants';
+export * from './types';

package/build/cidr/ipv4/ipv4-address.d.ts

@@ -0,0 +1,137 @@
+import { Ipv4Literal, Ipv4Representable } from './types';
+/**
+ * Representation of an IPv4 address. Provides various utility methods like equality
+ * checking.
+ *
+ * @remarks
+ * Direct instantiation should be avoided; use {@link ipv4.address} instead.
+ */
+export declare class Ipv4Address {
+    private _address;
+    constructor(address: Ipv4Literal);
+    /**
+     * The address as a number
+     */
+    get address(): number;
+    /**
+     * @example
+     * ```typescript
+     * import { ipv4 as ip } from 'cidr-block'
+     *
+     * ip.address(255)                                     // ==> '0.0.0.255'
+     * ip.address(0b11111111_00000000_11111111_00000000)   // ==> '255.0.255.0'
+     * ````
+     *
+     * @public
+     * @returns the IPv4 address as a string
+     */
+    toString(): string;
+    /**
+     * Compares if two IP address are the same.
+     *
+     * @example
+     * ```typescript
+     * import { ipv4 as ip } from 'cidr-block'
+     *
+     * function isLoopback(address: Ipv4Representable) {
+     *  return ip.address(address).equals('127.0.0.1')
+     * }
+     * ```
+     *
+     * @public
+     * @param otherIpAddress the other IPv4 address to compare
+     * @returns if the other IP address is the same
+     */
+    equals(otherIpAddress: Ipv4Representable): boolean;
+    /**
+     * @example
+     * ```typescript
+     * import { ipv4 as ip } from 'cidr-block'
+     *
+     * const myIp = ip.address('52.89.32.255')
+     * myIp.nextIp()                                       // ==> '52.89.33.0
+     * ```
+     *
+     * @public
+     * @returns the next consecutive IPv4 address
+     */
+    nextIp(): Ipv4Address;
+    /**
+     * @example
+     * ```typescript
+     * import { ipv4 as ip } from 'cidr-block'
+     *
+     * const myIp = ip.address('52.89.32.19')
+     * myIp.previousIp()                                   // ==> '52.89.32.18
+     * ```
+     *
+     * @public
+     * @returns the preceding IPv4 address
+     */
+    previousIp(): Ipv4Address;
+}
+/**
+ * Convenience function for creating an IPv4 address instance.
+ *
+ * @remarks
+ *
+ * In general, you should use this function instead of instantiating an Ipv4Address
+ * object directly. While there is nothing wrong with direct instantiation, convenience
+ * methods like these are meant to help reduce the footprint of your code and increase
+ * readability.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { ipv4 as ip } from 'cidr-block'
+ *
+ * const localhost = ip.address('127.0.0.1')
+ * ```
+ *
+ * @see {@link Ipv4Address}
+ *
+ * @param ip string representation of the IPv4 address
+ * @returns an instance of Ipv4Address
+ */
+export declare function address(ip: Ipv4Literal): Ipv4Address;
+/**
+ * Converts the string representation of an IPv4 address to a number.
+ *
+ * @example
+ *
+ * ```typescript
+ * import * as cidr from 'cidr-block'
+ *
+ * cidr.ipv4.stringToNum('255.255.255.255') === 4_294_967_295      // ==> true
+ * cidr.ipv4.stringToNum('0.0.0.255') === 255                      // ==> true
+ * ```
+ *
+ * @see This method is the inverse of {@link ipv4.numToString}
+ * @throws {@link InvalidIpAddressError}
+ *
+ * @public
+ * @param address IPv4 address represented as a string
+ * @returns numerical number representation of the address
+ */
+export declare function stringToNum(address: string): number;
+/**
+ * Converts the numerical number representation of an IPv4 address to its string representation.
+ *
+ * @example
+ *
+ * ```typescript
+ * import * as cidr from 'cidr-block'
+ *
+ * cidr.ipv4.numToString(0) === '0.0.0.0'                             // ==> true
+ * cidr.ipv4.numToString(65_280) === '0.0.255.0'                      // ==> true
+ * cidr.ipv4.numToString(4_294_967_295) === '255.255.255.255'         // ==> true
+ * ```
+ *
+ * @see This method is the inverse of {@link ipv4.stringToNum}
+ * @throws {@link InvalidIpAddressError}
+ *
+ * @public
+ * @param ip IPv4 address as a number
+ * @returns string representation of the address
+ */
+export declare function numToString(ip: number): string;

package/build/cidr/ipv4/ipv4-cidr.d.ts

@@ -0,0 +1,68 @@
+import { Ipv4Representable } from './types';
+import { Ipv4Address } from './ipv4-address';
+export declare class Ipv4Cidr {
+    private _ipAddress;
+    private _maskSize;
+    constructor(cidrRange: string);
+    /**
+     * The size of the cidr netmask (the number after the slash in cidr notation)
+     */
+    get maskSize(): number;
+    /**
+     * Number of IP addresses within the cidr range
+     */
+    get allocatableIpCount(): number;
+    /**
+     * The actual IPv4 netmask address
+     */
+    get netmask(): Ipv4Address;
+    /**
+     * The first IPv4 address that is usable within the given cidr range
+     */
+    get firstUsableIp(): Ipv4Address;
+    /**
+     * The last IPv4 address that is usable within the given cidr range
+     */
+    get lastUsableIp(): Ipv4Address;
+    private get addressLength();
+    /**
+     * @returns string representation of the cidr range
+     */
+    toString(): string;
+    /**
+     * @returns the next consecutive cidr block
+     */
+    nextBlock(ofSize?: number): Ipv4Cidr;
+    /**
+     * @returns the previous cidr block
+     */
+    previousBlock(): Ipv4Cidr;
+    /**
+     * @returns if the given IPv4 address is within the cidr range
+     */
+    includes(address: Ipv4Representable): boolean;
+}
+/**
+ * Convenience function for creating an IPv4 cidr range instance.
+ *
+ * @remarks
+ *
+ * In general, you should use this function instead of instantiating an Ipv4Cidr
+ * object directly. While there is nothing wrong with direct instantiation, convenience
+ * methods like these are meant to help reduce the footprint of your code and increase
+ * readability.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { ipv4 as ip } from 'cidr-block'
+ *
+ * const vpcCidrRange = ip.cidr('10.0.0.0/16')
+ * ```
+ *
+ * @see {@link Ipv4Cidr}
+ *
+ * @param cidrRange string representation of the cidr range
+ * @returns an instance of Ipv4Cidr
+ */
+export declare function cidr(cidrRange: string): Ipv4Cidr;

package/build/cidr/ipv4/types.d.ts

@@ -0,0 +1,9 @@
+import { Ipv4Address } from './ipv4-address';
+/**
+ * Type that indicates a literal string or number value that represents an IPv4 address
+ */
+export declare type Ipv4Literal = string | number;
+/**
+ * Type that indicates either a literal value or an address instance that is an IPv4
+ */
+export declare type Ipv4Representable = Ipv4Address | Ipv4Literal;

package/build/cidr/ipv6/constants.d.ts

@@ -0,0 +1,4 @@
+/**
+ * The numerical maximum size an IPv6 address can be
+ */
+export declare const MAX: bigint;

package/build/cidr/ipv6/index.d.ts

@@ -0,0 +1 @@
+export * from './constants';

package/build/cidr/ipv6/ipv6-address.d.ts

@@ -0,0 +1,13 @@
+import { Ipv6Literal, Ipv6Representable } from './types';
+export declare class Ipv6Address {
+    private _address;
+    constructor(address: Ipv6Literal);
+    get address(): bigint;
+    toString(): string;
+    equals(otherIpAddress: Ipv6Representable): boolean;
+    nextIp(): Ipv6Address;
+    previousIp(): Ipv6Address;
+}
+export declare function address(ip: Ipv6Literal): Ipv6Address;
+export declare function stringToNum(address: string): bigint;
+export declare function numToString(num: bigint): string;

package/build/cidr/ipv6/types.d.ts

@@ -0,0 +1,9 @@
+import { Ipv6Address } from './ipv6-address';
+/**
+ * Type that indicates a literal string or number value that represents an IPv6 address
+ */
+export declare type Ipv6Literal = string | bigint;
+/**
+ * Type that indicates either a literal value or an address instance that is an IPv6
+ */
+export declare type Ipv6Representable = Ipv6Address | Ipv6Literal;

package/build/index.d.ts

@@ -0,0 +1,3 @@
+export * as ipv4 from './cidr/ipv4/index';
+export * as ipv6 from './cidr/ipv6/index';
+export * as errors from './cidr/errors';

package/build/index.esm.js

@@ -1 +1,306 @@
-const hello = 'world';export{hello};//# sourceMappingURL=index.esm.js.map
+class InvalidIpAddressError extends Error {
+    constructor(badIp) {
+        super(`${badIp} is not a valid IPv4 address.`);
+    }
+}
+class InvalidCidrBlockError extends Error {
+    constructor(badCidr) {
+        super(`${badCidr} is not a valid IPv4 cidr block.`);
+    }
+}var errors=/*#__PURE__*/Object.freeze({__proto__:null,InvalidIpAddressError:InvalidIpAddressError,InvalidCidrBlockError:InvalidCidrBlockError});/**
+ * The numerical maximum size an IPv4 address can be
+ */
+const MAX$1 = 2 ** 32 - 1;const MAX_OCTET_SIZE = 255;
+/**
+ * Representation of an IPv4 address. Provides various utility methods like equality
+ * checking.
+ *
+ * @remarks
+ * Direct instantiation should be avoided; use {@link ipv4.address} instead.
+ */
+class Ipv4Address {
+    _address;
+    constructor(address) {
+        this._address = typeof address === 'number' ? address : stringToNum(address);
+    }
+    /**
+     * The address as a number
+     */
+    get address() {
+        return this._address;
+    }
+    /**
+     * @example
+     * ```typescript
+     * import { ipv4 as ip } from 'cidr-block'
+     *
+     * ip.address(255)                                     // ==> '0.0.0.255'
+     * ip.address(0b11111111_00000000_11111111_00000000)   // ==> '255.0.255.0'
+     * ````
+     *
+     * @public
+     * @returns the IPv4 address as a string
+     */
+    toString() {
+        return numToString(this._address);
+    }
+    /**
+     * Compares if two IP address are the same.
+     *
+     * @example
+     * ```typescript
+     * import { ipv4 as ip } from 'cidr-block'
+     *
+     * function isLoopback(address: Ipv4Representable) {
+     *  return ip.address(address).equals('127.0.0.1')
+     * }
+     * ```
+     *
+     * @public
+     * @param otherIpAddress the other IPv4 address to compare
+     * @returns if the other IP address is the same
+     */
+    equals(otherIpAddress) {
+        if (otherIpAddress instanceof Ipv4Address) {
+            return this._address === otherIpAddress._address;
+        }
+        else {
+            return this._address === address(otherIpAddress)._address;
+        }
+    }
+    /**
+     * @example
+     * ```typescript
+     * import { ipv4 as ip } from 'cidr-block'
+     *
+     * const myIp = ip.address('52.89.32.255')
+     * myIp.nextIp()                                       // ==> '52.89.33.0
+     * ```
+     *
+     * @public
+     * @returns the next consecutive IPv4 address
+     */
+    nextIp() {
+        return address(this._address + 1);
+    }
+    /**
+     * @example
+     * ```typescript
+     * import { ipv4 as ip } from 'cidr-block'
+     *
+     * const myIp = ip.address('52.89.32.19')
+     * myIp.previousIp()                                   // ==> '52.89.32.18
+     * ```
+     *
+     * @public
+     * @returns the preceding IPv4 address
+     */
+    previousIp() {
+        return address(this._address - 1);
+    }
+}
+/**
+ * Convenience function for creating an IPv4 address instance.
+ *
+ * @remarks
+ *
+ * In general, you should use this function instead of instantiating an Ipv4Address
+ * object directly. While there is nothing wrong with direct instantiation, convenience
+ * methods like these are meant to help reduce the footprint of your code and increase
+ * readability.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { ipv4 as ip } from 'cidr-block'
+ *
+ * const localhost = ip.address('127.0.0.1')
+ * ```
+ *
+ * @see {@link Ipv4Address}
+ *
+ * @param ip string representation of the IPv4 address
+ * @returns an instance of Ipv4Address
+ */
+function address(ip) {
+    return new Ipv4Address(ip);
+}
+/**
+ * Converts the string representation of an IPv4 address to a number.
+ *
+ * @example
+ *
+ * ```typescript
+ * import * as cidr from 'cidr-block'
+ *
+ * cidr.ipv4.stringToNum('255.255.255.255') === 4_294_967_295      // ==> true
+ * cidr.ipv4.stringToNum('0.0.0.255') === 255                      // ==> true
+ * ```
+ *
+ * @see This method is the inverse of {@link ipv4.numToString}
+ * @throws {@link InvalidIpAddressError}
+ *
+ * @public
+ * @param address IPv4 address represented as a string
+ * @returns numerical number representation of the address
+ */
+function stringToNum(address) {
+    try {
+        if (address.length < 7) {
+            throw new Error();
+        }
+        let octets = address.split('.').map(Number);
+        if (octets.some(octet => octet < 0 || octet > MAX_OCTET_SIZE)) {
+            throw new Error();
+        }
+        let [firstOctet, secondOctet, thirdOctet, fourthOctet] = octets;
+        firstOctet = (firstOctet << 24) >>> 0;
+        secondOctet = (secondOctet << 16) >>> 0;
+        thirdOctet = (thirdOctet << 8) >>> 0;
+        return firstOctet + secondOctet + thirdOctet + fourthOctet;
+    }
+    catch {
+        throw new InvalidIpAddressError(address);
+    }
+}
+/**
+ * Converts the numerical number representation of an IPv4 address to its string representation.
+ *
+ * @example
+ *
+ * ```typescript
+ * import * as cidr from 'cidr-block'
+ *
+ * cidr.ipv4.numToString(0) === '0.0.0.0'                             // ==> true
+ * cidr.ipv4.numToString(65_280) === '0.0.255.0'                      // ==> true
+ * cidr.ipv4.numToString(4_294_967_295) === '255.255.255.255'         // ==> true
+ * ```
+ *
+ * @see This method is the inverse of {@link ipv4.stringToNum}
+ * @throws {@link InvalidIpAddressError}
+ *
+ * @public
+ * @param ip IPv4 address as a number
+ * @returns string representation of the address
+ */
+function numToString(ip) {
+    try {
+        if (ip < 0 || ip > MAX$1) {
+            throw new Error();
+        }
+        const firstOctet = (ip >>> 24) & MAX_OCTET_SIZE;
+        const secondOctet = (ip >>> 16) & MAX_OCTET_SIZE;
+        const thirdOctet = (ip >>> 8) & MAX_OCTET_SIZE;
+        const fourthOctet = ip & MAX_OCTET_SIZE;
+        return `${firstOctet}.${secondOctet}.${thirdOctet}.${fourthOctet}`;
+    }
+    catch {
+        throw new InvalidIpAddressError(ip.toString());
+    }
+}class Ipv4Cidr {
+    _ipAddress;
+    _maskSize;
+    // TODO: Allow wider-range of values that can be used to create a cidr
+    constructor(cidrRange) {
+        try {
+            const [address$1, subnetMask] = cidrRange.split('/');
+            this._ipAddress = address(address$1);
+            this._maskSize = Number(subnetMask);
+        }
+        catch {
+            throw new InvalidCidrBlockError(cidrRange);
+        }
+    }
+    /**
+     * The size of the cidr netmask (the number after the slash in cidr notation)
+     */
+    get maskSize() {
+        return this._maskSize;
+    }
+    /**
+     * Number of IP addresses within the cidr range
+     */
+    get allocatableIpCount() {
+        return 2 ** this.addressLength;
+    }
+    /**
+     * The actual IPv4 netmask address
+     */
+    get netmask() {
+        return address((2 ** this.maskSize - 1) << this.addressLength);
+    }
+    /**
+     * The first IPv4 address that is usable within the given cidr range
+     */
+    get firstUsableIp() {
+        return address(this._ipAddress.address);
+    }
+    /**
+     * The last IPv4 address that is usable within the given cidr range
+     */
+    get lastUsableIp() {
+        // FIXME: Handle edge case of when cidr range goes outside valid ip range
+        return address(this._ipAddress.address + 2 ** this.addressLength - 1);
+    }
+    get addressLength() {
+        return Math.abs(32 - this._maskSize);
+    }
+    /**
+     * @returns string representation of the cidr range
+     */
+    toString() {
+        return `${this._ipAddress.toString()}/${this._maskSize}`;
+    }
+    /**
+     * @returns the next consecutive cidr block
+     */
+    nextBlock(ofSize) {
+        const nextIp = this._ipAddress.address + 2 ** this.addressLength;
+        return cidr(`${numToString(nextIp)}/${ofSize ?? this._maskSize}`);
+    }
+    /**
+     * @returns the previous cidr block
+     */
+    previousBlock() {
+        const nextIp = this._ipAddress.address - 2 ** this.addressLength;
+        return cidr(`${numToString(nextIp)}/${this._maskSize}`);
+    }
+    /**
+     * @returns if the given IPv4 address is within the cidr range
+     */
+    includes(address$1) {
+        const ip = address$1 instanceof Ipv4Address ? address$1 : address(address$1);
+        return (
+        // FIXME: How to handle edge case of next block erroring out?
+        ip.address >= this._ipAddress.address && ip.address <= this.nextBlock()._ipAddress.address);
+    }
+}
+/**
+ * Convenience function for creating an IPv4 cidr range instance.
+ *
+ * @remarks
+ *
+ * In general, you should use this function instead of instantiating an Ipv4Cidr
+ * object directly. While there is nothing wrong with direct instantiation, convenience
+ * methods like these are meant to help reduce the footprint of your code and increase
+ * readability.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { ipv4 as ip } from 'cidr-block'
+ *
+ * const vpcCidrRange = ip.cidr('10.0.0.0/16')
+ * ```
+ *
+ * @see {@link Ipv4Cidr}
+ *
+ * @param cidrRange string representation of the cidr range
+ * @returns an instance of Ipv4Cidr
+ */
+function cidr(cidrRange) {
+    return new Ipv4Cidr(cidrRange);
+}var index$1=/*#__PURE__*/Object.freeze({__proto__:null,Ipv4Address:Ipv4Address,address:address,stringToNum:stringToNum,numToString:numToString,Ipv4Cidr:Ipv4Cidr,cidr:cidr,MAX:MAX$1});/**
+ * The numerical maximum size an IPv6 address can be
+ */
+const MAX = 2n ** 128n;var index=/*#__PURE__*/Object.freeze({__proto__:null,MAX:MAX});export{errors,index$1 as ipv4,index as ipv6};//# sourceMappingURL=index.esm.js.map

package/build/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":"MAAa,KAAK,GAAG"}
+{"version":3,"file":"index.esm.js","sources":["../src/src/cidr/errors.ts","../src/src/cidr/ipv4/constants.ts","../src/src/cidr/ipv4/ipv4-address.ts","../src/src/cidr/ipv4/ipv4-cidr.ts","../src/src/cidr/ipv6/constants.ts"],"sourcesContent":[null,null,null,null,null],"names":["MAX","address","ipAddress"],"mappings":"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"}

package/build/index.js

@@ -1 +1,306 @@
-'use strict';Object.defineProperty(exports,'__esModule',{value:true});const hello = 'world';exports.hello=hello;//# sourceMappingURL=index.js.map
+'use strict';Object.defineProperty(exports,'__esModule',{value:true});class InvalidIpAddressError extends Error {
+    constructor(badIp) {
+        super(`${badIp} is not a valid IPv4 address.`);
+    }
+}
+class InvalidCidrBlockError extends Error {
+    constructor(badCidr) {
+        super(`${badCidr} is not a valid IPv4 cidr block.`);
+    }
+}var errors=/*#__PURE__*/Object.freeze({__proto__:null,InvalidIpAddressError:InvalidIpAddressError,InvalidCidrBlockError:InvalidCidrBlockError});/**
+ * The numerical maximum size an IPv4 address can be
+ */
+const MAX$1 = 2 ** 32 - 1;const MAX_OCTET_SIZE = 255;
+/**
+ * Representation of an IPv4 address. Provides various utility methods like equality
+ * checking.
+ *
+ * @remarks
+ * Direct instantiation should be avoided; use {@link ipv4.address} instead.
+ */
+class Ipv4Address {
+    _address;
+    constructor(address) {
+        this._address = typeof address === 'number' ? address : stringToNum(address);
+    }
+    /**
+     * The address as a number
+     */
+    get address() {
+        return this._address;
+    }
+    /**
+     * @example
+     * ```typescript
+     * import { ipv4 as ip } from 'cidr-block'
+     *
+     * ip.address(255)                                     // ==> '0.0.0.255'
+     * ip.address(0b11111111_00000000_11111111_00000000)   // ==> '255.0.255.0'
+     * ````
+     *
+     * @public
+     * @returns the IPv4 address as a string
+     */
+    toString() {
+        return numToString(this._address);
+    }
+    /**
+     * Compares if two IP address are the same.
+     *
+     * @example
+     * ```typescript
+     * import { ipv4 as ip } from 'cidr-block'
+     *
+     * function isLoopback(address: Ipv4Representable) {
+     *  return ip.address(address).equals('127.0.0.1')
+     * }
+     * ```
+     *
+     * @public
+     * @param otherIpAddress the other IPv4 address to compare
+     * @returns if the other IP address is the same
+     */
+    equals(otherIpAddress) {
+        if (otherIpAddress instanceof Ipv4Address) {
+            return this._address === otherIpAddress._address;
+        }
+        else {
+            return this._address === address(otherIpAddress)._address;
+        }
+    }
+    /**
+     * @example
+     * ```typescript
+     * import { ipv4 as ip } from 'cidr-block'
+     *
+     * const myIp = ip.address('52.89.32.255')
+     * myIp.nextIp()                                       // ==> '52.89.33.0
+     * ```
+     *
+     * @public
+     * @returns the next consecutive IPv4 address
+     */
+    nextIp() {
+        return address(this._address + 1);
+    }
+    /**
+     * @example
+     * ```typescript
+     * import { ipv4 as ip } from 'cidr-block'
+     *
+     * const myIp = ip.address('52.89.32.19')
+     * myIp.previousIp()                                   // ==> '52.89.32.18
+     * ```
+     *
+     * @public
+     * @returns the preceding IPv4 address
+     */
+    previousIp() {
+        return address(this._address - 1);
+    }
+}
+/**
+ * Convenience function for creating an IPv4 address instance.
+ *
+ * @remarks
+ *
+ * In general, you should use this function instead of instantiating an Ipv4Address
+ * object directly. While there is nothing wrong with direct instantiation, convenience
+ * methods like these are meant to help reduce the footprint of your code and increase
+ * readability.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { ipv4 as ip } from 'cidr-block'
+ *
+ * const localhost = ip.address('127.0.0.1')
+ * ```
+ *
+ * @see {@link Ipv4Address}
+ *
+ * @param ip string representation of the IPv4 address
+ * @returns an instance of Ipv4Address
+ */
+function address(ip) {
+    return new Ipv4Address(ip);
+}
+/**
+ * Converts the string representation of an IPv4 address to a number.
+ *
+ * @example
+ *
+ * ```typescript
+ * import * as cidr from 'cidr-block'
+ *
+ * cidr.ipv4.stringToNum('255.255.255.255') === 4_294_967_295      // ==> true
+ * cidr.ipv4.stringToNum('0.0.0.255') === 255                      // ==> true
+ * ```
+ *
+ * @see This method is the inverse of {@link ipv4.numToString}
+ * @throws {@link InvalidIpAddressError}
+ *
+ * @public
+ * @param address IPv4 address represented as a string
+ * @returns numerical number representation of the address
+ */
+function stringToNum(address) {
+    try {
+        if (address.length < 7) {
+            throw new Error();
+        }
+        let octets = address.split('.').map(Number);
+        if (octets.some(octet => octet < 0 || octet > MAX_OCTET_SIZE)) {
+            throw new Error();
+        }
+        let [firstOctet, secondOctet, thirdOctet, fourthOctet] = octets;
+        firstOctet = (firstOctet << 24) >>> 0;
+        secondOctet = (secondOctet << 16) >>> 0;
+        thirdOctet = (thirdOctet << 8) >>> 0;
+        return firstOctet + secondOctet + thirdOctet + fourthOctet;
+    }
+    catch {
+        throw new InvalidIpAddressError(address);
+    }
+}
+/**
+ * Converts the numerical number representation of an IPv4 address to its string representation.
+ *
+ * @example
+ *
+ * ```typescript
+ * import * as cidr from 'cidr-block'
+ *
+ * cidr.ipv4.numToString(0) === '0.0.0.0'                             // ==> true
+ * cidr.ipv4.numToString(65_280) === '0.0.255.0'                      // ==> true
+ * cidr.ipv4.numToString(4_294_967_295) === '255.255.255.255'         // ==> true
+ * ```
+ *
+ * @see This method is the inverse of {@link ipv4.stringToNum}
+ * @throws {@link InvalidIpAddressError}
+ *
+ * @public
+ * @param ip IPv4 address as a number
+ * @returns string representation of the address
+ */
+function numToString(ip) {
+    try {
+        if (ip < 0 || ip > MAX$1) {
+            throw new Error();
+        }
+        const firstOctet = (ip >>> 24) & MAX_OCTET_SIZE;
+        const secondOctet = (ip >>> 16) & MAX_OCTET_SIZE;
+        const thirdOctet = (ip >>> 8) & MAX_OCTET_SIZE;
+        const fourthOctet = ip & MAX_OCTET_SIZE;
+        return `${firstOctet}.${secondOctet}.${thirdOctet}.${fourthOctet}`;
+    }
+    catch {
+        throw new InvalidIpAddressError(ip.toString());
+    }
+}class Ipv4Cidr {
+    _ipAddress;
+    _maskSize;
+    // TODO: Allow wider-range of values that can be used to create a cidr
+    constructor(cidrRange) {
+        try {
+            const [address$1, subnetMask] = cidrRange.split('/');
+            this._ipAddress = address(address$1);
+            this._maskSize = Number(subnetMask);
+        }
+        catch {
+            throw new InvalidCidrBlockError(cidrRange);
+        }
+    }
+    /**
+     * The size of the cidr netmask (the number after the slash in cidr notation)
+     */
+    get maskSize() {
+        return this._maskSize;
+    }
+    /**
+     * Number of IP addresses within the cidr range
+     */
+    get allocatableIpCount() {
+        return 2 ** this.addressLength;
+    }
+    /**
+     * The actual IPv4 netmask address
+     */
+    get netmask() {
+        return address((2 ** this.maskSize - 1) << this.addressLength);
+    }
+    /**
+     * The first IPv4 address that is usable within the given cidr range
+     */
+    get firstUsableIp() {
+        return address(this._ipAddress.address);
+    }
+    /**
+     * The last IPv4 address that is usable within the given cidr range
+     */
+    get lastUsableIp() {
+        // FIXME: Handle edge case of when cidr range goes outside valid ip range
+        return address(this._ipAddress.address + 2 ** this.addressLength - 1);
+    }
+    get addressLength() {
+        return Math.abs(32 - this._maskSize);
+    }
+    /**
+     * @returns string representation of the cidr range
+     */
+    toString() {
+        return `${this._ipAddress.toString()}/${this._maskSize}`;
+    }
+    /**
+     * @returns the next consecutive cidr block
+     */
+    nextBlock(ofSize) {
+        const nextIp = this._ipAddress.address + 2 ** this.addressLength;
+        return cidr(`${numToString(nextIp)}/${ofSize ?? this._maskSize}`);
+    }
+    /**
+     * @returns the previous cidr block
+     */
+    previousBlock() {
+        const nextIp = this._ipAddress.address - 2 ** this.addressLength;
+        return cidr(`${numToString(nextIp)}/${this._maskSize}`);
+    }
+    /**
+     * @returns if the given IPv4 address is within the cidr range
+     */
+    includes(address$1) {
+        const ip = address$1 instanceof Ipv4Address ? address$1 : address(address$1);
+        return (
+        // FIXME: How to handle edge case of next block erroring out?
+        ip.address >= this._ipAddress.address && ip.address <= this.nextBlock()._ipAddress.address);
+    }
+}
+/**
+ * Convenience function for creating an IPv4 cidr range instance.
+ *
+ * @remarks
+ *
+ * In general, you should use this function instead of instantiating an Ipv4Cidr
+ * object directly. While there is nothing wrong with direct instantiation, convenience
+ * methods like these are meant to help reduce the footprint of your code and increase
+ * readability.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { ipv4 as ip } from 'cidr-block'
+ *
+ * const vpcCidrRange = ip.cidr('10.0.0.0/16')
+ * ```
+ *
+ * @see {@link Ipv4Cidr}
+ *
+ * @param cidrRange string representation of the cidr range
+ * @returns an instance of Ipv4Cidr
+ */
+function cidr(cidrRange) {
+    return new Ipv4Cidr(cidrRange);
+}var index$1=/*#__PURE__*/Object.freeze({__proto__:null,Ipv4Address:Ipv4Address,address:address,stringToNum:stringToNum,numToString:numToString,Ipv4Cidr:Ipv4Cidr,cidr:cidr,MAX:MAX$1});/**
+ * The numerical maximum size an IPv6 address can be
+ */
+const MAX = 2n ** 128n;var index=/*#__PURE__*/Object.freeze({__proto__:null,MAX:MAX});exports.errors=errors;exports.ipv4=index$1;exports.ipv6=index;//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":"4EAAa,KAAK,GAAG"}
+{"version":3,"file":"index.js","sources":["../src/src/cidr/errors.ts","../src/src/cidr/ipv4/constants.ts","../src/src/cidr/ipv4/ipv4-address.ts","../src/src/cidr/ipv4/ipv4-cidr.ts","../src/src/cidr/ipv6/constants.ts"],"sourcesContent":[null,null,null,null,null],"names":["MAX","address","ipAddress"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cidr-block",
-  "description": "cidr range utils for allocating blocks of ip ranges using cidr notation",
-  "version": "1.0.0",
+  "description": "ipv4 and ipv6 address and cidr range utilities",
+  "version": "1.3.0",
   "license": "MIT",
   "author": "Brandon Burrus <brandon@burrus.io>",
   "homepage": "https://cidr-block.com",
@@ -14,13 +14,14 @@
   },
   "main": "build/index.js",
   "module": "build/index.esm.js",
-  "types": "build/src/index.d.ts",
+  "types": "build/index.d.ts",
   "files": [
     "build"
   ],
   "scripts": {
     "build": "rollup -c",
     "build:watch": "rollup -cw",
+    "predocs": "rimraf docs",
     "docs": "typedoc src/index.ts",
     "lint": "eslint . --ext .ts",
     "lint:fix": "eslint . --fix --ext .ts",
@@ -28,6 +29,9 @@
     "format:fix": "prettier --write **/*.ts",
     "prebuild": "rimraf build",
     "test": "jest",
+    "test:ci": "jest --verbose",
+    "test:cov": "jest --coverage",
+    "test:verbose": "jest --verbose",
     "test:watch": "jest --watch",
     "test:ui": "majestic"
   },
@@ -65,11 +69,18 @@
   "jest": {
     "preset": "ts-jest",
     "testEnvironment": "node",
-    "roots": [
-      "<rootDir>/tests"
-    ],
     "transform": {
       "^.+\\.ts$": "ts-jest"
+    },
+    "collectCoverageFrom": [
+      "<rootDir>/src/**/*"
+    ],
+    "coverageThreshold": {
+      "global": {
+        "branches": 100,
+        "functions": 100,
+        "lines": 100
+      }
     }
   },
   "eslintConfig": {
@@ -81,7 +92,11 @@
     "extends": [
       "eslint:recommended",
       "plugin:@typescript-eslint/recommended"
-    ]
+    ],
+    "rules": {
+      "@typescript-eslint/no-non-null-assertion": "off",
+      "prefer-const": "off"
+    }
   },
   "prettier": {
     "arrowParens": "avoid",

package/build/src/index.d.ts

@@ -1 +0,0 @@
-export declare const hello = "world";