@flisk/analyze-tracking 0.8.5 → 0.8.7

package/README.md

@@ -101,17 +101,19 @@ See [schema.json](schema.json) for a JSON Schema of the output.
 
 | Library | JavaScript/TypeScript | Python | Ruby | Go |
 |---------|:---------------------:|:------:|:----:|:--:|
-| Google Analytics  | ✅ | ❌ | ❌ | ❌ |
-| Segment           | ✅ | ✅ | ✅ | ✅ |
-| Mixpanel          | ✅ | ✅ | ✅ | ✅ |
-| Amplitude         | ✅ | ✅ | ❌ | ✅ |
-| Rudderstack       | ✅ | ✅ | ✳️ | ✳️ |
-| mParticle         | ✅ | ❌ | ❌ | ❌ |
-| PostHog           | ✅ | ✅ | ✅ | ✅ |
-| Pendo             | ✅ | ❌ | ❌ | ❌ |
-| Heap              | ✅ | ❌ | ❌ | ❌ |
-| Snowplow          | ✅ | ✅ | ✅ | ✅ |
-| Custom Function   | ✅ | ✅ | ✅ | ✅ |
+| Google Analytics   | ✅ | ❌ | ❌ | ❌ |
+| Google Tag Manager | ✅ | ❌ | ❌ | ❌ |
+| Segment            | ✅ | ✅ | ✅ | ✅ |
+| Mixpanel           | ✅ | ✅ | ✅ | ✅ |
+| Amplitude          | ✅ | ✅ | ❌ | ✅ |
+| Rudderstack        | ✅ | ✅ | ✳️ | ✳️ |
+| mParticle          | ✅ | ❌ | ❌ | ❌ |
+| PostHog            | ✅ | ✅ | ✅ | ✅ |
+| Pendo              | ✅ | ❌ | ❌ | ❌ |
+| Heap               | ✅ | ❌ | ❌ | ❌ |
+| Snowplow           | ✅ | ✅ | ✅ | ✅ |
+| Datadog RUM        | ✅ | ❌ | ❌ | ❌ |
+| Custom Function    | ✅ | ✅ | ✅ | ✅ |
 
 ✳️ Rudderstack's SDKs often use the same format as Segment, so Rudderstack events may be detected as Segment events.
 
@@ -129,6 +131,24 @@ See [schema.json](schema.json) for a JSON Schema of the output.
   ```
 </details>
 
+<details>
+  <summary>Google Tag Manager</summary>
+
+  **JavaScript/TypeScript**
+  ```js
+  dataLayer.push({
+    event: '<event_name>',
+    '<property_name>': '<property_value>'
+  });
+
+  // Or via window
+  window.dataLayer.push({
+    event: '<event_name>',
+    '<property_name>': '<property_value>'
+  });
+  ```
+</details>
+
 <details>
   <summary>Segment</summary>
 
@@ -375,6 +395,27 @@ See [schema.json](schema.json) for a JSON Schema of the output.
 
 </details>
 
+<details>
+  <summary>Datadog RUM</summary>
+
+  **JavaScript/TypeScript**
+  ```js
+  datadogRum.addAction('<event_name>', {
+    '<property_name>': '<property_value>'
+  });
+  
+  // Or via window
+  window.DD_RUM.addAction('<event_name>', {
+    '<property_name>': '<property_value>'
+  });
+
+  // Or via global DD_RUM
+  DD_RUM.addAction('<event_name>', {
+    '<property_name>': '<property_value>'
+  });
+  ```
+</details>
+
 <details>
   <summary>Snowplow (Structured Events)</summary>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flisk/analyze-tracking",
-  "version": "0.8.5",
+  "version": "0.8.7",
   "description": "Analyzes tracking code in a project and generates data schemas",
   "main": "src/index.js",
   "bin": {

package/schema.json

@@ -67,6 +67,8 @@
                       "pendo",
                       "heap",
                       "snowplow",
+                      "datadog",
+                      "gtm",
                       "custom",
                       "unknown"
                     ],

package/src/analyze/javascript/constants.js

@@ -75,6 +75,18 @@ const ANALYTICS_PROVIDERS = {
     name: 'googleanalytics',
     functionName: 'gtag',
     type: 'function'
+  },
+  DATADOG_RUM: {
+    name: 'datadog',
+    objectNames: ['datadogRum', 'DD_RUM'],
+    methodName: 'addAction',
+    type: 'member'
+  },
+  GOOGLE_TAG_MANAGER: {
+    name: 'gtm',
+    objectNames: ['dataLayer'],
+    methodName: 'push',
+    type: 'member'
   }
 };
 

package/src/analyze/javascript/detectors/analytics-source.js

@@ -131,8 +131,17 @@ function detectMemberBasedProvider(node) {
     return 'unknown';
   }
 
-  const objectName = node.callee.object.name;
   const methodName = node.callee.property.name;
+  let objectName = node.callee.object.name;
+
+  // Handle nested member expressions like window.DD_RUM.addAction
+  if (!objectName && node.callee.object.type === NODE_TYPES.MEMBER_EXPRESSION) {
+    // For window.DD_RUM.addAction, we want to check if it matches DD_RUM.addAction pattern
+    const nestedObjectName = node.callee.object.property.name;
+    if (nestedObjectName) {
+      objectName = nestedObjectName;
+    }
+  }
 
   if (!objectName || !methodName) {
     return 'unknown';

package/src/analyze/javascript/extractors/event-extractor.js

@@ -20,6 +20,7 @@ const EXTRACTION_STRATEGIES = {
   googleanalytics: extractGoogleAnalyticsEvent,
   snowplow: extractSnowplowEvent,
   mparticle: extractMparticleEvent,
+  gtm: extractGTMEvent,
   custom: extractCustomEvent,
   default: extractDefaultEvent
 };
@@ -105,6 +106,43 @@ function extractMparticleEvent(node, constantMap) {
   return { eventName, propertiesNode };
 }
 
+/**
+ * Extracts Google Tag Manager event data
+ * @param {Object} node - CallExpression node
+ * @param {Object} constantMap - Collected constant map
+ * @returns {EventData}
+ */
+function extractGTMEvent(node, constantMap) {
+  if (!node.arguments || node.arguments.length === 0) {
+    return { eventName: null, propertiesNode: null };
+  }
+
+  // dataLayer.push({ event: 'event_name', property1: 'value1', property2: 'value2' })
+  const firstArg = node.arguments[0];
+  
+  if (firstArg.type !== NODE_TYPES.OBJECT_EXPRESSION) {
+    return { eventName: null, propertiesNode: null };
+  }
+
+  // Find the 'event' property
+  const eventProperty = findPropertyByKey(firstArg, 'event');
+  if (!eventProperty) {
+    return { eventName: null, propertiesNode: null };
+  }
+
+  const eventName = getStringValue(eventProperty.value, constantMap);
+  
+  // Create a modified properties node without the 'event' property
+  const modifiedPropertiesNode = {
+    ...firstArg,
+    properties: firstArg.properties.filter(prop => 
+      prop.key && (prop.key.name !== 'event' && prop.key.value !== 'event')
+    )
+  };
+
+  return { eventName, propertiesNode: modifiedPropertiesNode };
+}
+
 /**
  * Default event extraction for standard providers
  * @param {Object} node - CallExpression node

package/src/analyze/typescript/constants.js

@@ -75,6 +75,18 @@ const ANALYTICS_PROVIDERS = {
     name: 'googleanalytics',
     functionName: 'gtag',
     type: 'function'
+  },
+  DATADOG_RUM: {
+    name: 'datadog',
+    objectNames: ['datadogRum', 'DD_RUM'],
+    methodName: 'addAction',
+    type: 'member'
+  },
+  GOOGLE_TAG_MANAGER: {
+    name: 'gtm',
+    objectNames: ['dataLayer'],
+    methodName: 'push',
+    type: 'member'
   }
 };
 

package/src/analyze/typescript/detectors/analytics-source.js

@@ -87,8 +87,17 @@ function detectMemberBasedProvider(node) {
     return 'unknown';
   }
 
-  const objectName = node.expression.expression?.escapedText;
   const methodName = node.expression.name?.escapedText;
+  let objectName = node.expression.expression?.escapedText;
+
+  // Handle nested member expressions like window.DD_RUM.addAction
+  if (!objectName && ts.isPropertyAccessExpression(node.expression.expression)) {
+    // For window.DD_RUM.addAction, we want to check if it matches DD_RUM.addAction pattern
+    const nestedObjectName = node.expression.expression.name?.escapedText;
+    if (nestedObjectName) {
+      objectName = nestedObjectName;
+    }
+  }
 
   if (!objectName || !methodName) {
     return 'unknown';

package/src/analyze/typescript/extractors/event-extractor.js

@@ -21,6 +21,7 @@ const EXTRACTION_STRATEGIES = {
   googleanalytics: extractGoogleAnalyticsEvent,
   snowplow: extractSnowplowEvent,
   mparticle: extractMparticleEvent,
+  gtm: extractGTMEvent,
   custom: extractCustomEvent,
   default: extractDefaultEvent
 };
@@ -126,6 +127,60 @@ function extractMparticleEvent(node, checker, sourceFile) {
   return { eventName, propertiesNode };
 }
 
+/**
+ * Extracts Google Tag Manager event data
+ * @param {Object} node - CallExpression node
+ * @param {Object} checker - TypeScript type checker
+ * @param {Object} sourceFile - TypeScript source file
+ * @returns {EventData}
+ */
+function extractGTMEvent(node, checker, sourceFile) {
+  if (!node.arguments || node.arguments.length === 0) {
+    return { eventName: null, propertiesNode: null };
+  }
+
+  // dataLayer.push({ event: 'event_name', property1: 'value1', property2: 'value2' })
+  const firstArg = node.arguments[0];
+  
+  if (!ts.isObjectLiteralExpression(firstArg)) {
+    return { eventName: null, propertiesNode: null };
+  }
+
+  // Find the 'event' property
+  const eventProperty = findPropertyByKey(firstArg, 'event');
+  if (!eventProperty) {
+    return { eventName: null, propertiesNode: null };
+  }
+
+  const eventName = getStringValue(eventProperty.initializer, checker, sourceFile);
+  
+  // Create a modified properties node without the 'event' property
+  const modifiedProperties = firstArg.properties.filter(prop => {
+    if (ts.isPropertyAssignment(prop) && prop.name) {
+      if (ts.isIdentifier(prop.name)) {
+        return prop.name.escapedText !== 'event';
+      }
+      if (ts.isStringLiteral(prop.name)) {
+        return prop.name.text !== 'event';
+      }
+    }
+    return true;
+  });
+
+  // Create a synthetic object literal with the filtered properties
+  const modifiedPropertiesNode = ts.factory.createObjectLiteralExpression(modifiedProperties);
+  
+  // Copy source positions for proper analysis
+  if (firstArg.pos !== undefined) {
+    modifiedPropertiesNode.pos = firstArg.pos;
+  }
+  if (firstArg.end !== undefined) {
+    modifiedPropertiesNode.end = firstArg.end;
+  }
+
+  return { eventName, propertiesNode: modifiedPropertiesNode };
+}
+
 /**
  * Custom extraction
  * @param {Object} node - CallExpression node