Add flows:* events and deprecate nodes-* events

packages/node_modules/@node-red/runtime/lib/events.js

@@ -14,9 +14,34 @@
  * limitations under the License.
  **/
 
-var events = require("events");
+const events = new (require("events")).EventEmitter();
 
-module.exports = new events.EventEmitter();
+
+const deprecatedEvents = {
+    "nodes-stopped": "flows:stopped",
+    "nodes-started": "flows:started"
+}
+
+function wrapEventFunction(obj,func) {
+    events["_"+func] = events[func];
+    return function(eventName, listener) {
+        if (deprecatedEvents.hasOwnProperty(eventName)) {
+            const log = require("@node-red/util").log;
+            const stack = (new Error().stack).split("\n")[2].split("(")[1].slice(0,-1);
+            log.warn(`[RED.events] Deprecated use of "${eventName}" event from "${stack}". Use "${deprecatedEvents[eventName]}" instead.`)
+        }
+        return events["_"+func].call(events,eventName,listener)
+    }
+}
+
+
+events.on = wrapEventFunction(events,"on");
+events.once = wrapEventFunction(events,"once");
+events.addListener = events.on;
+
+
+
+module.exports = events;
 
 /**
  * Runtime events emitter

packages/node_modules/@node-red/runtime/lib/flows/index.js

@@ -28,6 +28,7 @@ var flowUtil = require("./util");
 var log;
 var events = require("../events");
 var redUtil = require("@node-red/util").util;
+const hooks = require("../hooks");
 
 var storage = null;
 var settings = null;
@@ -292,6 +293,8 @@ function start(type,diff,muteLog) {
         }
     }
 
+    events.emit("flows:starting", {config: activeConfig, type: type, diff: diff})
+
     var id;
     if (type === "full") {
         // A full start means everything should
@@ -352,6 +355,8 @@ function start(type,diff,muteLog) {
             }
         }
     }
+    events.emit("flows:started", {config: activeConfig, type: type, diff: diff});
+    // Deprecated event
     events.emit("nodes-started");
 
     if (credentialsPendingReset === true) {
@@ -399,6 +404,8 @@ function stop(type,diff,muteLog) {
         stopList = diff.changed.concat(diff.removed).concat(diff.linked);
     }
 
+    events.emit("flows:stopping",{config: activeConfig, type: type, diff: diff})
+
     for (var id in activeFlows) {
         if (activeFlows.hasOwnProperty(id)) {
             var flowStateChanged = diff && (diff.added.indexOf(id) !== -1 || diff.removed.indexOf(id) !== -1);
@@ -430,6 +437,8 @@ function stop(type,diff,muteLog) {
                 log.info(log._("nodes.flows.stopped-flows"));
             }
         }
+        events.emit("flows:stopped",{config: activeConfig, type: type, diff: diff});
+        // Deprecated event
         events.emit("nodes-stopped");
     });
 }