valve/src/nodeClass.js

/**
 * Encapsulates all node logic in a reusable class. In future updates we can split this into multiple generic classes and use the config to specifiy which ones to use.
 * This allows us to keep the Node-RED node clean and focused on wiring up the UI and event handlers.
 */
const { outputUtils, configManager } = require('generalFunctions');
const Specific = require("./specificClass");


class nodeClass {
  /**
   * Create a MeasurementNode.
   * @param {object} uiConfig - Node-RED node configuration.
   * @param {object} RED    - Node-RED runtime API.
   * @param {object} nodeInstance - The Node-RED node instance.
   * @param {string} nameOfNode - The name of the node, used for
   */
  constructor(uiConfig, RED, nodeInstance, nameOfNode) {

    // Preserve RED reference for HTTP endpoints if needed
    this.node = nodeInstance;
    this.RED = RED;
    this.name = nameOfNode;
    this.source = null; // Will hold the specific class instance
    this.config = null; // Will hold the merged configuration

    // Load default & UI config
    this._loadConfig(uiConfig,this.node);

    // Instantiate core Measurement class
    this._setupSpecificClass(uiConfig);

    // Wire up event and lifecycle handlers
    this._bindEvents();
    this._registerChild();
    this._startTickLoop();
    this._attachInputHandler();
    this._attachCloseHandler();
  }

  /**
   * Load and merge default config with user-defined settings.
   * @param {object} uiConfig - Raw config from Node-RED UI.
   */
  _loadConfig(uiConfig,node) {

    // Merge UI config over defaults
    this.config = {
      general: {
        name: uiConfig.name,
        id: node.id, // node.id is for the child registration process
        unit: uiConfig.unit, // add converter options later to convert to default units (need like a model that defines this which units we are going to use and then conver to those standards)
        logging: {
          enabled: uiConfig.enableLog,
          logLevel: uiConfig.logLevel
        }
      },
      asset: {
        uuid: uiConfig.assetUuid, //need to add this later to the asset model
        tagCode: uiConfig.assetTagCode, //need to add this later to the asset model
        supplier: uiConfig.supplier,
        category: uiConfig.category, //add later to define as the software type 
        type: uiConfig.assetType,
        model: uiConfig.model,
        unit: uiConfig.unit
      },
      functionality: {
        positionVsParent: uiConfig.positionVsParent || 'atEquipment', // Default to 'atEquipment' if not specified
      }
    };

    // Utility for formatting outputs
    this._output = new outputUtils();
  }

  /**
   * Instantiate the core logic and store as source.
   */
  _setupSpecificClass(uiConfig) {
    const vconfig = this.config;

    // need extra state for this
    const stateConfig = {
        general: {
          logging: {
            enabled: vconfig.eneableLog,
            logLevel: vconfig.logLevel
          }
        },
        movement: {
          speed: Number(uiConfig.speed)
        },
        time: {
          starting: Number(uiConfig.startup),
          warmingup: Number(uiConfig.warmup),
          stopping: Number(uiConfig.shutdown),
          coolingdown: Number(uiConfig.cooldown)
        }
      };

    this.source = new Specific(vconfig, stateConfig);

    //store in node 
    this.node.source = this.source; // Store the source in the node instance for easy access
  
  }

  /**
   * Bind Measurement events to Node-RED status updates. Using internal emitter. --> REMOVE LATER WE NEED ONLY COMPLETE CHILDS AND THEN CHECK FOR UPDATES
   */
  _bindEvents() {

  }

  _updateNodeStatus() {
    const v = this.source;

        try {
          const mode = v.currentMode; // modus is bijv. auto, manual, etc.
          const state = v.state.getCurrentState(); //is bijv. operational, idle, off, etc.
          // check if measured flow is available otherwise use predicted flow
          const flow = Math.round(v.measurements.type("flow").variant("predicted").position("downstream").getCurrentValue());

          let deltaP = v.measurements.type("pressure").variant("predicted").position("delta").getCurrentValue();
          if (deltaP !== null) {
            deltaP = parseFloat(deltaP.toFixed(0));
          } //afronden op 4 decimalen indien geen "null"  
          if(isNaN(deltaP)) {
            deltaP = "∞";
          }      
          const roundedPosition = Math.round(v.state.getCurrentPosition() * 100) / 100;
          let symbolState;
          switch(state){
            case "off":
              symbolState = "⬛";
              break;
            case "idle":
              symbolState = "⏸️";
              break;
            case "operational":
              symbolState = "⏵️";
              break;
            case "starting":
              symbolState = "⏯️";
              break;
            case "warmingup":
              symbolState = "🔄";
              break;
            case "accelerating":
              symbolState = "⏩";
              break;
            case "stopping":
              symbolState = "⏹️";
              break;
            case "coolingdown":
              symbolState = "❄️";
              break;
            case "decelerating":
              symbolState = "⏪";
              break;
          }
         

          let status;
          switch (state) {
            case "off":
              status = { fill: "red", shape: "dot", text: `${mode}: OFF` };
              break;
            case "idle":
              status = { fill: "blue", shape: "dot", text: `${mode}: ${symbolState}` };
              break;
            case "operational":
                status = { fill: "green", shape: "dot", text: `${mode}: ${symbolState} | ${roundedPosition}% | 💨${flow}m³/h | ΔP${deltaP} mbar`}; //deltaP toegevoegd
              break;
            case "starting":
              status = { fill: "yellow", shape: "dot", text: `${mode}: ${symbolState}` };
              break;
            case "warmingup":
              status = { fill: "green", shape: "dot", text: `${mode}: ${symbolState} | ${roundedPosition}% | 💨${flow}m³/h | ΔP${deltaP} mbar`}; //deltaP toegevoegd
              break;
            case "accelerating":
                status = { fill: "yellow", shape: "dot", text: `${mode}: ${symbolState} | ${roundedPosition}% | 💨${flow}m³/h | ΔP${deltaP} mbar` }; //deltaP toegevoegd
              break;
            case "stopping":
              status = { fill: "yellow", shape: "dot", text: `${mode}: ${symbolState}` };
              break;
            case "coolingdown":
              status = { fill: "yellow", shape: "dot", text: `${mode}: ${symbolState}` };
              break;
            case "decelerating":
              status = { fill: "yellow", shape: "dot", text: `${mode}: ${symbolState} - ${roundedPosition}% | 💨${flow}m³/h | ΔP${deltaP} mbar`}; //deltaP toegevoegd
              break;
            default:
              status = { fill: "grey", shape: "dot", text: `${mode}: ${symbolState}` };
          }
          return status;
        } catch (error) {
          node.error("Error in updateNodeStatus: " + error.message);
          return { fill: "red", shape: "ring", text: "Status Error" };
        }
      }

  /**
   * Register this node as a child upstream and downstream.
   * Delayed to avoid Node-RED startup race conditions.
   */
  _registerChild() {
    setTimeout(() => {
      this.node.send([
        null,
        null,
        { topic: 'registerChild', payload: this.node.id , positionVsParent: this.config?.functionality?.positionVsParent || 'atEquipment' },
      ]);
    }, 100);
  }

  /**
   * Start the periodic tick loop.
   */
  _startTickLoop() {
    setTimeout(() => {
      this._tickInterval = setInterval(() => this._tick(), 1000);

      // Update node status on nodered screen every second ( this is not the best way to do this, but it works for now)
      this._statusInterval = setInterval(() => {
        const status = this._updateNodeStatus();
        this.node.status(status);
      }, 1000);

    }, 1000);
  }

  /**
   * Execute a single tick: update measurement, format and send outputs.
   */
  _tick() {
    //this.source.tick();

    const raw = this.source.getOutput();
    const processMsg = this._output.formatMsg(raw, this.config, 'process');
    const influxMsg  = this._output.formatMsg(raw, this.config, 'influxdb');

    // Send only updated outputs on ports 0 & 1
    this.node.send([processMsg, influxMsg]);
  }

  /**
   * Attach the node's input handler, routing control messages to the class.
   */
  _attachInputHandler() {
    this.node.on('input', (msg, send, done) => {
    const v = this.source;
    switch(msg.topic) {
      case 'registerChild':
        const childId = msg.payload;
        const childObj = this.RED.nodes.getNode(childId); 
        v.childRegistrationUtils.registerChild(childObj.source ,msg.positionVsParent);
        break;
      case 'setMode':
        v.setMode(msg.payload);
        break;
      case 'execSequence':
        const { source: seqSource, action: seqAction, parameter } = msg.payload;
        v.handleInput(seqSource, seqAction, parameter);
        break;
      case 'execMovement':
        const { source: mvSource, action: mvAction, setpoint } = msg.payload;
        v.handleInput(mvSource, mvAction, Number(setpoint));
        break;
      case 'emergencystop':
        const { source: esSource, action: esAction } = msg.payload;
        v.handleInput(esSource, esAction);
        break;
      case 'showcurve':
        v.showCurve();
        send({ topic : "Showing curve" , payload: v.showCurve() });
        break;
      case 'updateFlow': //Als nieuwe flow van header node dan moet deltaP weer opnieuw worden berekend en doorgegeven aan header node
        v.updateFlow(msg.payload.variant, msg.payload.value, msg.payload.position);
      }
      done();
    });
  }

  /**
   * Clean up timers and intervals when Node-RED stops the node.
   */
  _attachCloseHandler() {
    this.node.on('close', (done) => {
      clearInterval(this._tickInterval);
      clearInterval(this._statusInterval);
      done();
    });
  }
}

module.exports = nodeClass;