feat(cloudlog): add response parsing for cloud logging service

- Add _NAVCloudLogResponse struct to represent service responses
- Add NAVCloudLogResponseInit() to initialize response structures
- Add NAVCloudLogResponseParse() to parse JSON responses
- Validate required status field to prevent silent failures

Author: damienbutt

ErrorLogUtils/NAVFoundation.CloudLog.axi

@@ -268,4 +268,81 @@ define_function NAVCloudLog(dev device, long level, char message[]) {
 }
 
 
+/**
+ * @function NAVCloudLogResponseInit
+ * @public
+ * @description Initializes a _NAVCloudLogResponse structure with empty values.
+ *              Useful for creating a clean response structure before parsing.
+ *
+ * @param {_NAVCloudLogResponse} response - The response structure to initialize
+ *
+ * @example
+ * stack_var _NAVCloudLogResponse response
+ * NAVCloudLogResponseInit(response)
+ */
+define_function NAVCloudLogResponseInit(_NAVCloudLogResponse response) {
+    response.status = ''
+    response.id = ''
+    response.timestamp = ''
+    response.type = ''
+    response.message = ''
+}
+
+
+/**
+ * @function NAVCloudLogResponseParse
+ * @public
+ * @description Parses a JSON response from the cloud logging service into a structured format.
+ *              Automatically initializes the response structure and extracts all fields
+ *              from the JSON payload (status, id, timestamp, type, message).
+ *
+ * @param {char[]} payload - JSON string containing the cloud logging service response
+ * @param {_NAVCloudLogResponse} response - Output parameter to receive the parsed response data
+ *
+ * @returns {char} True if parsing succeeded, false if JSON parsing failed
+ *
+ * @example
+ * stack_var _NAVCloudLogResponse response
+ * stack_var char jsonPayload[1024]
+ * jsonPayload = '{"status":"success","id":"abc-123","timestamp":"2026-01-29T10:30:00Z","type":"control_system"}'
+ * if (NAVCloudLogResponseParse(jsonPayload, response)) {
+ *     // Response successfully parsed
+ *     if (response.status == 'success') {
+ *         send_string 0, "'Log submitted successfully: ', response.id"
+ *     }
+ * }
+ */
+define_function char NAVCloudLogResponseParse(char payload[], _NAVCloudLogResponse response) {
+    stack_var _NAVJson json
+
+    if (!NAVJsonParse(payload, json)) {
+        NAVLibraryFunctionErrorLog(NAV_LOG_LEVEL_WARNING,
+                                __NAV_FOUNDATION_CLOUDLOG__,
+                                'NAVCloudLogResponseParse',
+                                'Failed to parse JSON response')
+        return false
+    }
+
+    NAVCloudLogResponseInit(response)
+
+    // Query all response fields
+    NAVJsonQueryString(json, '.status', response.status)
+    NAVJsonQueryString(json, '.id', response.id)
+    NAVJsonQueryString(json, '.timestamp', response.timestamp)
+    NAVJsonQueryString(json, '.type', response.type)
+    NAVJsonQueryString(json, '.message', response.message)
+
+    // Validate that critical fields were found
+    if (!length_array(response.status)) {
+        NAVLibraryFunctionErrorLog(NAV_LOG_LEVEL_WARNING,
+                                __NAV_FOUNDATION_CLOUDLOG__,
+                                'NAVCloudLogResponseParse',
+                                'Response missing required field: status')
+        return false
+    }
+
+    return true
+}
+
+
 #END_IF // __NAV_FOUNDATION_CLOUDLOG__

ErrorLogUtils/NAVFoundation.CloudLog.h.axi

@@ -104,4 +104,24 @@ struct _NAVCloudLog {
 }
 
 
+/**
+ * @struct _NAVCloudLogResponse
+ * @description Structure representing the response from the cloud logging service.
+ *              Indicates success or failure of log submission along with relevant details.
+ *
+ * @property {char[10]} status - Status of the log submission ("success" or "error")
+ * @property {char[40]} id - Unique identifier for the log entry (UUID v4 format, 36 chars)
+ * @property {char[32]} timestamp - ISO 8601 formatted timestamp of when the response was generated (~24 chars)
+ * @property {char[15]} type - Type of log ("control_system" or "generic")
+ * @property {char[512]} message - Error message if status is "error"
+ */
+struct _NAVCloudLogResponse {
+    char status[10]
+    char id[NAV_CLOUDLOG_SIZE_ID]
+    char timestamp[NAV_CLOUDLOG_SIZE_TIMESTAMP]
+    char type[15]
+    char message[NAV_CLOUDLOG_SIZE_MESSAGE]
+}
+
+
 #END_IF // __NAV_FOUNDATION_CLOUDLOG_H__