node-red-contrib-senec-cloud-v2 0.2.0

package/dist/lib/error-handler.js

@@ -0,0 +1,139 @@
+"use strict";
+/**
+ * Error Handler
+ *
+ * Centralized error handling with classification and retry logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorHandler = void 0;
+class ErrorHandler {
+    /**
+     * Handle and classify an error
+     */
+    handleError(error) {
+        const errorType = this.classifyError(error);
+        const shouldRetry = this.shouldRetry(error);
+        const retryDelay = shouldRetry ? this.getRetryDelay(1) : undefined;
+        return {
+            type: errorType,
+            message: this.getErrorMessage(error),
+            originalError: error,
+            shouldRetry,
+            retryDelay,
+        };
+    }
+    /**
+     * Classify error by type
+     */
+    classifyError(error) {
+        if (this.isAxiosError(error)) {
+            const status = error.response?.status;
+            if (status === 401 || status === 403) {
+                return 'authentication';
+            }
+            if (status === 429) {
+                return 'rateLimit';
+            }
+            if (status && status >= 400 && status < 500) {
+                return 'client';
+            }
+            if (status && status >= 500) {
+                return 'server';
+            }
+            // Network errors, timeouts
+            if (error.code === 'ECONNABORTED' || error.code === 'ETIMEDOUT') {
+                return 'transient';
+            }
+        }
+        // Default to transient for unknown errors
+        return 'transient';
+    }
+    /**
+     * Determine if error should be retried
+     */
+    shouldRetry(error) {
+        const errorType = this.classifyError(error);
+        switch (errorType) {
+            case 'transient':
+            case 'server':
+            case 'rateLimit':
+                return true;
+            case 'authentication':
+                // Authentication errors should trigger re-auth, not simple retry
+                return false;
+            case 'client':
+                // Client errors (bad request) should not be retried
+                return false;
+            default:
+                return false;
+        }
+    }
+    /**
+     * Calculate retry delay with exponential backoff
+     * @param attempt - Retry attempt number (1-based)
+     */
+    getRetryDelay(attempt) {
+        const delays = [
+            10000, // 10 seconds
+            30000, // 30 seconds
+            60000, // 1 minute
+            300000, // 5 minutes
+        ];
+        const baseDelay = delays[Math.min(attempt - 1, delays.length - 1)];
+        // Add jitter (±20%)
+        const jitter = baseDelay * 0.2 * (Math.random() * 2 - 1);
+        return Math.floor(baseDelay + jitter);
+    }
+    /**
+     * Get Retry-After header value if present (for rate limiting)
+     */
+    getRetryAfter(error) {
+        const retryAfter = error.response?.headers['retry-after'];
+        if (!retryAfter) {
+            return null;
+        }
+        // Retry-After can be in seconds or HTTP date
+        const seconds = parseInt(retryAfter, 10);
+        if (!isNaN(seconds)) {
+            return seconds * 1000; // Convert to milliseconds
+        }
+        // Try parsing as date
+        const date = new Date(retryAfter);
+        if (!isNaN(date.getTime())) {
+            return Math.max(0, date.getTime() - Date.now());
+        }
+        return null;
+    }
+    /**
+     * Get user-friendly error message
+     */
+    getErrorMessage(error) {
+        if (this.isAxiosError(error)) {
+            const status = error.response?.status;
+            if (status === 401) {
+                return 'Authentication failed. Please check your credentials.';
+            }
+            if (status === 429) {
+                return 'Rate limit exceeded. Please wait before retrying.';
+            }
+            if (status && status >= 500) {
+                return 'SENEC Cloud service error. Will retry automatically.';
+            }
+            if (error.code === 'ECONNABORTED' || error.code === 'ETIMEDOUT') {
+                return 'Connection timeout. Will retry automatically.';
+            }
+            if (error.code === 'ENOTFOUND' || error.code === 'ECONNREFUSED') {
+                return 'Cannot reach SENEC Cloud. Check your internet connection.';
+            }
+        }
+        return error.message || 'Unknown error occurred';
+    }
+    /**
+     * Type guard for AxiosError
+     */
+    isAxiosError(error) {
+        return error.isAxiosError === true;
+    }
+}
+exports.ErrorHandler = ErrorHandler;
+//# sourceMappingURL=error-handler.js.map

package/dist/lib/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/lib/error-handler.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAKH,MAAa,YAAY;IACvB;;OAEG;IACH,WAAW,CAAC,KAAyB;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEnE,OAAO;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YACpC,aAAa,EAAE,KAAK;YACpB,WAAW;YACX,UAAU;SACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAyB;QACrC,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC;YAEtC,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACrC,OAAO,gBAAgB,CAAC;YAC1B,CAAC;YAED,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnB,OAAO,WAAW,CAAC;YACrB,CAAC;YAED,IAAI,MAAM,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;gBAC5C,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,IAAI,MAAM,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBAC5B,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,2BAA2B;YAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAChE,OAAO,WAAW,CAAC;YACrB,CAAC;QACH,CAAC;QAED,0CAA0C;QAC1C,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAyB;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAE5C,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,WAAW,CAAC;YACjB,KAAK,QAAQ,CAAC;YACd,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC;YAEd,KAAK,gBAAgB;gBACnB,iEAAiE;gBACjE,OAAO,KAAK,CAAC;YAEf,KAAK,QAAQ;gBACX,oDAAoD;gBACpD,OAAO,KAAK,CAAC;YAEf;gBACE,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,OAAe;QAC3B,MAAM,MAAM,GAAG;YACb,KAAK,EAAI,aAAa;YACtB,KAAK,EAAI,aAAa;YACtB,KAAK,EAAI,WAAW;YACpB,MAAM,EAAG,YAAY;SACtB,CAAC;QAEF,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAEnE,oBAAoB;QACpB,MAAM,MAAM,GAAG,SAAS,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAEzD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAiB;QAC7B,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QAE1D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,6CAA6C;QAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACpB,OAAO,OAAO,GAAG,IAAI,CAAC,CAAC,0BAA0B;QACnD,CAAC;QAED,sBAAsB;QACtB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,KAAyB;QAC/C,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC;YAEtC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnB,OAAO,uDAAuD,CAAC;YACjE,CAAC;YAED,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnB,OAAO,mDAAmD,CAAC;YAC7D,CAAC;YAED,IAAI,MAAM,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBAC5B,OAAO,sDAAsD,CAAC;YAChE,CAAC;YAED,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAChE,OAAO,+CAA+C,CAAC;YACzD,CAAC;YAED,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBAChE,OAAO,2DAA2D,CAAC;YACrE,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,OAAO,IAAI,wBAAwB,CAAC;IACnD,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,KAAU;QAC7B,OAAO,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC;IACrC,CAAC;CACF;AA9JD,oCA8JC"}

package/dist/lib/senec-api-client.d.ts

@@ -0,0 +1,45 @@
+/**
+ * SENEC API Client
+ *
+ * Main API client for interacting with the SENEC Cloud App API
+ * (app-gateway.prod.senec.dev, in use since the August 2025 API change).
+ * Coordinates authentication, data retrieval, and error handling.
+ */
+import { SenecConfig, SenecData, ConnectionStatus } from '../types/senec';
+export declare class SenecAPIClient {
+    private config;
+    private authManager;
+    private dataParser;
+    private errorHandler;
+    private httpClient;
+    private status;
+    private systemId;
+    private systemInfo;
+    constructor(config: SenecConfig);
+    /**
+     * Ensure a valid access token is available
+     */
+    private ensureAuthenticated;
+    /**
+     * Get the ID of the first SENEC system associated with the account.
+     * The result is cached for subsequent calls.
+     */
+    private getSystemId;
+    /**
+     * Get current energy data from SENEC Cloud
+     */
+    getData(retried?: boolean): Promise<SenecData>;
+    /**
+     * Test connection to SENEC Cloud
+     */
+    testConnection(): Promise<boolean>;
+    /**
+     * Get current connection status
+     */
+    getStatus(): ConnectionStatus;
+    /**
+     * Disconnect and clear authentication
+     */
+    disconnect(): void;
+}
+//# sourceMappingURL=senec-api-client.d.ts.map

package/dist/lib/senec-api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"senec-api-client.d.ts","sourceRoot":"","sources":["../../src/lib/senec-api-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAO1E,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,UAAU,CAAa;gBAEnB,MAAM,EAAE,WAAW;IAwB/B;;OAEG;YACW,mBAAmB;IAgBjC;;;OAGG;YACW,WAAW;IAmBzB;;OAEG;IACG,OAAO,CAAC,OAAO,GAAE,OAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAyC3D;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAYxC;;OAEG;IACH,SAAS,IAAI,gBAAgB;IAI7B;;OAEG;IACH,UAAU,IAAI,IAAI;CAMnB"}

package/dist/lib/senec-api-client.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * SENEC API Client
+ *
+ * Main API client for interacting with the SENEC Cloud App API
+ * (app-gateway.prod.senec.dev, in use since the August 2025 API change).
+ * Coordinates authentication, data retrieval, and error handling.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SenecAPIClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const auth_manager_1 = require("./auth-manager");
+const data_parser_1 = require("./data-parser");
+const error_handler_1 = require("./error-handler");
+const API_BASE = 'https://app-gateway.prod.senec.dev';
+class SenecAPIClient {
+    constructor(config) {
+        this.status = 'disconnected';
+        this.systemId = null;
+        this.systemInfo = null;
+        this.config = {
+            timeout: 30000,
+            retryAttempts: 3,
+            retryDelay: 10000,
+            ...config,
+        };
+        this.authManager = new auth_manager_1.AuthenticationManager({
+            username: config.username,
+            password: config.password,
+        });
+        this.dataParser = new data_parser_1.DataParser();
+        this.errorHandler = new error_handler_1.ErrorHandler();
+        this.httpClient = axios_1.default.create({
+            timeout: this.config.timeout,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+    }
+    /**
+     * Ensure a valid access token is available
+     */
+    async ensureAuthenticated() {
+        if (!this.authManager.isTokenValid()) {
+            if (this.authManager.canRefresh()) {
+                await this.authManager.refreshToken();
+            }
+            else {
+                await this.authManager.authenticate();
+            }
+        }
+        const token = this.authManager.getToken();
+        if (!token) {
+            throw new Error('No authentication token available');
+        }
+        return token;
+    }
+    /**
+     * Get the ID of the first SENEC system associated with the account.
+     * The result is cached for subsequent calls.
+     */
+    async getSystemId(token) {
+        if (this.systemId) {
+            return this.systemId;
+        }
+        const response = await this.httpClient.get(`${API_BASE}/v1/senec/anlagen`, {
+            headers: { authorization: `Bearer ${token}` },
+        });
+        const systems = Array.isArray(response.data) ? response.data : [];
+        if (systems.length === 0 || !systems[0].id) {
+            throw new Error('No SENEC system found for this account');
+        }
+        this.systemId = String(systems[0].id);
+        this.systemInfo = systems[0];
+        return this.systemId;
+    }
+    /**
+     * Get current energy data from SENEC Cloud
+     */
+    async getData(retried = false) {
+        try {
+            const token = await this.ensureAuthenticated();
+            const systemId = await this.getSystemId(token);
+            const response = await this.httpClient.get(`${API_BASE}/v2/senec/systems/${systemId}/dashboard`, {
+                headers: { authorization: `Bearer ${token}` },
+            });
+            this.status = 'connected';
+            // Parse and validate data
+            const data = this.dataParser.parseEnergyData(response.data, this.systemInfo);
+            const validation = this.dataParser.validateData(data);
+            if (!validation.valid) {
+                console.warn('Data validation errors:', validation.errors);
+            }
+            if (validation.warnings.length > 0) {
+                console.warn('Data validation warnings:', validation.warnings);
+            }
+            return data;
+        }
+        catch (error) {
+            this.status = 'error';
+            const handledError = this.errorHandler.handleError(error);
+            // If it's an authentication error, clear token and retry once
+            if (handledError.type === 'authentication' && !retried) {
+                this.authManager.clearToken();
+                return this.getData(true);
+            }
+            throw new Error(handledError.message);
+        }
+    }
+    /**
+     * Test connection to SENEC Cloud
+     */
+    async testConnection() {
+        try {
+            this.status = 'connecting';
+            await this.authManager.authenticate();
+            this.status = 'connected';
+            return true;
+        }
+        catch (error) {
+            this.status = 'error';
+            return false;
+        }
+    }
+    /**
+     * Get current connection status
+     */
+    getStatus() {
+        return this.status;
+    }
+    /**
+     * Disconnect and clear authentication
+     */
+    disconnect() {
+        this.authManager.clearToken();
+        this.systemId = null;
+        this.systemInfo = null;
+        this.status = 'disconnected';
+    }
+}
+exports.SenecAPIClient = SenecAPIClient;
+//# sourceMappingURL=senec-api-client.js.map

package/dist/lib/senec-api-client.js.map

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

package/dist/nodes/senec-config.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=senec-config.d.ts.map

package/dist/nodes/senec-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"senec-config.d.ts","sourceRoot":"","sources":["../../src/nodes/senec-config.ts"],"names":[],"mappings":""}

package/dist/nodes/senec-config.html

@@ -0,0 +1,47 @@
+<script type="text/javascript">
+  RED.nodes.registerType('senec-config', {
+    category: 'config',
+    defaults: {
+      name: { value: '' },
+      username: { value: '', required: true }
+    },
+    credentials: {
+      password: { type: 'password' }
+    },
+    label: function() {
+      return this.name || 'SENEC Cloud Config';
+    }
+  });
+</script>
+
+<script type="text/html" data-template-name="senec-config">
+  <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="SENEC Cloud">
+  </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="your@email.com">
+  </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">
+  </div>
+</script>
+
+<script type="text/html" data-help-name="senec-config">
+  <p>Configuration node for SENEC Cloud API access.</p>
+  
+  <h3>Configuration</h3>
+  <dl class="message-properties">
+    <dt>Username <span class="property-type">string</span></dt>
+    <dd>Your SENEC Cloud account email address</dd>
+    
+    <dt>Password <span class="property-type">string</span></dt>
+    <dd>Your SENEC Cloud account password</dd>
+  </dl>
+  
+  <h3>Details</h3>
+  <p>This configuration node stores your SENEC Cloud credentials securely.
+  It is used by the senec-data and senec-image nodes to authenticate with the SENEC Cloud API.</p>
+</script>

package/dist/nodes/senec-config.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+module.exports = function (RED) {
+    function SenecConfigNode(config) {
+        RED.nodes.createNode(this, config);
+        this.username = config.username;
+        // Credentials are stored separately by Node-RED
+        // Access via this.credentials.password
+    }
+    RED.nodes.registerType('senec-config', SenecConfigNode, {
+        credentials: {
+            password: { type: 'password' }
+        }
+    });
+};
+//# sourceMappingURL=senec-config.js.map

package/dist/nodes/senec-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"senec-config.js","sourceRoot":"","sources":["../../src/nodes/senec-config.ts"],"names":[],"mappings":";;AAgBA,MAAM,CAAC,OAAO,GAAG,UAAS,GAAQ;IAChC,SAAS,eAAe,CAAwB,MAA0B;QACxE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEnC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAEhC,gDAAgD;QAChD,uCAAuC;IACzC,CAAC;IAED,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,eAAe,EAAE;QACtD,WAAW,EAAE;YACX,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;SAC/B;KACF,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/nodes/senec-data.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=senec-data.d.ts.map

package/dist/nodes/senec-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"senec-data.d.ts","sourceRoot":"","sources":["../../src/nodes/senec-data.ts"],"names":[],"mappings":""}

package/dist/nodes/senec-data.html

@@ -0,0 +1,82 @@
+<script type="text/javascript">
+  RED.nodes.registerType('senec-data', {
+    category: 'SENEC',
+    color: '#00A0E3',
+    defaults: {
+      name: { value: '' },
+      config: { value: '', type: 'senec-config', required: true },
+      interval: { value: 0, validate: RED.validators.number() }
+    },
+    inputs: 1,
+    outputs: 1,
+    icon: 'font-awesome/fa-solar-panel',
+    label: function() {
+      return this.name || 'SENEC Data';
+    },
+    labelStyle: function() {
+      return this.name ? 'node_label_italic' : '';
+    }
+  });
+</script>
+
+<script type="text/html" data-template-name="senec-data">
+  <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="SENEC Data">
+  </div>
+  <div class="form-row">
+    <label for="node-input-config"><i class="fa fa-cog"></i> Config</label>
+    <input type="text" id="node-input-config">
+  </div>
+  <div class="form-row">
+    <label for="node-input-interval"><i class="fa fa-clock-o"></i> Interval (s)</label>
+    <input type="number" id="node-input-interval" placeholder="0 = manual only" min="0">
+  </div>
+  <div class="form-tips">
+    <p><b>Tip:</b> Set interval to 0 to fetch data only on input message. 
+    For automatic polling, set interval in seconds (e.g., 60 for every minute).</p>
+  </div>
+</script>
+
+<script type="text/html" data-help-name="senec-data">
+  <p>Fetches data from SENEC Cloud API.</p>
+  
+  <h3>Inputs</h3>
+  <dl class="message-properties">
+    <dt>payload <span class="property-type">any</span></dt>
+    <dd>Any input triggers a data fetch</dd>
+  </dl>
+  
+  <h3>Outputs</h3>
+  <dl class="message-properties">
+    <dt>payload <span class="property-type">object</span></dt>
+    <dd>Parsed SENEC system data including battery, grid, solar, and consumption values</dd>
+    
+    <dt>topic <span class="property-type">string</span></dt>
+    <dd>Set to "senec/data"</dd>
+  </dl>
+  
+  <h3>Configuration</h3>
+  <dl class="message-properties">
+    <dt>Config</dt>
+    <dd>SENEC Cloud configuration node with credentials</dd>
+    
+    <dt>Interval</dt>
+    <dd>Automatic polling interval in seconds. Set to 0 to disable automatic polling.</dd>
+  </dl>
+  
+  <h3>Details</h3>
+  <p>This node fetches current data from your SENEC system via the SENEC Cloud API.</p>
+  <p>You can trigger data fetching manually by sending any message to the input, 
+  or configure automatic polling by setting an interval.</p>
+  
+  <h3>Output Format</h3>
+  <p>The output payload contains:</p>
+  <ul>
+    <li><code>battery</code> - Battery status (charge level, power, state)</li>
+    <li><code>grid</code> - Grid connection data (power, state)</li>
+    <li><code>solar</code> - Solar production data</li>
+    <li><code>consumption</code> - House consumption data</li>
+    <li><code>timestamp</code> - Data timestamp</li>
+  </ul>
+</script>

package/dist/nodes/senec-data.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const senec_api_client_1 = require("../lib/senec-api-client");
+module.exports = function (RED) {
+    function SenecDataNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+        node.timer = null;
+        node.apiClient = null;
+        // Get config node
+        const configNode = RED.nodes.getNode(config.config);
+        if (!configNode) {
+            node.error('Missing SENEC configuration');
+            node.status({ fill: 'red', shape: 'ring', text: 'no config' });
+            return;
+        }
+        // Initialize API client
+        try {
+            node.apiClient = new senec_api_client_1.SenecAPIClient({
+                username: configNode.username,
+                password: configNode.credentials.password
+            });
+            node.status({ fill: 'green', shape: 'dot', text: 'ready' });
+        }
+        catch (error) {
+            node.error('Failed to initialize API client: ' + error);
+            node.status({ fill: 'red', shape: 'ring', text: 'error' });
+            return;
+        }
+        // Fetch data function
+        async function fetchData() {
+            if (!node.apiClient)
+                return;
+            try {
+                node.status({ fill: 'blue', shape: 'dot', text: 'fetching...' });
+                const parsedData = await node.apiClient.getData();
+                node.send({
+                    payload: parsedData,
+                    topic: 'senec/data'
+                });
+                node.status({ fill: 'green', shape: 'dot', text: 'success' });
+            }
+            catch (error) {
+                node.error('Failed to fetch data: ' + error.message);
+                node.status({ fill: 'red', shape: 'ring', text: 'error' });
+            }
+        }
+        // Handle input messages
+        node.on('input', async function (_msg) {
+            await fetchData();
+        });
+        // Setup polling if interval is set
+        if (config.interval && config.interval > 0) {
+            node.timer = setInterval(fetchData, config.interval * 1000);
+        }
+        // Cleanup on close
+        node.on('close', function () {
+            if (node.timer) {
+                clearInterval(node.timer);
+                node.timer = null;
+            }
+        });
+    }
+    RED.nodes.registerType('senec-data', SenecDataNode);
+};
+//# sourceMappingURL=senec-data.js.map

package/dist/nodes/senec-data.js.map

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

package/dist/nodes/senec-image.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=senec-image.d.ts.map

package/dist/nodes/senec-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"senec-image.d.ts","sourceRoot":"","sources":["../../src/nodes/senec-image.ts"],"names":[],"mappings":""}