ipaddress 0.2.11 → 0.2.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -81,6 +81,8 @@ export declare class IPAddress {
81
81
  broadcast(): IPAddress;
82
82
  is_network(): boolean;
83
83
  network(): IPAddress;
84
+ host(n: number | bigint): IPAddress | null;
85
+ host_number(): bigint;
84
86
  static to_network(adr: Crunchy, host_prefix: number): Crunchy;
85
87
  sub(other: IPAddress): Crunchy;
86
88
  add(other: IPAddress): IPAddress[];
@@ -1 +1 @@
1
- {"version":3,"file":"ipaddress.d.ts","sourceRoot":"","sources":["../../src/ipaddress.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ipaddress.d.ts","sourceRoot":"","sources":["../../src/ipaddress.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,MAAM,MAAM,cAAc,CAAC;AAMlC,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,MAAM,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC;AAEhD,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,SAAS,KAAK,SAAS,CAAC;AAEtD,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;AAEjD,qBAAa,kBAAkB;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;gBAET,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;CAK5C;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,EAAE,CAAC;IAClB,cAAc,EAAE,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,SAAS;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,EAAE,CAAC;IAClB,cAAc,EAAE,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;gBAEP,GAAG,EAAE,eAAe;IAUzB,KAAK,IAAI,SAAS;IAgBlB,EAAE,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO;IAI3B,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO;IAI5B,EAAE,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO;IAI3B,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO;IAI5B,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM;IAe3B,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAe7B,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;WAqBtB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;WAuBpC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;WAQtC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAa3D,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS;IAuB9C,OAAO,IAAI,OAAO;IAWlB,OAAO,IAAI,OAAO;WAeX,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;WAI/B,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;WAezC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;WAsBzC,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;WASzC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;WA6B1C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;WAcpC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;WAoBvD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;WA2BrD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;WASpC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;WAQ5C,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE;IAmEpD,KAAK,IAAI,MAAM,EAAE;IAIjB,aAAa,IAAI,MAAM,EAAE;IAiBzB,eAAe,IAAI,MAAM,EAAE;IAS3B,WAAW,IAAI,MAAM;IAmBrB,SAAS,IAAI,MAAM,EAAE;IAYrB,YAAY,IAAI,SAAS,EAAE;WAqJpB,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE;WAI7C,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE;IASnD,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO;IAQrC,cAAc,IAAI,OAAO;IAQzB,WAAW,IAAI,OAAO;IAQtB,SAAS,IAAI,OAAO;WA2Bb,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;WAIvC,iBAAiB,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;WAoB3D,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAmC9D,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAQ5C,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAgB7C,SAAS,IAAI,MAAM;IAQnB,IAAI,IAAI,MAAM;IAId,sBAAsB,IAAI,MAAM;IAQhC,iBAAiB,IAAI,MAAM;IAI3B,WAAW,IAAI,MAAM;IAOrB,gBAAgB,IAAI,MAAM;IAgB1B,IAAI,IAAI,MAAM;IAUd,MAAM,IAAI,MAAM;IAIhB,OAAO,IAAI,SAAS;IAWpB,SAAS,IAAI,SAAS;IAiBtB,UAAU,IAAI,OAAO;IAYrB,OAAO,IAAI,SAAS;IAapB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI;IAwB1C,WAAW,IAAI,MAAM;WAId,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAI7D,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAO9B,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE;WAI3B,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE;WAQpC,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE;WAQzC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE;IA+BnD,KAAK,IAAI,SAAS;IAwBlB,IAAI,IAAI,SAAS;IAmBjB,SAAS,CAAC,IAAI,EAAE,MAAM;IAQtB,GAAG,IAAI,SAAS,GAAG,IAAI;IASvB,GAAG,IAAI,SAAS,GAAG,IAAI;IA6BvB,IAAI,CAAC,IAAI,EAAE,MAAM;IAiDjB,IAAI,IAAI,OAAO;IAIf,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO;IAkBrC,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO;IAoBjC,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO;IAkBxC,UAAU,IAAI,OAAO;IAmCrB,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE;IAkB9C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,IAAI;IA2C1C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAgC9C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,IAAI;IA0B7C,OAAO,IAAI,SAAS;IAIpB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAS7C;AAED,eAAe,SAAS,CAAC"}
@@ -836,6 +836,42 @@ export class IPAddress {
836
836
  network() {
837
837
  return this.from(IPAddress.to_network(this.host_address, this.prefix.host_prefix()), this.prefix);
838
838
  }
839
+ // Returns the address at host number +n+ relative to this address's
840
+ // network, keeping the prefix. The address does not need to be a
841
+ // network itself.
842
+ //
843
+ // IPAddress.parse("192.168.128.7/24").host(93).to_string()
844
+ // // => "192.168.128.93/24"
845
+ //
846
+ // Host 0 is the network itself. Returns null when +n+ falls outside
847
+ // the network (including negative numbers).
848
+ host(n) {
849
+ let offset;
850
+ if (typeof n === "bigint") {
851
+ if (n < 0n) {
852
+ return null;
853
+ }
854
+ offset = Crunchy.parse(n.toString());
855
+ }
856
+ else {
857
+ if (n < 0 || !Number.isInteger(n)) {
858
+ return null;
859
+ }
860
+ offset = Crunchy.from_number(n);
861
+ }
862
+ if (offset.gte(this.size())) {
863
+ return null;
864
+ }
865
+ return this.from(this.network().host_address.add(offset), this.prefix);
866
+ }
867
+ // Returns the host number of this address within its network, i.e.
868
+ // this address minus its network base. The inverse of host().
869
+ //
870
+ // IPAddress.parse("192.168.128.93/24").host_number()
871
+ // // => 93n
872
+ host_number() {
873
+ return BigInt(this.host_address.sub(this.network().host_address).toString());
874
+ }
839
875
  static to_network(adr, host_prefix) {
840
876
  return adr.shr(host_prefix).shl(host_prefix);
841
877
  }
@@ -204,6 +204,20 @@ describe("Ipv4Test", () => {
204
204
  const ip = IPAddress.parse("127.0.0.1");
205
205
  assert.equal("01111111000000000000000000000001", ip.bits());
206
206
  });
207
+ it("test_method_host", () => {
208
+ const ip = IPAddress.parse("192.168.128.7/22");
209
+ assert.equal("192.168.129.44/22", ip.host(300).to_string());
210
+ assert.equal("192.168.128.7/22", ip.host(7).to_string());
211
+ assert.equal("192.168.128.0/22", ip.host(0).to_string());
212
+ assert.equal("192.168.131.255/22", ip.host(1023).to_string());
213
+ assert.isNull(ip.host(1024));
214
+ assert.isNull(ip.host(-1));
215
+ });
216
+ it("test_method_host_number", () => {
217
+ assert.equal(300n, IPAddress.parse("192.168.129.44/22").host_number());
218
+ assert.equal(0n, IPAddress.parse("192.168.128.0/22").host_number());
219
+ assert.equal(1023n, IPAddress.parse("192.168.131.255/22").host_number());
220
+ });
207
221
  it("test_method_first", () => {
208
222
  let ip = IPAddress.parse("192.168.100.0/24");
209
223
  assert.equal("192.168.100.1", ip.first().to_s());
@@ -103,6 +103,19 @@ describe("ipv6", () => {
103
103
  assert.equal(true, setup().network.is_network());
104
104
  assert.equal(false, setup().ip.is_network());
105
105
  });
106
+ it("test_method_host", () => {
107
+ const ip = IPAddress.parse("fd00::10:12:80:1/64");
108
+ assert.equal("fd00::1000:0:0/64", ip.host(2n ** 44n).to_string());
109
+ assert.equal("fd00::/64", ip.host(0).to_string());
110
+ assert.equal("fd00::ffff:ffff:ffff:ffff/64", ip.host(2n ** 64n - 1n).to_string());
111
+ assert.isNull(ip.host(2n ** 64n));
112
+ assert.isNull(ip.host(-1));
113
+ });
114
+ it("test_method_host_number", () => {
115
+ assert.equal(2n ** 44n, IPAddress.parse("fd00::1000:0:0/64").host_number());
116
+ assert.equal(0n, IPAddress.parse("fd00::/64").host_number());
117
+ assert.equal(2n ** 64n - 1n, IPAddress.parse("fd00::ffff:ffff:ffff:ffff/64").host_number());
118
+ });
106
119
  it("test_method_first", () => {
107
120
  // the zero host is the subnet-router anycast, NOT a usable unicast —
108
121
  // first()/last() are the first/last USABLE hosts (:1/:f), 2026-08-19
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ipaddress",
3
- "version": "0.2.11",
3
+ "version": "0.2.12",
4
4
  "description": "ipaddress handles ipv4 and ipv6",
5
5
  "main": "./dist/src/index.js",
6
6
  "type": "module",
package/src/ipaddress.ts CHANGED
@@ -915,6 +915,43 @@ export class IPAddress {
915
915
  return this.from(IPAddress.to_network(this.host_address, this.prefix.host_prefix()), this.prefix);
916
916
  }
917
917
 
918
+ // Returns the address at host number +n+ relative to this address's
919
+ // network, keeping the prefix. The address does not need to be a
920
+ // network itself.
921
+ //
922
+ // IPAddress.parse("192.168.128.7/24").host(93).to_string()
923
+ // // => "192.168.128.93/24"
924
+ //
925
+ // Host 0 is the network itself. Returns null when +n+ falls outside
926
+ // the network (including negative numbers).
927
+ public host(n: number | bigint): IPAddress | null {
928
+ let offset: Crunchy;
929
+ if (typeof n === "bigint") {
930
+ if (n < 0n) {
931
+ return null;
932
+ }
933
+ offset = Crunchy.parse(n.toString());
934
+ } else {
935
+ if (n < 0 || !Number.isInteger(n)) {
936
+ return null;
937
+ }
938
+ offset = Crunchy.from_number(n);
939
+ }
940
+ if (offset.gte(this.size())) {
941
+ return null;
942
+ }
943
+ return this.from(this.network().host_address.add(offset), this.prefix);
944
+ }
945
+
946
+ // Returns the host number of this address within its network, i.e.
947
+ // this address minus its network base. The inverse of host().
948
+ //
949
+ // IPAddress.parse("192.168.128.93/24").host_number()
950
+ // // => 93n
951
+ public host_number(): bigint {
952
+ return BigInt(this.host_address.sub(this.network().host_address).toString());
953
+ }
954
+
918
955
  public static to_network(adr: Crunchy, host_prefix: number): Crunchy {
919
956
  return adr.shr(host_prefix).shl(host_prefix);
920
957
  }
package/test/test_ipv4.ts CHANGED
@@ -219,6 +219,20 @@ describe("Ipv4Test", () => {
219
219
  const ip = IPAddress.parse("127.0.0.1");
220
220
  assert.equal("01111111000000000000000000000001", ip!.bits());
221
221
  });
222
+ it("test_method_host", () => {
223
+ const ip = IPAddress.parse("192.168.128.7/22");
224
+ assert.equal("192.168.129.44/22", ip!.host(300)!.to_string());
225
+ assert.equal("192.168.128.7/22", ip!.host(7)!.to_string());
226
+ assert.equal("192.168.128.0/22", ip!.host(0)!.to_string());
227
+ assert.equal("192.168.131.255/22", ip!.host(1023)!.to_string());
228
+ assert.isNull(ip!.host(1024));
229
+ assert.isNull(ip!.host(-1));
230
+ });
231
+ it("test_method_host_number", () => {
232
+ assert.equal(300n, IPAddress.parse("192.168.129.44/22")!.host_number());
233
+ assert.equal(0n, IPAddress.parse("192.168.128.0/22")!.host_number());
234
+ assert.equal(1023n, IPAddress.parse("192.168.131.255/22")!.host_number());
235
+ });
222
236
  it("test_method_first", () => {
223
237
  let ip = IPAddress.parse("192.168.100.0/24");
224
238
  assert.equal("192.168.100.1", ip!.first().to_s());
package/test/test_ipv6.ts CHANGED
@@ -112,6 +112,19 @@ describe("ipv6", () => {
112
112
  assert.equal(true, setup().network.is_network());
113
113
  assert.equal(false, setup().ip.is_network());
114
114
  });
115
+ it("test_method_host", () => {
116
+ const ip = IPAddress.parse("fd00::10:12:80:1/64");
117
+ assert.equal("fd00::1000:0:0/64", ip!.host(2n ** 44n)!.to_string());
118
+ assert.equal("fd00::/64", ip!.host(0)!.to_string());
119
+ assert.equal("fd00::ffff:ffff:ffff:ffff/64", ip!.host(2n ** 64n - 1n)!.to_string());
120
+ assert.isNull(ip!.host(2n ** 64n));
121
+ assert.isNull(ip!.host(-1));
122
+ });
123
+ it("test_method_host_number", () => {
124
+ assert.equal(2n ** 44n, IPAddress.parse("fd00::1000:0:0/64")!.host_number());
125
+ assert.equal(0n, IPAddress.parse("fd00::/64")!.host_number());
126
+ assert.equal(2n ** 64n - 1n, IPAddress.parse("fd00::ffff:ffff:ffff:ffff/64")!.host_number());
127
+ });
115
128
  it("test_method_first", () => {
116
129
  // the zero host is the subnet-router anycast, NOT a usable unicast —
117
130
  // first()/last() are the first/last USABLE hosts (:1/:f), 2026-08-19