Enable telemetry in the for the Application

Add telemetry events and metrics tracking throughout the
application to monitor user interactions and file operations.
All telemetry respects user privacy by only sending statistical
counts, not content.

* Add telemetry events for cluster and extension file loading
* Add error reporting for XML parsing failures
* Implement sendClusterSaveMetrics() to track cluster save
  statistics (counts of attributes, commands, events, enums,
  structs)
* Implement sendClusterExtensionSaveMetrics() to track
  extension save statistics (counts of attributes, commands,
  events)
* Call metrics methods in getSerializedCluster() and
  getSerializedClusterExtension()
* Add telemetry events for successful file save operations
* Track cluster file saves separately from extension file saves
* Add telemetry event when components are opened/rendered
 Track which component types users are working with
* Enable telemetry at application startup

- Only element counts are transmitted, never content or values
- No sensitive data (names, codes, descriptions) is included
- Separate tracking for cluster vs. cluster extension operations
- All events respect user's telemetry opt-in/opt-out settings

Signed-off-by: Arkadiusz Balys <arkadiusz.balys@nordicsemi.no>

Author: ArekBalysNordic

src/app/Components/ClusterFile.tsx

@@ -6,7 +6,7 @@
 
 /* eslint-disable @typescript-eslint/no-explicit-any */
 
-import { logger } from '@nordicsemiconductor/pc-nrfconnect-shared';
+import { logger, telemetry } from '@nordicsemiconductor/pc-nrfconnect-shared';
 
 import { defaultXMLConfigurator } from '../defaults';
 import {
@@ -159,13 +159,15 @@ class ClusterFile {
             const configurator = await parseClusterXML(content);
             this.file = configurator as XMLFile;
             logger.info('Loaded cluster file:', fileUrl.name);
+            telemetry.sendEvent('Loaded cluster file');
             this.loadedClusterExtension = false;
             return (
                 Array.isArray(this.file.cluster) ||
                 this.file.cluster !== undefined ||
                 this.file.deviceType !== undefined
             );
         } catch (error) {
+            telemetry.sendEvent('Error parsing XML file while loading cluster');
             logger.error('Error parsing XML:', error);
             return false;
         }
@@ -269,9 +271,14 @@ class ClusterFile {
             this.loadedClusterExtension = true;
 
             eventEmitter.emit('xmlInstanceChanged');
+
+            telemetry.sendEvent('Loaded cluster exension file');
             logger.info('Loaded cluster extension file:', fileUrl.name);
             return true;
         } catch (error) {
+            telemetry.sendErrorReport(
+                'Error parsing XML while loading cluster extension'
+            );
             logger.error('Error parsing XML:', error);
             return false;
         }
@@ -639,6 +646,34 @@ class ClusterFile {
         return this.XMLCurrentInstance.deviceType;
     }
 
+    /**
+     * Sends telemetry metrics for cluster extension save operation.
+     * Only sends counts of elements, not their content.
+     *
+     * @function ClusterFile.sendClusterExtensionSaveMetrics
+     * @param {XMLAttribute[]} attributes - The attributes to count
+     * @param {XMLCommand[]} commands - The commands to count
+     * @param {XMLEvent[]} events - The events to count
+     * @param {XMLDeviceType | string} deviceType - The device type (if any)
+     * @returns {void}
+     */
+    private static sendClusterExtensionSaveMetrics(
+        attributes: XMLAttribute[],
+        commands: XMLCommand[],
+        events: XMLEvent[],
+        deviceType: XMLDeviceType | string
+    ) {
+        const metrics = {
+            attributesCount: attributes?.length || 0,
+            commandsCount: commands?.length || 0,
+            eventsCount: events?.length || 0,
+            hasDeviceType: !!deviceType && deviceType !== '',
+        };
+
+        telemetry.sendEvent('Saved cluster extension', metrics);
+        logger.info('Cluster extension save metrics:', metrics);
+    }
+
     /**
      * Gets the serialized cluster extension.
      *
@@ -675,9 +710,51 @@ class ClusterFile {
         clusterExtensionInstance.clusterExtension.event = newEvents;
         clusterExtensionInstance.clusterExtension.deviceType =
             newDeviceType as XMLDeviceType;
+
+        // Send telemetry about what was saved
+        this.sendClusterExtensionSaveMetrics(
+            newAttributes || [],
+            newCommands || [],
+            newEvents || [],
+            newDeviceType || ''
+        );
+
         return serializeClusterXML(clusterExtensionInstance);
     }
 
+    /**
+     * Sends telemetry metrics for cluster save operation.
+     * Only sends counts of elements, not their content.
+     *
+     * @function ClusterFile.sendClusterSaveMetrics
+     * @param {XMLCluster} cluster - The cluster to count elements from
+     * @param {XMLEnum[]} enums - The enums to count
+     * @param {XMLStruct[]} structs - The structs to count
+     * @param {boolean} hasDeviceType - Whether device type is present
+     * @param {boolean} hasClusterExtension - Whether cluster extension is present
+     * @returns {void}
+     */
+    private static sendClusterSaveMetrics(
+        cluster: XMLCluster | undefined,
+        enums: XMLEnum[] | undefined,
+        structs: XMLStruct[] | undefined,
+        hasDeviceType: boolean,
+        hasClusterExtension: boolean
+    ) {
+        const metrics = {
+            attributesCount: cluster?.attribute?.length || 0,
+            commandsCount: cluster?.command?.length || 0,
+            eventsCount: cluster?.event?.length || 0,
+            enumsCount: enums?.length || 0,
+            structsCount: structs?.length || 0,
+            hasDeviceType,
+            hasClusterExtension,
+        };
+
+        telemetry.sendEvent('Saved cluster', metrics);
+        logger.info('Cluster save metrics:', metrics);
+    }
+
     /**
      * Gets the serialized cluster.
      *
@@ -718,6 +795,15 @@ class ClusterFile {
             xmlFile.clusterExtension = currentExt || originalExt;
         }
 
+        // Send telemetry about what was saved
+        this.sendClusterSaveMetrics(
+            this.XMLCurrentInstance.cluster,
+            this.XMLCurrentInstance.enum,
+            this.XMLCurrentInstance.struct,
+            this.XMLCurrentInstance.deviceType !== undefined,
+            !!(currentExt || originalExt)
+        );
+
         return serializeClusterXML(xmlFile);
     }
 }

src/app/Components/Component.tsx

@@ -8,6 +8,7 @@
 
 import * as React from 'react';
 import { ReactNode, useCallback, useEffect, useState } from 'react';
+import { telemetry } from '@nordicsemiconductor/pc-nrfconnect-shared';
 
 import eventEmitter from './EventEmitter';
 import ClusterTable from './Table';
@@ -262,6 +263,11 @@ const Component = <T,>({
         };
     }, [saveAllRows]);
 
+    useEffect(() => {
+        // Send telemetry event when Component is rendered
+        telemetry.sendEvent(`Component opened: ${name}`);
+    }, [name]);
+
     /// Render a table according to the current name, headers, rows and addRow callback function
     return ClusterTable(name, headers, rows, addRow, description);
 };

src/app/SidePanel/Buttons.tsx

@@ -13,6 +13,7 @@ import {
     InfoDialog,
     logger,
     Overlay,
+    telemetry,
     useHotKey,
 } from '@nordicsemiconductor/pc-nrfconnect-shared';
 
@@ -133,6 +134,7 @@ const OpenSavePanelButtons = () => {
         a.download = ClusterFile.fileName;
         a.click();
         URL.revokeObjectURL(url);
+        telemetry.sendEvent('Saved the cluster to XML file');
         logger.info('Saved the cluster');
     };
 

src/app/SidePanel/ExtensionButtons.tsx

@@ -10,6 +10,7 @@ import {
     InfoDialog,
     logger,
     Overlay,
+    telemetry,
     useHotKey,
 } from '@nordicsemiconductor/pc-nrfconnect-shared';
 
@@ -84,6 +85,7 @@ const ExtensionButtons = () => {
         a.download = ClusterFile.fileName.replace('.xml', '_extension.xml');
         a.click();
         URL.revokeObjectURL(url);
+        telemetry.sendEvent('Saved cluster extension to XML file');
         logger.info('Extension saved to file');
     };
 

src/index.tsx

@@ -7,7 +7,11 @@
 import 'regenerator-runtime/runtime';
 
 import React from 'react';
-import { App, render } from '@nordicsemiconductor/pc-nrfconnect-shared';
+import {
+    App,
+    render,
+    telemetry,
+} from '@nordicsemiconductor/pc-nrfconnect-shared';
 
 import AttributesTable from './app/Attributes/Attributes';
 import ClusterPage from './app/Cluster/Cluster';
@@ -23,6 +27,8 @@ import '../resources/css/index.scss';
 
 const reducer = undefined;
 
+telemetry.enableTelemetry();
+
 render(
     <App
         appReducer={reducer}

tests/__mocks__/nordic-shared.mock.tsx

@@ -185,4 +185,9 @@ jest.mock('@nordicsemiconductor/pc-nrfconnect-shared', () => ({
         error: jest.fn(),
         info: jest.fn(),
     },
+    telemetry: {
+        sendEvent: jest.fn(),
+        sendErrorReport: jest.fn(),
+        enableTelemetry: jest.fn(),
+    },
 }));