pmcf 4.7.0 → 4.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmcf",
-  "version": "4.7.0",
+  "version": "4.8.1",
   "publishConfig": {
     "access": "public"
   },

package/src/base.mjs

@@ -28,6 +28,8 @@ import { asArray } from "./utils.mjs";
 
 /**
  *
+ * attributes: essential values
+ * properties: use defined values to support attribute value definitions
  */
 export class Base {
   static name = "base";
@@ -367,49 +369,20 @@ export class Base {
     return this.constructor.typeDefinition.name;
   }
 
-  *_extendedPropertyIterator(propertyName, seen) {
-    if (!seen.has(this)) {
-      seen.add(this);
-
-      const value = getAttribute(this, propertyName);
+  /**
+   * 
+   * @param {string} name 
+   * @returns {any}
+   */
+  extendedAttribute(name) {
+    for (const node of this.walkDirections(["this", "extends"])) {
+      const value = getAttribute(node, name);
       if (value !== undefined) {
-        yield value;
-      } else {
-        const value = this._properties?.[propertyName];
-        if (value !== undefined) {
-          yield value;
-        }
-      }
-
-      for (const e of this.walkDirections(["extends"])) {
-        yield* e._extendedPropertyIterator(propertyName, seen);
-      }
-    }
-  }
-
-  _extendedProperty(propertyName, seen) {
-    if (!seen.has(this)) {
-      seen.add(this);
-      for (const e of this.walkDirections(["extends"])) {
-        const value =
-          getAttribute(e, propertyName) ??
-          e._extendedProperty(propertyName, seen);
-        if (value !== undefined) {
-          return value;
-        }
+        return this.expand(value);
       }
     }
   }
 
-  extendedProperty(propertyName) {
-    const value = getAttribute(this, propertyName);
-    if (value !== undefined) {
-      return value;
-    }
-
-    return this._extendedProperty(propertyName, new Set());
-  }
-
   /**
    * Retrive attribute values from an object.
    * @param {Function} [filter]
@@ -426,7 +399,7 @@ export class Base {
         filter
       )) {
         const name = path.join(".");
-        const value = this.extendedProperty(name);
+        const value = this.extendedAttribute(name);
 
         if (value !== undefined) {
           yield [def.externalName ?? name, toExternal(value, def), path, def];
@@ -616,7 +589,7 @@ export class Base {
   }
 
   getGlobal(a) {
-    return globals[a] ?? this.property(a);
+    return globals[a] ?? this.extendedAttribute(a) ?? this.property(a);
   }
 
   get properties() {

package/src/host.mjs

@@ -143,7 +143,7 @@ export class Host extends ServiceOwner {
   }
 
   get serial() {
-    return this.extendedProperty("_serial");
+    return this.extendedAttribute("_serial");
   }
 
   set deployment(value) {
@@ -151,7 +151,7 @@ export class Host extends ServiceOwner {
   }
 
   get deployment() {
-    return this.extendedProperty("_deployment");
+    return this.extendedAttribute("_deployment");
   }
 
   set chassis(value) {
@@ -159,7 +159,7 @@ export class Host extends ServiceOwner {
   }
 
   get chassis() {
-    return this.extendedProperty("_chassis");
+    return this.extendedAttribute("_chassis");
   }
 
   set vendor(value) {
@@ -167,7 +167,7 @@ export class Host extends ServiceOwner {
   }
 
   get vendor() {
-    return this.extendedProperty("_vendor");
+    return this.extendedAttribute("_vendor");
   }
 
   set keymap(value) {
@@ -175,7 +175,7 @@ export class Host extends ServiceOwner {
   }
 
   get keymap() {
-    return this.extendedProperty("_keymap");
+    return this.extendedAttribute("_keymap");
   }
 
   set architecture(value) {
@@ -183,7 +183,7 @@ export class Host extends ServiceOwner {
   }
 
   get architecture() {
-    return this.extendedProperty("_architecture");
+    return this.extendedAttribute("_architecture");
   }
 
   get derivedPackaging() {
@@ -261,7 +261,7 @@ export class Host extends ServiceOwner {
   }
 
   get os() {
-    return this.extendedProperty("_os");
+    return this.extendedAttribute("_os");
   }
 
   set distribution(value) {
@@ -269,7 +269,7 @@ export class Host extends ServiceOwner {
   }
 
   get distribution() {
-    return this.extendedProperty("_distribution");
+    return this.extendedAttribute("_distribution");
   }
 
   get modelName() {

package/src/network-interfaces/network-interface.mjs

@@ -126,7 +126,7 @@ export class NetworkInterface extends SkeletonNetworkInterface {
   }
 
   get hostName() {
-    return this.extendedProperty("_hostName") ?? this.host.hostName;
+    return this.extendedAttribute("_hostName") ?? this.host.hostName;
   }
 
   set hostName(value) {
@@ -147,7 +147,7 @@ export class NetworkInterface extends SkeletonNetworkInterface {
 
   get scope() {
     return (
-      this.extendedProperty("_scope") ??
+      this.extendedAttribute("_scope") ??
       this.network?.scope ??
       networkAttributes.scope.default
     );
@@ -158,7 +158,7 @@ export class NetworkInterface extends SkeletonNetworkInterface {
   }
 
   get hwaddr() {
-    return this.extendedProperty("_hwaddr");
+    return this.extendedAttribute("_hwaddr");
   }
 
   set metric(value) {
@@ -167,7 +167,7 @@ export class NetworkInterface extends SkeletonNetworkInterface {
 
   get metric() {
     return (
-      this.extendedProperty("_metric") ??
+      this.extendedAttribute("_metric") ??
       this.network?.metric ??
       networkAttributes.metric.default
     );
@@ -178,7 +178,7 @@ export class NetworkInterface extends SkeletonNetworkInterface {
   }
 
   get mtu() {
-    return this.extendedProperty("_mtu"); // ?? networkAttributes.mtu.default;
+    return this.extendedAttribute("_mtu"); // ?? networkAttributes.mtu.default;
   }
 
   set class(value) {
@@ -186,7 +186,7 @@ export class NetworkInterface extends SkeletonNetworkInterface {
   }
 
   get class() {
-    return this.extendedProperty("_class") ?? this.network?.class;
+    return this.extendedAttribute("_class") ?? this.network?.class;
   }
 
   set kind(value) {
@@ -194,7 +194,7 @@ export class NetworkInterface extends SkeletonNetworkInterface {
   }
 
   get kind() {
-    return this.extendedProperty("_kind") ?? this.network?.kind;
+    return this.extendedAttribute("_kind") ?? this.network?.kind;
   }
 
   async systemdDefinitions(packageData) {

package/src/network-interfaces/skeleton.mjs

@@ -52,7 +52,7 @@ export class SkeletonNetworkInterface extends ServiceOwner {
   }
 
   get network() {
-    return this.extendedProperty("_network") ?? this.host?.network;
+    return this.extendedAttribute("_network") ?? this.host?.network;
   }
 
   set network(network) {

package/src/network-interfaces/wlan.mjs

@@ -52,7 +52,7 @@ export class WLANNetworkInterface extends EthernetNetworkInterface {
 
   get secretName() {
     return (
-      this.extendedProperty("_secretName") ??
+      this.extendedAttribute("_secretName") ??
       this.network?.secretName ??
       `${this.network.name}.password`
     );
@@ -63,7 +63,7 @@ export class WLANNetworkInterface extends EthernetNetworkInterface {
   }
 
   get ssid() {
-    return this.extendedProperty("_ssid") ?? this.network?.ssid;
+    return this.extendedAttribute("_ssid") ?? this.network?.ssid;
   }
 
   set psk(value) {
@@ -71,7 +71,7 @@ export class WLANNetworkInterface extends EthernetNetworkInterface {
   }
 
   get psk() {
-    return this.extendedProperty("_psk") ?? this.network?.psk;
+    return this.extendedAttribute("_psk") ?? this.network?.psk;
   }
 
   async systemdDefinitions(packageData) {

package/src/service.mjs

@@ -218,7 +218,7 @@ export class Service extends Base {
   }
 
   get alias() {
-    return this.extendedProperty("_alias");
+    return this.extendedAttribute("_alias");
   }
 
   set port(value) {
@@ -234,7 +234,7 @@ export class Service extends Base {
   }
 
   get weight() {
-    return this.extendedProperty("_weight") ?? this.owner.weight ?? 1;
+    return this.extendedAttribute("_weight") ?? this.owner.weight ?? 1;
   }
 
   set type(value) {
@@ -251,7 +251,7 @@ export class Service extends Base {
 
   get systemdService() {
     return (
-      this.extendedProperty("_systemdService") ??
+      this.extendedAttribute("_systemdService") ??
       ServiceTypes[this.type]?.systemdService
     );
   }

package/src/services/openldap.mjs

@@ -68,7 +68,7 @@ export class OpenLDAPService extends Service {
   }
 
   get base() {
-    return this.expand(this._base);
+    return this.extendedAttribute("_base");
   }
 
   set base(value) {
@@ -76,7 +76,7 @@ export class OpenLDAPService extends Service {
   }
 
   get uri() {
-    return this._uri;
+    return this.extendedAttribute("_uri");
   }
 
   set uri(value) {

package/types/base.d.mts

@@ -1,6 +1,8 @@
 export function extractFrom(object: any, typeDefinition?: any): any;
 /**
  *
+ * attributes: essential values
+ * properties: use defined values to support attribute value definitions
  */
 export class Base {
     static name: string;
@@ -66,9 +68,12 @@ export class Base {
     isNamed(name: any): boolean;
     relativeName(name: any): any;
     get typeName(): any;
-    _extendedPropertyIterator(propertyName: any, seen: any): Generator<any, void, any>;
-    _extendedProperty(propertyName: any, seen: any): any;
-    extendedProperty(propertyName: any): any;
+    /**
+     *
+     * @param {string} name
+     * @returns {any}
+     */
+    extendedAttribute(name: string): any;
     /**
      * Retrive attribute values from an object.
      * @param {Function} [filter]