FEAT: introduce invalid input value status code

fiftyone.h

@@ -435,6 +435,8 @@ MAP_TYPE(KeyValuePairArray)
 #define TEMP_FILE_ERROR FIFTYONE_DEGREES_STATUS_TEMP_FILE_ERROR /**< Synonym for #FIFTYONE_DEGREES_STATUS_INCORRECT_IP_ADDRESS_FORMAT status code. */
 #define DATA_FILE_NEEDS_UPDATED FIFTYONE_DEGREES_STATUS_DATA_FILE_NEEDS_UPDATED /**< Synonym for #FIFTYONE_DEGREES_STATUS_DATA_FILE_NEEDS_UPDATED status code. */
 #define INSUFFICIENT_CAPACITY FIFTYONE_DEGREES_STATUS_INSUFFICIENT_CAPACITY /**< Synonym for #FIFTYONE_DEGREES_STATUS_INSUFFICIENT_CAPACITY status code. */
+#define INVALID_INPUT FIFTYONE_DEGREES_STATUS_INVALID_INPUT /**< Synonym for
+    #FIFTYONE_DEGREES_STATUS_INVALID_INPUT status code.*/
 /**
  * @}
  */

status.c

@@ -120,7 +120,8 @@ static StatusMessage messages[] = {
 		"string has correct format. If passing a byte array, verify the "
 		"associated input data is also consistent." },
 	{ TEMP_FILE_ERROR,
-		"Error occurs during the creation of a temporary file."}
+		"Error occurs during the creation of a temporary file."},
+    { INVALID_INPUT, "The input value is invalid: misformatted or semantically inconsistent."},
 };
 
 static char defaultMessage[] = "Status code %i does not have any message text.";
@@ -157,4 +158,4 @@ const char* fiftyoneDegreesStatusGetMessage(
 		Snprintf(message, messageSize, defaultMessage, (int)status);
 	}
 	return message;
-}
+}

status.h

@@ -138,7 +138,10 @@ typedef enum e_fiftyone_degrees_status_code {
 	FIFTYONE_DEGREES_STATUS_INCORRECT_IP_ADDRESS_FORMAT, /**< IP address 
 														format is incorrect */
 	FIFTYONE_DEGREES_STATUS_TEMP_FILE_ERROR, /**< Error creating temp file */
-	FIFTYONE_DEGREES_STATUS_INSUFFICIENT_CAPACITY,
+	FIFTYONE_DEGREES_STATUS_INSUFFICIENT_CAPACITY, /**< Insufficient capacity of
+                                                    the array to hold all the items*/
+    FIFTYONE_DEGREES_STATUS_INVALID_INPUT, /**< Invalid input data (f.e. base64 / JSON
+                                     misformat or semantic inconsistency) */
 } fiftyoneDegreesStatusCode;
 
 /**
@@ -158,4 +161,4 @@ EXTERNAL const char* fiftyoneDegreesStatusGetMessage(
  * @}
  */
 
-#endif
+#endif

tests/StatusTests.cpp

@@ -274,4 +274,18 @@ TEST(Status, Get_NegativeCode) {
 	Snprintf(code, 3, "%d", invalidStatus);
 	assertContains(message, code);
 	free((void*)message);
-}
+}
+
+/**
+ * Check that a message is still returned for a negative status code which does
+ * not (and cannot) exist and the message contains the code as a string.
+ */
+TEST(Status, Get_InvalidInput) {
+    const char *message = fiftyoneDegreesStatusGetMessage(
+                                                          FIFTYONE_DEGREES_STATUS_INVALID_INPUT,
+                                                          NULL);
+    assertValidMessage(message);
+    assertContains(message, "invalid");
+    assertContains(message, "input value");
+    free((void*)message);
+}