node-red-contrib-s2 0.1.1

package/dist/lib/s2/session.js

@@ -0,0 +1,304 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S2Session = exports.State = void 0;
+const messages_1 = require("./messages");
+/**
+ * S2 session states.
+ */
+exports.State = Object.freeze({
+    HANDSHAKING: 'HANDSHAKING', // Handshake sent by RM, waiting for HandshakeResponse from CEM
+    CONNECTED: 'CONNECTED' // HandshakeResponse received, session active
+});
+/**
+ * S2Session manages the S2 protocol state for a single CEM connection.
+ *
+ * The RM (us) initiates the Handshake immediately after the CEM connects.
+ * This applies to both transports:
+ * - D-Bus (acload): CEM calls Connect on D-Bus, RM sends Handshake via Message signal
+ * - WebSocket (future): CEM opens WS connection, RM sends Handshake over the socket
+ *
+ * Usage:
+ *   const session = new S2Session({
+ *     cemId,
+ *     rmDetails,
+ *     controlTypeConfig: {  // optional control type configuration
+ *       OMBC: {
+ *         systemDescription: { operationModes: [...], transitions: [], timers: [] },
+ *         status: { activeOperationModeId: 'mode-1', operationModeFactor: 1 }
+ *       }
+ *     },
+ *     onSend:        (msg) => <send S2 message object to CEM>,
+ *     onStateChange: (state) => ...,
+ *     onMessage:     (msg) => <forward received message downstream>,
+ *     onError:       (err) => ...
+ *   })
+ *
+ *   session.start()              // sends Handshake, call after Connect
+ *   session.handleMessage(msg)   // call for each Message from the CEM
+ *   session.send(msg)            // send an outbound S2 message (only when CONNECTED)
+ */
+class S2Session {
+    constructor({ cemId, rmDetails, controlTypeConfig, onSend, onStateChange, onMessage, onInstruction, onError, retryDelayMs, skipInstructionStatus }) {
+        var _a, _b;
+        this._cemId = cemId;
+        this._rmDetails = rmDetails;
+        this._controlTypeConfig = controlTypeConfig || {};
+        this._onSend = onSend || (() => { });
+        this._onStateChange = onStateChange || (() => { });
+        this._onMessage = onMessage || (() => { });
+        this._onInstruction = onInstruction || this._onMessage;
+        this._onError = onError || ((err) => console.error(err));
+        this._retryDelayMs = retryDelayMs !== null && retryDelayMs !== void 0 ? retryDelayMs : 5000;
+        this._skipInstructionStatus = skipInstructionStatus === true;
+        this._sentMessages = new Map();
+        this._retryTimers = new Map();
+        this._state = exports.State.HANDSHAKING;
+        this._selectedControlType = messages_1.ControlType.NO_SELECTION;
+        this._lastKeepAlive = null;
+        this._pebcPowerConstraints = null;
+        this._currentOMBCStatus = (_b = (_a = this._controlTypeConfig.OMBC) === null || _a === void 0 ? void 0 : _a.status) !== null && _b !== void 0 ? _b : null;
+    }
+    get cemId() { return this._cemId; }
+    get state() { return this._state; }
+    get selectedControlType() { return this._selectedControlType; }
+    get lastKeepAlive() { return this._lastKeepAlive; }
+    get currentOMBCStatus() { return this._currentOMBCStatus; }
+    /**
+     * Cancel pending retry timers and clear the sent-message buffer.
+     * Call when the session is no longer needed (disconnect, node close).
+     */
+    dispose() {
+        for (const timer of this._retryTimers.values()) {
+            clearTimeout(timer);
+        }
+        this._retryTimers.clear();
+        this._sentMessages.clear();
+    }
+    /**
+     * Record that a keepalive was received from the CEM.
+     */
+    keepAlive() {
+        this._lastKeepAlive = new Date();
+    }
+    /**
+     * Send the initial Handshake to the CEM. Call once after the CEM connects.
+     */
+    start() {
+        this._send((0, messages_1.makeHandshake)(this._cemId));
+    }
+    /**
+     * Process an S2 message received from the CEM.
+     * Accepts a raw JSON string or an already-parsed object.
+     */
+    handleMessage(raw) {
+        let msg;
+        if (raw && typeof raw === 'object') {
+            if (!raw.message_type) {
+                this._onError(new Error('S2 message missing message_type'));
+                return;
+            }
+            msg = raw;
+        }
+        else {
+            msg = (0, messages_1.parse)(raw, this._onError);
+        }
+        if (!msg)
+            return;
+        switch (msg.message_type) {
+            case messages_1.MessageType.HANDSHAKE:
+                // CEM's own Handshake (role: CEM) - ack and forward as a regular message
+                this._send((0, messages_1.makeReceptionStatus)(msg.message_id, messages_1.ReceptionStatusResult.OK));
+                this._onMessage(msg);
+                break;
+            case messages_1.MessageType.HANDSHAKE_RESPONSE:
+                this._handleHandshakeResponse(msg);
+                break;
+            case messages_1.MessageType.SELECT_CONTROL_TYPE:
+                this._handleSelectControlType(msg);
+                break;
+            case messages_1.MessageType.RECEPTION_STATUS: {
+                const statusResult = msg.status;
+                const subjectId = msg.subject_message_id;
+                if (subjectId && statusResult === messages_1.ReceptionStatusResult.OK) {
+                    const pendingTimer = this._retryTimers.get(subjectId);
+                    if (pendingTimer) {
+                        clearTimeout(pendingTimer);
+                        this._retryTimers.delete(subjectId);
+                    }
+                    this._sentMessages.delete(subjectId);
+                }
+                else if (subjectId && statusResult === messages_1.ReceptionStatusResult.TEMPORARY_ERROR) {
+                    const entry = this._sentMessages.get(subjectId);
+                    if (entry && entry.retryCount < 1) {
+                        entry.retryCount++;
+                        const timer = setTimeout(() => {
+                            this._retryTimers.delete(subjectId);
+                            const e = this._sentMessages.get(subjectId);
+                            if (e)
+                                this._onSend(e.msg);
+                        }, this._retryDelayMs);
+                        this._retryTimers.set(subjectId, timer);
+                    }
+                    else if (entry) {
+                        this._sentMessages.delete(subjectId);
+                        this._onError(new Error(`Message ${subjectId} rejected with TEMPORARY_ERROR after retry`));
+                    }
+                }
+                this._onMessage(msg);
+                break;
+            }
+            case messages_1.MessageType.REVOKE_OBJECT:
+                this._send((0, messages_1.makeReceptionStatus)(msg.message_id, messages_1.ReceptionStatusResult.OK));
+                this._onMessage(msg);
+                break;
+            case messages_1.MessageType.INSTRUCTION:
+            case messages_1.MessageType.FRBC_INSTRUCTION:
+            case messages_1.MessageType.DDBC_INSTRUCTION:
+            case messages_1.MessageType.OMBC_INSTRUCTION:
+            case messages_1.MessageType.PEBC_INSTRUCTION:
+            case messages_1.MessageType.PPBC_SCHEDULE_INSTRUCTION:
+            case messages_1.MessageType.PPBC_START_INTERRUPTION_INSTRUCTION:
+            case messages_1.MessageType.PPBC_END_INTERRUPTION_INSTRUCTION:
+                this._ackAndForward(msg);
+                break;
+            default:
+                this._onMessage(msg);
+                break;
+        }
+    }
+    /**
+     * Send an S2 message object to the CEM. Only valid when CONNECTED.
+     */
+    send(msg) {
+        if (this._state !== exports.State.CONNECTED) {
+            this._onError(new Error(`Cannot send in state ${this._state} for CEM ${this._cemId}`));
+            return;
+        }
+        this._send(msg);
+    }
+    /**
+     * Store PEBC power constraints and send them to the CEM immediately if
+     * PEBC is the active control type. Stored constraints are also sent
+     * automatically when SelectControlType(PEBC) is received.
+     */
+    setPEBCPowerConstraints(input) {
+        this._pebcPowerConstraints = input;
+        if (this._state === exports.State.CONNECTED &&
+            this._selectedControlType === messages_1.ControlType.PEBC) {
+            this._send((0, messages_1.makePEBCPowerConstraints)(input));
+        }
+    }
+    /**
+     * Update the tracked OMBC status and send OMBC.Status to the CEM.
+     * Call after an OMBC.Instruction is dispatched to inform the CEM of the new
+     * active operation mode. Also updates the status used when SELECT_CONTROL_TYPE
+     * is received again (e.g. after a CEM reconnect).
+     */
+    updateOMBCStatus(status) {
+        if (this._currentOMBCStatus &&
+            this._currentOMBCStatus.activeOperationModeId !== status.activeOperationModeId) {
+            status = {
+                ...status,
+                previousOperationModeId: this._currentOMBCStatus.activeOperationModeId,
+                transitionTimestamp: new Date().toISOString()
+            };
+        }
+        this._currentOMBCStatus = status;
+        if (this._state === exports.State.CONNECTED) {
+            this._send((0, messages_1.makeOMBCStatus)(status));
+        }
+    }
+    /**
+     * Send an InstructionStatusUpdate for an instruction previously received from the CEM.
+     * Use this to report STARTED, SUCCEEDED, ABORTED, etc. after ACCEPTED was auto-sent.
+     *
+     * @param instructionId - the `id` field of the instruction (not its message_id)
+     * @param status - one of InstructionStatus values
+     */
+    sendInstructionStatus(instructionId, status) {
+        this._send((0, messages_1.makeInstructionStatusUpdate)(instructionId, status));
+    }
+    // -- private --
+    /**
+     * Buffer the message by its message_id (if present) and forward to onSend.
+     * Buffered messages can be retried when the CEM responds with TEMPORARY_ERROR.
+     */
+    _send(msg) {
+        const m = msg;
+        if (typeof m.message_id === 'string') {
+            this._sentMessages.set(m.message_id, { msg, retryCount: 0 });
+        }
+        this._onSend(msg);
+    }
+    _setState(newState) {
+        if (newState !== this._state) {
+            this._state = newState;
+            this._onStateChange(newState);
+        }
+    }
+    _handleHandshakeResponse(msg) {
+        if (this._state !== exports.State.HANDSHAKING) {
+            this._onError(new Error(`Unexpected HandshakeResponse in state ${this._state} for CEM ${this._cemId}`));
+            return;
+        }
+        this._send((0, messages_1.makeReceptionStatus)(msg.message_id, messages_1.ReceptionStatusResult.OK));
+        this._setState(exports.State.CONNECTED);
+        this._onMessage(msg);
+        if (this._rmDetails) {
+            this._send((0, messages_1.makeResourceManagerDetails)(this._rmDetails));
+        }
+        else {
+            this._onError(new Error(`No rmDetails configured - cannot send ResourceManagerDetails for CEM ${this._cemId}`));
+        }
+    }
+    _handleSelectControlType(msg) {
+        this._selectedControlType = msg.control_type || messages_1.ControlType.NO_SELECTION;
+        this._send((0, messages_1.makeReceptionStatus)(msg.message_id, messages_1.ReceptionStatusResult.OK));
+        this._onMessage(msg);
+        // After SelectControlType, send the appropriate SystemDescription and Status
+        const controlType = msg.control_type;
+        if (controlType === messages_1.ControlType.OMBC || controlType === 'OMBC') {
+            this._sendOMBCSystemDescriptionAndStatus();
+        }
+        else if (controlType === messages_1.ControlType.PEBC) {
+            if (this._pebcPowerConstraints) {
+                this._send((0, messages_1.makePEBCPowerConstraints)(this._pebcPowerConstraints));
+            }
+        }
+    }
+    _sendOMBCSystemDescriptionAndStatus() {
+        const config = this._controlTypeConfig.OMBC;
+        if (!config) {
+            this._onError(new Error(`No OMBC config for CEM ${this._cemId} - set Control Type Config in the s2-rm node`));
+            return;
+        }
+        if (config.systemDescription) {
+            this._send((0, messages_1.makeOMBCSystemDescription)(config.systemDescription));
+        }
+        if (this._currentOMBCStatus) {
+            this._send((0, messages_1.makeOMBCStatus)(this._currentOMBCStatus));
+        }
+    }
+    _ackAndForward(msg) {
+        this._send((0, messages_1.makeReceptionStatus)(msg.message_id, messages_1.ReceptionStatusResult.OK));
+        const instructionId = msg.id;
+        if (typeof instructionId === 'string' && !this._skipInstructionStatus) {
+            this._send((0, messages_1.makeInstructionStatusUpdate)(instructionId, messages_1.InstructionStatus.ACCEPTED));
+        }
+        // For OMBC instructions: send OMBC.Status immediately at accept time.
+        // transition_timestamp is set to now (initiation time) by updateOMBCStatus when the mode changes.
+        if (msg.message_type === messages_1.MessageType.OMBC_INSTRUCTION) {
+            const modeId = msg.operation_mode_id;
+            const factor = msg.operation_mode_factor;
+            if (modeId) {
+                this.updateOMBCStatus({
+                    activeOperationModeId: modeId,
+                    operationModeFactor: typeof factor === 'number' ? factor : 1
+                });
+            }
+        }
+        this._onInstruction(msg);
+    }
+}
+exports.S2Session = S2Session;
+//# sourceMappingURL=session.js.map

package/dist/lib/s2/session.js.map

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

package/dist/lib/transport/websocket.d.ts

@@ -0,0 +1,58 @@
+import { EventEmitter } from 'events';
+export interface S2WebSocketTransportOptions {
+    url: string;
+    reconnectInterval?: number;
+    maxReconnectInterval?: number;
+    headers?: Record<string, string>;
+}
+/**
+ * S2WebSocketTransport manages a single outbound WebSocket connection
+ * from an RM to a CEM. It is a thin EventEmitter wrapper around `ws`
+ * with automatic reconnection, exponential backoff, and heartbeat.
+ *
+ * Events:
+ *   'open'    - WS connection established
+ *   'message' - raw string received from CEM, arg: string
+ *   'close'   - connection closed
+ *   'error'   - error occurred, arg: Error
+ *
+ * @example
+ * const transport = new S2WebSocketTransport({ url: 'wss://cem.local/s2/{resourceId}' })
+ * transport.on('open', () => { transport.send(JSON.stringify(handshake)) })
+ * transport.on('message', (raw) => handleMessage(raw))
+ * transport.on('close', () => handleDisconnect())
+ * transport.connect()
+ */
+export declare class S2WebSocketTransport extends EventEmitter {
+    private readonly _url;
+    private readonly _initialReconnectInterval;
+    private readonly _maxReconnectInterval;
+    private readonly _headers;
+    private _ws;
+    private _reconnectTimer;
+    private _heartbeatTimer;
+    private _intentionalClose;
+    private _currentReconnectInterval;
+    private _isAlive;
+    private _lastContact;
+    constructor({ url, reconnectInterval, maxReconnectInterval, headers }: S2WebSocketTransportOptions);
+    /**
+     * Initiate the WebSocket connection to the CEM.
+     */
+    connect(): void;
+    /**
+     * Close the WebSocket connection and stop reconnecting.
+     */
+    disconnect(): void;
+    /**
+     * Send a raw string over the WebSocket. Throws if not connected.
+     */
+    send(raw: string): void;
+    get url(): string;
+    get lastContact(): Date | null;
+    private _recordActivity;
+    private _doConnect;
+    private _startHeartbeat;
+    private _stopHeartbeat;
+    private _scheduleReconnect;
+}

package/dist/lib/transport/websocket.js

@@ -0,0 +1,149 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S2WebSocketTransport = void 0;
+const events_1 = require("events");
+const ws_1 = __importDefault(require("ws"));
+/**
+ * S2WebSocketTransport manages a single outbound WebSocket connection
+ * from an RM to a CEM. It is a thin EventEmitter wrapper around `ws`
+ * with automatic reconnection, exponential backoff, and heartbeat.
+ *
+ * Events:
+ *   'open'    - WS connection established
+ *   'message' - raw string received from CEM, arg: string
+ *   'close'   - connection closed
+ *   'error'   - error occurred, arg: Error
+ *
+ * @example
+ * const transport = new S2WebSocketTransport({ url: 'wss://cem.local/s2/{resourceId}' })
+ * transport.on('open', () => { transport.send(JSON.stringify(handshake)) })
+ * transport.on('message', (raw) => handleMessage(raw))
+ * transport.on('close', () => handleDisconnect())
+ * transport.connect()
+ */
+class S2WebSocketTransport extends events_1.EventEmitter {
+    constructor({ url, reconnectInterval = 5000, maxReconnectInterval = 30000, headers }) {
+        super();
+        this._url = url;
+        this._initialReconnectInterval = reconnectInterval;
+        this._maxReconnectInterval = maxReconnectInterval;
+        this._headers = headers;
+        this._ws = null;
+        this._reconnectTimer = null;
+        this._heartbeatTimer = null;
+        this._intentionalClose = false;
+        this._currentReconnectInterval = reconnectInterval;
+        this._isAlive = false;
+        this._lastContact = null;
+    }
+    /**
+     * Initiate the WebSocket connection to the CEM.
+     */
+    connect() {
+        this._intentionalClose = false;
+        this._doConnect();
+    }
+    /**
+     * Close the WebSocket connection and stop reconnecting.
+     */
+    disconnect() {
+        this._intentionalClose = true;
+        this._stopHeartbeat();
+        if (this._reconnectTimer) {
+            clearTimeout(this._reconnectTimer);
+            this._reconnectTimer = null;
+        }
+        if (this._ws) {
+            this._ws.terminate();
+            this._ws = null;
+        }
+    }
+    /**
+     * Send a raw string over the WebSocket. Throws if not connected.
+     */
+    send(raw) {
+        if (!this._ws) {
+            throw new Error('WebSocket is not connected');
+        }
+        this._ws.send(raw);
+    }
+    get url() {
+        return this._url;
+    }
+    get lastContact() {
+        return this._lastContact;
+    }
+    // -- private --
+    _recordActivity() {
+        this._isAlive = true;
+        this._lastContact = new Date();
+        this.emit('activity', this._lastContact);
+    }
+    _doConnect() {
+        const ws = this._headers
+            ? new ws_1.default(this._url, { headers: this._headers })
+            : new ws_1.default(this._url);
+        this._ws = ws;
+        ws.on('open', () => {
+            this._currentReconnectInterval = this._initialReconnectInterval;
+            this._recordActivity();
+            this._startHeartbeat();
+            this.emit('open');
+        });
+        ws.on('message', (data) => {
+            this._recordActivity();
+            this.emit('message', data.toString());
+        });
+        ws.on('pong', () => {
+            this._recordActivity();
+        });
+        ws.on('close', () => {
+            this._ws = null;
+            this._stopHeartbeat();
+            this.emit('close');
+            if (!this._intentionalClose) {
+                this._scheduleReconnect();
+            }
+        });
+        ws.on('error', (err) => {
+            this.emit('error', err);
+            // 'close' will fire after 'error', reconnect is handled there
+        });
+    }
+    _startHeartbeat() {
+        this._stopHeartbeat();
+        this._heartbeatTimer = setInterval(() => {
+            if (this._isAlive === false) {
+                if (this._ws) {
+                    this._ws.terminate();
+                }
+                return;
+            }
+            this._isAlive = false;
+            if (this._ws) {
+                this._ws.ping();
+            }
+        }, 30000);
+    }
+    _stopHeartbeat() {
+        if (this._heartbeatTimer) {
+            clearInterval(this._heartbeatTimer);
+            this._heartbeatTimer = null;
+        }
+    }
+    _scheduleReconnect() {
+        if (this._reconnectTimer)
+            return;
+        this._reconnectTimer = setTimeout(() => {
+            this._reconnectTimer = null;
+            this._doConnect();
+        }, this._currentReconnectInterval);
+        // Increase interval for next time
+        this._currentReconnectInterval = Math.min(this._currentReconnectInterval * 2, this._maxReconnectInterval);
+    }
+}
+exports.S2WebSocketTransport = S2WebSocketTransport;
+//# sourceMappingURL=websocket.js.map

package/dist/lib/transport/websocket.js.map

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

package/dist/nodes/s2-cem-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-cem-config/index.html

@@ -0,0 +1,54 @@
+<script src="resources/node-red-contrib-s2/s2-common.js"></script>
+<script type="text/javascript">
+  RED.nodes.registerType('s2-cem-config', {
+    category: 'config',
+    defaults: {
+      name: { value: '' },
+      url: { value: '', required: true },
+      apiPrefix: { value: '' }
+    },
+    credentials: {
+      username: { type: 'text' },
+      password: { type: 'password' }
+    },
+    label: function () {
+      return this.name || this.url || 's2-cem-config'
+    },
+    oneditprepare: function () {
+      window.__s2Common.initializeTooltips()
+    }
+  })
+</script>
+
+<script type="text/html" data-template-name="s2-cem-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-url"><i class="fa fa-globe"></i> CEM URL<i class="fa fa-info-circle tooltip-icon" data-tooltip="WebSocket URL of the CEM. Either use {resourceId} as a placeholder (e.g. wss://cem.example.com/s2/{resourceId}) or end the URL with a trailing slash and the Resource ID will be appended automatically (e.g. wss://cem.example.com/s2/ws/)."></i></label>
+      <input type="text" id="node-config-input-url" placeholder="wss://cem.example.com/s2/ws/">
+    </div>
+
+    <div class="form-row">
+      <label for="node-config-input-apiPrefix"><i class="fa fa-folder"></i> API Prefix<i class="fa fa-info-circle tooltip-icon" data-tooltip="Optional path prefix for the CEM REST API (e.g. /s2-message-handler). Used to build flex instruction URLs. Leave empty if the REST API is at the root."></i></label>
+      <input type="text" id="node-config-input-apiPrefix" placeholder="/s2-message-handler (optional)">
+    </div>
+
+    <div class="form-row">
+      <label for="node-config-input-username"><i class="fa fa-user"></i> Username</label>
+      <input type="text" id="node-config-input-username" placeholder="Username (optional)">
+    </div>
+
+    <div class="form-row">
+      <label for="node-config-input-password"><i class="fa fa-lock"></i> Password</label>
+      <input type="password" id="node-config-input-password" placeholder="Password (optional)">
+    </div>
+
+  </div>
+</script>
+
+<link rel="stylesheet" href="resources/node-red-contrib-s2/s2-styles.css">

package/dist/nodes/s2-cem-config/index.js

@@ -0,0 +1,16 @@
+"use strict";
+module.exports = function (RED) {
+    function S2CemConfigNodeConstructor(config) {
+        RED.nodes.createNode(this, config);
+        this.url = config.url;
+        this.apiPrefix = config.apiPrefix;
+        // credentials are populated automatically by Node-RED
+    }
+    RED.nodes.registerType('s2-cem-config', S2CemConfigNodeConstructor, {
+        credentials: {
+            username: { type: 'text' },
+            password: { type: 'password' }
+        }
+    });
+};
+//# sourceMappingURL=index.js.map

package/dist/nodes/s2-cem-config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/nodes/s2-cem-config/index.ts"],"names":[],"mappings":";AAGA,iBAAS,UAAU,GAAe;IAChC,SAAS,0BAA0B,CAAyB,MAAkB;QAC5E,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAClC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAa,CAAA;QAC/B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAA+B,CAAA;QACvD,sDAAsD;IACxD,CAAC;IAED,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,0BAA0B,EAAE;QAClE,WAAW,EAAE;YACX,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;YAC1B,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;SAC/B;KACF,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/nodes/s2-rm/icons/s2-logo.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 1042 1042" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
+    <g transform="matrix(1,0,0,1,-312,-142)">
+        <g transform="matrix(1038.75,-1038.75,-1038.75,-1038.75,314.531,1181.19)">
+            <path d="M0.75,0.251C0.739,0.262 0.727,0.272 0.715,0.281C0.708,0.286 0.701,0.291 0.694,0.296C0.65,0.325 0.6,0.344 0.549,0.351C0.516,0.356 0.482,0.356 0.449,0.351C0.398,0.344 0.348,0.325 0.303,0.296C0.284,0.283 0.265,0.268 0.248,0.251C0.22,0.223 0.22,0.178 0.248,0.15C0.276,0.123 0.321,0.123 0.348,0.15C0.366,0.168 0.386,0.182 0.407,0.192C0.465,0.22 0.533,0.22 0.591,0.192C0.612,0.182 0.632,0.168 0.649,0.15L0.758,0.042C0.773,0.027 0.789,0.015 0.806,0.006C0.821,-0.003 0.837,-0.009 0.853,-0.013C0.902,-0.026 0.954,-0.022 1,-0L0.75,0.251ZM0.525,0.115C0.499,0.112 0.482,0.097 0.474,0.088C0.465,0.078 0.466,0.062 0.477,0.052C0.487,0.043 0.503,0.044 0.513,0.054C0.515,0.057 0.521,0.063 0.531,0.064C0.541,0.065 0.551,0.061 0.557,0.052C0.564,0.042 0.564,0.026 0.556,0.016C0.549,0.008 0.538,0.006 0.535,0.005L0.33,-0.014L0.447,-0.132C0.457,-0.142 0.474,-0.142 0.483,-0.132C0.493,-0.122 0.493,-0.106 0.483,-0.096L0.443,-0.055L0.541,-0.045C0.551,-0.044 0.577,-0.039 0.596,-0.015C0.618,0.013 0.619,0.052 0.599,0.081C0.596,0.085 0.593,0.089 0.59,0.092C0.573,0.109 0.549,0.118 0.525,0.115ZM0.649,-0.15C0.632,-0.168 0.612,-0.182 0.591,-0.192C0.533,-0.22 0.465,-0.22 0.407,-0.192C0.386,-0.182 0.366,-0.168 0.348,-0.15L0.24,-0.042C0.225,-0.027 0.209,-0.015 0.192,-0.006C0.177,0.003 0.161,0.009 0.145,0.013C0.096,0.026 0.044,0.022 -0.003,0L0.248,-0.251C0.259,-0.262 0.271,-0.272 0.282,-0.281C0.289,-0.286 0.296,-0.291 0.303,-0.296C0.348,-0.325 0.398,-0.344 0.449,-0.351C0.482,-0.356 0.516,-0.356 0.549,-0.351C0.6,-0.344 0.65,-0.325 0.694,-0.296C0.714,-0.283 0.732,-0.268 0.75,-0.251C0.777,-0.223 0.777,-0.178 0.75,-0.15C0.722,-0.123 0.677,-0.123 0.649,-0.15Z" style="fill:url(#s2logo-gradient);fill-rule:nonzero;"/>
+        </g>
+    </g>
+    <defs>
+        <linearGradient id="s2logo-gradient" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(1,0,0,-1,0,3.73045e-07)">
+            <stop offset="0" style="stop-color:rgb(45,19,75);stop-opacity:1"/>
+            <stop offset="0.37" style="stop-color:rgb(25,38,101);stop-opacity:1"/>
+            <stop offset="1" style="stop-color:rgb(17,88,163);stop-opacity:1"/>
+        </linearGradient>
+    </defs>
+</svg>