@theotherwillembotha/node-red-plugincore 0.1.0 → 0.2.0

package/build/core/NodeConstructor.js

@@ -3,14 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildNode = exports.NodeBuilder = exports.BaseService = exports.NodeManager = exports.Template = exports.ServiceDescriptor = exports.TemplateDescriptor = exports.NodeDescriptor = exports.ConfigNode = exports.BaseNode = void 0;
+exports.buildNodeBuilder = exports.buildNode = exports.NodeBuilder = exports.BaseService = exports.Template = exports.ServiceDescriptor = exports.TemplateDescriptor = exports.NodeDescriptor = exports.ConfigNode = exports.BaseNode = exports.NodeManager = exports.runPostConstructInitializers = exports.POST_CONSTRUCT_KEY = exports.NODEMANAGER_API_VERSION = void 0;
 exports.createPostConstructDecorator = createPostConstructDecorator;
 require("reflect-metadata");
-const jsdom_1 = __importDefault(require("jsdom"));
 const fs_1 = __importDefault(require("fs"));
-const js_beautify_1 = __importDefault(require("js-beautify"));
-const markdown_it_1 = __importDefault(require("markdown-it"));
-const handlebars_1 = __importDefault(require("handlebars"));
+const NodeManagerRuntime_1 = require("./NodeManagerRuntime");
+Object.defineProperty(exports, "NODEMANAGER_API_VERSION", { enumerable: true, get: function () { return NodeManagerRuntime_1.NODEMANAGER_API_VERSION; } });
+Object.defineProperty(exports, "POST_CONSTRUCT_KEY", { enumerable: true, get: function () { return NodeManagerRuntime_1.POST_CONSTRUCT_KEY; } });
+Object.defineProperty(exports, "runPostConstructInitializers", { enumerable: true, get: function () { return NodeManagerRuntime_1.runPostConstructInitializers; } });
+Object.defineProperty(exports, "NodeManager", { enumerable: true, get: function () { return NodeManagerRuntime_1.NodeManager; } });
 class BaseNode {
     node() { return this._node; }
     config() { return this._config; }
@@ -135,7 +136,6 @@ class Template {
     }
 }
 exports.Template = Template;
-const POST_CONSTRUCT_KEY = Symbol('postConstructInitializers');
 // Builder class for post-construct decorators
 class PostConstructDecoratorBuilder {
     constructor(decoratorName) {
@@ -201,10 +201,10 @@ class PostConstructDecoratorBuilder {
                                 `  Issue: Method returned a value (${typeof result}) but should return void or Promise<void>.`);
                         }
                     };
-                    if (!target[POST_CONSTRUCT_KEY]) {
-                        target[POST_CONSTRUCT_KEY] = [];
+                    if (!target[NodeManagerRuntime_1.POST_CONSTRUCT_KEY]) {
+                        target[NodeManagerRuntime_1.POST_CONSTRUCT_KEY] = [];
                     }
-                    target[POST_CONSTRUCT_KEY].push((instance) => {
+                    target[NodeManagerRuntime_1.POST_CONSTRUCT_KEY].push((instance) => {
                         if (initLogic) {
                             try {
                                 initLogic(instance, propertyKey, config);
@@ -245,117 +245,6 @@ class PostConstructDecoratorBuilder {
 function createPostConstructDecorator(decoratorName) {
     return new PostConstructDecoratorBuilder(decoratorName);
 }
-// Single function to run all post-construct initializers
-let runPostConstructInitializers = function (instance) {
-    const initializers = instance[POST_CONSTRUCT_KEY];
-    if (initializers && initializers.length > 0) {
-        const className = instance.constructor.name;
-        //console.log(`Running ${initializers.length} post-construct initializers for ${className}`);
-        initializers.forEach((init, index) => {
-            try {
-                init(instance);
-            }
-            catch (error) {
-                console.error(`Post-construct initialization failed:\n` +
-                    `  Class: ${className}\n` +
-                    `  Initializer: ${index + 1}/${initializers.length}\n` +
-                    `  Error: ${error instanceof Error ? error.message : String(error)}`);
-                throw error;
-            }
-        });
-        // Clear the initializers after running
-        delete instance[POST_CONSTRUCT_KEY];
-    }
-};
-// ************************************************
-class NodeManager {
-    static { this.PLUGINID = "node-red-contrib-theotherwillembotha/services-plugin"; }
-    constructor(RED) {
-        this.typeBacklog = [];
-        NodeManager._RED = RED;
-        let nodeTypeServiceListener = async (pluginID) => {
-            if (pluginID === "@theotherwillembotha/nodetypeservice") {
-                // disable the listener- the plugin has been installed.
-                RED.events.off('plugin.instantiated', nodeTypeServiceListener);
-                // get a handle on the NodeTypeService
-                let plugin = RED.plugins.get("@theotherwillembotha/nodetypeservice");
-                this.nodeTypeService = RED.plugins.get("@theotherwillembotha/nodetypeservice").instance;
-                // process the backlog.
-                for (let nodeType of this.typeBacklog) {
-                    for (let tag of nodeType.getNodeDescriptor().tags()) {
-                        this.nodeTypeService.registerNodeType(tag, nodeType);
-                    }
-                }
-            }
-        };
-        // check if the reverserproxyttypesewrvice is installed yet.
-        this.nodeTypeService = RED.plugins.get("@theotherwillembotha/nodetypeservice").instance;
-        if (!this.nodeTypeService) {
-            RED.events.on('plugin.instantiated', nodeTypeServiceListener);
-        }
-    }
-    static get RED() {
-        return NodeManager._RED;
-    }
-    registerService(type) {
-        let servicePlugin = NodeManager.RED.plugins.get(NodeManager.PLUGINID);
-        if (servicePlugin) {
-            servicePlugin.instance.install(NodeManager.RED, type);
-        }
-        else {
-            let serviceName = `${type.getServiceDescriptor().sourceFile()}.${type.getServiceDescriptor().name()}`;
-            console.log(`ERROR: plugin ${NodeManager.PLUGINID} does not seem to be loaded. Cannot start service: ${serviceName}`);
-        }
-        return this;
-    }
-    registerNodeType(typeName, type) {
-        if (!type) {
-            console.error(`Type "${typeName}" has no associated type. Make sure that it was exported and included in the index.js file!`);
-        }
-        let nodeConstructor = function (config) {
-            //console.log("constructing node", typeName);
-            try {
-                // instantiate the node.
-                NodeManager.RED.nodes.createNode(this, config);
-                // assign an instance of it to the config.
-                //(config as any).__node = this;
-                // instatiate the actual node.
-                let node = new type(this, config);
-                //this.__node = node;
-                // run the constructor initializers.
-                runPostConstructInitializers(node);
-                // after the node has been instantiated, attempt to invole the onInit method.
-                if (node.onInit) {
-                    node.onInit();
-                }
-            }
-            catch (error) {
-                console.log(error);
-                console.log("typeName:", typeName);
-                console.log("type:", type);
-                console.log("config:", config);
-            }
-        };
-        try {
-            NodeManager.RED.nodes.registerType(typeName, nodeConstructor, { settings: {} });
-            let nodeDescription = type.getNodeDescriptor();
-            // registger the node tags.
-            if (this.nodeTypeService) {
-                for (let tag of nodeDescription.tags()) {
-                    this.nodeTypeService.registerNodeType(tag, type);
-                }
-            }
-            else {
-                this.typeBacklog.push(type);
-            }
-        }
-        catch (error) {
-            console.error("registering node: " + typeName + " failed", error);
-        }
-        return this;
-    }
-}
-exports.NodeManager = NodeManager;
 class BaseService {
     constructor(name) {
         this._name = name;
@@ -371,23 +260,26 @@ class BaseService {
     }
 }
 exports.BaseService = BaseService;
-const { JSDOM } = jsdom_1.default;
-const md = (0, markdown_it_1.default)({
-    html: true,
-    linkify: true,
-    typographer: true
-});
-// Custom renderer for headings
-md.renderer.rules.heading_open = function (tokens, idx, options, env, self) {
-    const token = tokens[idx];
-    const level = token.tag.substring(1); // 'h1', 'h2', etc. -> '1', '2'
-    return `<h${level} class="custom-heading">`;
-};
-md.renderer.rules.heading_close = function (tokens, idx, options, env, self) {
-    const token = tokens[idx];
-    const level = token.tag.substring(1);
-    return `</h${level}>`;
-};
+// Build-time deps - lazy loaded so they are never required at runtime in production bundles.
+// These are only invoked during `npm run build` (GenerateNodes), never in the deployed container.
+function getJSDOM() { return require('jsdom').JSDOM; }
+function getBeautify() { return require('js-beautify'); }
+function getHandlebars() { return require('handlebars'); }
+let _md = null;
+function getMd() {
+    if (!_md) {
+        _md = require('markdown-it')({ html: true, linkify: true, typographer: true });
+        _md.renderer.rules.heading_open = (tokens, idx) => {
+            const level = tokens[idx].tag.substring(1);
+            return `<h${level} class="custom-heading">`;
+        };
+        _md.renderer.rules.heading_close = (tokens, idx) => {
+            const level = tokens[idx].tag.substring(1);
+            return `</h${level}>`;
+        };
+    }
+    return _md;
+}
 let beautifyOptions = {
     "indent_size": 4,
     "preserve-newlines": false,
@@ -423,7 +315,7 @@ class NodeBuilder {
         this._category = category;
     }
     addDefault(name, template) {
-        // if list:true, this is an array of config references — generate shadow defaults for each slot.
+        // if list:true, this is an array of config references - generate shadow defaults for each slot.
         if (template.list === true) {
             template.maxInstances = template.maxInstances ? template.maxInstances : 10;
             this._defaults[name] = { value: "", required: (template.required) ? template.required : false, maxInstances: template.maxInstances };
@@ -466,8 +358,9 @@ class NodeBuilder {
     }
     addTemplate(template) {
         let templateDescriptor = template.template.getTemplateDescriptor();
+        let templateConfig = template.config;
         // load the html source file
-        let uiDom = new JSDOM(fs_1.default.readFileSync(templateDescriptor.templateFile()));
+        let uiDom = new (getJSDOM())(fs_1.default.readFileSync(templateDescriptor.templateFile()));
         // apply the onCompose section if available.
         let onCompose = uiDom.window.document.querySelector("script[template-section='onCompose']")?.innerHTML;
         if (onCompose) {
@@ -478,6 +371,14 @@ class NodeBuilder {
         Object.values(sections).forEach(section => {
             let sectionData = uiDom.window.document.querySelector(`[template-section='on${section}']`)?.innerHTML;
             if (sectionData) {
+                if (section !== "IncludeOnce" && section !== "IncludeEditForm" && section !== "IncludeDocumentation") {
+                    // add the packageing around the sectionData
+                    sectionData = `{
+                        let node = this;
+                        let templateConfig = ${JSON.stringify(templateConfig)};
+                        ${sectionData}
+                    }`;
+                }
                 this[`add${section}`](templateDescriptor.name(), sectionData);
             }
         });
@@ -511,6 +412,63 @@ class NodeBuilder {
         this._onIncludeDocumentation.push({ source: source, script: script });
         return this;
     }
+    buildOnceHtml() {
+        return this._onIncludeOnce.map(entry => ({
+            source: entry.source,
+            html: this.serializeHTML(entry.source, entry.script)
+        }));
+    }
+    buildDeferredType() {
+        // Apply shadow defaults (same side-effect as buildType)
+        let shaddowDefaults = Object.entries(this._defaults).filter(([name, template]) => template.type && template.type.endsWith("[]"));
+        if (shaddowDefaults.length > 0) {
+            this.addIncludeEditSave(this._name + "_shaddowDefaults", `{ let node = this; ` +
+                shaddowDefaults
+                    .map(([name, template]) => `
+                    for(let i = 0; i < ${template.maxInstances}; i++){
+                        node["_${name}_" + i] = (node.${name}[i] || {}).proxy || "";
+                    }`)
+                    .join("\n\n") +
+                `}`);
+        }
+        const registerTypeBody = `{
+            category: '${this._category}',
+            ${(this._category !== "config" && this._icon) ? `icon: '${this._icon}',` : ""}
+            ${(this._category !== "config" && this._color) ? `color: '${this._color}',` : ""}
+            ${(this._category !== "config" && this._labelStyle) ? `labelStyle: '${this._labelStyle}',` : ""}
+            ${(this._label) ? `label: ${this._label},` : ""}
+            ${this._paletteLabel ? `paletteLabel: '${this._paletteLabel}',` : ""}
+            ${(this._category !== "config") ? `inputs:${this._inputs ? "1" : "0"},` : ""}
+            ${(this._category !== "config") ? `inputLabels:(i) => '${this._inputs}',` : ""}
+            ${(this._category !== "config") ? `outputs:${this._outputs.length},` : ""}
+            ${(this._category !== "config") ? `outputLabels:(i) => ${this.serializeProperty(this._outputs)}[i],` : ""}
+            defaults: {
+                ${Object.entries(this._defaults).map(([key, value]) => this.serializeDefault(key, value)).join("\n")}
+            },
+            oneditprepare: function() {
+                ${this._onIncludeEditPrepare.map(entry => this.serializeJavaScript(entry.source, entry.script)).join("")}
+            },
+            oneditsave: function() {
+                ${this._onIncludeEditSave.map(entry => this.serializeJavaScript(entry.source, entry.script)).join("")}
+            },
+            oneditcancel: function() {
+                ${this._onIncludeEditCancel.map(entry => this.serializeJavaScript(entry.source, entry.script)).join("")}
+            },
+            oneditdelete: function() {
+                ${this._onIncludeEditDelete.map(entry => this.serializeJavaScript(entry.source, entry.script)).join("")}
+            },
+        }`;
+        return getBeautify().html_beautify(`
+        <script type="text/javascript">
+        (function () {
+            RED.events.on('registry:node-set-added', function (ns) {
+                if (ns.types && ns.types.indexOf('${this._name}') !== -1) {
+                    RED.nodes.registerType('${this._name}', ${registerTypeBody});
+                }
+            });
+        }());
+        </script>`, beautifyOptions);
+    }
     serializeProperty(value) {
         switch (typeof value) {
             case "boolean": {
@@ -540,7 +498,7 @@ class NodeBuilder {
                 : Object.fromEntries(Object.keys(this._defaults).map(k => [k, `node-input-${k}`]))
         };
         return `<!-- ${source} -->
-        ${handlebars_1.default.compile(script)(context)}
+        ${getHandlebars().compile(script)(context)}
         `;
     }
     serializeJavaScript(source, script) {
@@ -549,7 +507,7 @@ class NodeBuilder {
                 ? Object.fromEntries(Object.keys(this._defaults).map(k => [k, `node-config-input-${k}`]))
                 : Object.fromEntries(Object.keys(this._defaults).map(k => [k, `node-input-${k}`]))
         };
-        let serialized = handlebars_1.default.compile(script)(context).trim();
+        let serialized = getHandlebars().compile(script)(context).trim();
         if (!serialized.startsWith("{") && !serialized.endsWith("}")) {
             serialized = "{\n" + serialized + "\n}";
         }
@@ -564,7 +522,7 @@ class NodeBuilder {
                 : Object.fromEntries(Object.keys(this._defaults).map(k => [k, `node-input-${k}`]))
         };
         return `
-            <div id='section_${source}'>${handlebars_1.default.compile(script)(context)}
+            <div id='section_${source}'>${getHandlebars().compile(script)(context)}
             </div>
         `;
     }
@@ -587,7 +545,7 @@ class NodeBuilder {
                     .join("\n\n") +
                 `}`);
         }
-        return js_beautify_1.default.html_beautify(`
+        return getBeautify().html_beautify(`
         ${this._onIncludeOnce.map(entry => this.serializeHTML(entry.source, entry.script)).join("")}
         <script type="text/javascript">
             RED.nodes.registerType('${this._name}',{      
@@ -621,7 +579,7 @@ class NodeBuilder {
     }
     ;
     buildHtml() {
-        return js_beautify_1.default.html_beautify(`
+        return getBeautify().html_beautify(`
         <script type="text/html" data-template-name='${this._name}'>
             ${this._onIncludeEditForm.map(entry => this.serializeFormEntry(entry.source, entry.script)).join("")}
         </script>
@@ -651,12 +609,12 @@ let evalInContext = (context, js) => {
         throw error;
     }
 };
-let buildNode = function (node) {
+let buildNodeBuilder = function (node) {
     // get the node descriptor and create the builder.
     let nodeDescriptor = node.getNodeDescriptor();
     let nodeBuilder = new NodeBuilder(nodeDescriptor.id(), nodeDescriptor.group());
     // load the html source file
-    let uiDom = new JSDOM(fs_1.default.readFileSync(nodeDescriptor.sourceFile()));
+    let uiDom = new (getJSDOM())(fs_1.default.readFileSync(nodeDescriptor.sourceFile()));
     // apply the onCompose section if available.
     let onCompose = uiDom.window.document.querySelector("script[template-section='onCompose']")?.innerHTML;
     if (onCompose) {
@@ -672,6 +630,11 @@ let buildNode = function (node) {
     });
     // add some of the dependencies here.
     nodeDescriptor.templates().forEach(template => nodeBuilder.addTemplate(template));
+    return nodeBuilder;
+};
+exports.buildNodeBuilder = buildNodeBuilder;
+let buildNode = function (node) {
+    let nodeBuilder = buildNodeBuilder(node);
     return [nodeBuilder.buildType(), nodeBuilder.buildHtml(), nodeBuilder.buildDocumentation()].join("\n\n");
 };
 exports.buildNode = buildNode;

package/build/core/NodeGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeGenerator.d.ts","sourceRoot":"","sources":["../../src/core/NodeGenerator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,QAAQ,EAAE,cAAc,EAAe,iBAAiB,EAA4B,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAIrJ,MAAM,WAAW,cAAc;IAC3B,QAAQ,QAAQ,CAAC;IACjB,qBAAqB,IAAI,kBAAkB,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IACvB,iBAAiB,IAAG,cAAc,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC1B,oBAAoB,IAAG,iBAAiB,CAAC;CAC5C;AAED,cAAM,aAAa;IAEf,OAAO,CAAC,MAAM,CAAC,WAAW,CAAM;IAChC,OAAO,CAAC,MAAM,CAAC,OAAO,CAKpB;IAEF,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,MAAM,CAA4E;IAC1F,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,UAAU,CAA2B;gBAE1B,UAAU,EAAC,MAAM;IAIpC,OAAO,CAAC,aAAa;IAmBd,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa;IAiBzD,YAAY,CAAC,IAAI,EAAC,UAAU,GAAE,aAAa;IAiB3C,eAAe,CAAC,OAAO,EAAE,aAAa,GAAE,aAAa;IAerD,QAAQ,CAAC,eAAe,EAAC,MAAM,EAAE,iBAAiB,EAAC,MAAM;IAyIhE,OAAO,CAAC,MAAM,CAAC,cAAc;CAQhC;AAID,OAAO,EACH,aAAa,EAChB,CAAA;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAC,MAAM,CAAC;CACf;AAmCD,qBAAa,aAAa;WAER,aAAa,CAAC,SAAS,EAAC,MAAM,EAAE,UAAU,EAAC,MAAM,GAAE,MAAM;CA2B1E;AAED,MAAM,MAAM,OAAO,GAAG;IAClB,CAAC,GAAG,EAAC,MAAM,GAAE,GAAG,CAAC;CACpB,CAAA"}
+{"version":3,"file":"NodeGenerator.d.ts","sourceRoot":"","sources":["../../src/core/NodeGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,EAA+B,QAAQ,EAAE,cAAc,EAAe,iBAAiB,EAA4B,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAIvK,MAAM,WAAW,cAAc;IAC3B,QAAQ,QAAQ,CAAC;IACjB,qBAAqB,IAAI,kBAAkB,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IACvB,iBAAiB,IAAG,cAAc,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC1B,oBAAoB,IAAG,iBAAiB,CAAC;CAC5C;AAED,cAAM,aAAa;IAEf,OAAO,CAAC,MAAM,CAAC,WAAW,CAAM;IAChC,OAAO,CAAC,MAAM,CAAC,OAAO,CAKpB;IAEF,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,MAAM,CAA4E;IAC1F,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,UAAU,CAA2B;IAE7C,YAAmB,UAAU,EAAC,MAAM,EAEnC;IAED,OAAO,CAAC,aAAa;IAmBd,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa,CAe/D;IAEM,YAAY,CAAC,IAAI,EAAC,UAAU,GAAE,aAAa,CAejD;IAEM,eAAe,CAAC,OAAO,EAAE,aAAa,GAAE,aAAa,CAa3D;IAEM,QAAQ,CAAC,eAAe,EAAC,MAAM,EAAE,iBAAiB,EAAC,MAAM,QA6L/D;IAED,OAAO,CAAC,MAAM,CAAC,cAAc;CAQhC;AAID,OAAO,EACH,aAAa,EAChB,CAAA;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAC,MAAM,CAAC;CACf;AAmCD,qBAAa,aAAa;IAEtB,OAAc,aAAa,CAAC,SAAS,EAAC,MAAM,EAAE,UAAU,EAAC,MAAM,GAAE,MAAM,CA0BtE;CACJ;AAED,MAAM,MAAM,OAAO,GAAG;IAClB,CAAC,GAAG,EAAC,MAAM,GAAE,GAAG,CAAC;CACpB,CAAA"}

package/build/core/NodeGenerator.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SourceUtility = exports.NodeGenerator = void 0;
 const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
 const NodeConstructor_1 = require("./NodeConstructor");
 const templatePropertyKeys = ["onIncludeOnce", "onIncludeDefaults", "onIncludeEditPrepare", "onIncludeEditPrepare", "onIncludeEditSave", "onIncludeEditForm"];
 class NodeGenerator {
@@ -111,28 +112,17 @@ class NodeGenerator {
         return this;
     }
     generate(nodesOutputFile, pluginsOutputFile) {
-        // STEP 1. Compile the templates.
-        // let templateInclude =  this._templates
-        //     .map(template => new (template.clazz()))
-        //     .map(template => {
-        //         return template.onIncludeOnce();
-        //     })
-        //     .join("\n");
-        let templateInclude = "";
-        // STEP 2. compose the HTMLStructure of each of the nodes.
-        let nodeHTMLOutut = Object.values(this._nodes)
-            .map(node => {
-            console.log(`Processing node: ${node.descriptor.id()}`);
-            return (0, NodeConstructor_1.buildNode)(node.nodeClass);
-        })
-            .join("\n");
+        // STEP 1. Write an empty Nodes.html.
+        // Client-side node type definitions live in Plugins.html (generated below)
+        // to prevent HTML-scanning conflicts when multiple plugins bundle the same
+        // plugincore infrastructure nodes.
         fs.writeFileSync(nodesOutputFile + ".html", `
 <!--
 ${NodeGenerator.warning}
+Client-side node type definitions have been moved to Plugins.html to prevent
+duplicate type registration conflicts when multiple plugins share the same
+plugincore infrastructure nodes.
 -->
-${templateInclude}
-${nodeHTMLOutut}
-
         `);
         // Step 3. compose the JS structure for each of the nodes.
         // 1. get a list of the files to import.
@@ -153,14 +143,34 @@ ${nodeHTMLOutut}
 ${NodeGenerator.warning}
 */
 "use strict";
-const NodeManager = require("@theotherwillembotha/node-red-plugincore").NodeManager;
+const { NodeManager } = require("./runtime/NodeManagerRuntime");
 ${importList}
 module.exports = (RED) => {
 let manager = new NodeManager(RED);
 ${moduleExports}
-}        
-        
+}
+
         `);
+        // Copy NodeManagerRuntime.js into the plugin's build/runtime/ folder so that
+        // the generated Nodes.js require("./runtime/NodeManagerRuntime") resolves locally
+        // with no dependency on plugincore being installed in the user's environment.
+        const outputDir = path.dirname(nodesOutputFile);
+        const runtimeDestDir = path.join(outputDir, 'runtime');
+        const runtimeDestPath = path.join(runtimeDestDir, 'NodeManagerRuntime.js');
+        let runtimeSrcPath;
+        try {
+            // Resolves when this is a consumer plugin - plugincore is in node_modules.
+            runtimeSrcPath = require.resolve('@theotherwillembotha/node-red-plugincore/build/runtime/NodeManagerRuntime');
+        }
+        catch {
+            // We ARE plugincore - NodeManagerRuntime.js is compiled alongside us in build/core/.
+            runtimeSrcPath = path.join(__dirname, 'NodeManagerRuntime.js');
+        }
+        if (path.resolve(runtimeSrcPath) !== path.resolve(runtimeDestPath)) {
+            fs.mkdirSync(runtimeDestDir, { recursive: true });
+            fs.copyFileSync(runtimeSrcPath, runtimeDestPath);
+        }
+        console.log(`NodeManagerRuntime.js → ${runtimeDestPath}`);
         console.log(`Done building ${Object.keys(this._nodes).length} nodes\n${Object.values(this._nodes).map(node => " - " + node.descriptor.id() + "\n").join("")}\n`);
         let serviceExports = this._services.map(service => {
             return `    manager.registerService(${service.name()}.${service.name()});`;
@@ -192,29 +202,38 @@ module.exports = function (RED) {
 
             if(addedPlugin && plugin.instantiate && !plugin.instance){
                 plugin.instance = new plugin.class();
-                
+
                 // instantiate the plugin.
                 await plugin.instance.init(RED);
 
+                // Eagerly call onDeploy with any pre-existing saved flows so that
+                // service registries (MetricsService, WebhookServerService, etc.) are
+                // populated before config nodes are constructed during flow startup.
+                // Without this, MetricsConfigNode._metrics is undefined on first boot.
+                const existingFlows = await runtime.flows.getFlows({});
+                const hasExistingFlows = existingFlows && existingFlows.flows && existingFlows.flows.length > 0;
+                if (hasExistingFlows) {
+                    await plugin.instance.onDeploy(existingFlows);
+                }
+
                 // publish an event that it has ben deployed.
                 RED.events.emit("plugin.instantiated", pluginID);
-                                
+
                 pluginList.splice(pluginList.findIndex(current => current.id() === addedPlugin.id()), 1);
 
                 // register a flow deployment listener.
-                let startupDeployment = true;
+                // startupDeployment is only needed for a truly fresh Node-RED with no saved flows.
+                let startupDeployment = !hasExistingFlows;
                 RED.events.on('runtime-event', async (event) => {
-                    // startup deployment.
+                    // startup deployment (fresh Node-RED with no pre-existing flows).
                     if ("runtime-deploy" === event?.id && startupDeployment) {
-                        //console.log("STARTUP DEPLOYMENT");
                         startupDeployment = false;
                         const flows = await runtime.flows.getFlows({});
                         await plugin.instance.onDeploy(flows);
                     }
-                    
+
                     // stopping flows on redeployment.
                     if ("runtime-state" === event?.id && event?.payload?.state === "stop" && event?.payload?.deploy) {
-                        //console.log("REDEPLOY!");
                         const flows = await runtime.flows.getFlows({});
                         await plugin.instance.onDeploy(flows);
                     }
@@ -235,6 +254,38 @@ module.exports = function (RED) {
 `;
         fs.writeFileSync(pluginsOutputFile + ".js", output);
         console.log(`Done building ${this._services.length} services\n${this._services.map(service => " - " + service.name() + "\n").join("")}\n`);
+        // STEP 4. Generate Plugins.html with deferred client-side node definitions.
+        // All nodes are registered via registry:node-set-added so that:
+        //   a) registerType is only called after typeToId/nodeSets are populated, and
+        //   b) data-template-name declarations are absent from Nodes.html, avoiding
+        //      the HTML-scanning conflict that causes Node-RED to reject an entire
+        //      plugin when a second package declares the same node type.
+        const seenOnce = new Set();
+        const onceHtmlParts = [];
+        const nodePluginParts = [];
+        Object.values(this._nodes).forEach(node => {
+            console.log(`Building Plugins.html for: ${node.descriptor.id()}`);
+            const nb = (0, NodeConstructor_1.buildNodeBuilder)(node.nodeClass);
+            nb.buildOnceHtml().forEach(({ source, html }) => {
+                if (!seenOnce.has(source)) {
+                    seenOnce.add(source);
+                    onceHtmlParts.push(html);
+                }
+            });
+            nodePluginParts.push([
+                nb.buildDeferredType(),
+                nb.buildHtml(),
+                nb.buildDocumentation()
+            ].join('\n\n'));
+        });
+        fs.writeFileSync(pluginsOutputFile + ".html", `
+<!--
+${NodeGenerator.warning}
+-->
+${onceHtmlParts.join('\n')}
+${nodePluginParts.join('\n\n')}
+        `);
+        console.log(`Done building Plugins.html\n`);
     }
     static generateHeader(node) {
         let padding = ' '.repeat(Math.max(0, Math.floor(NodeGenerator.headerWidth - node.id().length) / 2));

package/build/core/NodeManagerRuntime.d.ts

@@ -0,0 +1,44 @@
+/**
+ * NodeManagerRuntime.ts
+ *
+ * STANDALONE - zero imports from the rest of plugincore.
+ *
+ * This file is compiled and copied into every plugin's build output so that
+ * plugins are self-contained and do not require plugincore to be separately
+ * installed in the user's Node-RED environment.
+ *
+ * When multiple plugins are deployed, each ships its own copy of this file.
+ * The first plugin to load registers its NodeManager and nodes; subsequent
+ * copies operate independently on their own node types with no conflict.
+ *
+ * POST_CONSTRUCT_KEY is intentionally a plain string (not a Symbol) so that
+ * the decorators (from plugincore's NodeConstructor, loaded via the plugin's
+ * dependency on plugincore) and this runtime file (a separate module instance)
+ * resolve to the same property key on node instances.
+ */
+import type { NodeAPI, NodeAPISettingsWithData } from "node-red";
+export declare const NODEMANAGER_API_VERSION = "1.0.0";
+export declare const POST_CONSTRUCT_KEY = "__plugincore_postConstructInitializers__";
+export interface BaseNodeConfig {
+    id: string;
+    name: string;
+    type: string;
+}
+interface INodeDescriptor {
+    id(): string;
+    tags(): string[];
+}
+interface INodeClass {
+    new (node: any, config: any): any;
+    getNodeDescriptor(): INodeDescriptor;
+}
+export declare function runPostConstructInitializers(instance: any): void;
+export declare class NodeManager {
+    private nodeTypeService;
+    private typeBacklog;
+    constructor(RED: NodeAPI<NodeAPISettingsWithData>);
+    static get RED(): NodeAPI<NodeAPISettingsWithData>;
+    registerNodeType(typeName: string, type: INodeClass): NodeManager;
+}
+export {};
+//# sourceMappingURL=NodeManagerRuntime.d.ts.map

package/build/core/NodeManagerRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeManagerRuntime.d.ts","sourceRoot":"","sources":["../../src/core/NodeManagerRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAMjE,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAI/C,eAAO,MAAM,kBAAkB,6CAA6C,CAAC;AAI7E,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,eAAe;IACrB,EAAE,IAAI,MAAM,CAAC;IACb,IAAI,IAAI,MAAM,EAAE,CAAC;CACpB;AAED,UAAU,UAAU;IAChB,KAAI,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IACjC,iBAAiB,IAAI,eAAe,CAAC;CACxC;AAID,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAoBhE;AA0BD,qBAAa,WAAW;IAGpB,OAAO,CAAC,eAAe,CAAM;IAC7B,OAAO,CAAC,WAAW,CAAoB;IAEvC,YAAmB,GAAG,EAAE,OAAO,CAAC,uBAAuB,CAAC,EAuBvD;IAED,WAAkB,GAAG,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAExD;IAEM,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,CA6CvE;CACJ"}