@salesforcedevs/docs-components 1.27.6 → 1.27.7

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforcedevs/docs-components",
-    "version": "1.27.6",
+    "version": "1.27.7",
     "description": "Docs Lightning web components for DSC",
     "license": "MIT",
     "main": "index.js",
@@ -25,7 +25,7 @@
         "@types/lodash.orderby": "4.6.9",
         "@types/lodash.uniqby": "4.7.9"
     },
-    "gitHead": "96007cd5dbbd2c0754377ecbaf6f5916082b2fb0",
+    "gitHead": "9a6692c538b9622479d013aeffb1a2c9760b7494",
     "volta": {
         "node": "20.19.0",
         "yarn": "1.22.19"

package/src/modules/doc/amfReference/amfReference.ts

@@ -3,8 +3,8 @@ import { noCase } from "no-case";
 import { sentenceCase } from "sentence-case";
 import qs from "query-string";
 import { AmfModelParser } from "doc/amfModelParser";
-import { normalizeBoolean } from "dxUtils/normalizers";
-import type { OptionWithLink } from "typings/custom";
+import { normalizeBoolean, toJson } from "dxUtils/normalizers";
+import type { OptionWithLink, Breadcrumb } from "typings/custom";
 import type {
     AmfConfig,
     AmfMetadataTopic,
@@ -29,6 +29,7 @@ import {
 import { restoreScroll } from "dx/scrollManager";
 import { DocPhaseInfo } from "typings/custom";
 import { oldVersionDocInfo } from "docUtils/utils";
+import { track as trackEvent } from "dxUtils/analytics";
 
 type NavigationItem = {
     label: string;
@@ -944,6 +945,16 @@ export default class AmfReference extends LightningElement {
         this.handleSelectedItem();
 
         this.updateDocPhase();
+
+        // Track page view when a new spec reference page is loaded
+        trackEvent(this.template.host, "doc_page_view", {
+            page_path: window.location.pathname + window.location.search,
+            reference_id: referenceId,
+            reference_type: "spec",
+            meta: meta,
+            topic_type: type,
+            article_name: this.getArticleName()
+        });
     }
 
     /**
@@ -1305,6 +1316,15 @@ export default class AmfReference extends LightningElement {
             this.isVersionFetched = true;
             this.updateDocPhase();
             this.selectedSidebarValue = window.location.pathname;
+
+            // Track page view when a new markdown reference page is loaded
+            trackEvent(this.template.host, "doc_page_view", {
+                page_path: window.location.pathname + window.location.search,
+                reference_id: selectedItemRefId,
+                reference_type: "markdown",
+                topic_meta: referenceMeta,
+                article_name: this.getArticleName()
+            });
         }
     }
 
@@ -1444,6 +1464,23 @@ export default class AmfReference extends LightningElement {
         }
     }
 
+    private getArticleName(): string | undefined {
+        if (!this.breadcrumbs) {
+            return undefined;
+        }
+        try {
+            const breadcrumbArray = toJson(this.breadcrumbs) as Breadcrumb[];
+            if (Array.isArray(breadcrumbArray) && breadcrumbArray.length > 0) {
+                // Join all breadcrumb labels with "/" to create article name
+                // e.g., "Tooling API Objects/FieldDefinition"
+                return breadcrumbArray.map((crumb) => crumb.label).join("/");
+            }
+        } catch (e) {
+            // If parsing fails, return undefined
+        }
+        return undefined;
+    }
+
     handleSelectedItem(): void {
         // update topic view
         const { referenceId, amfId, type } = this.selectedTopic!;

package/src/modules/doc/xmlContent/xmlContent.ts

@@ -504,6 +504,18 @@ export default class DocXmlContent extends LightningElementWithState<{
         this.setState({
             isFetchingDocument: false
         });
+
+        // Track page view when a new document is loaded
+        trackGTM(this.template.host, "doc_page_view", {
+            page_path: this.pageReferenceToString(this.pageReference),
+            doc_id: this.pageReference.docId,
+            content_document_id: this.pageReference.contentDocumentId,
+            deliverable: this.pageReference.deliverable,
+            language: this.language?.id,
+            version: this.version?.id,
+            article_name: this.getArticleName()
+        });
+
         return data.content;
     }
 
@@ -528,6 +540,20 @@ export default class DocXmlContent extends LightningElementWithState<{
             if (!this.pageReference.hash) {
                 document.body.scrollIntoView();
             }
+
+            // Track page view when new content is loaded (navigation within same document)
+            // Note: breadcrumbs will be built after this in updatePageReference,
+            // but we need to build them here to get article_name
+            this.buildBreadcrumbs();
+            trackGTM(this.template.host, "doc_page_view", {
+                page_path: this.pageReferenceToString(this.pageReference),
+                doc_id: this.pageReference.docId,
+                content_document_id: this.pageReference.contentDocumentId,
+                deliverable: this.pageReference.deliverable,
+                language: this.language?.id,
+                version: this.version?.id,
+                article_name: this.getArticleName()
+            });
         }
         this.setState({
             isFetchingContent: false
@@ -644,6 +670,15 @@ export default class DocXmlContent extends LightningElementWithState<{
         return this.breadcrumbs && this.breadcrumbs.length > 1;
     }
 
+    private getArticleName(): string | undefined {
+        if (!this.breadcrumbs || this.breadcrumbs.length === 0) {
+            return undefined;
+        }
+        // Join all breadcrumb labels with "/" to create article name
+        // e.g., "Tooling API Objects/FieldDefinition"
+        return this.breadcrumbs.map((crumb) => crumb.label).join("/");
+    }
+
     private buildBreadcrumbs(): void {
         const { contentDocumentId } = this.pageReference;
         if (!contentDocumentId) {