@salesforce/telemetry 6.5.1 → 6.6.0

package/lib/exported.d.ts

@@ -2,4 +2,4 @@ import { TelemetryReporter } from './telemetryReporter';
 export * from './telemetryReporter';
 export { isEnabled } from './enabledCheck';
 export default TelemetryReporter;
-export type { Attributes, O11ySchema, O11yBatchingConfig } from './types';
+export type { Attributes, O11ySchema, O11yBatchingConfig, PdpEvent } from './types';

package/lib/o11yReporter.d.ts

@@ -1,5 +1,5 @@
 import { type BatchingOptions } from '@salesforce/o11y-reporter';
-import { Attributes, O11ySchema, Properties, TelemetryOptions } from './types';
+import { Attributes, O11ySchema, PdpEvent, Properties, TelemetryOptions } from './types';
 import { BaseReporter } from './baseReporter';
 export declare class O11yReporter extends BaseReporter {
     private service;
@@ -46,6 +46,12 @@ export declare class O11yReporter extends BaseReporter {
      * @param schema - O11y schema object (e.g. from o11y_schema package)
      */
     sendTelemetryEventWithSchema(eventName: string, attributes: Attributes, schema: O11ySchema): Promise<void>;
+    /**
+     * Sends a PDP event via O11y service.
+     *
+     * @param event - PDP event to send.
+     */
+    sendPdpEvent(event: PdpEvent): Promise<void>;
     flush(): Promise<void>;
     /**
      * Publishes exception to O11y service

package/lib/o11yReporter.js

@@ -17,6 +17,9 @@ exports.O11yReporter = void 0;
  * limitations under the License.
  */
 const o11y_reporter_1 = require("@salesforce/o11y-reporter");
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore o11y_schema/sf_pdp.d.ts is not a valid module
+const sf_pdp_1 = require("o11y_schema/sf_pdp");
 const baseReporter_1 = require("./baseReporter");
 const utils_1 = require("./utils");
 class O11yReporter extends baseReporter_1.BaseReporter {
@@ -105,6 +108,18 @@ class O11yReporter extends baseReporter_1.BaseReporter {
             await this.service.forceFlush();
         }
     }
+    /**
+     * Sends a PDP event via O11y service.
+     *
+     * @param event - PDP event to send.
+     */
+    async sendPdpEvent(event) {
+        await this.initialized;
+        this.service.logEventWithSchema(event, sf_pdp_1.pdpEventSchema);
+        if (!this._batchingEnabled) {
+            await this.service.forceFlush();
+        }
+    }
     async flush() {
         // Wait for initialization to complete before using the service
         await this.initialized;

package/lib/telemetryReporter.d.ts

@@ -1,7 +1,7 @@
 import { AsyncCreatable } from '@salesforce/kit';
 import type { BatchingOptions } from '@salesforce/o11y-reporter';
 import { TelemetryClient } from './appInsights';
-import { Attributes, O11ySchema, Properties, TelemetryOptions } from './types';
+import { Attributes, O11ySchema, PdpEvent, Properties, TelemetryOptions } from './types';
 /**
  * This is the main telemetry reporter that should be used by consumers.
  * It will check if telemetry is disabled and do GDPR checks.
@@ -44,6 +44,12 @@ export declare class TelemetryReporter extends AsyncCreatable<TelemetryOptions>
      * @param schema - O11y schema object (e.g. from o11y_schema package)
      */
     sendTelemetryEventWithSchema(eventName: string, attributes: Attributes, schema: O11ySchema): void;
+    /**
+     * Sends a PDP event via O11y.
+     *
+     * @param event - PDP event data to send.
+     */
+    sendPdpEvent(event: PdpEvent): void;
     /**
      * Sends message to both AppInsights and O11y (if enabled).
      *

package/lib/telemetryReporter.js

@@ -203,6 +203,18 @@ class TelemetryReporter extends kit_1.AsyncCreatable {
             });
         }
     }
+    /**
+     * Sends a PDP event via O11y.
+     *
+     * @param event - PDP event data to send.
+     */
+    sendPdpEvent(event) {
+        if (this.isSfdxTelemetryEnabled() && this.enableO11y && this.o11yReporter) {
+            void this.o11yReporter.sendPdpEvent(event).catch((error) => {
+                this.logger.debug('Failed to send PDP event to O11y:', error);
+            });
+        }
+    }
     /**
      * Sends message to both AppInsights and O11y (if enabled).
      *

package/lib/types.d.ts

@@ -15,6 +15,49 @@ export type Attributes = {
  * (not a primitive, null, or undefined).
  */
 export type O11ySchema = Record<string, unknown>;
+/**
+ * PDP Product Feature Taxonomy (PFT) event sent via O11y.
+ */
+export type PdpEvent = {
+    /**
+     * Unique identifier for the event. Follows this naming convention:
+     *     <object>.<action>
+     *
+     * object = Specific object within the Product Feature that give us context around the action in lowerCamelCase format.
+     *          Note: The object name can include context around the Product Feature (eg. slackforceMessage).
+     *          Examples: calculatedInsightsRecord,checkoutPaymentmethod, slackforceMessage, promptBuilderTemplate
+     *
+     * action = Action the user takes in past tense. This should only be ONE word, in lower case
+     *          Examples: processed, selected, sent, saved
+     */
+    eventName: `${string}.${string}`;
+    /**
+     * Product Feature ID from GUS.
+     *
+     * Examples:
+     *   Salesforce CLI = aJCEE0000000mHP4AY
+     *   Salesforce Extensions for VS Code = aJCEE0000000mLm4AI
+     */
+    productFeatureId: `aJC${string}`;
+    /**
+     * Populate this if there is a unique component with your Event for which a distinct count would be a relevant metric
+     * E.g., CLI plugin command name (<pluginName.commandName>) or ext command name.
+     */
+    componentId?: string;
+    /**
+     * Populate this if there is a unique quantity with your Event for which a sum would be a relevant metric for your
+     * Product Feature. E.g., rowsProcessed → total Rows processed for Data Streams.
+     */
+    eventVolume?: number;
+    /**
+     * Use this field to specify the name of your flexible attribute (eg. experimentId, buttonColor).
+     */
+    contextName?: string;
+    /**
+     * Use this field to specify the value of your flexible attribute (eg. exp_123, green).
+     */
+    contextValue?: string;
+};
 /**
  * Batching configuration for O11y telemetry
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/telemetry",
-  "version": "6.5.1",
+  "version": "6.6.0",
   "description": "Library for telemetry reporting to Application Insights and O11y",
   "main": "lib/exported",
   "exports": {
@@ -43,9 +43,10 @@
   "dependencies": {
     "@salesforce/core": "^8.25.1",
     "@salesforce/kit": "^3.2.4",
-    "@salesforce/o11y-reporter": "1.7.0",
+    "@salesforce/o11y-reporter": "1.7.3",
     "applicationinsights": "^2.9.8",
     "got": "^11",
+    "o11y_schema": "^260.41.0",
     "proxy-agent": "^6.5.0"
   },
   "devDependencies": {