pmcf 2.19.5 → 2.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmcf",
-  "version": "2.19.5",
+  "version": "2.20.0",
   "publishConfig": {
     "access": "public"
   },
@@ -40,7 +40,7 @@
   "dependencies": {
     "ip-utilties": "^1.1.0",
     "npm-pkgbuild": "^18.0.1",
-    "pacc": "^3.3.0",
+    "pacc": "^3.4.0",
     "pkg-dir": "^8.0.0"
   },
   "devDependencies": {

package/src/host.mjs

@@ -421,16 +421,9 @@ export class Host extends Base {
     }
   }
 
-  *networkAddresses() {
+  *networkAddresses(filter) {
     for (const networkInterface of this.networkInterfaces.values()) {
-      for (const [address, subnet] of networkInterface.ipAddresses) {
-        yield {
-          networkInterface,
-          domainNames: networkInterface.domainNames,
-          address,
-          subnet
-        };
-      }
+      yield* networkInterface.networkAddresses(filter);
     }
   }
 

package/src/network-interface.mjs

@@ -6,6 +6,7 @@ import {
   normalizeIP
 } from "ip-utilties";
 import { Base } from "./base.mjs";
+import { Subnet } from "./subnet.mjs";
 import {
   networkProperties,
   networkAddressProperties
@@ -13,6 +14,14 @@ import {
 import { asArray } from "./utils.mjs";
 import { addType } from "./types.mjs";
 
+/**
+ * @typedef {object} NetworkAddress
+ * @property {NetworkInterface} networkInterface
+ * @property {string|Uint8Array|Uint16Array} address
+ * @property {Subnet} subnet
+ * @property {Set<string>} domainNames
+ */
+
 class SkeletonNetworkInterface extends Base {
   _extends = [];
   _network;
@@ -43,7 +52,7 @@ class SkeletonNetworkInterface extends Base {
 
   matches(other) {
     if (this.isTemplate) {
-      const name = this.name.replace("*", "");
+      const name = this.name.replaceAll("*", "");
       return name.length === 0 || other.name.indexOf(name) >= 0;
     }
 
@@ -58,6 +67,30 @@ class SkeletonNetworkInterface extends Base {
     this._network = network;
   }
 
+  get ipAddresses() {
+    return new Map();
+  }
+
+  /**
+   * 
+   * @param {object} filter
+   * @return {Iterable<NetworkAddress>} 
+   */
+  *networkAddresses(filter=(n)=>true) {
+    for (const [address, subnet] of this.ipAddresses) {
+      const networkAddress = {
+        networkInterface: this,
+        domainNames: this.domainNames,
+        address,
+        subnet
+      };
+
+      if(filter(networkAddress)) {
+        yield networkAddress;
+      }
+    }
+  }
+
   get rawAddress() {
     return this.rawAddresses[0];
   }
@@ -74,10 +107,6 @@ class SkeletonNetworkInterface extends Base {
     return this.cidrAddresses[0];
   }
 
-  get ipAddresses() {
-    return new Map();
-  }
-
   get rawAddresses() {
     return [...this.ipAddresses].map(([address]) => address);
   }

package/src/owner.mjs

@@ -298,9 +298,9 @@ export class Owner extends Base {
     return all;
   }
 
-  *networkAddresses() {
+  *networkAddresses(filter) {
     for (const host of this.hosts()) {
-      yield* host.networkAddresses();
+      yield* host.networkAddresses(filter);
     }
   }
 

package/types/host.d.mts

@@ -232,12 +232,7 @@ export class Host extends Base {
     findNetworkInterface(filter: any): any;
     set networkInterfaces(networkInterface: Map<any, any>);
     get networkInterfaces(): Map<any, any>;
-    networkAddresses(): Generator<{
-        networkInterface: any;
-        domainNames: any;
-        address: any;
-        subnet: any;
-    }, void, unknown>;
+    networkAddresses(filter: any): Generator<any, void, any>;
     get rawAddress(): any;
     get rawAddresses(): any[];
     get cidrAddress(): any;

package/types/network-interface.d.mts

@@ -685,6 +685,19 @@ export class LoopbackNetworkInterface extends SkeletonNetworkInterface {
         prefixLength: number;
     }>;
 }
+export type NetworkAddress = {
+    networkInterface: NetworkInterface;
+    address: string | Uint8Array | Uint16Array;
+    subnet: Subnet;
+    domainNames: Set<string>;
+};
+/**
+ * @typedef {object} NetworkAddress
+ * @property {NetworkInterface} networkInterface
+ * @property {string|Uint8Array|Uint16Array} address
+ * @property {Subnet} subnet
+ * @property {Set<string>} domainNames
+ */
 declare class SkeletonNetworkInterface extends Base {
     _extends: any[];
     _network: any;
@@ -695,15 +708,22 @@ declare class SkeletonNetworkInterface extends Base {
     matches(other: any): boolean;
     set network(network: any);
     get network(): any;
+    get ipAddresses(): Map<any, any>;
+    /**
+     *
+     * @param {object} filter
+     * @return {Iterable<NetworkAddress>}
+     */
+    networkAddresses(filter?: object): Iterable<NetworkAddress>;
     get rawAddress(): any;
     get rawIPv4Address(): any;
     get rawIPv6Address(): any;
     get cidrAddress(): any;
-    get ipAddresses(): Map<any, any>;
     get rawAddresses(): any[];
     get rawIPv4Addresses(): any[];
     get rawIPv6Addresses(): any[];
     get cidrAddresses(): any[];
 }
+import { Subnet } from "./subnet.mjs";
 import { Base } from "./base.mjs";
 export {};

package/types/owner.d.mts

@@ -155,7 +155,7 @@ export class Owner extends Base {
     addBridge(network: any, destinationNetworks: any): any;
     _resolveBridges(): void;
     get derivedPackaging(): Set<any>;
-    networkAddresses(): Generator<any, void, any>;
+    networkAddresses(filter: any): Generator<any, void, any>;
     _country: any;
     set country(value: any);
     get country(): any;