node-red-contrib-s2 0.1.2 → 0.2.0

package/dist/nodes/s2-pebc/index.d.ts

@@ -0,0 +1,44 @@
+import { NodeRedApp } from '../../types/node-red';
+/**
+ * s2-pebc node
+ *
+ * Owns Power Envelope Based Control (PEBC) behavior: accumulates power envelope
+ * schedules from PEBC instructions and dispatches the currently active bound as
+ * it becomes effective. Also pushes a default PowerConstraints range (from
+ * s2-pebc-config) on deploy, used until a runtime override is supplied. That same
+ * wattage (or null if unconfigured) is published to flow context as
+ * `pebcDefaultMaxPowerW`, so downstream flow logic can derive a released-state
+ * limit (e.g. amps) from it instead of hardcoding one.
+ *
+ * Wiring:
+ *   [s2-rm output 2 (from CEM)]     -> [s2-pebc input]  (to observe RevokeObject)
+ *   [s2-rm output 3 (instructions)] -> [s2-pebc input]  (to accumulate PEBC instructions)
+ *   [Forecast command source]       -> [s2-pebc input]  (optional - to cap the forecast to the accumulated schedule)
+ *   [PowerMeasurement command source] -> [s2-pebc input]  (optional - to resolve which side of an
+ *                                          asymmetric bound currently applies; see output port 1)
+ *   [s2-pebc output 1] -> downstream flow (active element dispatch / pass-through instructions)
+ *   [s2-pebc output 2] -> downstream flow (full accumulated schedule dump)
+ *   [s2-pebc output 3] -> [s2-rm input]  (PowerConstraints / InstructionStatus / Forecast commands)
+ *
+ * Output port 1 - active element / pass-through:
+ *   Active element: { cemId, payload: { startTime, endTime, duration, lowerBound, upperBound, commodityQuantity, direction, limitW } }
+ *   Released (no PEBC bound active - last instruction revoked, or its final element ended with
+ *   nothing queued after it): { cemId, payload: { lowerBound: null, upperBound: null, commodityQuantity, direction, limitW: null } }
+ *   `direction` ('import' or 'export') and `limitW` (watts) are resolved from the last known
+ *   PowerMeasurement for that commodity, if any was wired in; `direction` defaults to 'import'
+ *   (limitW = upperBound) otherwise. When a measurement flips `direction` for the currently
+ *   active element and its two bounds actually differ, output 1 is re-emitted with the updated
+ *   values - this does not resend InstructionStatus on output 3, since the instruction itself
+ *   hasn't changed, only which of its bounds is presently binding.
+ *   Non-PEBC instructions: passed through unchanged (node status shows a warning).
+ *
+ * Output port 2 - schedule:
+ *   { cemId, payload: { commodityQuantity, elements: [{ startTime, endTime, durationSec, lowerBound, upperBound }] } }
+ *
+ * Output port 3 - commands to s2-rm:
+ *   { payload: { command: 'PowerConstraints', constraints } }
+ *   { payload: { command: 'InstructionStatus', cemId, instructionId, status } }
+ *   { payload: { command: 'Forecast', cemId, forecast } }  (forecast capped to the accumulated schedule, if any)
+ */
+declare const _default: (RED: NodeRedApp) => void;
+export = _default;

package/dist/nodes/s2-pebc/index.html

@@ -0,0 +1,85 @@
+<script src="resources/node-red-contrib-s2/s2-common.js"></script>
+<script type="text/javascript">
+  RED.nodes.registerType('s2-pebc', {
+    category: 's2',
+    color: '#5A8EC2',
+    defaults: {
+      name: { value: '' },
+      pebcConfig: { value: '', type: 's2-pebc-config', required: true }
+    },
+    inputs: 1,
+    outputs: 3,
+    icon: 's2-logo.svg',
+    outputLabels: ['active / instructions', 'schedule', 'to s2-rm'],
+    inputLabels: ['from s2-rm'],
+    label: function () {
+      return this.name || 's2-pebc'
+    },
+    labelStyle: function () {
+      return this.name ? 'node_label_italic' : ''
+    },
+    oneditprepare: function () {
+      window.__s2Common.initializeTooltips()
+    }
+  })
+</script>
+
+<script type="text/html" data-template-name="s2-pebc">
+  <div class="s2-form">
+
+    <div class="form-row">
+      <label for="node-input-name">
+        <i class="fa fa-tag"></i> Name
+      </label>
+      <input type="text" id="node-input-name" placeholder="Name (optional)">
+    </div>
+
+    <div class="form-row">
+      <label for="node-input-pebcConfig"><i class="fa fa-id-card"></i> PEBC Config<i class="fa fa-info-circle tooltip-icon" data-tooltip="Default power constraints (grid connection / custom max power)."></i></label>
+      <input type="text" id="node-input-pebcConfig">
+    </div>
+
+  </div>
+</script>
+
+<link rel="stylesheet" href="resources/node-red-contrib-s2/s2-styles.css">
+
+<script type="text/html" data-help-name="s2-pebc">
+  <p>Owns Power Envelope Based Control (PEBC) behavior: accumulates power envelope schedules from PEBC instructions and dispatches the currently active bound to your flow as it becomes effective. Pushes a default PowerConstraints range on deploy, used until a runtime override is supplied. That same wattage is published to flow context as <code>pebcDefaultMaxPowerW</code> (<code>null</code> if unconfigured), so your own flow logic can derive a released-state limit from it instead of hardcoding one.</p>
+  <p>Wire this node's input to both <b>s2-rm</b>'s "from CEM" output (to observe <code>RevokeObject</code>) and its "instructions" output (to accumulate PEBC instructions). Optionally also wire a <code>Forecast</code> command into this input instead of directly into s2-rm - it will be capped to the accumulated schedule before being forwarded. Optionally also wire your <code>PowerMeasurement</code> command into this input (in addition to wherever else it already goes) so the node can resolve which side of an asymmetric bound currently applies - see output 1. Wire this node's third output back to <b>s2-rm</b>'s input.</p>
+  <h3>Input</h3>
+  <dl class="message-properties">
+    <dt>payload <span class="property-type">object</span></dt>
+    <dd>S2 "from CEM" messages and enriched instructions forwarded from <b>s2-rm</b>, as-is. Also accepts <code>{ command: 'Forecast', cemId, forecast }</code> and <code>{ command: 'PowerMeasurement', cemId, values }</code>.</dd>
+  </dl>
+  <h3>Outputs</h3>
+  <ol class="node-ports">
+    <li>Active / instructions
+      <dl class="message-properties">
+        <dt>payload.startTime / endTime / duration / lowerBound / upperBound / commodityQuantity</dt>
+        <dd>The schedule's currently active element, emitted when it becomes effective.</dd>
+        <dt>payload.direction <span class="property-type">'import' | 'export'</span></dt>
+        <dd>Which side of the bound currently applies, from the sign of the last <code>PowerMeasurement</code> received for this commodity (positive/none seen yet = <code>'import'</code>, negative = <code>'export'</code>).</dd>
+        <dt>payload.limitW <span class="property-type">number | null</span></dt>
+        <dd>Magnitude, in watts, of whichever bound matches <code>direction</code> (<code>upperBound</code> for import, <code>|lowerBound|</code> for export) - useful when your hardware only supports a single settable limit and you need to know which value to apply. <code>null</code> when that bound is unbounded.</dd>
+      </dl>
+      When no PEBC bound is active any more - the last instruction is revoked, or its final element ends with nothing queued after it - a released element is emitted instead, with <code>lowerBound</code> and <code>upperBound</code> both <code>null</code>. Treat that explicitly as "no PEBC-imposed limit right now", not as "no data yet".
+      <br>If you've wired in <code>PowerMeasurement</code>, this output is also re-emitted (with updated <code>direction</code>/<code>limitW</code>) whenever a measurement flips which side of an asymmetric bound applies mid-slot - without resending <code>InstructionStatus</code> on output 3, since the instruction itself hasn't changed.
+      <br>Non-PEBC instructions are passed through unchanged (node status shows a warning), so this node can be wired in parallel with s2-ombc downstream of the same s2-rm.
+    </li>
+    <li>Schedule
+      <dl class="message-properties">
+        <dt>payload.commodityQuantity <span class="property-type">string</span></dt>
+        <dd>Commodity quantity for all elements (e.g. <code>ELECTRIC.POWER.3_PHASE_SYMMETRIC</code>).</dd>
+        <dt>payload.elements <span class="property-type">array</span></dt>
+        <dd>Full accumulated PEBC schedule as an array of <code>{ startTime, endTime, durationSec, lowerBound, upperBound }</code>. Emitted each time the schedule is updated. Use this to program DESS schedule slots or similar downstream consumers.</dd>
+      </dl>
+    </li>
+    <li>To s2-rm
+      <dl class="message-properties">
+        <dt>payload <span class="property-type">object</span></dt>
+        <dd><code>{ command: 'PowerConstraints', constraints }</code>, <code>{ command: 'InstructionStatus', cemId, instructionId, status }</code>, or a <code>Forecast</code> command forwarded from the input (capped to the accumulated schedule, if any). Wire to s2-rm's input.</dd>
+      </dl>
+    </li>
+  </ol>
+</script>

package/dist/nodes/s2-pebc/index.js

@@ -0,0 +1,417 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const messages_1 = require("../../lib/s2/messages");
+const schedule_1 = require("../../lib/s2/schedule");
+const SCHEDULE_CONTEXT_KEY = 's2PebcSchedule';
+module.exports = function (RED) {
+    function S2PebcNode(config) {
+        var _a;
+        RED.nodes.createNode(this, config);
+        const node = this;
+        const pebcConfigNode = RED.nodes.getNode(config.pebcConfig);
+        if (!pebcConfigNode) {
+            node.error('s2-pebc-config node is missing - please configure PEBC power constraints defaults');
+            node.status({ fill: 'red', shape: 'dot', text: 'config missing' });
+            return;
+        }
+        // Persist/restore schedule across restarts
+        const scheduleDir = path.join(((_a = RED.settings) === null || _a === void 0 ? void 0 : _a.userDir) || path.join(os.homedir(), '.node-red'), '.s2');
+        const scheduleFile = path.join(scheduleDir, `${node.id}-schedule.json`);
+        function saveSchedule(schedule) {
+            try {
+                fs.mkdirSync(scheduleDir, { recursive: true });
+                fs.writeFileSync(scheduleFile, JSON.stringify(schedule, null, 2));
+            }
+            catch (e) {
+                node.warn('Failed to persist S2 schedule: ' + e.message);
+            }
+        }
+        function loadPersistedSchedule() {
+            try {
+                const raw = fs.readFileSync(scheduleFile, 'utf8');
+                const schedule = JSON.parse(raw);
+                const now = Date.now();
+                const validElements = schedule.elements.filter(el => el.endMs > now);
+                if (validElements.length === 0)
+                    return;
+                applySchedule({ ...schedule, elements: validElements });
+                node.log(`Restored S2 schedule for CEM ${schedule.cemId} with ${validElements.length} future element(s)`);
+            }
+            catch (e) {
+                if (e.code !== 'ENOENT') {
+                    node.warn('Failed to load persisted S2 schedule: ' + e.message);
+                }
+            }
+        }
+        let scheduleTimer = null;
+        // Accumulated PEBC slots: keyed by slot start time (ms).
+        // Cleared when power_constraints_id changes (new planning period).
+        let pebcConstraintsId = null;
+        const pebcSlots = new Map();
+        // Deduplication: track last emitted active element to suppress identical re-emits from the CEM.
+        let lastEmittedActive = null;
+        let duplicateActiveCount = 0;
+        // Latest signed PowerMeasurement value per commodity quantity (positive = import, negative = export).
+        const lastMeasurement = new Map();
+        // Direction last announced to the flow, tracked independently of lastEmittedActive so a
+        // measurement-driven re-announcement never interacts with the InstructionStatus dedup above.
+        let lastAnnouncedDirection = null;
+        function resolveDirection(commodityQuantity) {
+            const measured = lastMeasurement.get(commodityQuantity);
+            return measured !== undefined && measured < 0 ? 'export' : 'import';
+        }
+        function resolveLimitW(direction, lowerBound, upperBound) {
+            if (direction === 'export')
+                return lowerBound === null ? null : Math.abs(lowerBound);
+            return upperBound;
+        }
+        function formatTime(ms) {
+            return new Date(ms).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+        }
+        function formatBound(bound) {
+            return bound === null ? '∞' : `${bound}W`;
+        }
+        function updateNodeStatus() {
+            const count = pebcSlots.size;
+            if (count === 0) {
+                node.status({ fill: 'grey', shape: 'ring', text: 'no schedule' });
+                return;
+            }
+            const countLabel = `${count} slot${count > 1 ? 's' : ''}`;
+            const sorted = [...pebcSlots.values()].sort((a, b) => a.element.startMs - b.element.startMs);
+            const now = Date.now();
+            const active = sorted.find(s => now >= s.element.startMs && now < s.element.endMs);
+            if (active) {
+                node.status({
+                    fill: 'green',
+                    shape: 'dot',
+                    text: `${countLabel} · active ${formatBound(active.element.lowerBound)}..${formatBound(active.element.upperBound)} until ${formatTime(active.element.endMs)}`
+                });
+                return;
+            }
+            const next = sorted.find(s => s.element.startMs > now);
+            if (next) {
+                node.status({ fill: 'blue', shape: 'dot', text: `${countLabel} · next @ ${formatTime(next.element.startMs)}` });
+                return;
+            }
+            node.status({ fill: 'yellow', shape: 'ring', text: `${countLabel} · all expired` });
+        }
+        function emitActiveElement(schedule) {
+            const el = (0, schedule_1.getActiveElement)(schedule, Date.now());
+            if (!el)
+                return;
+            const isDuplicate = lastEmittedActive !== null &&
+                lastEmittedActive.startMs === el.startMs &&
+                lastEmittedActive.lowerBound === el.lowerBound &&
+                lastEmittedActive.upperBound === el.upperBound &&
+                lastEmittedActive.commodityQuantity === schedule.commodityQuantity;
+            if (isDuplicate) {
+                duplicateActiveCount++;
+                node.debug(`duplicate active element from CEM (${duplicateActiveCount} total) - suppressing emit`);
+                node.status({ fill: 'yellow', shape: 'ring', text: `${pebcSlots.size} slot(s) · ${duplicateActiveCount} dup.` });
+                return;
+            }
+            lastEmittedActive = { startMs: el.startMs, lowerBound: el.lowerBound, upperBound: el.upperBound, commodityQuantity: schedule.commodityQuantity };
+            duplicateActiveCount = 0;
+            updateNodeStatus();
+            const slot = pebcSlots.get(el.startMs);
+            if (slot) {
+                node.send([null, null, { payload: { command: 'InstructionStatus', cemId: slot.cemId, instructionId: slot.instructionId, status: messages_1.InstructionStatus.STARTED } }]);
+            }
+            const direction = resolveDirection(schedule.commodityQuantity);
+            lastAnnouncedDirection = direction;
+            node.send([{
+                    cemId: schedule.cemId,
+                    payload: {
+                        startTime: new Date(el.startMs).toISOString(),
+                        endTime: new Date(el.endMs).toISOString(),
+                        duration: el.duration,
+                        lowerBound: el.lowerBound,
+                        upperBound: el.upperBound,
+                        commodityQuantity: schedule.commodityQuantity,
+                        direction,
+                        limitW: resolveLimitW(direction, el.lowerBound, el.upperBound)
+                    }
+                }, null, null]);
+        }
+        // Signals that no PEBC-imposed bound is active right now - after the last known
+        // instruction is revoked, or its final element ends with nothing queued after it.
+        // Reuses the S2 meaning of a null bound ("unbounded on this side") rather than a
+        // separate message shape, so downstream consumers can treat it like any other
+        // active-element update.
+        function emitReleased(cemId, commodityQuantity) {
+            lastEmittedActive = null;
+            const direction = resolveDirection(commodityQuantity);
+            lastAnnouncedDirection = direction;
+            node.send([{ cemId, payload: { lowerBound: null, upperBound: null, commodityQuantity, direction, limitW: null } }, null, null]);
+            updateNodeStatus();
+        }
+        function scheduleNextDispatch(schedule) {
+            if (scheduleTimer) {
+                clearTimeout(scheduleTimer);
+                scheduleTimer = null;
+            }
+            const now = Date.now();
+            const nextStart = (0, schedule_1.getNextElementStart)(schedule, now);
+            if (nextStart !== null) {
+                const delay = Math.max(0, nextStart - now);
+                scheduleTimer = setTimeout(() => {
+                    scheduleTimer = null;
+                    emitActiveElement(schedule);
+                    scheduleNextDispatch(schedule);
+                }, delay);
+                return;
+            }
+            // No next element queued - if one is currently active, it's the last one:
+            // arm a release once it ends instead of leaving output 1 silent forever.
+            const active = (0, schedule_1.getActiveElement)(schedule, now);
+            if (!active)
+                return;
+            const delay = Math.max(0, active.endMs - now);
+            scheduleTimer = setTimeout(() => {
+                scheduleTimer = null;
+                emitReleased(schedule.cemId, schedule.commodityQuantity);
+            }, delay);
+        }
+        function applySchedule(schedule) {
+            node.context().set(SCHEDULE_CONTEXT_KEY, schedule);
+            saveSchedule(schedule);
+            emitActiveElement(schedule);
+            scheduleNextDispatch(schedule);
+            node.send([null, {
+                    cemId: schedule.cemId,
+                    payload: {
+                        commodityQuantity: schedule.commodityQuantity,
+                        elements: schedule.elements.map(el => ({
+                            startTime: new Date(el.startMs).toISOString(),
+                            endTime: new Date(el.endMs).toISOString(),
+                            durationSec: Math.round(el.duration / 1000),
+                            lowerBound: el.lowerBound,
+                            upperBound: el.upperBound
+                        }))
+                    }
+                }, null]);
+            updateNodeStatus();
+        }
+        function handleInstruction(msg) {
+            if (msg.controlType !== messages_1.ControlType.PEBC) {
+                node.status({ fill: 'yellow', shape: 'ring', text: `ignoring ${String(msg.controlType)} instruction` });
+                node.send([msg, null, null]);
+                return;
+            }
+            const cemId = msg.cemId;
+            const rawMsg = (msg.pebc || msg.payload);
+            const parsed = (0, schedule_1.parsePebcInstruction)(rawMsg, Date.now(), cemId);
+            if (!parsed || parsed.elements.length === 0)
+                return;
+            const constraintsId = rawMsg.power_constraints_id;
+            if (constraintsId && constraintsId !== pebcConstraintsId) {
+                pebcSlots.clear();
+                pebcConstraintsId = constraintsId;
+            }
+            for (const el of parsed.elements) {
+                pebcSlots.set(el.startMs, { element: el, commodityQuantity: parsed.commodityQuantity, cemId: cemId || '', instructionId: parsed.instructionId });
+            }
+            const sorted = [...pebcSlots.values()].sort((a, b) => a.element.startMs - b.element.startMs);
+            const combined = {
+                receivedAt: Date.now(),
+                cemId: sorted[0].cemId,
+                instructionId: parsed.instructionId,
+                commodityQuantity: sorted[0].commodityQuantity,
+                elements: sorted.map(s => s.element)
+            };
+            applySchedule(combined);
+        }
+        function handleRevoke(msg) {
+            const payload = msg.payload;
+            const revokedId = payload.object_id;
+            const revokedObjectType = payload.object_type;
+            if (!revokedId || !revokedObjectType || !revokedObjectType.endsWith('.Instruction'))
+                return;
+            let found = false;
+            let commodityQuantity = '';
+            for (const [key, slot] of pebcSlots.entries()) {
+                if (slot.instructionId === revokedId) {
+                    commodityQuantity = slot.commodityQuantity;
+                    pebcSlots.delete(key);
+                    found = true;
+                }
+            }
+            if (!found)
+                return;
+            node.send([null, null, { payload: { command: 'InstructionStatus', cemId: msg.cemId, instructionId: revokedId, status: messages_1.InstructionStatus.REVOKED } }]);
+            if (pebcSlots.size === 0) {
+                if (scheduleTimer) {
+                    clearTimeout(scheduleTimer);
+                    scheduleTimer = null;
+                }
+                node.context().set(SCHEDULE_CONTEXT_KEY, null);
+                emitReleased(msg.cemId || '', commodityQuantity);
+            }
+            else {
+                const sorted = [...pebcSlots.values()].sort((a, b) => a.element.startMs - b.element.startMs);
+                const rebuilt = {
+                    receivedAt: Date.now(),
+                    cemId: sorted[0].cemId,
+                    instructionId: sorted[0].instructionId,
+                    commodityQuantity: sorted[0].commodityQuantity,
+                    elements: sorted.map(s => s.element)
+                };
+                applySchedule(rebuilt);
+            }
+        }
+        function buildCurrentSchedule() {
+            if (pebcSlots.size === 0)
+                return null;
+            const sorted = [...pebcSlots.values()].sort((a, b) => a.element.startMs - b.element.startMs);
+            return {
+                receivedAt: Date.now(),
+                cemId: sorted[0].cemId,
+                instructionId: sorted[0].instructionId,
+                commodityQuantity: sorted[0].commodityQuantity,
+                elements: sorted.map(s => s.element)
+            };
+        }
+        function handleForecast(msg) {
+            const payload = msg.payload;
+            const forecast = payload.forecast;
+            const schedule = forecast ? buildCurrentSchedule() : null;
+            if (!forecast || !schedule) {
+                node.send([null, null, msg]);
+                return;
+            }
+            node.send([null, null, { ...msg, payload: { ...payload, forecast: (0, schedule_1.capForecastToSchedule)(forecast, schedule) } }]);
+        }
+        function handlePowerMeasurement(msg) {
+            const payload = msg.payload;
+            const values = payload.values;
+            if (!Array.isArray(values))
+                return;
+            for (const v of values) {
+                if (typeof v.value === 'number' && typeof v.commodity_quantity === 'string') {
+                    lastMeasurement.set(v.commodity_quantity, v.value);
+                }
+            }
+            reannounceIfDirectionChanged();
+        }
+        // Re-emits the active element on output 1 only (no InstructionStatus on output 3) when a
+        // measurement flips which side of an asymmetric bound currently applies. Deliberately
+        // independent of emitActiveElement's dedup/InstructionStatus logic - the instruction itself
+        // hasn't changed, only which of its two bounds is presently binding.
+        function reannounceIfDirectionChanged() {
+            const schedule = buildCurrentSchedule();
+            if (!schedule)
+                return;
+            const el = (0, schedule_1.getActiveElement)(schedule, Date.now());
+            if (!el)
+                return;
+            const direction = resolveDirection(schedule.commodityQuantity);
+            if (direction === lastAnnouncedDirection)
+                return;
+            const importLimit = resolveLimitW('import', el.lowerBound, el.upperBound);
+            const exportLimit = resolveLimitW('export', el.lowerBound, el.upperBound);
+            lastAnnouncedDirection = direction;
+            if (importLimit === exportLimit)
+                return;
+            node.send([{
+                    cemId: schedule.cemId,
+                    payload: {
+                        startTime: new Date(el.startMs).toISOString(),
+                        endTime: new Date(el.endMs).toISOString(),
+                        duration: el.duration,
+                        lowerBound: el.lowerBound,
+                        upperBound: el.upperBound,
+                        commodityQuantity: schedule.commodityQuantity,
+                        direction,
+                        limitW: resolveLimitW(direction, el.lowerBound, el.upperBound)
+                    }
+                }, null, null]);
+        }
+        updateNodeStatus();
+        node.on('input', (msg, _send, done) => {
+            if ('controlType' in msg) {
+                handleInstruction(msg);
+                done();
+                return;
+            }
+            const payload = msg.payload;
+            if (payload && typeof payload === 'object' && payload.message_type === messages_1.MessageType.REVOKE_OBJECT) {
+                handleRevoke(msg);
+                done();
+                return;
+            }
+            if (payload && typeof payload === 'object' && payload.command === 'Forecast') {
+                handleForecast(msg);
+                done();
+                return;
+            }
+            if (payload && typeof payload === 'object' && payload.command === 'PowerMeasurement') {
+                handlePowerMeasurement(msg);
+                done();
+                return;
+            }
+            done();
+        });
+        node.on('close', (done) => {
+            if (scheduleTimer) {
+                clearTimeout(scheduleTimer);
+                scheduleTimer = null;
+            }
+            done();
+        });
+        loadPersistedSchedule();
+        // Push the configured default power constraints on deploy, used until a runtime
+        // override is supplied. Deferred so s2-rm's input listener is guaranteed attached first.
+        const defaultMaxPowerW = (0, messages_1.gridConnectionToWatts)(pebcConfigNode.gridConnection, pebcConfigNode.customMaxPowerW);
+        // Published so downstream flow logic can derive a released-state limit (e.g. amps)
+        // the same way it derives any other numeric bound, instead of hardcoding one.
+        node.context().flow.set('pebcDefaultMaxPowerW', defaultMaxPowerW);
+        if (defaultMaxPowerW != null) {
+            const constraints = {
+                commodityQuantity: 'ELECTRIC.POWER.3_PHASE_SYMMETRIC',
+                minPower: -defaultMaxPowerW,
+                maxPower: defaultMaxPowerW
+            };
+            setTimeout(() => {
+                node.send([null, null, { payload: { command: 'PowerConstraints', constraints } }]);
+            }, 100);
+        }
+    }
+    RED.nodes.registerType('s2-pebc', S2PebcNode);
+};
+//# sourceMappingURL=index.js.map

package/dist/nodes/s2-pebc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/nodes/s2-pebc/index.ts"],"names":[],"mappings":"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"}

package/dist/nodes/s2-pebc-config/index.d.ts

@@ -0,0 +1,3 @@
+import { NodeRedApp } from '../../types/node-red';
+declare const _default: (RED: NodeRedApp) => void;
+export = _default;

package/dist/nodes/s2-pebc-config/index.html

@@ -0,0 +1,64 @@
+<script src="resources/node-red-contrib-s2/s2-common.js"></script>
+<script type="text/javascript">
+  RED.nodes.registerType('s2-pebc-config', {
+    category: 'config',
+    defaults: {
+      name: { value: '' },
+      gridConnection: { value: '' },
+      customMaxPowerW: { value: '' }
+    },
+    label: function () {
+      return this.name || 's2-pebc-config'
+    },
+    oneditprepare: function () {
+      function updateCustomPowerVisibility () {
+        var val = $('#node-config-input-gridConnection').val()
+        $('#s2-pebc-config-custom-power-row').toggle(val === 'custom')
+      }
+      $('#node-config-input-gridConnection').on('change', updateCustomPowerVisibility)
+      updateCustomPowerVisibility()
+
+      window.__s2Common.initializeTooltips()
+    }
+  })
+</script>
+
+<script type="text/html" data-template-name="s2-pebc-config">
+  <div class="s2-form">
+
+    <div class="form-row">
+      <label for="node-config-input-name"><i class="fa fa-tag"></i> Name</label>
+      <input type="text" id="node-config-input-name" placeholder="Name (optional)">
+    </div>
+
+    <div class="form-row">
+      <label for="node-config-input-gridConnection"><i class="fa fa-plug"></i> Grid Fuse<i class="fa fa-info-circle tooltip-icon" data-tooltip="Fuse/breaker capacity at the grid connection point. Sets the default outer PEBC power limits sent to the CEM as [-max, +max] watts, until a runtime override is supplied."></i></label>
+      <select id="node-config-input-gridConnection">
+        <option value="">-- Not set --</option>
+        <option value="1x16A">1x16A (3.7 kW)</option>
+        <option value="3x16A">3x16A (11 kW)</option>
+        <option value="3x25A">3x25A (17.3 kW)</option>
+        <option value="3x32A">3x32A (22 kW)</option>
+        <option value="3x40A">3x40A (27.6 kW)</option>
+        <option value="3x63A">3x63A (43.5 kW)</option>
+        <option value="custom">Custom</option>
+      </select>
+    </div>
+
+    <div class="form-row" id="s2-pebc-config-custom-power-row" style="display:none">
+      <label for="node-config-input-customMaxPowerW"><i class="fa fa-bolt"></i> Max Power (W)<i class="fa fa-info-circle tooltip-icon" data-tooltip="Maximum power in watts for a custom grid connection. Used as both import and export limit."></i></label>
+      <input type="number" id="node-config-input-customMaxPowerW" placeholder="e.g. 15000" min="1">
+    </div>
+
+  </div>
+</script>
+
+<script type="text/html" data-help-name="s2-pebc-config">
+  <p>Configuration for <b>s2-pebc</b>: the default <code>PEBC.PowerConstraints</code> range it pushes on deploy, used until a runtime override is supplied or a CEM sends its own.</p>
+
+  <p><b>Grid Fuse</b> picks a standard fuse/breaker size; <b>s2-pebc</b> converts it to a symmetric <code>[-max, +max]</code> watt range (the same limit for import and export). Choose <b>Custom</b> to set an exact wattage instead - useful when the site's actual limit doesn't match a standard fuse size, or is asymmetric in practice.</p>
+
+  <p>Leaving this unset is valid: <b>s2-pebc</b> simply won't push a default, and relies entirely on whatever the CEM sends. The configured value is also published to flow context as <code>pebcDefaultMaxPowerW</code>, so your own flow logic can fall back to it - for example when a PEBC instruction's bound is released (<code>null</code>) and you need to know what limit to apply instead of leaving your hardware silently unconstrained.</p>
+</script>
+
+<link rel="stylesheet" href="resources/node-red-contrib-s2/s2-styles.css">