@waterclick/waterlyconnect-nodejs-client

WaterlyConnect NodeJS Client

Required Values

You will need 3 specific values provided by the Waterly team to proceed:

• url: The endpoint URL to submit data to
• clientToken: The client "secret" for the API client
• clientDeviceId: A unique identifier for the API client

---

Installation

yarn add @waterclick/waterlyconnect-nodejs-client

---

Usage

import {
  TagDatum,
  WaterlyConnectApiClient,
  WaterlyConnectApiClientConfig
} from "@waterclick/waterlyconnect-nodejs-client";

const config: WaterlyConnectApiClientConfig = {
  url: "https://foo.bar/connect/submit",
  clientToken: "abcpdqxyz123",
  clientDevice: {
    id: "my-fancy-device",
    type: "SCADACo",
  },
};

const c = new WaterlyConnectApiClient(config);

const data: TagDatum[] = [
  // Note that timestamps must be in *seconds* since the epoch, not milliseconds
  { name: "TagName", value: "123.2", last_change_timestamp: Math.floor(new Date().getTime() / 1000) },
];

c.submitData(data)
  .then(() => console.log("Success!"))
  .catch((err) => console.error("Failed to submit data", err));

---

API

WaterlyConnectApiClient

constructor

The WaterlyConnectApiClient requires one argument: an object of WaterlyConnectApiClientConfig. Please see the type documentation below for specifics of how it may be configured.

submitData

submitData is an async method with a void value. You must resolve calls to function with either then()/catch() syntax or async/await.

This function will throw an error that you must catch in your code if data was unable to be accepted by the WaterlyConnect service for any reason, or will complete silently when successful.

---

Types

WaterlyConnectApiClientConfig

WaterlyConnectApiClientConfig is used to configure the api client.

Property	Required	Description
url	true	The endpoint URL for the WaterlyConnect service, provided by the Waterly team. A typical value would end in /connect/submit like: https://host.name/connect/submit
clientToken	true	The unique client secret WaterlyConnect service, provided by the Waterly team. It is usually a 32 character string. Please use secure transmission and storage methods to manage this value.
clientDevice	true	See the section describing ClientDeviceInfo for more information
proxy	false	If your API client is behind a firewall, it may be configured here. This object is an Axios Proxy configuration object. You may find more details on it here.

ClientDeviceInfo

ClientDeviceInfo is used to describe the API client to the Waterly Connect service.

Property	Required	Description
id	true	An identifier for the API client, assigned by the Waterly team.
type	true	A simple string describing the type of system connecting to Waterly Connect. For instance, it may be a device type (e..g, Ewon Flexy) or a system name. You are free to choose this value.
lan_ip	false	(Optional) The internal IP address of the client device or system
wan_ip	false	(Optional) The external IP address of the client device or system
serial	false	(Optional) A serial number for the client device or system
uptime_millis	false	(Optional) A number representing the epoch time, represented in milliseconds that they client device or system has been "up" (or since last boot).

TagDatum

TagDatum represents the actual tagged data to be submitted to WaterlyConnect

Property	Required	Description
name	true	The client-assigned tag name for the value. It may be any string, but must be unique within the submission.
value	true	The actual data value being measured. While WaterlyConnect only accepts numeric values, this value must be encoded a string. For instance: "123.2"
last_change_timestamp	true	The timestamp that the value was recorded, measured in seconds since the epoch.
type	false	(Optional)(Legacy) A historical value used to track the type of data being submitted.
unit	false	(Optional)(Legacy) Typically unused, this value was used to track the unit type of the submitted data.