@walkeros/web-destination-gtag 3.3.1 → 3.4.0

package/dist/examples/index.d.mts

@@ -36,6 +36,21 @@ declare namespace env {
   export { env_init as init, env_push as push, env_simulation as simulation };
 }
 
+/**
+ * GA4 destination bootstrap.
+ * Initializes gtag infrastructure and configures the GA4 measurementId.
+ */
+declare const ga4Init: Flow.StepExample;
+/**
+ * Google Ads destination bootstrap.
+ * Initializes gtag infrastructure and configures the Ads conversionId.
+ */
+declare const adsInit: Flow.StepExample;
+/**
+ * GTM destination bootstrap.
+ * Initializes the dataLayer and pushes the gtm.js start event.
+ */
+declare const gtmInit: Flow.StepExample;
 declare const purchase: Flow.StepExample;
 declare const addToCart: Flow.StepExample;
 declare const pageView: Flow.StepExample;
@@ -71,7 +86,7 @@ declare const ga4WithIncludeAll: Flow.StepExample;
 /**
  * One event pushed to GA4 + Ads + GTM simultaneously.
  * Shows settings for all three tools in a single mapping rule.
- * The out is an object keyed by tool name with each tool's expected output.
+ * The out is a flat array of all observable calls in execution order:
  *
  * - GA4: gtag('event', eventName, { ...params, send_to })
  * - Ads: gtag('event', 'conversion', { send_to, currency, ...data })
@@ -80,15 +95,18 @@ declare const ga4WithIncludeAll: Flow.StepExample;
 declare const multipleToolsSimultaneous: Flow.StepExample;
 
 declare const step_addToCart: typeof addToCart;
+declare const step_adsInit: typeof adsInit;
 declare const step_consentModeV2: typeof consentModeV2;
+declare const step_ga4Init: typeof ga4Init;
 declare const step_ga4WithIncludeAll: typeof ga4WithIncludeAll;
 declare const step_googleAdsConversion: typeof googleAdsConversion;
 declare const step_gtmDataLayerPush: typeof gtmDataLayerPush;
+declare const step_gtmInit: typeof gtmInit;
 declare const step_multipleToolsSimultaneous: typeof multipleToolsSimultaneous;
 declare const step_pageView: typeof pageView;
 declare const step_purchase: typeof purchase;
 declare namespace step {
-  export { step_addToCart as addToCart, step_consentModeV2 as consentModeV2, step_ga4WithIncludeAll as ga4WithIncludeAll, step_googleAdsConversion as googleAdsConversion, step_gtmDataLayerPush as gtmDataLayerPush, step_multipleToolsSimultaneous as multipleToolsSimultaneous, step_pageView as pageView, step_purchase as purchase };
+  export { step_addToCart as addToCart, step_adsInit as adsInit, step_consentModeV2 as consentModeV2, step_ga4Init as ga4Init, step_ga4WithIncludeAll as ga4WithIncludeAll, step_googleAdsConversion as googleAdsConversion, step_gtmDataLayerPush as gtmDataLayerPush, step_gtmInit as gtmInit, step_multipleToolsSimultaneous as multipleToolsSimultaneous, step_pageView as pageView, step_purchase as purchase };
 }
 
 export { env, step };

package/dist/examples/index.d.ts

@@ -36,6 +36,21 @@ declare namespace env {
   export { env_init as init, env_push as push, env_simulation as simulation };
 }
 
+/**
+ * GA4 destination bootstrap.
+ * Initializes gtag infrastructure and configures the GA4 measurementId.
+ */
+declare const ga4Init: Flow.StepExample;
+/**
+ * Google Ads destination bootstrap.
+ * Initializes gtag infrastructure and configures the Ads conversionId.
+ */
+declare const adsInit: Flow.StepExample;
+/**
+ * GTM destination bootstrap.
+ * Initializes the dataLayer and pushes the gtm.js start event.
+ */
+declare const gtmInit: Flow.StepExample;
 declare const purchase: Flow.StepExample;
 declare const addToCart: Flow.StepExample;
 declare const pageView: Flow.StepExample;
@@ -71,7 +86,7 @@ declare const ga4WithIncludeAll: Flow.StepExample;
 /**
  * One event pushed to GA4 + Ads + GTM simultaneously.
  * Shows settings for all three tools in a single mapping rule.
- * The out is an object keyed by tool name with each tool's expected output.
+ * The out is a flat array of all observable calls in execution order:
  *
  * - GA4: gtag('event', eventName, { ...params, send_to })
  * - Ads: gtag('event', 'conversion', { send_to, currency, ...data })
@@ -80,15 +95,18 @@ declare const ga4WithIncludeAll: Flow.StepExample;
 declare const multipleToolsSimultaneous: Flow.StepExample;
 
 declare const step_addToCart: typeof addToCart;
+declare const step_adsInit: typeof adsInit;
 declare const step_consentModeV2: typeof consentModeV2;
+declare const step_ga4Init: typeof ga4Init;
 declare const step_ga4WithIncludeAll: typeof ga4WithIncludeAll;
 declare const step_googleAdsConversion: typeof googleAdsConversion;
 declare const step_gtmDataLayerPush: typeof gtmDataLayerPush;
+declare const step_gtmInit: typeof gtmInit;
 declare const step_multipleToolsSimultaneous: typeof multipleToolsSimultaneous;
 declare const step_pageView: typeof pageView;
 declare const step_purchase: typeof purchase;
 declare namespace step {
-  export { step_addToCart as addToCart, step_consentModeV2 as consentModeV2, step_ga4WithIncludeAll as ga4WithIncludeAll, step_googleAdsConversion as googleAdsConversion, step_gtmDataLayerPush as gtmDataLayerPush, step_multipleToolsSimultaneous as multipleToolsSimultaneous, step_pageView as pageView, step_purchase as purchase };
+  export { step_addToCart as addToCart, step_adsInit as adsInit, step_consentModeV2 as consentModeV2, step_ga4Init as ga4Init, step_ga4WithIncludeAll as ga4WithIncludeAll, step_googleAdsConversion as googleAdsConversion, step_gtmDataLayerPush as gtmDataLayerPush, step_gtmInit as gtmInit, step_multipleToolsSimultaneous as multipleToolsSimultaneous, step_pageView as pageView, step_purchase as purchase };
 }
 
 export { env, step };

package/dist/examples/index.js

@@ -79,10 +79,13 @@ var simulation = [
 var step_exports = {};
 __export(step_exports, {
   addToCart: () => addToCart,
+  adsInit: () => adsInit,
   consentModeV2: () => consentModeV2,
+  ga4Init: () => ga4Init,
   ga4WithIncludeAll: () => ga4WithIncludeAll,
   googleAdsConversion: () => googleAdsConversion,
   gtmDataLayerPush: () => gtmDataLayerPush,
+  gtmInit: () => gtmInit,
   multipleToolsSimultaneous: () => multipleToolsSimultaneous,
   pageView: () => pageView,
   purchase: () => purchase
@@ -95,9 +98,9 @@ var c = {};
   for (var o in n) e(t, o, { get: n[o], enumerable: true });
 })(c, { Level: () => u });
 var u = ((e2) => (e2[e2.ERROR = 0] = "ERROR", e2[e2.WARN = 1] = "WARN", e2[e2.INFO = 2] = "INFO", e2[e2.DEBUG = 3] = "DEBUG", e2))(u || {});
-var F = { merge: true, shallow: true, extend: true };
+var W = { merge: true, shallow: true, extend: true };
 function L(e2, t = {}, n = {}) {
-  n = { ...F, ...n };
+  n = { ...W, ...n };
   const o = Object.entries(t).reduce((t2, [o2, r]) => {
     const i = e2[o2];
     return n.merge && Array.isArray(i) && Array.isArray(r) ? t2[o2] = r.reduce((e3, t3) => e3.includes(t3) ? e3 : [...e3, t3], [...i]) : (n.extend || o2 in e2) && (t2[o2] = r), t2;
@@ -112,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.3.1", 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.0", 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);
@@ -125,6 +128,46 @@ function le(e2 = "entity action", t = {}) {
 }
 
 // src/examples/step.ts
+var INIT_DATE_MS = 17e11;
+var INIT_DATE = new Date(INIT_DATE_MS);
+var ga4Init = {
+  in: {
+    settings: {
+      ga4: { measurementId: "G-XXXXXX-1" }
+    }
+  },
+  out: [
+    ["gtag", "js", INIT_DATE],
+    ["gtag", "config", "G-XXXXXX-1", {}]
+  ]
+};
+var adsInit = {
+  in: {
+    settings: {
+      ads: { conversionId: "AW-123456789", currency: "EUR" }
+    }
+  },
+  out: [
+    ["gtag", "js", INIT_DATE],
+    ["gtag", "config", "AW-123456789"]
+  ]
+};
+var gtmInit = {
+  in: {
+    settings: {
+      gtm: { containerId: "GTM-XXXXXXX" }
+    }
+  },
+  out: [
+    [
+      "dataLayer.push",
+      {
+        "gtm.start": INIT_DATE_MS,
+        event: "gtm.js"
+      }
+    ]
+  ]
+};
 var purchase = {
   in: le("order complete", { timestamp: 1700000100 }),
   mapping: {
@@ -154,20 +197,30 @@ var purchase = {
     }
   },
   out: [
-    "event",
-    "purchase",
-    {
-      transaction_id: "0rd3r1d",
-      value: 555,
-      tax: 73.76,
-      shipping: 5.22,
-      currency: "EUR",
-      items: [
-        { item_id: "ers", item_name: "Everyday Ruck Snack", quantity: 1 },
-        { item_id: "cc", item_name: "Cool Cap", quantity: 1 }
-      ],
-      send_to: "G-XXXXXX-1"
-    }
+    [
+      "gtag",
+      "event",
+      "purchase",
+      {
+        transaction_id: "0rd3r1d",
+        value: 555,
+        tax: 73.76,
+        shipping: 5.22,
+        currency: "EUR",
+        items: [
+          { item_id: "ers", item_name: "Everyday Ruck Snack", quantity: 1 },
+          { item_id: "cc", item_name: "Cool Cap", quantity: 1 }
+        ],
+        // include: ['data', 'context'] flattens both sections as prefixed params.
+        data_id: "0rd3r1d",
+        data_currency: "EUR",
+        data_shipping: 5.22,
+        data_taxes: 73.76,
+        data_total: 555,
+        context_shopping: "complete",
+        send_to: "G-XXXXXX-1"
+      }
+    ]
   ]
 };
 var addToCart = {
@@ -195,20 +248,29 @@ var addToCart = {
     }
   },
   out: [
-    "event",
-    "add_to_cart",
-    {
-      currency: "EUR",
-      value: 420,
-      items: [{ item_id: "ers", item_variant: "black", quantity: 1 }],
-      send_to: "G-XXXXXX-1"
-    }
+    [
+      "gtag",
+      "event",
+      "add_to_cart",
+      {
+        currency: "EUR",
+        value: 420,
+        items: [{ item_id: "ers", item_variant: "black", quantity: 1 }],
+        // include: ['data'] flattens data as prefixed params.
+        data_id: "ers",
+        data_name: "Everyday Ruck Snack",
+        data_color: "black",
+        data_size: "l",
+        data_price: 420,
+        send_to: "G-XXXXXX-1"
+      }
+    ]
   ]
 };
 var pageView = {
   in: le("page view", { timestamp: 1700000102 }),
   mapping: void 0,
-  out: ["event", "page_view", { send_to: "G-XXXXXX-1" }]
+  out: [["gtag", "event", "page_view", { send_to: "G-XXXXXX-1" }]]
 };
 var googleAdsConversion = {
   in: le("order complete", { timestamp: 1700000103 }),
@@ -224,13 +286,16 @@ var googleAdsConversion = {
     }
   },
   out: [
-    "event",
-    "conversion",
-    {
-      send_to: "AW-123456789/PURCHASE_CONV",
-      currency: "EUR",
-      value: 555
-    }
+    [
+      "gtag",
+      "event",
+      "conversion",
+      {
+        send_to: "AW-123456789/PURCHASE_CONV",
+        currency: "EUR",
+        value: 555
+      }
+    ]
   ]
 };
 var gtmDataLayerPush = {
@@ -247,24 +312,44 @@ var gtmDataLayerPush = {
       }
     }
   },
-  out: {
-    event: "page_view",
-    page_title: "walkerOS documentation",
-    page_location: "www.example.com"
-  }
+  out: [
+    [
+      "dataLayer.push",
+      {
+        event: "page_view",
+        page_title: "walkerOS documentation",
+        page_location: "www.example.com"
+      }
+    ]
+  ]
 };
 var consentModeV2 = {
   command: "consent",
   in: { marketing: true, functional: true },
   out: [
-    "consent",
-    "update",
-    {
-      ad_storage: "granted",
-      ad_user_data: "granted",
-      ad_personalization: "granted",
-      analytics_storage: "granted"
-    }
+    // First consent call sets default to denied for all mapped parameters.
+    [
+      "gtag",
+      "consent",
+      "default",
+      {
+        ad_storage: "denied",
+        ad_user_data: "denied",
+        ad_personalization: "denied",
+        analytics_storage: "denied"
+      }
+    ],
+    [
+      "gtag",
+      "consent",
+      "update",
+      {
+        ad_storage: "granted",
+        ad_user_data: "granted",
+        ad_personalization: "granted",
+        analytics_storage: "granted"
+      }
+    ]
   ]
 };
 var ga4WithIncludeAll = {
@@ -273,37 +358,47 @@ var ga4WithIncludeAll = {
     include: ["all"]
   },
   out: [
-    "event",
-    "page_view",
-    {
-      // data_* params from event.data
-      data_domain: "www.example.com",
-      data_title: "walkerOS documentation",
-      data_referrer: "https://www.walkeros.io/",
-      data_search: "?foo=bar",
-      data_hash: "#hash",
-      data_id: "/docs/",
-      // context_* params from event.context
-      context_dev: "test",
-      // globals_* params from event.globals
-      globals_pagegroup: "docs",
-      // user_* params from event.user
-      user_id: "us3r",
-      user_device: "c00k13",
-      user_session: "s3ss10n",
-      // source_* params from event.source
-      source_type: "web",
-      source_id: "https://localhost:80",
-      source_previous_id: "http://remotehost:9001",
-      // event_* params from event properties
-      event_entity: "page",
-      event_action: "view",
-      event_trigger: "load",
-      event_group: "gr0up",
-      event_count: 1,
-      // send_to is always set for GA4
-      send_to: "G-XXXXXX-1"
-    }
+    [
+      "gtag",
+      "event",
+      "page_view",
+      {
+        // data_* params from event.data
+        data_domain: "www.example.com",
+        data_title: "walkerOS documentation",
+        data_referrer: "https://www.walkeros.io/",
+        data_search: "?foo=bar",
+        data_hash: "#hash",
+        data_id: "/docs/",
+        // context_* params from event.context
+        context_dev: "test",
+        // globals_* params from event.globals
+        globals_pagegroup: "docs",
+        // user_* params from event.user
+        user_id: "us3r",
+        user_device: "c00k13",
+        user_session: "s3ss10n",
+        // source_* params from event.source
+        source_type: "web",
+        source_id: "https://localhost:80",
+        source_previous_id: "http://remotehost:9001",
+        // event_* params from event properties
+        event_entity: "page",
+        event_action: "view",
+        event_trigger: "load",
+        event_group: "gr0up",
+        event_count: 1,
+        event_id: "1700000106-gr0up-1",
+        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"
+      }
+    ]
   ]
 };
 var multipleToolsSimultaneous = {
@@ -323,31 +418,52 @@ var multipleToolsSimultaneous = {
       }
     }
   },
-  out: {
-    ga4: [
+  out: [
+    [
+      "gtag",
       "event",
       "purchase",
       {
         value: 555,
         currency: "EUR",
+        // include: ['data'] flattens data as prefixed params.
+        data_id: "0rd3r1d",
+        data_currency: "EUR",
+        data_shipping: 5.22,
+        data_taxes: 73.76,
+        data_total: 555,
         send_to: "G-XXXXXX-1"
       }
     ],
-    ads: [
+    [
+      "gtag",
       "event",
       "conversion",
       {
         send_to: "AW-123456789/PURCHASE_CONV",
         currency: "EUR",
-        value: 555
+        value: 555,
+        data_id: "0rd3r1d",
+        data_currency: "EUR",
+        data_shipping: 5.22,
+        data_taxes: 73.76,
+        data_total: 555
       }
     ],
-    gtm: {
-      event: "purchase",
-      value: 555,
-      currency: "EUR"
-    }
-  }
+    [
+      "dataLayer.push",
+      {
+        event: "purchase",
+        value: 555,
+        currency: "EUR",
+        data_id: "0rd3r1d",
+        data_currency: "EUR",
+        data_shipping: 5.22,
+        data_taxes: 73.76,
+        data_total: 555
+      }
+    ]
+  ]
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {