node-red-contrib-influxdb3 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,339 @@
+# node-red-contrib-influxdb3
+
+[![npm version](https://badge.fury.io/js/node-red-contrib-influxdb3.svg)](https://www.npmjs.com/package/node-red-contrib-influxdb3)
+[![npm downloads](https://img.shields.io/npm/dm/node-red-contrib-influxdb3.svg)](https://www.npmjs.com/package/node-red-contrib-influxdb3)
+[![Node-RED](https://img.shields.io/badge/Node--RED-contrib-red.svg)](https://flows.nodered.org/node/node-red-contrib-influxdb3)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Node-RED nodes for writing data to InfluxDB v3.
+
+This package provides Node-RED integration with InfluxDB v3 using the official [@influxdata/influxdb3-client](https://github.com/InfluxCommunity/influxdb3-js) JavaScript library.
+
+## Installation
+
+### From npm (when published)
+
+```bash
+cd ~/.node-red
+npm install node-red-contrib-influxdb3
+```
+
+### From local directory
+
+```bash
+cd ~/.node-red
+npm install /path/to/node-red-contrib-influxdb3
+```
+
+### Development Installation
+
+1. Clone this repository
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+3. Link to your Node-RED installation:
+   ```bash
+   cd ~/.node-red
+   npm install /path/to/node-red-contrib-influxdb3
+   ```
+4. Restart Node-RED
+
+## Nodes
+
+This package includes two nodes:
+
+### InfluxDB v3 Config Node
+
+A configuration node that stores connection details for your InfluxDB v3 instance.
+
+**Configuration:**
+- **Name**: A friendly name for the connection
+- **Host**: Your InfluxDB v3 host URL (e.g., `https://us-east-1-1.aws.cloud2.influxdata.com`)
+- **Token**: Your InfluxDB v3 authentication token
+- **Database**: The default database (bucket) name
+
+### InfluxDB v3 Write Node
+
+Writes data points to InfluxDB v3.
+
+**Configuration:**
+- **Connection**: Select an InfluxDB v3 config node
+- **Name**: Optional node name
+- **Measurement**: Default measurement name (can be overridden by `msg.measurement`)
+- **Database**: Optional database override (uses connection default if not set)
+
+## Usage
+
+### Input Message Formats
+
+The write node accepts data in multiple formats:
+
+#### 1. Line Protocol String
+
+Send data as a string in InfluxDB line protocol format:
+
+```javascript
+msg.payload = "temperature,location=room1 value=21.5";
+return msg;
+```
+
+#### 2. Object with Fields and Tags
+
+Send an object with explicit `fields` and `tags` properties:
+
+```javascript
+msg.measurement = "temperature";
+msg.payload = {
+    fields: {
+        value: 21.5,
+        humidity: 65
+    },
+    tags: {
+        location: "room1",
+        sensor: "dht22"
+    },
+    timestamp: Date.now() // optional
+};
+return msg;
+```
+
+#### 3. Simplified Object Format
+
+Send an object where all properties (except 'tags' and 'timestamp') are treated as fields:
+
+```javascript
+msg.measurement = "environment";
+msg.payload = {
+    temperature: 21.5,
+    humidity: 65,
+    pressure: 1013.25,
+    tags: {
+        room: "bedroom",
+        floor: "2"
+    }
+};
+return msg;
+```
+
+### Data Types
+
+When using object format, the node automatically handles data types:
+- **Numbers**: 
+  - Integers are written as integer fields
+  - Floats are written as float fields
+- **Booleans**: Written as boolean fields
+- **Strings**: Written as string fields
+- **Tags**: Always converted to strings
+
+### Message Properties
+
+The following message properties can be used to override node configuration:
+
+- `msg.measurement` - Override the measurement name
+- `msg.database` - Override the database name
+- `msg.timestamp` - Set the timestamp for the data point (Date object or milliseconds)
+
+## Examples
+
+### Example 1: Temperature Sensor
+
+```javascript
+// Function node
+msg.measurement = "temperature";
+msg.payload = {
+    value: 21.5,
+    tags: {
+        location: "living_room",
+        sensor_id: "temp_001"
+    }
+};
+return msg;
+```
+
+### Example 2: Multi-Sensor Data
+
+```javascript
+// Function node
+msg.measurement = "environment";
+msg.payload = {
+    fields: {
+        temperature: 22.3,
+        humidity: 58,
+        co2: 412,
+        light: 850
+    },
+    tags: {
+        room: "office",
+        floor: "3",
+        building: "A"
+    }
+};
+return msg;
+```
+
+### Example 3: MQTT to InfluxDB
+
+```
+[MQTT In] --> [JSON Parse] --> [Function] --> [InfluxDB v3 Write]
+```
+
+Function node:
+```javascript
+// Parse MQTT topic for location
+const location = msg.topic.split('/')[1];
+
+msg.measurement = "sensor_data";
+msg.payload = {
+    temperature: msg.payload.temp,
+    humidity: msg.payload.hum,
+    tags: {
+        location: location
+    }
+};
+return msg;
+```
+
+### Example 4: Using Line Protocol
+
+```javascript
+// Function node - direct line protocol
+const location = "warehouse";
+const temp = 18.5;
+const humidity = 72;
+
+msg.payload = `climate,location=${location} temperature=${temp},humidity=${humidity}`;
+return msg;
+```
+
+### Example 5: Multiple Databases
+
+```javascript
+// Write to different databases based on data type
+if (msg.payload.type === "critical") {
+    msg.database = "critical-events";
+} else {
+    msg.database = "general-logs";
+}
+
+msg.measurement = "events";
+msg.payload = {
+    severity: msg.payload.severity,
+    message: msg.payload.msg,
+    tags: {
+        type: msg.payload.type
+    }
+};
+return msg;
+```
+
+## Sample Flow
+
+Import this flow into Node-RED to get started:
+
+```json
+[
+    {
+        "id": "influxdb3-config-node",
+        "type": "influxdb3-config",
+        "name": "My InfluxDB v3",
+        "host": "https://us-east-1-1.aws.cloud2.influxdata.com",
+        "database": "my-database"
+    },
+    {
+        "id": "inject-node",
+        "type": "inject",
+        "name": "Generate Data",
+        "props": [{"p": "payload"}],
+        "repeat": "5",
+        "topic": "",
+        "payload": "",
+        "payloadType": "date",
+        "x": 140,
+        "y": 100,
+        "wires": [["function-node"]]
+    },
+    {
+        "id": "function-node",
+        "type": "function",
+        "name": "Format Data",
+        "func": "msg.measurement = 'temperature';\nmsg.payload = {\n    value: 20 + Math.random() * 10,\n    tags: {\n        location: 'office'\n    }\n};\nreturn msg;",
+        "x": 320,
+        "y": 100,
+        "wires": [["influxdb3-write-node"]]
+    },
+    {
+        "id": "influxdb3-write-node",
+        "type": "influxdb3-write",
+        "name": "Write to InfluxDB",
+        "influxdb": "influxdb3-config-node",
+        "measurement": "",
+        "database": "",
+        "x": 530,
+        "y": 100,
+        "wires": [["debug-node"]]
+    },
+    {
+        "id": "debug-node",
+        "type": "debug",
+        "name": "Debug",
+        "x": 730,
+        "y": 100,
+        "wires": []
+    }
+]
+```
+
+## Configuration with Environment Variables
+
+You can use environment variables in the configuration node:
+
+- `INFLUX_HOST` - InfluxDB v3 host URL
+- `INFLUX_TOKEN` - Authentication token
+- `INFLUX_DATABASE` - Default database name
+
+Simply reference them in the Node-RED UI using `${INFLUX_HOST}` syntax (if using Node-RED environment variable substitution).
+
+## Troubleshooting
+
+### Connection Issues
+
+- Verify your host URL is correct and includes `https://`
+- Check that your token has write permissions for the database
+- Ensure the database name exists in your InfluxDB v3 instance
+
+### Data Not Appearing
+
+- Check the node status - it should show "written" briefly after successful writes
+- Verify at least one field is provided (InfluxDB requires at least one field)
+- Check that field values are not null or undefined
+
+### Error Messages
+
+The node will display error status and log details to the Node-RED debug panel:
+- **"no config"** - The InfluxDB v3 config node is not selected
+- **"error"** - Check the debug panel for details
+
+## Requirements
+
+- Node-RED v2.0.0 or higher
+- InfluxDB v3 instance (Cloud or Edge)
+
+## License
+
+MIT
+
+## Author
+
+Your Name
+
+## Links
+
+- [InfluxDB v3 JavaScript Client](https://github.com/InfluxCommunity/influxdb3-js)
+- [InfluxDB v3 Documentation](https://docs.influxdata.com/influxdb/v3/)
+- [Node-RED](https://nodered.org/)
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+

package/examples/basic-flow.json

@@ -0,0 +1,170 @@
+[
+    {
+        "id": "example-flow",
+        "type": "tab",
+        "label": "InfluxDB v3 Example",
+        "disabled": false,
+        "info": "Example flow showing how to write data to InfluxDB v3"
+    },
+    {
+        "id": "inject-temp",
+        "type": "inject",
+        "z": "example-flow",
+        "name": "Generate Temperature Data",
+        "props": [
+            {
+                "p": "payload"
+            }
+        ],
+        "repeat": "5",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "",
+        "payloadType": "date",
+        "x": 180,
+        "y": 100,
+        "wires": [
+            [
+                "format-temp"
+            ]
+        ]
+    },
+    {
+        "id": "format-temp",
+        "type": "function",
+        "z": "example-flow",
+        "name": "Format Temperature",
+        "func": "// Generate random temperature between 18 and 28 degrees\nconst temp = 18 + Math.random() * 10;\nconst humidity = 40 + Math.random() * 30;\n\nmsg.measurement = 'environment';\nmsg.payload = {\n    temperature: parseFloat(temp.toFixed(2)),\n    humidity: parseFloat(humidity.toFixed(2)),\n    tags: {\n        location: 'office',\n        sensor: 'dht22_01'\n    }\n};\n\nreturn msg;",
+        "outputs": 1,
+        "noerr": 0,
+        "initialize": "",
+        "finalize": "",
+        "libs": [],
+        "x": 420,
+        "y": 100,
+        "wires": [
+            [
+                "write-influx",
+                "debug-payload"
+            ]
+        ]
+    },
+    {
+        "id": "write-influx",
+        "type": "influxdb3-write",
+        "z": "example-flow",
+        "influxdb": "influxdb3-config",
+        "name": "Write to InfluxDB v3",
+        "measurement": "",
+        "database": "",
+        "x": 660,
+        "y": 100,
+        "wires": [
+            [
+                "debug-result"
+            ]
+        ]
+    },
+    {
+        "id": "debug-payload",
+        "type": "debug",
+        "z": "example-flow",
+        "name": "Debug Payload",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "payload",
+        "targetType": "msg",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 660,
+        "y": 60,
+        "wires": []
+    },
+    {
+        "id": "debug-result",
+        "type": "debug",
+        "z": "example-flow",
+        "name": "Debug Result",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "true",
+        "targetType": "full",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 870,
+        "y": 100,
+        "wires": []
+    },
+    {
+        "id": "inject-line-protocol",
+        "type": "inject",
+        "z": "example-flow",
+        "name": "Line Protocol Example",
+        "props": [
+            {
+                "p": "payload"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "weather,location=garden temperature=18.5,humidity=75,pressure=1013.25",
+        "payloadType": "str",
+        "x": 180,
+        "y": 200,
+        "wires": [
+            [
+                "write-influx-lp"
+            ]
+        ]
+    },
+    {
+        "id": "write-influx-lp",
+        "type": "influxdb3-write",
+        "z": "example-flow",
+        "influxdb": "influxdb3-config",
+        "name": "Write Line Protocol",
+        "measurement": "",
+        "database": "",
+        "x": 450,
+        "y": 200,
+        "wires": [
+            [
+                "debug-lp"
+            ]
+        ]
+    },
+    {
+        "id": "debug-lp",
+        "type": "debug",
+        "z": "example-flow",
+        "name": "Debug LP",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "true",
+        "targetType": "full",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 660,
+        "y": 200,
+        "wires": []
+    },
+    {
+        "id": "influxdb3-config",
+        "type": "influxdb3-config",
+        "name": "My InfluxDB v3",
+        "host": "https://us-east-1-1.aws.cloud2.influxdata.com",
+        "database": "my-database"
+    }
+]
+

package/examples/mqtt-to-influx.json

@@ -0,0 +1,134 @@
+[
+    {
+        "id": "mqtt-flow",
+        "type": "tab",
+        "label": "MQTT to InfluxDB v3",
+        "disabled": false,
+        "info": "Example flow showing how to capture MQTT data and write to InfluxDB v3"
+    },
+    {
+        "id": "mqtt-in",
+        "type": "mqtt in",
+        "z": "mqtt-flow",
+        "name": "MQTT Sensor Data",
+        "topic": "sensors/+/data",
+        "qos": "0",
+        "datatype": "json",
+        "broker": "mqtt-broker",
+        "nl": false,
+        "rap": false,
+        "inputs": 0,
+        "x": 140,
+        "y": 100,
+        "wires": [
+            [
+                "parse-mqtt"
+            ]
+        ]
+    },
+    {
+        "id": "parse-mqtt",
+        "type": "function",
+        "z": "mqtt-flow",
+        "name": "Parse MQTT Data",
+        "func": "// Extract sensor ID from topic (sensors/SENSOR_ID/data)\nconst topicParts = msg.topic.split('/');\nconst sensorId = topicParts[1];\n\n// Prepare data for InfluxDB\nmsg.measurement = 'sensor_readings';\nmsg.payload = {\n    fields: {\n        temperature: msg.payload.temperature,\n        humidity: msg.payload.humidity,\n        battery: msg.payload.battery\n    },\n    tags: {\n        sensor_id: sensorId,\n        location: msg.payload.location || 'unknown'\n    }\n};\n\nreturn msg;",
+        "outputs": 1,
+        "noerr": 0,
+        "initialize": "",
+        "finalize": "",
+        "libs": [],
+        "x": 360,
+        "y": 100,
+        "wires": [
+            [
+                "influx-write",
+                "debug-mqtt"
+            ]
+        ]
+    },
+    {
+        "id": "influx-write",
+        "type": "influxdb3-write",
+        "z": "mqtt-flow",
+        "influxdb": "influxdb3-config",
+        "name": "Store in InfluxDB",
+        "measurement": "",
+        "database": "",
+        "x": 590,
+        "y": 100,
+        "wires": [
+            [
+                "debug-success"
+            ]
+        ]
+    },
+    {
+        "id": "debug-mqtt",
+        "type": "debug",
+        "z": "mqtt-flow",
+        "name": "MQTT Data",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "payload",
+        "targetType": "msg",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 570,
+        "y": 60,
+        "wires": []
+    },
+    {
+        "id": "debug-success",
+        "type": "debug",
+        "z": "mqtt-flow",
+        "name": "Write Result",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "true",
+        "targetType": "full",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 790,
+        "y": 100,
+        "wires": []
+    },
+    {
+        "id": "mqtt-broker",
+        "type": "mqtt-broker",
+        "name": "Local MQTT Broker",
+        "broker": "localhost",
+        "port": "1883",
+        "clientid": "",
+        "autoConnect": true,
+        "usetls": false,
+        "protocolVersion": "4",
+        "keepalive": "60",
+        "cleansession": true,
+        "birthTopic": "",
+        "birthQos": "0",
+        "birthPayload": "",
+        "birthMsg": {},
+        "closeTopic": "",
+        "closeQos": "0",
+        "closePayload": "",
+        "closeMsg": {},
+        "willTopic": "",
+        "willQos": "0",
+        "willPayload": "",
+        "willMsg": {},
+        "userProps": "",
+        "sessionExpiry": ""
+    },
+    {
+        "id": "influxdb3-config",
+        "type": "influxdb3-config",
+        "name": "My InfluxDB v3",
+        "host": "https://us-east-1-1.aws.cloud2.influxdata.com",
+        "database": "my-database"
+    }
+]
+

package/influxdb3.html

@@ -0,0 +1,204 @@
+<!--
+  InfluxDB v3 Configuration Node
+-->
+<script type="text/javascript">
+    RED.nodes.registerType('influxdb3-config', {
+        category: 'config',
+        defaults: {
+            name: { value: '' },
+            host: { value: '', required: true },
+            database: { value: '', required: true }
+        },
+        credentials: {
+            token: { type: 'password' }
+        },
+        label: function() {
+            return this.name || this.host || 'InfluxDB v3';
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="influxdb3-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="Connection name">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-host"><i class="fa fa-server"></i> Host</label>
+        <input type="text" id="node-config-input-host" placeholder="https://us-east-1-1.aws.cloud2.influxdata.com">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-token"><i class="fa fa-key"></i> Token</label>
+        <input type="password" id="node-config-input-token">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-database"><i class="fa fa-database"></i> Database</label>
+        <input type="text" id="node-config-input-database" placeholder="my-database">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="influxdb3-config">
+    <p>Configuration node for InfluxDB v3 connection.</p>
+    <h3>Details</h3>
+    <p>This configuration node stores the connection details for an InfluxDB v3 instance.</p>
+    <dl class="message-properties">
+        <dt>Name <span class="property-type">string</span></dt>
+        <dd>A friendly name for this connection</dd>
+        <dt>Host <span class="property-type">string</span></dt>
+        <dd>The InfluxDB v3 host URL (e.g., https://us-east-1-1.aws.cloud2.influxdata.com)</dd>
+        <dt>Token <span class="property-type">string</span></dt>
+        <dd>The authentication token for accessing InfluxDB v3</dd>
+        <dt>Database <span class="property-type">string</span></dt>
+        <dd>The default database (bucket) name to write to</dd>
+    </dl>
+</script>
+
+<!--
+  InfluxDB v3 Write Node
+-->
+<script type="text/javascript">
+    RED.nodes.registerType('influxdb3-write', {
+        category: 'storage',
+        color: '#9ea8db',
+        defaults: {
+            influxdb: { type: 'influxdb3-config', required: true },
+            name: { value: '' },
+            measurement: { value: '' },
+            database: { value: '' }
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: 'db.png',
+        label: function() {
+            return this.name || 'influxdb3 write';
+        },
+        labelStyle: function() {
+            return this.name ? 'node_label_italic' : '';
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="influxdb3-write">
+    <div class="form-row">
+        <label for="node-input-influxdb"><i class="fa fa-server"></i> Connection</label>
+        <input type="text" id="node-input-influxdb">
+    </div>
+    <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">
+    </div>
+    <div class="form-row">
+        <label for="node-input-measurement"><i class="fa fa-chart-line"></i> Measurement</label>
+        <input type="text" id="node-input-measurement" placeholder="Leave empty to use msg.measurement">
+    </div>
+    <div class="form-row">
+        <label for="node-input-database"><i class="fa fa-database"></i> Database</label>
+        <input type="text" id="node-input-database" placeholder="Override default database (optional)">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="influxdb3-write">
+    <p>Writes data to InfluxDB v3.</p>
+    
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">string | object</span></dt>
+        <dd>The data to write. Can be either:
+            <ul>
+                <li>A string in line protocol format</li>
+                <li>An object with <code>fields</code> (required) and optionally <code>tags</code> and <code>timestamp</code></li>
+            </ul>
+        </dd>
+        <dt class="optional">measurement <span class="property-type">string</span></dt>
+        <dd>Override the measurement name configured in the node</dd>
+        <dt class="optional">database <span class="property-type">string</span></dt>
+        <dd>Override the database configured in the node or connection</dd>
+        <dt class="optional">timestamp <span class="property-type">Date | number</span></dt>
+        <dd>Timestamp for the data point (if not in payload)</dd>
+    </dl>
+
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">object</span></dt>
+        <dd>The original payload is passed through</dd>
+    </dl>
+
+    <h3>Details</h3>
+    <p>This node writes data to InfluxDB v3. The data can be provided in two formats:</p>
+    
+    <h4>Line Protocol Format</h4>
+    <p>Send a string in line protocol format:</p>
+    <pre>msg.payload = "temperature,location=room1 value=21.5";</pre>
+    
+    <h4>Object Format</h4>
+    <p>Send an object with fields and optionally tags:</p>
+    <pre>{
+  "fields": {
+    "temperature": 21.5,
+    "humidity": 65
+  },
+  "tags": {
+    "location": "room1",
+    "sensor": "dht22"
+  },
+  "timestamp": Date.now()
+}</pre>
+
+    <h4>Simplified Object Format</h4>
+    <p>Send an object where all properties (except 'tags' and 'timestamp') are treated as fields:</p>
+    <pre>{
+  "temperature": 21.5,
+  "humidity": 65,
+  "tags": {
+    "location": "room1"
+  }
+}</pre>
+
+    <h3>Configuration</h3>
+    <dl class="message-properties">
+        <dt>Connection</dt>
+        <dd>The InfluxDB v3 connection configuration</dd>
+        <dt>Measurement</dt>
+        <dd>The measurement name to use. Can be overridden by <code>msg.measurement</code></dd>
+        <dt>Database</dt>
+        <dd>Optional database override. If not set, uses the database from the connection config</dd>
+    </dl>
+
+    <h3>Examples</h3>
+    <h4>Example 1: Simple temperature reading</h4>
+    <pre>msg.measurement = "temperature";
+msg.payload = {
+  "fields": {
+    "value": 21.5
+  },
+  "tags": {
+    "location": "living_room"
+  }
+};
+return msg;</pre>
+
+    <h4>Example 2: Multiple sensor values</h4>
+    <pre>msg.measurement = "environment";
+msg.payload = {
+  "temperature": 21.5,
+  "humidity": 65,
+  "pressure": 1013.25,
+  "tags": {
+    "room": "bedroom",
+    "floor": "2"
+  }
+};
+return msg;</pre>
+
+    <h4>Example 3: Line protocol string</h4>
+    <pre>msg.payload = "weather,location=garden temperature=18.5,humidity=75";
+return msg;</pre>
+
+    <h3>References</h3>
+    <ul>
+        <li><a href="https://github.com/InfluxCommunity/influxdb3-js">InfluxDB v3 JavaScript Client</a></li>
+        <li><a href="https://docs.influxdata.com/influxdb/v3/">InfluxDB v3 Documentation</a></li>
+        <li><a href="https://docs.influxdata.com/influxdb/v3/reference/syntax/line-protocol/">Line Protocol Reference</a></li>
+    </ul>
+</script>
+

package/influxdb3.js

@@ -0,0 +1,207 @@
+/**
+ * InfluxDB v3 nodes for Node-RED
+ */
+
+module.exports = function(RED) {
+    const { InfluxDBClient, Point } = require('@influxdata/influxdb3-client');
+
+    /**
+     * Configuration node to hold InfluxDB v3 connection details
+     */
+    function InfluxDB3ConfigNode(config) {
+        RED.nodes.createNode(this, config);
+        
+        this.host = config.host;
+        this.database = config.database;
+        this.name = config.name;
+        
+        // Store token as a credential
+        this.token = this.credentials.token;
+        
+        // Client instance (will be created on demand)
+        this.client = null;
+        
+        // Get or create a client instance
+        this.getClient = function() {
+            if (!this.client) {
+                try {
+                    this.client = new InfluxDBClient({
+                        host: this.host,
+                        token: this.token,
+                        database: this.database
+                    });
+                } catch (error) {
+                    throw new Error(`Failed to create InfluxDB client: ${error.message}`);
+                }
+            }
+            return this.client;
+        };
+        
+        // Clean up on close
+        this.on('close', function() {
+            if (this.client) {
+                try {
+                    this.client.close();
+                    this.client = null;
+                } catch (error) {
+                    // Ignore errors on close
+                }
+            }
+        });
+    }
+    
+    RED.nodes.registerType('influxdb3-config', InfluxDB3ConfigNode, {
+        credentials: {
+            token: { type: 'password' }
+        }
+    });
+
+    /**
+     * InfluxDB v3 Write Node
+     */
+    function InfluxDB3WriteNode(config) {
+        RED.nodes.createNode(this, config);
+        
+        this.influxdb = RED.nodes.getNode(config.influxdb);
+        this.measurement = config.measurement;
+        this.database = config.database;
+        
+        const node = this;
+        
+        if (!this.influxdb) {
+            this.error('InfluxDB v3 config not set');
+            this.status({ fill: 'red', shape: 'dot', text: 'no config' });
+            return;
+        }
+        
+        // Process incoming messages
+        node.on('input', async function(msg, send, done) {
+            // For Node-RED 0.x compatibility
+            send = send || function() { node.send.apply(node, arguments); };
+            done = done || function(err) { 
+                if (err) {
+                    node.error(err, msg);
+                }
+            };
+            
+            try {
+                const client = node.influxdb.getClient();
+                
+                // Determine the database to use
+                const targetDatabase = msg.database || node.database || node.influxdb.database;
+                
+                if (!targetDatabase) {
+                    throw new Error('Database not specified');
+                }
+                
+                let lineProtocol;
+                
+                // Check if msg.payload is already in line protocol format
+                if (typeof msg.payload === 'string') {
+                    lineProtocol = msg.payload;
+                } else if (msg.payload && typeof msg.payload === 'object') {
+                    // Build line protocol from payload object
+                    const measurement = msg.measurement || node.measurement;
+                    
+                    if (!measurement) {
+                        throw new Error('Measurement not specified');
+                    }
+                    
+                    const point = new Point(measurement);
+                    
+                    // Add tags
+                    if (msg.payload.tags && typeof msg.payload.tags === 'object') {
+                        for (const [key, value] of Object.entries(msg.payload.tags)) {
+                            if (value !== null && value !== undefined) {
+                                point.setTag(key, String(value));
+                            }
+                        }
+                    }
+                    
+                    // Add fields
+                    if (msg.payload.fields && typeof msg.payload.fields === 'object') {
+                        for (const [key, value] of Object.entries(msg.payload.fields)) {
+                            if (value !== null && value !== undefined) {
+                                if (typeof value === 'number') {
+                                    if (Number.isInteger(value)) {
+                                        point.setIntegerField(key, value);
+                                    } else {
+                                        point.setFloatField(key, value);
+                                    }
+                                } else if (typeof value === 'boolean') {
+                                    point.setBooleanField(key, value);
+                                } else {
+                                    point.setStringField(key, String(value));
+                                }
+                            }
+                        }
+                    } else {
+                        // If no 'fields' property, treat all non-tag properties as fields
+                        for (const [key, value] of Object.entries(msg.payload)) {
+                            if (key !== 'tags' && key !== 'timestamp' && value !== null && value !== undefined) {
+                                if (typeof value === 'number') {
+                                    if (Number.isInteger(value)) {
+                                        point.setIntegerField(key, value);
+                                    } else {
+                                        point.setFloatField(key, value);
+                                    }
+                                } else if (typeof value === 'boolean') {
+                                    point.setBooleanField(key, value);
+                                } else if (typeof value !== 'object') {
+                                    point.setStringField(key, String(value));
+                                }
+                            }
+                        }
+                    }
+                    
+                    // Add timestamp if provided
+                    if (msg.payload.timestamp) {
+                        if (msg.payload.timestamp instanceof Date) {
+                            point.setTimestamp(msg.payload.timestamp);
+                        } else if (typeof msg.payload.timestamp === 'number') {
+                            point.setTimestamp(new Date(msg.payload.timestamp));
+                        }
+                    } else if (msg.timestamp) {
+                        if (msg.timestamp instanceof Date) {
+                            point.setTimestamp(msg.timestamp);
+                        } else if (typeof msg.timestamp === 'number') {
+                            point.setTimestamp(new Date(msg.timestamp));
+                        }
+                    }
+                    
+                    lineProtocol = point.toLineProtocol();
+                    
+                    if (!lineProtocol) {
+                        throw new Error('No fields to write - at least one field is required');
+                    }
+                } else {
+                    throw new Error('Invalid payload format. Expected string (line protocol) or object with fields');
+                }
+                
+                // Write to InfluxDB
+                await client.write(lineProtocol, targetDatabase);
+                
+                node.status({ fill: 'green', shape: 'dot', text: 'written' });
+                
+                // Clear status after 3 seconds
+                setTimeout(() => {
+                    node.status({});
+                }, 3000);
+                
+                send(msg);
+                done();
+                
+            } catch (error) {
+                node.status({ fill: 'red', shape: 'dot', text: 'error' });
+                done(error);
+            }
+        });
+        
+        node.on('close', function() {
+            node.status({});
+        });
+    }
+    
+    RED.nodes.registerType('influxdb3-write', InfluxDB3WriteNode);
+};
+

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "node-red-contrib-influxdb3",
+  "version": "1.0.0",
+  "description": "Node-RED nodes for InfluxDB v3 integration",
+  "main": "influxdb3.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "node-red",
+    "influxdb",
+    "influxdb3",
+    "time-series",
+    "database"
+  ],
+  "author": "Stuart B",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stuartb55/nodered-influxdb3.git"
+  },
+  "homepage": "https://github.com/stuartb55/nodered-influxdb3#readme",
+  "bugs": {
+    "url": "https://github.com/stuartb55/nodered-influxdb3/issues"
+  },
+  "node-red": {
+    "nodes": {
+      "influxdb3": "influxdb3.js"
+    }
+  },
+  "dependencies": {
+    "@influxdata/influxdb3-client": "^1.4.0"
+  },
+  "peerDependencies": {
+    "node-red": ">=2.0.0"
+  }
+}
+