Add getValidThreadColors

DOCS.md

@@ -22,6 +22,7 @@
 * [`api.getThreadPictures`](#getThreadPictures)
 * [`api.getUserID`](#getUserID)
 * [`api.getUserInfo`](#getUserInfo)
+* [`api.validThreadColors`](#validThreadColors)
 * [`api.handleMessageRequest`](#handleMessageRequest)
 * [`api.listen`](#listen)
 * [`api.logout`](#logout)
@@ -715,6 +716,29 @@ login({appState: JSON.parse(fs.readFileSync('appstate.json', 'utf8'))}, (err, ap
 
 ---------------------------------------
 
+<a name="validThreadColors"></a>
+### api.validThreadColors
+
+Returns a dictionary mapping names of all currently valid thread colors to their hexadecimal values that are accepted by [`api.changeThreadColor`](#changeThreadColor). These colors, listed below, are the ones present in the palette UI used for selecting thread colors on the Messenger client. Due to Facebook backend changes, the thread color can no longer be set to an arbitrary hex value.
+
+- MessengerBlue: `null`
+- Viking: `#44bec7`
+- GoldenPoppy: `#ffc300`
+- RadicalRed: `#fa3c4c`
+- Shocking: `#d696bb`
+- PictonBlue: `#6699cc`
+- FreeSpeechGreen: `#13cf13`
+- Pumpkin: `#ff7e29`
+- LightCoral: `#e68585`
+- MediumSlateBlue: `#7646ff`
+- DeepSkyBlue: `#20cef5`
+- Fern: `#67b868`
+- Cameo: `#d4a88c`
+- BrilliantRose: `#ff5ca1`
+- BilobaFlower: `#a695c7`
+
+---------------------------------------
+
 <a name="handleMessageRequest"></a>
 ### api.handleMessageRequest(threadID, accept[, callback])
 

index.js

@@ -93,6 +93,7 @@ function buildAPI(globalOptions, html, jar) {
     'getThreadPictures',
     'getUserID',
     'getUserInfo',
+    'validThreadColors',
     'handleMessageRequest',
     'listen',
     'logout',

src/changeThreadColor.js

@@ -8,8 +8,17 @@ module.exports = function(defaultFuncs, api, ctx) {
     if(!callback) {
       callback = function() {};
     }
+
+    var validatedColor = (color !== null) ? color.toLowerCase() : color; // API only accepts lowercase letters in hex string
+    var colorList = Object.keys(api.validThreadColors).map(function(name) {
+      return api.validThreadColors[name];
+    });
+    if(!colorList.includes(validatedColor)) {
+        throw {error: "The color you are trying to use is not a valid thread color. Use api.validThreadColors to find acceptable values."};
+    }
+
     var form = {
-      'color_choice' : color,
+      'color_choice' : validatedColor,
       'thread_or_other_fbid' : threadID
     };
 

src/validThreadColors.js

@@ -0,0 +1,22 @@
+"use strict";
+
+module.exports = function(defaultFuncs, api, ctx) {
+    // Currently the only colors that can be passed to api.changeThreadColor(); may change if Facebook adds more
+    return {
+        "MessengerBlue": null,
+        "Viking": "#44bec7",
+        "GoldenPoppy": "#ffc300",
+        "RadicalRed": "#fa3c4c",
+        "Shocking": "#d696bb",
+        "PictonBlue": "#6699cc",
+        "FreeSpeechGreen": "#13cf13",
+        "Pumpkin": "#ff7e29",
+        "LightCoral": "#e68585",
+        "MediumSlateBlue": "#7646ff",
+        "DeepSkyBlue": "#20cef5",
+        "Fern": "#67b868",
+        "Cameo": "#d4a88c",
+        "BrilliantRose": "#ff5ca1",
+        "BilobaFlower": "#a695c7"
+    };
+};