@walkeros/web-destination-gtag 3.4.0 → 3.4.1

package/dist/examples/index.d.mts

@@ -78,9 +78,12 @@ declare const gtmDataLayerPush: Flow.StepExample;
  */
 declare const consentModeV2: Flow.StepExample;
 /**
- * GA4 event with include: ['all'] — flattens all event sections as prefixed params.
- * Each section (data, context, globals, user, source, event, version)
- * is flattened into params like data_*, context_*, user_*, etc.
+ * GA4 event flattening selected event sections into prefixed params.
+ * Each listed section (data, context, globals, user, source, event) is
+ * flattened into params like data_*, context_*, user_*, etc.
+ * The `version` section is intentionally omitted — version_source is baked
+ * in at build time from @walkeros/core's package.json, so asserting on it
+ * would couple the fixture to the release version.
  */
 declare const ga4WithIncludeAll: Flow.StepExample;
 /**

package/dist/examples/index.d.ts

@@ -78,9 +78,12 @@ declare const gtmDataLayerPush: Flow.StepExample;
  */
 declare const consentModeV2: Flow.StepExample;
 /**
- * GA4 event with include: ['all'] — flattens all event sections as prefixed params.
- * Each section (data, context, globals, user, source, event, version)
- * is flattened into params like data_*, context_*, user_*, etc.
+ * GA4 event flattening selected event sections into prefixed params.
+ * Each listed section (data, context, globals, user, source, event) is
+ * flattened into params like data_*, context_*, user_*, etc.
+ * The `version` section is intentionally omitted — version_source is baked
+ * in at build time from @walkeros/core's package.json, so asserting on it
+ * would couple the fixture to the release version.
  */
 declare const ga4WithIncludeAll: Flow.StepExample;
 /**

package/dist/examples/index.js

@@ -115,7 +115,7 @@ function Q(e2) {
 }
 function fe(e2 = {}) {
   var _a;
-  const t = e2.timestamp || (/* @__PURE__ */ new Date()).setHours(0, 13, 37, 0), n = e2.group || "gr0up", o = e2.count || 1, r = L({ name: "entity action", data: { string: "foo", number: 1, boolean: true, array: [0, "text", false], not: void 0 }, context: { dev: ["test", 1] }, globals: { lang: "elb" }, custom: { completely: "random" }, user: { id: "us3r", device: "c00k13", session: "s3ss10n" }, nested: [{ entity: "child", data: { is: "subordinated" }, nested: [], context: { element: ["child", 0] } }], consent: { functional: true }, id: `${t}-${n}-${o}`, trigger: "test", entity: "entity", action: "action", timestamp: t, timing: 3.14, group: n, count: o, version: { source: "3.4.0", tagging: 1 }, source: { type: "web", id: "https://localhost:80", previous_id: "http://remotehost:9001" } }, e2, { merge: false });
+  const t = e2.timestamp || (/* @__PURE__ */ new Date()).setHours(0, 13, 37, 0), n = e2.group || "gr0up", o = e2.count || 1, r = L({ name: "entity action", data: { string: "foo", number: 1, boolean: true, array: [0, "text", false], not: void 0 }, context: { dev: ["test", 1] }, globals: { lang: "elb" }, custom: { completely: "random" }, user: { id: "us3r", device: "c00k13", session: "s3ss10n" }, nested: [{ entity: "child", data: { is: "subordinated" }, nested: [], context: { element: ["child", 0] } }], consent: { functional: true }, id: `${t}-${n}-${o}`, trigger: "test", entity: "entity", action: "action", timestamp: t, timing: 3.14, group: n, count: o, version: { source: "3.4.1", tagging: 1 }, source: { type: "web", id: "https://localhost:80", previous_id: "http://remotehost:9001" } }, e2, { merge: false });
   if (e2.name) {
     const [t2, n2] = (_a = e2.name.split(" ")) != null ? _a : [];
     t2 && n2 && (r.entity = t2, r.action = n2);
@@ -131,6 +131,8 @@ function le(e2 = "entity action", t = {}) {
 var INIT_DATE_MS = 17e11;
 var INIT_DATE = new Date(INIT_DATE_MS);
 var ga4Init = {
+  title: "GA4 init",
+  description: "The destination bootstraps gtag and configures a GA4 property via its measurementId.",
   in: {
     settings: {
       ga4: { measurementId: "G-XXXXXX-1" }
@@ -142,6 +144,8 @@ var ga4Init = {
   ]
 };
 var adsInit = {
+  title: "Google Ads init",
+  description: "The destination bootstraps gtag and configures a Google Ads account via its conversionId.",
   in: {
     settings: {
       ads: { conversionId: "AW-123456789", currency: "EUR" }
@@ -153,6 +157,8 @@ var adsInit = {
   ]
 };
 var gtmInit = {
+  title: "GTM init",
+  description: "The destination initializes the dataLayer and pushes the gtm.js start event for a GTM container.",
   in: {
     settings: {
       gtm: { containerId: "GTM-XXXXXXX" }
@@ -169,6 +175,8 @@ var gtmInit = {
   ]
 };
 var purchase = {
+  title: "Purchase",
+  description: "An order complete event is mapped to the GA4 purchase event with transaction details and nested product items.",
   in: le("order complete", { timestamp: 1700000100 }),
   mapping: {
     name: "purchase",
@@ -224,6 +232,8 @@ var purchase = {
   ]
 };
 var addToCart = {
+  title: "Add to cart",
+  description: "A product add event is mapped to the GA4 add_to_cart event with item details and value.",
   in: le("product add", { timestamp: 1700000101 }),
   mapping: {
     name: "add_to_cart",
@@ -268,11 +278,15 @@ var addToCart = {
   ]
 };
 var pageView = {
+  title: "Page view",
+  description: "A page view event is forwarded as a GA4 page_view event with no additional mapping.",
   in: le("page view", { timestamp: 1700000102 }),
   mapping: void 0,
   out: [["gtag", "event", "page_view", { send_to: "G-XXXXXX-1" }]]
 };
 var googleAdsConversion = {
+  title: "Ads conversion",
+  description: "An order complete event is sent as a Google Ads conversion with a configured label and transaction value.",
   in: le("order complete", { timestamp: 1700000103 }),
   mapping: {
     name: "PURCHASE_CONV",
@@ -299,6 +313,8 @@ var googleAdsConversion = {
   ]
 };
 var gtmDataLayerPush = {
+  title: "GTM dataLayer push",
+  description: "A page view event is pushed to window.dataLayer for GTM with the mapped event name and parameters.",
   in: le("page view", { timestamp: 1700000104 }),
   mapping: {
     name: "page_view",
@@ -324,6 +340,8 @@ var gtmDataLayerPush = {
   ]
 };
 var consentModeV2 = {
+  title: "Consent Mode v2",
+  description: "A walker consent command with marketing and functional granted updates gtag Consent Mode v2 parameters.",
   command: "consent",
   in: { marketing: true, functional: true },
   out: [
@@ -353,9 +371,11 @@ var consentModeV2 = {
   ]
 };
 var ga4WithIncludeAll = {
+  title: "GA4 include all",
+  description: "Include flattens every event section into prefixed GA4 params, exposing data, context, user, source, and event fields.",
   in: le("page view", { timestamp: 1700000106 }),
   mapping: {
-    include: ["all"]
+    include: ["data", "context", "globals", "user", "source", "event"]
   },
   out: [
     [
@@ -392,9 +412,6 @@ var ga4WithIncludeAll = {
         event_name: "page view",
         event_timestamp: 1700000106,
         event_timing: 3.14,
-        // version_* params from event.version
-        version_source: "3.3.1",
-        version_tagging: 1,
         // send_to is always set for GA4
         send_to: "G-XXXXXX-1"
       }
@@ -402,6 +419,8 @@ var ga4WithIncludeAll = {
   ]
 };
 var multipleToolsSimultaneous = {
+  title: "Multi-tool push",
+  description: "A single order event fans out to GA4, Google Ads, and GTM from one mapping rule with per-tool settings.",
   in: le("order complete", { timestamp: 1700000107 }),
   mapping: {
     name: "purchase",

package/dist/examples/index.mjs

@@ -94,7 +94,7 @@ function Q(e2) {
 }
 function fe(e2 = {}) {
   var _a;
-  const t = e2.timestamp || (/* @__PURE__ */ new Date()).setHours(0, 13, 37, 0), n = e2.group || "gr0up", o = e2.count || 1, r = L({ name: "entity action", data: { string: "foo", number: 1, boolean: true, array: [0, "text", false], not: void 0 }, context: { dev: ["test", 1] }, globals: { lang: "elb" }, custom: { completely: "random" }, user: { id: "us3r", device: "c00k13", session: "s3ss10n" }, nested: [{ entity: "child", data: { is: "subordinated" }, nested: [], context: { element: ["child", 0] } }], consent: { functional: true }, id: `${t}-${n}-${o}`, trigger: "test", entity: "entity", action: "action", timestamp: t, timing: 3.14, group: n, count: o, version: { source: "3.4.0", tagging: 1 }, source: { type: "web", id: "https://localhost:80", previous_id: "http://remotehost:9001" } }, e2, { merge: false });
+  const t = e2.timestamp || (/* @__PURE__ */ new Date()).setHours(0, 13, 37, 0), n = e2.group || "gr0up", o = e2.count || 1, r = L({ name: "entity action", data: { string: "foo", number: 1, boolean: true, array: [0, "text", false], not: void 0 }, context: { dev: ["test", 1] }, globals: { lang: "elb" }, custom: { completely: "random" }, user: { id: "us3r", device: "c00k13", session: "s3ss10n" }, nested: [{ entity: "child", data: { is: "subordinated" }, nested: [], context: { element: ["child", 0] } }], consent: { functional: true }, id: `${t}-${n}-${o}`, trigger: "test", entity: "entity", action: "action", timestamp: t, timing: 3.14, group: n, count: o, version: { source: "3.4.1", tagging: 1 }, source: { type: "web", id: "https://localhost:80", previous_id: "http://remotehost:9001" } }, e2, { merge: false });
   if (e2.name) {
     const [t2, n2] = (_a = e2.name.split(" ")) != null ? _a : [];
     t2 && n2 && (r.entity = t2, r.action = n2);
@@ -110,6 +110,8 @@ function le(e2 = "entity action", t = {}) {
 var INIT_DATE_MS = 17e11;
 var INIT_DATE = new Date(INIT_DATE_MS);
 var ga4Init = {
+  title: "GA4 init",
+  description: "The destination bootstraps gtag and configures a GA4 property via its measurementId.",
   in: {
     settings: {
       ga4: { measurementId: "G-XXXXXX-1" }
@@ -121,6 +123,8 @@ var ga4Init = {
   ]
 };
 var adsInit = {
+  title: "Google Ads init",
+  description: "The destination bootstraps gtag and configures a Google Ads account via its conversionId.",
   in: {
     settings: {
       ads: { conversionId: "AW-123456789", currency: "EUR" }
@@ -132,6 +136,8 @@ var adsInit = {
   ]
 };
 var gtmInit = {
+  title: "GTM init",
+  description: "The destination initializes the dataLayer and pushes the gtm.js start event for a GTM container.",
   in: {
     settings: {
       gtm: { containerId: "GTM-XXXXXXX" }
@@ -148,6 +154,8 @@ var gtmInit = {
   ]
 };
 var purchase = {
+  title: "Purchase",
+  description: "An order complete event is mapped to the GA4 purchase event with transaction details and nested product items.",
   in: le("order complete", { timestamp: 1700000100 }),
   mapping: {
     name: "purchase",
@@ -203,6 +211,8 @@ var purchase = {
   ]
 };
 var addToCart = {
+  title: "Add to cart",
+  description: "A product add event is mapped to the GA4 add_to_cart event with item details and value.",
   in: le("product add", { timestamp: 1700000101 }),
   mapping: {
     name: "add_to_cart",
@@ -247,11 +257,15 @@ var addToCart = {
   ]
 };
 var pageView = {
+  title: "Page view",
+  description: "A page view event is forwarded as a GA4 page_view event with no additional mapping.",
   in: le("page view", { timestamp: 1700000102 }),
   mapping: void 0,
   out: [["gtag", "event", "page_view", { send_to: "G-XXXXXX-1" }]]
 };
 var googleAdsConversion = {
+  title: "Ads conversion",
+  description: "An order complete event is sent as a Google Ads conversion with a configured label and transaction value.",
   in: le("order complete", { timestamp: 1700000103 }),
   mapping: {
     name: "PURCHASE_CONV",
@@ -278,6 +292,8 @@ var googleAdsConversion = {
   ]
 };
 var gtmDataLayerPush = {
+  title: "GTM dataLayer push",
+  description: "A page view event is pushed to window.dataLayer for GTM with the mapped event name and parameters.",
   in: le("page view", { timestamp: 1700000104 }),
   mapping: {
     name: "page_view",
@@ -303,6 +319,8 @@ var gtmDataLayerPush = {
   ]
 };
 var consentModeV2 = {
+  title: "Consent Mode v2",
+  description: "A walker consent command with marketing and functional granted updates gtag Consent Mode v2 parameters.",
   command: "consent",
   in: { marketing: true, functional: true },
   out: [
@@ -332,9 +350,11 @@ var consentModeV2 = {
   ]
 };
 var ga4WithIncludeAll = {
+  title: "GA4 include all",
+  description: "Include flattens every event section into prefixed GA4 params, exposing data, context, user, source, and event fields.",
   in: le("page view", { timestamp: 1700000106 }),
   mapping: {
-    include: ["all"]
+    include: ["data", "context", "globals", "user", "source", "event"]
   },
   out: [
     [
@@ -371,9 +391,6 @@ var ga4WithIncludeAll = {
         event_name: "page view",
         event_timestamp: 1700000106,
         event_timing: 3.14,
-        // version_* params from event.version
-        version_source: "3.3.1",
-        version_tagging: 1,
         // send_to is always set for GA4
         send_to: "G-XXXXXX-1"
       }
@@ -381,6 +398,8 @@ var ga4WithIncludeAll = {
   ]
 };
 var multipleToolsSimultaneous = {
+  title: "Multi-tool push",
+  description: "A single order event fans out to GA4, Google Ads, and GTM from one mapping rule with per-tool settings.",
   in: le("order complete", { timestamp: 1700000107 }),
   mapping: {
     name: "purchase",

package/dist/walkerOS.json

@@ -1,7 +1,7 @@
 {
   "$meta": {
     "package": "@walkeros/web-destination-gtag",
-    "version": "3.4.0",
+    "version": "3.4.1",
     "type": "destination",
     "platform": [
       "web"
@@ -296,6 +296,8 @@
     },
     "step": {
       "addToCart": {
+        "title": "Add to cart",
+        "description": "A product add event is mapped to the GA4 add_to_cart event with item details and value.",
         "in": {
           "name": "product add",
           "data": {
@@ -335,7 +337,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -400,6 +402,8 @@
         ]
       },
       "adsInit": {
+        "title": "Google Ads init",
+        "description": "The destination bootstraps gtag and configures a Google Ads account via its conversionId.",
         "in": {
           "settings": {
             "ads": {
@@ -422,6 +426,8 @@
         ]
       },
       "consentModeV2": {
+        "title": "Consent Mode v2",
+        "description": "A walker consent command with marketing and functional granted updates gtag Consent Mode v2 parameters.",
         "command": "consent",
         "in": {
           "marketing": true,
@@ -453,6 +459,8 @@
         ]
       },
       "ga4Init": {
+        "title": "GA4 init",
+        "description": "The destination bootstraps gtag and configures a GA4 property via its measurementId.",
         "in": {
           "settings": {
             "ga4": {
@@ -475,6 +483,8 @@
         ]
       },
       "ga4WithIncludeAll": {
+        "title": "GA4 include all",
+        "description": "Include flattens every event section into prefixed GA4 params, exposing data, context, user, source, and event fields.",
         "in": {
           "name": "page view",
           "data": {
@@ -529,7 +539,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -540,7 +550,12 @@
         },
         "mapping": {
           "include": [
-            "all"
+            "data",
+            "context",
+            "globals",
+            "user",
+            "source",
+            "event"
           ]
         },
         "out": [
@@ -572,14 +587,14 @@
               "event_name": "page view",
               "event_timestamp": 1700000106,
               "event_timing": 3.14,
-              "version_source": "3.3.1",
-              "version_tagging": 1,
               "send_to": "G-XXXXXX-1"
             }
           ]
         ]
       },
       "googleAdsConversion": {
+        "title": "Ads conversion",
+        "description": "An order complete event is sent as a Google Ads conversion with a configured label and transaction value.",
         "in": {
           "name": "order complete",
           "data": {
@@ -666,7 +681,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -702,6 +717,8 @@
         ]
       },
       "gtmDataLayerPush": {
+        "title": "GTM dataLayer push",
+        "description": "A page view event is pushed to window.dataLayer for GTM with the mapped event name and parameters.",
         "in": {
           "name": "page view",
           "data": {
@@ -756,7 +773,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -789,6 +806,8 @@
         ]
       },
       "gtmInit": {
+        "title": "GTM init",
+        "description": "The destination initializes the dataLayer and pushes the gtm.js start event for a GTM container.",
         "in": {
           "settings": {
             "gtm": {
@@ -807,6 +826,8 @@
         ]
       },
       "multipleToolsSimultaneous": {
+        "title": "Multi-tool push",
+        "description": "A single order event fans out to GA4, Google Ads, and GTM from one mapping rule with per-tool settings.",
         "in": {
           "name": "order complete",
           "data": {
@@ -893,7 +914,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -971,6 +992,8 @@
         ]
       },
       "pageView": {
+        "title": "Page view",
+        "description": "A page view event is forwarded as a GA4 page_view event with no additional mapping.",
         "in": {
           "name": "page view",
           "data": {
@@ -1025,7 +1048,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -1046,6 +1069,8 @@
         ]
       },
       "purchase": {
+        "title": "Purchase",
+        "description": "An order complete event is mapped to the GA4 purchase event with transaction details and nested product items.",
         "in": {
           "name": "order complete",
           "data": {
@@ -1132,7 +1157,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walkeros/web-destination-gtag",
   "description": "Unified Google destination for walkerOS (GA4, Ads, GTM)",
-  "version": "3.4.0",
+  "version": "3.4.1",
   "license": "MIT",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -37,7 +37,7 @@
     "update": "npx npm-check-updates -u && npm update"
   },
   "dependencies": {
-    "@walkeros/web-core": "3.4.0"
+    "@walkeros/web-core": "3.4.1"
   },
   "repository": {
     "url": "git+https://github.com/elbwalker/walkerOS.git",