ga4-export-fixer 0.1.4 → 0.1.5-dev.0

package/README.md

@@ -2,6 +2,20 @@
 
 **ga4-export-fixer** is a **Dataform NPM package** that transforms raw GA4 BigQuery export data into a cleaner, more queryable incremental table. It combines daily and intraday exports so the best available version of each event is always in use, adds session-level fields like `session_id` and `landing_page`, promotes key event parameters to columns, and fixes known GA4 export issues — handling the boilerplate transformations that are otherwise tedious to include in every GA4 query.
 
+The goal of the package is to **speed up development** when building data models and pipelines on top of GA4 export data, allowing you to focus on your use case instead of wrestling with the raw export format.
+
+### Planned Features
+
+- Support for using only intraday export data
+- Tools for building on top of the enhanced events table
+- Column descriptions
+- Default configurations for app and web properties
+- Item list attribution
+- Data enrichment (item-level, session-level, event-level)
+- Support for fresh export (GA4 360)
+- Custom processing steps (additional CTEs)
+- Custom traffic source attribution
+
 ## Installation
 
 ### Bash
@@ -19,7 +33,7 @@ Include the package in the package.json file in your Dataform repository.
 {
   "dependencies": {
     "@dataform/core": "3.0.42",
-    "ga4-export-fixer": "0.1.2"
+    "ga4-export-fixer": "0.1.5-dev.0"
   }
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ga4-export-fixer",
-  "version": "0.1.4",
+  "version": "0.1.5-dev.0",
   "description": "",
   "main": "index.js",
   "files": [
@@ -18,7 +18,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/tanelytics/ga4-export-fixer"
+    "url": "git+https://github.com/tanelytics/ga4-export-fixer.git"
   },
   "author": "Taneli Salonen",
   "license": "MIT",

package/tables/ga4EventsEnhanced.js

@@ -52,11 +52,13 @@ const defaultConfig = {
         //{name: 'page_location', type: 'string', columnName: 'page_location2'},
     ],
     sessionParams: [],
-    defaultExcludedEvents: [
+    defaultExcludedEvents: [],
+    // session_start and first_visit are excluded via the excludedEvents array
+    // this allows the user to include them if needed
+    excludedEvents: [
         'session_start',
         'first_visit'
     ],
-    excludedEvents: [],
     defaultExcludedColumns: [
         'event_dimensions', // legacy column, not needed
         'traffic_source', // renamed to user_traffic_source

package/utils.js

@@ -87,7 +87,7 @@ ${groupByClause}`;
  * 
  * Rules:
  * - Nested objects are merged recursively key by key
- * - Arrays are concatenated and deduplicated
+ * - Arrays are overwritten by user input
  * - Default values are preserved unless explicitly overridden (including with undefined)
  * - Explicitly setting a value to undefined in inputConfig will override the default
  * - Date fields: after merging, specific date fields (listed in dateFields) are processed via processDate().
@@ -120,9 +120,9 @@ const mergeSQLConfigurations = (defaultConfig, inputConfig = {}) => {
             continue;
         }
 
-        // Handle arrays: concatenate and remove duplicates
+        // Handle arrays: overwrite with user input
         if (Array.isArray(defaultValue) && Array.isArray(inputValue)) {
-            result[key] = mergeUniqueArrays(defaultValue, inputValue);
+            result[key] = inputValue;
             continue;
         }