@theotherwillembotha/node-red-cluster 0.0.55 → 0.4.4

package/build/cluster/node/ClusterConfigNode.d.ts

@@ -0,0 +1,35 @@
+import { Node } from "node-red";
+import { ConfigNode, ConfigNodeConfig } from "@theotherwillembotha/node-red-plugincore";
+import { ClusterClient } from "../service/ClusterClient";
+export declare enum ClusterRole {
+    Member = "Member",
+    Observer = "Observer"
+}
+export interface ClusterConfigNodeConfig extends ConfigNodeConfig {
+    instanceId: string;
+    zkRootPath: string;
+    natsAddress: string;
+    natsUser: string;
+    natsPass: string;
+    role: ClusterRole;
+}
+export declare class ClusterConfigNode extends ConfigNode<ClusterConfigNodeConfig> {
+    private _instanceId;
+    private _zkRootPath;
+    private _natsAddress;
+    private _natsUser;
+    private _natsPass;
+    private _role;
+    private _unsubscribeStatus;
+    constructor(node: Node, config: ClusterConfigNodeConfig);
+    protected onInit(): void;
+    instanceId(): string;
+    zkRootPath(): string;
+    natsAddress(): string;
+    natsUser(): string;
+    natsPass(): string;
+    role(): ClusterRole;
+    isObserver(): boolean;
+    getClient(): ClusterClient | null;
+}
+//# sourceMappingURL=ClusterConfigNode.d.ts.map

package/build/cluster/node/ClusterConfigNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterConfigNode.d.ts","sourceRoot":"","sources":["../../../src/cluster/node/ClusterConfigNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAkC,MAAM,0CAA0C,CAAC;AAExH,OAAO,EAAE,aAAa,EAAuB,MAAM,0BAA0B,CAAC;AAE9E,oBAAY,WAAW;IACnB,MAAM,WAAa;IACnB,QAAQ,aAAa;CACxB;AAED,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC7D,UAAU,EAAG,MAAM,CAAC;IACpB,UAAU,EAAG,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAK,MAAM,CAAC;IACpB,QAAQ,EAAK,MAAM,CAAC;IACpB,IAAI,EAAS,WAAW,CAAC;CAC5B;AAYD,qBAQa,iBAAkB,SAAQ,UAAU,CAAC,uBAAuB,CAAC;IAEtE,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,KAAK,CAAqB;IAElC,OAAO,CAAC,kBAAkB,CAA6B;IAEvD,YAAY,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,uBAAuB,EAwBtD;IAED,SAAS,CAAC,MAAM,IAAI,IAAI,CAWvB;IAIM,UAAU,IAAK,MAAM,CAAmC;IACxD,UAAU,IAAK,MAAM,CAAmC;IACxD,WAAW,IAAI,MAAM,CAAmC;IACxD,QAAQ,IAAO,MAAM,CAAmC;IACxD,QAAQ,IAAO,MAAM,CAAmC;IACxD,IAAI,IAAW,WAAW,CAA8B;IAExD,UAAU,IAAI,OAAO,CAE3B;IAEM,SAAS,IAAI,aAAa,GAAG,IAAI,CAEvC;CACJ"}

package/build/cluster/node/ClusterConfigNode.js

@@ -55,7 +55,7 @@ let ClusterConfigNode = class ClusterConfigNode extends node_red_plugincore_1.Co
             this._unsubscribeStatus?.();
             this._unsubscribeStatus = null;
             if (removed) {
-                // Node permanently deleted  tear down the cluster connection.
+                // Node permanently deleted - tear down the cluster connection.
                 ClusterService_1.ClusterService.removeClient(this.id());
             }
             done();

package/build/cluster/node/ClusterPublishNode.d.ts

@@ -0,0 +1,25 @@
+import { Node } from "node-red";
+import { BaseNode, BaseNodeConfig, Message } from "@theotherwillembotha/node-red-plugincore";
+export declare enum DeliveryMode {
+    Durable = "Durable",
+    Ephemeral = "Ephemeral"
+}
+export interface ClusterPublishNodeConfig extends BaseNodeConfig {
+    clusterConfig: string;
+    subject: string;
+    mode: DeliveryMode;
+    ttl: number;
+}
+export declare class ClusterPublishNode extends BaseNode<ClusterPublishNodeConfig> {
+    private _configNode;
+    private _subject;
+    private _mode;
+    private _ttl;
+    private _unsubscribeStatus;
+    constructor(node: Node, config: ClusterPublishNodeConfig);
+    protected onInit(): void;
+    protected messageReceived(message: Message): Promise<void>;
+    private _announceEndpoint;
+    private _removeEndpoint;
+}
+//# sourceMappingURL=ClusterPublishNode.d.ts.map

package/build/cluster/node/ClusterPublishNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterPublishNode.d.ts","sourceRoot":"","sources":["../../../src/cluster/node/ClusterPublishNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAwD,OAAO,EAAE,MAAM,0CAA0C,CAAC;AAInJ,oBAAY,YAAY;IACpB,OAAO,YAAc;IACrB,SAAS,cAAc;CAC1B;AAED,MAAM,WAAW,wBAAyB,SAAQ,cAAc;IAC5D,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAQ,MAAM,CAAC;IACtB,IAAI,EAAW,YAAY,CAAC;IAC5B,GAAG,EAAY,MAAM,CAAC;CACzB;AAMD,qBASa,kBAAmB,SAAQ,QAAQ,CAAC,wBAAwB,CAAC;IAEtE,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,kBAAkB,CAA6B;IAEvD,YAAY,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,wBAAwB,EA+BvD;IAED,SAAS,CAAC,MAAM,IAAI,IAAI,CAWvB;IAED,UACgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB/D;IAID,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,eAAe;CAG1B"}

package/build/cluster/node/ClusterPublishNode.js

@@ -17,7 +17,7 @@ var DeliveryMode;
     DeliveryMode["Durable"] = "Durable";
     DeliveryMode["Ephemeral"] = "Ephemeral";
 })(DeliveryMode || (exports.DeliveryMode = DeliveryMode = {}));
-const observerStatus = { fill: "grey", shape: "ring", text: "observer  publish disabled" };
+const observerStatus = { fill: "grey", shape: "ring", text: "observer - publish disabled" };
 const readyStatus = { fill: "green", shape: "dot", text: "ready" };
 const notConnectedStatus = { fill: "yellow", shape: "ring", text: "waiting for connection..." };
 let ClusterPublishNode = class ClusterPublishNode extends node_red_plugincore_1.BaseNode {

package/build/cluster/node/ClusterSubscribeNode.d.ts

@@ -0,0 +1,17 @@
+import { Node } from "node-red";
+import { BaseNode, BaseNodeConfig } from "@theotherwillembotha/node-red-plugincore";
+export interface ClusterSubscribeNodeConfig extends BaseNodeConfig {
+    clusterConfig: string;
+    subjectPattern: string;
+}
+export declare class ClusterSubscribeNode extends BaseNode<ClusterSubscribeNodeConfig> {
+    private _configNode;
+    private _subjectPattern;
+    private _subscriptions;
+    private _unsubscribeStatus;
+    constructor(node: Node, config: ClusterSubscribeNodeConfig);
+    protected onInit(): void;
+    private _subscribe;
+    private _unsubscribe;
+}
+//# sourceMappingURL=ClusterSubscribeNode.d.ts.map

package/build/cluster/node/ClusterSubscribeNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterSubscribeNode.d.ts","sourceRoot":"","sources":["../../../src/cluster/node/ClusterSubscribeNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAA+C,MAAM,0CAA0C,CAAC;AAKjI,MAAM,WAAW,0BAA2B,SAAQ,cAAc;IAC9D,aAAa,EAAG,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAMD,qBASa,oBAAqB,SAAQ,QAAQ,CAAC,0BAA0B,CAAC;IAE1E,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,eAAe,CAAY;IACnC,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,kBAAkB,CAA6B;IAEvD,YAAY,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,0BAA0B,EAyBzD;IAED,SAAS,CAAC,MAAM,IAAI,IAAI,CAUvB;IAID,OAAO,CAAC,UAAU;IAiClB,OAAO,CAAC,YAAY;CAKvB"}

package/build/cluster/service/ClusterClient.d.ts

@@ -0,0 +1,49 @@
+import { NatsConnection } from "@nats-io/nats-core";
+import { KV } from "@nats-io/kv";
+import { ClusterRole } from "../node/ClusterConfigNode";
+export type ClusterClientParams = {
+    instanceId: string;
+    zkRootPath: string;
+    natsAddress: string;
+    natsUser?: string;
+    natsPass?: string;
+    role: ClusterRole;
+};
+export type ClusterClientStatus = "idle" | "connecting" | "connected" | "disconnected" | "error";
+type StatusListener = (status: ClusterClientStatus, error?: Error) => void;
+export declare class ClusterClient {
+    private _params;
+    private _natsClient;
+    private _kvBucket;
+    private _status;
+    private _statusListeners;
+    private _streamName;
+    constructor(params: ClusterClientParams);
+    updateParams(params: ClusterClientParams): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    natsClient(): NatsConnection | null;
+    kvBucket(): KV | null;
+    status(): ClusterClientStatus;
+    params(): ClusterClientParams;
+    /** `nodered-cluster.field-a.commands.opengate` */
+    buildPublishSubject(subject: string): string;
+    /** `nodered-cluster.*.commands.opengate` */
+    buildSubscribePattern(subjectPattern: string): string;
+    /** Strip leading `/`, replace `/` with `.` e.g. `/nodered-cluster` -> `nodered-cluster` */
+    rootPrefix(): string;
+    /** KV bucket name e.g. `CLUSTER_NODERED_CLUSTER` */
+    kvBucketName(): string;
+    announceEndpoint(subject: string, mode: string, ttl: number): Promise<void>;
+    removeEndpoint(subject: string): Promise<void>;
+    ensureStream(): Promise<string>;
+    /** Publish to JetStream (durable delivery). Ensures stream exists first. */
+    jsPublish(subject: string, data: string): Promise<void>;
+    /** Publish via core NATS (ephemeral - fire and forget). */
+    corePublish(subject: string, data: string): void;
+    onStatusChange(listener: StatusListener): () => void;
+    private _setStatus;
+    private _initKV;
+}
+export {};
+//# sourceMappingURL=ClusterClient.d.ts.map

package/build/cluster/service/ClusterClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterClient.d.ts","sourceRoot":"","sources":["../../../src/cluster/service/ClusterClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAqB,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EAAO,EAAE,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,UAAU,EAAG,MAAM,CAAC;IACpB,UAAU,EAAG,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAI,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAI,MAAM,CAAC;IACpB,IAAI,EAAS,WAAW,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC;AAEjG,KAAK,cAAc,GAAG,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;AAE3E,qBAAa,aAAa;IAEtB,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,WAAW,CAA4B;IAE/C,YAAY,MAAM,EAAE,mBAAmB,EAEtC;IAIM,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAWrD;IAEY,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAWlC;IAEY,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAmBjC;IAIM,UAAU,IAAI,cAAc,GAAG,IAAI,CAA6B;IAChE,QAAQ,IAAM,EAAE,GAAG,IAAI,CAAyC;IAChE,MAAM,IAAQ,mBAAmB,CAA+B;IAChE,MAAM,IAAQ,mBAAmB,CAA+B;IAIvE,kDAAkD;IAC3C,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;IAED,4CAA4C;IACrC,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE3D;IAED,2FAA2F;IACpF,UAAU,IAAI,MAAM,CAE1B;IAED,oDAAoD;IAC7C,YAAY,IAAI,MAAM,CAE5B;IAIY,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvF;IAEY,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1D;IAIY,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAgB3C;IAED,4EAA4E;IAC/D,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAInE;IAED,2DAA2D;IACpD,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEtD;IAIM,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAK1D;IAID,OAAO,CAAC,UAAU;YAKJ,OAAO;CASxB"}

package/build/cluster/service/ClusterClient.js

@@ -80,7 +80,7 @@ class ClusterClient {
     buildSubscribePattern(subjectPattern) {
         return `${this.rootPrefix()}.${subjectPattern}`;
     }
-    /** Strip leading `/`, replace `/` with `.`  e.g. `/nodered-cluster` → `nodered-cluster` */
+    /** Strip leading `/`, replace `/` with `.` e.g. `/nodered-cluster` -> `nodered-cluster` */
     rootPrefix() {
         return this._params.zkRootPath.replace(/^\//, "").replace(/\//g, ".");
     }
@@ -124,7 +124,7 @@ class ClusterClient {
         const js = (0, jetstream_1.jetstream)(this._natsClient);
         await js.publish(subject, data);
     }
-    /** Publish via core NATS (ephemeral  fire and forget). */
+    /** Publish via core NATS (ephemeral - fire and forget). */
     corePublish(subject, data) {
         this._natsClient.publish(subject, data);
     }

package/build/cluster/service/ClusterService.d.ts

@@ -0,0 +1,19 @@
+import { BaseService } from "@theotherwillembotha/node-red-plugincore";
+import { NodeAPI, NodeAPISettingsWithData } from "node-red";
+import { ClusterClient, ClusterClientParams } from "./ClusterClient";
+export declare class ClusterService extends BaseService {
+    private static readonly _CLIENTS_KEY;
+    private static _clientsMap;
+    constructor();
+    init(red: NodeAPI<NodeAPISettingsWithData>): Promise<void>;
+    deinit(_red: NodeAPI<NodeAPISettingsWithData>): void;
+    static ensureClient(configId: string, params: ClusterClientParams): ClusterClient;
+    static getClient(configId: string): ClusterClient | null;
+    static removeClient(configId: string): void;
+    private _handleStatus;
+    private _handleMembers;
+    private _handleDiscovery;
+    private _handleTestConnection;
+    private _testNats;
+}
+//# sourceMappingURL=ClusterService.d.ts.map

package/build/cluster/service/ClusterService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterService.d.ts","sourceRoot":"","sources":["../../../src/cluster/service/ClusterService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAsB,MAAM,0CAA0C,CAAC;AAC3F,OAAO,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAIrE,qBAMa,cAAe,SAAQ,WAAW;IAK3C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAErE,OAAO,CAAC,MAAM,CAAC,WAAW;IAO1B,cAEC;IAIY,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtE;IAEM,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAM1D;IAID,OAAc,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAavF;IAED,OAAc,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAE9D;IAED,OAAc,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOjD;IAID,OAAO,CAAC,aAAa;YASP,cAAc;YAyBd,gBAAgB;YAgDhB,qBAAqB;YAMrB,SAAS;CAY1B"}

package/build/cluster/service/ClusterService.js

@@ -1,17 +1,36 @@
 "use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var ClusterService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClusterService = void 0;
 const node_red_plugincore_1 = require("@theotherwillembotha/node-red-plugincore");
 const transport_node_1 = require("@nats-io/transport-node");
 const ClusterClient_1 = require("./ClusterClient");
-class ClusterService extends node_red_plugincore_1.BaseService {
-    static { this._clients = {}; }
+let ClusterService = class ClusterService extends node_red_plugincore_1.BaseService {
+    static { ClusterService_1 = this; }
+    // Backed by `global` - esbuild bundles this class separately into Nodes.js
+    // and Plugins.js, so a plain static field would give each bundle its own
+    // isolated (and mostly empty) copy. See PluginStarterGuide.md Section 17.
+    static { this._CLIENTS_KEY = '__nodered_cluster_clients__'; }
+    static _clientsMap() {
+        if (!global[ClusterService_1._CLIENTS_KEY]) {
+            global[ClusterService_1._CLIENTS_KEY] = {};
+        }
+        return global[ClusterService_1._CLIENTS_KEY];
+    }
     constructor() {
         super("ClusterService");
     }
     // ── BaseService lifecycle ────────────────────────────────────────────────
     async init(red) {
-        console.log("STARTING: ClusterService");
         const writePermission = red.auth.needsPermission("inject.write");
         red.httpAdmin.get("/cluster/status/:configId", writePermission, (req, res) => this._handleStatus(req, res));
         red.httpAdmin.get("/cluster/members/:configId", writePermission, (req, res) => this._handleMembers(req, res));
@@ -19,18 +38,20 @@ class ClusterService extends node_red_plugincore_1.BaseService {
         red.httpAdmin.post("/cluster/testconnection", writePermission, (req, res) => this._handleTestConnection(req, res));
     }
     deinit(_red) {
-        console.log("STOPPING: ClusterService");
-        Object.values(ClusterService._clients).forEach(client => {
+        const clients = ClusterService_1._clientsMap();
+        Object.values(clients).forEach(client => {
             client.stop().catch(err => console.error("ClusterService: error stopping client:", err));
         });
-        ClusterService._clients = {};
+        for (const key of Object.keys(clients))
+            delete clients[key];
     }
     // ── Static client management ─────────────────────────────────────────────
     static ensureClient(configId, params) {
-        let client = ClusterService._clients[configId];
+        const clients = ClusterService_1._clientsMap();
+        let client = clients[configId];
         if (!client) {
             client = new ClusterClient_1.ClusterClient(params);
-            ClusterService._clients[configId] = client;
+            clients[configId] = client;
             client.start().catch(err => {
                 console.error(`ClusterService: failed to start client for ${configId}:`, err);
             });
@@ -41,18 +62,19 @@ class ClusterService extends node_red_plugincore_1.BaseService {
         return client;
     }
     static getClient(configId) {
-        return ClusterService._clients[configId] ?? null;
+        return ClusterService_1._clientsMap()[configId] ?? null;
     }
     static removeClient(configId) {
-        const client = ClusterService._clients[configId];
+        const clients = ClusterService_1._clientsMap();
+        const client = clients[configId];
         if (client) {
             client.stop().catch(err => console.error(`ClusterService: error stopping client ${configId}:`, err));
-            delete ClusterService._clients[configId];
+            delete clients[configId];
         }
     }
     // ── HTTP admin handlers ──────────────────────────────────────────────────
     _handleStatus(req, res) {
-        const client = ClusterService._clients[req.params.configId];
+        const client = ClusterService_1._clientsMap()[req.params.configId];
         if (!client) {
             res.status(404).json({ error: "No client for that config node" });
             return;
@@ -60,7 +82,7 @@ class ClusterService extends node_red_plugincore_1.BaseService {
         res.json({ status: client.status(), params: client.params() });
     }
     async _handleMembers(req, res) {
-        const client = ClusterService._clients[req.params.configId];
+        const client = ClusterService_1._clientsMap()[req.params.configId];
         if (!client) {
             res.status(404).json({ error: "No client for that config node" });
             return;
@@ -79,12 +101,12 @@ class ClusterService extends node_red_plugincore_1.BaseService {
             res.json({ members });
         }
         catch (err) {
-            // No keys found is not an error  return empty list
+            // No keys found is not an error - return empty list
             res.json({ members: [] });
         }
     }
     async _handleDiscovery(req, res) {
-        const client = ClusterService._clients[req.params.configId];
+        const client = ClusterService_1._clientsMap()[req.params.configId];
         if (!client) {
             res.status(404).json({ error: "No client for that config node" });
             return;
@@ -152,9 +174,14 @@ class ClusterService extends node_red_plugincore_1.BaseService {
             return { ok: false, error: err.message || "Connection failed" };
         }
     }
-    // ── ServiceDescriptor ────────────────────────────────────────────────────
-    static getServiceDescriptor() {
-        return new node_red_plugincore_1.ServiceDescriptor("@theotherwillembotha/clusterservice", "ClusterService", "integration-plugin", "./cluster/service/ClusterService", ClusterService);
-    }
-}
+};
 exports.ClusterService = ClusterService;
+exports.ClusterService = ClusterService = ClusterService_1 = __decorate([
+    (0, node_red_plugincore_1.ServiceDescription)({
+        id: "cluster/clusterservice",
+        name: "ClusterService",
+        type: "integration-plugin",
+        sourceFile: "./cluster/service/ClusterService",
+    }),
+    __metadata("design:paramtypes", [])
+], ClusterService);

package/build/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./cluster/node/ClusterConfigNode";
+export * from "./cluster/node/ClusterPublishNode";
+export * from "./cluster/node/ClusterSubscribeNode";
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC"}

package/build/runtime/NodeManagerRuntime.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeManager = exports.POST_CONSTRUCT_KEY = exports.NODEMANAGER_API_VERSION = void 0;
+exports.runPostConstructInitializers = runPostConstructInitializers;
+// ─── API version ────────────────────────────────────────────────────────────
+// Semver of the NodeManager API contract - independent of plugincore's package
+// version. Bump when the contract changes; plugins can read this to warn users
+// that they were built against a different NodeManager version.
+exports.NODEMANAGER_API_VERSION = "1.0.0";
+// ─── Shared key for post-construct initializer lists ────────────────────────
+// Must be a plain string so it resolves identically across module instances.
+exports.POST_CONSTRUCT_KEY = '__plugincore_postConstructInitializers__';
+// ─── Post-construct initializer runner ───────────────────────────────────────
+function runPostConstructInitializers(instance) {
+    const initializers = instance[exports.POST_CONSTRUCT_KEY];
+    if (!initializers || initializers.length === 0)
+        return;
+    const className = instance.constructor.name;
+    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;
+        }
+    });
+    delete instance[exports.POST_CONSTRUCT_KEY];
+}
+// ─── NodeManager ─────────────────────────────────────────────────────────────
+// RED is stored on `global` rather than as a static class field so that all
+// module instances of NodeManagerRuntime (the local copy bundled into Nodes.js
+// and the copy bundled via plugincore's NodeConstructor) share the same value.
+// Without this, esbuild's two separate inline copies would have independent
+// static fields and the one used by decorators would never see RED being set.
+const _GLOBAL_RED_KEY = '__plugincore_NodeManager_RED__';
+// ─── Global node-type registration guard ─────────────────────────────────────
+// When multiple self-contained plugins are installed they each bundle plugincore
+// inline and each try to call RED.nodes.registerType for the same shared
+// infrastructure node types (ConsoleLoggerConfigNode, RestLoggerConfigNode, etc.).
+// Node-RED rejects duplicate registrations with a warning and the second
+// plugin's Nodes.js fails to load. This global set tracks which types have
+// already been registered so subsequent plugins silently skip them.
+const _GLOBAL_REGISTERED_NODES_KEY = '__plugincore_registered_nodes__';
+function getRegisteredNodes() {
+    if (!global[_GLOBAL_REGISTERED_NODES_KEY]) {
+        global[_GLOBAL_REGISTERED_NODES_KEY] = new Set();
+    }
+    return global[_GLOBAL_REGISTERED_NODES_KEY];
+}
+class NodeManager {
+    constructor(RED) {
+        this.typeBacklog = [];
+        global[_GLOBAL_RED_KEY] = RED;
+        const nodeTypeServiceId = "@theotherwillembotha/nodetypeservice";
+        const nodeTypeServiceListener = (pluginID) => {
+            if (pluginID === nodeTypeServiceId) {
+                RED.events.off('plugin.instantiated', nodeTypeServiceListener);
+                this.nodeTypeService = RED.plugins.get(nodeTypeServiceId).instance;
+                for (const nodeType of this.typeBacklog) {
+                    for (const tag of nodeType.getNodeDescriptor().tags()) {
+                        this.nodeTypeService.registerNodeType(tag, nodeType);
+                    }
+                }
+                this.typeBacklog = [];
+            }
+        };
+        this.nodeTypeService = RED.plugins.get(nodeTypeServiceId)?.instance;
+        if (!this.nodeTypeService) {
+            RED.events.on('plugin.instantiated', nodeTypeServiceListener);
+        }
+    }
+    static get RED() {
+        return global[_GLOBAL_RED_KEY];
+    }
+    registerNodeType(typeName, type) {
+        if (!type) {
+            console.error(`[NodeManager v${exports.NODEMANAGER_API_VERSION}] Type "${typeName}" is undefined. ` +
+                `Ensure it is exported and included in GenerateNodes.`);
+            return this;
+        }
+        const registeredNodes = getRegisteredNodes();
+        if (registeredNodes.has(typeName)) {
+            // Already registered by another plugin - skip to avoid Node-RED duplicate-registration error.
+            return this;
+        }
+        registeredNodes.add(typeName);
+        const nodeConstructor = function (config) {
+            try {
+                NodeManager.RED.nodes.createNode(this, config);
+                const node = new type(this, config);
+                runPostConstructInitializers(node);
+                if (node.onInit) {
+                    node.onInit();
+                }
+            }
+            catch (error) {
+                console.error(`[NodeManager v${exports.NODEMANAGER_API_VERSION}] Failed to construct node "${typeName}":`, error);
+            }
+        };
+        try {
+            NodeManager.RED.nodes.registerType(typeName, nodeConstructor, { settings: {} });
+            const nodeDescription = type.getNodeDescriptor();
+            if (this.nodeTypeService) {
+                for (const tag of nodeDescription.tags()) {
+                    this.nodeTypeService.registerNodeType(tag, type);
+                }
+            }
+            else {
+                this.typeBacklog.push(type);
+            }
+        }
+        catch (error) {
+            console.error(`[NodeManager v${exports.NODEMANAGER_API_VERSION}] Failed to register node type "${typeName}":`, error);
+        }
+        return this;
+    }
+}
+exports.NodeManager = NodeManager;

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@theotherwillembotha/node-red-cluster",
-  "version": "0.0.55",
+  "version": "0.4.4",
   "description": "Node-RED clustering plugin - connect multiple Node-RED instances into a coordinated cluster using NATS JetStream for message transport and NATS KV for shared state.",
   "main": "./build/index.js",
   "exports": "./build/index.js",
+  "types": "./build/index.d.ts",
   "author": "Willem Botha (@theotherwillembotha)",
   "license": "ISC",
   "keywords": [
@@ -16,9 +17,10 @@
   ],
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
-    "build": "npm run clean && tsc && npm run generate-nodes && npm run copy-files",
+    "build": "npm run clean && tsc && npm run generate-nodes && npm run bundle && npm run copy-files",
     "clean": "rm -rf ./build",
     "generate-nodes": "node build/GenerateNodes.js",
+    "bundle": "node esbuild.js",
     "copy-files": "cp -r ./icons ./build/"
   },
   "files": [
@@ -44,12 +46,13 @@
     "@nats-io/kv": "^3.4.0",
     "@nats-io/nats-core": "^3.4.0",
     "@nats-io/transport-node": "^3.4.0",
-    "@theotherwillembotha/node-red-plugincore": "^0.0.55"
+    "@theotherwillembotha/node-red-plugincore": "^0.4.4"
   },
   "devDependencies": {
     "@theotherwillembotha/node-red-plugincore": "../nodered_plugincore",
     "@types/node": "^25.9.1",
-    "@types/node-red": "~1.3.5"
+    "@types/node-red": "~1.3.5",
+    "esbuild": "^0.25.0"
   },
   "publishConfig": {
     "access": "public"