Add IAppGatewayTelemetry interface for context-aware telemetry recording (#699)

* Initial plan

* Add IAppGatewayTelemetry interface with telemetry recording methods

Co-authored-by: satlead <970901+satlead@users.noreply.github.com>

* Add .gitignore and remove build artifacts

Co-authored-by: satlead <970901+satlead@users.noreply.github.com>

* Change metricValue parameter to double for type safety

Co-authored-by: satlead <970901+satlead@users.noreply.github.com>

* Complete telemetry interface implementation

Co-authored-by: satlead <970901+satlead@users.noreply.github.com>

* Remove .gitignore and _codeql_detected_source_root files

Co-authored-by: satlead <970901+satlead@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: satlead <970901+satlead@users.noreply.github.com>
Co-authored-by: Sathishkumar <satlead@gmail.com>

Author: Copilot

apis/AppGateway/IAppGateway.h

@@ -190,5 +190,45 @@ namespace WPEFramework
                                           string& result /*@out @opaque */) = 0;
 
         };
+
+        // @text:keep
+        struct EXTERNAL IAppGatewayTelemetry : virtual public Core::IUnknown
+        {
+            enum
+            {
+                ID = ID_APP_GATEWAY_TELEMETRY
+            };
+
+            // @json:omit
+            // @text recordTelemetryEvent
+            // @brief Records a telemetry event with gateway context information
+            // @param context: Execution context containing requestId, connectionId, appId
+            // @param eventName: Name of the telemetry event to record
+            // @param eventData: JSON string containing telemetry event data
+            // @retval Core::ERROR_NONE: Event recorded successfully
+            // @retval Core::ERROR_GENERAL: Failed to record the event
+            // @retval Core::ERROR_UNAVAILABLE: Telemetry service is not available
+            // @returns Core::hresult
+            virtual Core::hresult RecordTelemetryEvent(const GatewayContext& context /* @text context */,
+                                                       const string& eventName /* @text eventName */,
+                                                       const string& eventData /* @text eventData */ /*@opaque */) = 0;
+
+            // @json:omit
+            // @text recordTelemetryMetric
+            // @brief Records a telemetry metric with gateway context information
+            // @param context: Execution context containing requestId, connectionId, appId
+            // @param metricName: Name of the telemetry metric to record
+            // @param metricValue: Numeric value of the metric
+            // @param metricUnit: Unit of measurement for the metric
+            // @retval Core::ERROR_NONE: Metric recorded successfully
+            // @retval Core::ERROR_GENERAL: Failed to record the metric
+            // @retval Core::ERROR_UNAVAILABLE: Telemetry service is not available
+            // @returns Core::hresult
+            virtual Core::hresult RecordTelemetryMetric(const GatewayContext& context /* @text context */,
+                                                        const string& metricName /* @text metricName */,
+                                                        const double metricValue /* @text metricValue */,
+                                                        const string& metricUnit /* @text metricUnit */) = 0;
+
+        };
     } // namespace Exchange
 } // namespace WPEFramework

apis/Ids.h

@@ -330,6 +330,7 @@ namespace Exchange {
         ID_APP_GATEWAY_AUTHENTICATOR                 = ID_APP_GATEWAY + 2,
         ID_APP_GATEWAY_CONNECTION_NOTIFICATION        = ID_APP_GATEWAY + 3,
         ID_APP_GATEWAY_REQUEST_HANDLER               = ID_APP_GATEWAY + 4,
+        ID_APP_GATEWAY_TELEMETRY                     = ID_APP_GATEWAY + 5,
 
         ID_APP_NOTIFICATIONS                         = ID_ENTOS_OFFSET + 0x450,
         ID_APP_NOTIFICATIONS_HANDLER_INTERNAL        = ID_APP_NOTIFICATIONS + 1,