feat: changing to new device attributes

Author: tdeleanu

lib/Services/cayenne.js

@@ -131,6 +131,10 @@ class Cayenne {
    * Begin Device Attribute Routes
    */
 
+  /*
+   * Begin Device Attribute Routes
+   */
+
   /**
    * Gets all attribute groups and attributes for a device
    * @param {String} deviceId The device id to get attributes for
@@ -144,27 +148,37 @@ class Cayenne {
   }
 
   /**
-   * Create or Update an attribute group. Pass null to group_id to create a new group.
+   * Update an attribute group. Pass null to group_id to create a new group.
    * @param {String} deviceId The id of the parent device
    * @param {String?} groupId Optional: Updates group, if null creates instead
-   * @param {Object} payload The group to create or update
+   * @param {Object} payload The group to update
    * @param {UUID?} payload.id Optional: The group id, will be overriden by group_id parameter
    * @param {String} payload.name The name of the group
    * @param {Integer} payload.order The display order of the group
    * @param {String?} payload.device_id Optional: The device id this group is attached to. Overriden by deviceId paramter
    * @param {UUID} payload.user_id The user id of the device owner
    * @param {UUID} payload.client_id The application id of the API call
    */
-  createOrUpdateGroup(deviceId, groupId, payload) {
-    var url = null;
-    if (groupId == null) {
-      url = `${this.url}/things/${deviceId}/groups`;
-    } else {
-      url = `${this.url}/things/${deviceId}/groups/${groupId}`;
-    }
+  updateGroup(deviceId, groupId, payload) {
+    const url = `${this.url}/things/${deviceId}/groups/${groupId}`;
+    
     return this.auth.send(this.service, 'PUT', url, { payload });
   }
 
+   /**
+   * Create an attribute group. Pass null to group_id to create a new group.
+   * @param {String} deviceId The id of the parent device
+   * @param {Object} payload The group to create
+   * @param {UUID?} payload.id Optional: The group id, will be overriden by group_id parameter
+   * @param {String} payload.name The name of the group
+   * @param {Integer} payload.order The display order of the group
+   */
+  createGroup(deviceId, payload) {
+    const url = `${this.url}/things/${deviceId}/groups`;
+
+    return this.auth.send(this.service, 'POST', url, { payload });
+  }
+
   /**
    * Delete a group
    * @param {String} deviceId
@@ -179,7 +193,6 @@ class Cayenne {
    * Create or Update an attribute. Pass null to attribute_id to create a new attribute.
    * @param {String} deviceId The id of the parent device
    * @param {String} groupId The id of the parent group
-   * @param {String?} attributeId Optional: Updates attribute, if null creates instead
    * @param {Object} payload The attribute to create or update
    * @param {UUID?} payload.id Optional: The attribute id, will be overriden by attributeId parameter
    * @param {String} payload.name The name of the attribute
@@ -190,15 +203,32 @@ class Cayenne {
    * @param {String} payload.value The value, contents vary based on value_type
    * @param {String} payload.value_type The type of content contained in value string
    */
-  createOrUpdateAttribute(deviceId, groupId, attributeId, payload) {
-    var url = null;
-    if (attributeId == null) {
-      url = `${this.url}/things/${deviceId}/groups/${groupId}/attributes`;
-    } else {
-      url = `${
+  createAttribute(deviceId, groupId, payload) {
+    const url = `${this.url}/things/${deviceId}/groups/${groupId}/attributes`;
+
+    return this.auth.send(this.service, 'POST', url, { payload });
+  }
+
+  /**
+   * Update an attribute. Pass null to attribute_id to create a new attribute.
+   * @param {String} deviceId The id of the parent device
+   * @param {String} groupId The id of the parent group
+   * @param {String?} attributeId Updates attribute
+   * @param {Object} payload The attribute to update
+   * @param {UUID?} payload.id Optional: The attribute id, will be overriden by attributeId parameter
+   * @param {String} payload.name The name of the attribute
+   * @param {Integer} payload.order The display order of the attribute
+   * @param {String?} payload.device_id Optional: The device id this attribute is attached to. Overriden by deviceId paramter
+   * @param {UUID} payload.user_id The user id of the device owner
+   * @param {UUID?} payload.group_id The group id of the parent group
+   * @param {String} payload.value The value, contents vary based on value_type
+   * @param {String} payload.value_type The type of content contained in value string
+   */
+  updateAttribute(deviceId, groupId, attributeId, payload) {
+    const url = `${
         this.url
       }/things/${deviceId}/groups/${groupId}/attributes/${attributeId}`;
-    }
+
     return this.auth.send(this.service, 'PUT', url, { payload });
   }
 
@@ -215,10 +245,24 @@ class Cayenne {
     return this.auth.send(this.service, 'DELETE', url);
   }
 
+    /**
+   * Get an attribute
+   * @param {String} deviceId
+   * @param {String} groupId
+   * @param {String} attributeId
+   */
+  getAttribute(deviceId, groupId, attributeId) {
+    const url = `${
+      this.url
+    }/things/${deviceId}/groups/${groupId}/attributes/${attributeId}`;
+    return this.auth.send(this.service, 'GET', url);
+  }
+
   /*
    * End Device Attribute Routes
    */
 
+
   /*
    * Begin Registry Routes
    */