ga4-export-fixer 0.1.6-dev.6 → 0.1.6-dev.8

package/README.md

@@ -220,6 +220,38 @@ All fields are optional except `sourceTable`. Default values are applied automat
 
 Date fields (`dateRangeStart`, `dateRangeEnd`, etc.) accept string dates in `YYYYMMDD` or `YYYY-MM-DD` format, or BigQuery SQL expressions (e.g. `'current_date()'`, `'date(2026, 1, 1)'`).
 
+### Build on top of the ga4_events_enhanced table
+
+**`definitions/ga4/ga4_sessions.sqlx`**
+```javascript
+config {
+  type: "incremental",
+  description: "GA4 Events Enhanced table",
+  schema: "ga4",
+  bigquery: {
+    partitionBy: "event_date",
+    clusterBy: ['event_name', 'session_id', 'page_location', 'data_is_final'],
+  },
+  tags: ['ga4_export_fixer']
+}
+
+js {
+  const { ga4EventsEnhanced } = require('ga4-export-fixer');
+
+  const config = {
+    sourceTable: ref(constants.GA4_TABLES.MY_GA4_EXPORT),
+    self: self(),
+    incremental: incremental()
+  };
+}
+
+${ga4EventsEnhanced.generateSql(config)}
+
+pre_operations {
+  ${ga4EventsEnhanced.setPreOperations(config)}
+}
+```
+
 ### Helpers
 
 The helpers contain templates for common SQL expressions. The functions are referenced by **ga4EventsEnhanced** but can also be imported as utility functions for working with GA4 data.

package/helpers.js

@@ -563,8 +563,14 @@ Aggregation
  *   // => SQL expression for the last user_id by event_timestamp.
  */
 const aggregateValue = (column, aggregateType, timestampColumn) => {
-  if (typeof column === 'undefined' || typeof timestampColumn === 'undefined') {
-    throw new Error("aggregateValue: 'column' and 'timestampColumn' are required parameters and must be defined.");
+  if (typeof column === 'undefined') {
+    throw new Error("aggregateValue: 'column' is a required parameter and must be defined.");
+  }
+  if (typeof aggregateType === 'undefined') {
+    throw new Error("aggregateValue: 'aggregateType' is a required parameter and must be defined.");
+  }
+  if ((aggregateType === 'first' || aggregateType === 'last') && typeof timestampColumn === 'undefined') {
+    throw new Error(`aggregateValue: 'timestampColumn' is required when aggregateType is '${aggregateType}'.`);
   }
   
   if (aggregateType === 'max') {
@@ -598,6 +604,17 @@ const aggregateValue = (column, aggregateType, timestampColumn) => {
   throw new Error(`aggregateValue: Unsupported aggregateType '${aggregateType}'. Supported values are 'max', 'min', 'first', 'last', and 'any'.`);
 };
 
+// perform aggregations on an array of values
+const aggregateValues = (values) => {
+  if (Array.isArray(values)) {
+    return values.map(value => {
+      const sqlExpression = aggregateValue(value.column, value.aggregateType, value.timestampColumn)
+      return `${sqlExpression}${value.alias ? ` as ${value.alias}` : ''}`;
+    }).join('\n, ');
+  }
+  throw new Error("aggregateValues: 'values' must be an array of objects with 'column', 'aggregateType', and 'timestampColumn' properties.");
+};
+
 /*
 Ecommerce
 */
@@ -748,6 +765,7 @@ module.exports = {
   unnestEventParam,
   sessionId,
   aggregateValue,
+  aggregateValues,
   fixEcommerceStruct,
   isFinalData,
   ga4ExportDateFilter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ga4-export-fixer",
-  "version": "0.1.6-dev.6",
+  "version": "0.1.6-dev.8",
   "description": "",
   "main": "index.js",
   "files": [