@walkeros/web-destination-matomo 4.8.1 → 4.8.2

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @walkeros/web-destination-matomo
 
+## 4.8.2
+
+### Patch Changes
+
+- 2374f54: An event that no rule maps fails with `missing-input` instead of a
+  warning. An invalid `goalId` sends the hit without the goal and logs one ERROR
+  per cause. A consent revocation sends `forgetConsentGiven`, stopping link
+  tracking too, and silent rules send only their goal.
+- 2374f54: A destination with `config.consent` now tells the vendor about
+  consent changes: Meta calls `fbq('consent', 'revoke' | 'grant')`, Matomo
+  `forgetConsentGiven` and `setConsentGiven`, Clarity sends ConsentV2, FullStory
+  stops and starts capture, and Piwik PRO turns off the link tracking it
+  enabled.
+- 2374f54: A failed vendor call, a missing required setting (`config`) and an
+  event that cannot be sent (`missing-input`) are reported as failed pushes,
+  with the dead-letter queue and one ERROR line, instead of counting as
+  delivered. Rules with `silent: true` send no event. Settings schemas reject
+  unknown keys.
+- b1d65e2: Web destinations that load a vendor script inject it through the
+  document of their `env`, so simulation and server-side rendering work without
+  a browser page. A page still gets the script in its own document by default,
+  and a missing document fails the push with `vendor-not-ready`.
+- 2374f54: Vendor scripts load through walkerOS: a blocked or slow script fails
+  later events visibly (`vendor-not-loaded`, `vendor-timeout`) instead of losing
+  them. Pushes made while the script loads wait for it, and each script is
+  injected once per page.
+- Updated dependencies [2374f54]
+- Updated dependencies [7e5fc27]
+- Updated dependencies [2374f54]
+- Updated dependencies [964590a]
+- Updated dependencies [4100ede]
+- Updated dependencies [2374f54]
+- Updated dependencies [2374f54]
+- Updated dependencies [15eb7b2]
+- Updated dependencies [33a2779]
+- Updated dependencies [33a2779]
+- Updated dependencies [b1d65e2]
+- Updated dependencies [964590a]
+- Updated dependencies [2374f54]
+  - @walkeros/core@4.8.2
+  - @walkeros/web-core@4.8.2
+
 ## 4.8.1
 
 ### Patch Changes

package/dist/dev.d.mts

@@ -10,7 +10,7 @@ declare const SettingsSchema: z.ZodObject<{
     enableLinkTracking: z.ZodDefault<z.ZodBoolean>;
     enableHeartBeatTimer: z.ZodOptional<z.ZodNumber>;
     customDimensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 type Settings$1 = z.infer<typeof SettingsSchema>;
 
 declare const MappingSchema: z.ZodObject<{
@@ -63,23 +63,12 @@ interface Env extends DestinationWeb.Env {
             href?: string;
         };
     };
-    document: {
-        createElement: (tagName: string) => {
-            type: string;
-            src: string;
-            async?: boolean;
-            defer?: boolean;
-        };
-        head: {
-            appendChild: (node: unknown) => void;
-        };
-    };
 }
 
 /**
  * Example environment configurations for Matomo destination.
- * Mocks the _paq command queue and DOM elements for testing
- * without requiring real browser or network.
+ * Mocks the _paq command queue for testing without requiring real browser
+ * or network.
  */
 declare const init$1: Env | undefined;
 declare const push: Env;
@@ -159,8 +148,21 @@ declare const goalTracking: StepExample;
  * example stays out of them.
  */
 declare const customDimensions: StepExample;
+/** A silent rule without a goal sends nothing. */
+declare const silentRule: StepExample;
+/**
+ * An event no rule maps: Matomo has no command for it, so the push fails
+ * instead of counting as delivered.
+ */
+declare const unmappedEvent: StepExample;
+/**
+ * A revocation of the consent the destination requires stops Matomo:
+ * config.consent { marketing: true }, granted first, then revoked.
+ */
+declare const consentRevoke: StepExample;
 
 type step_StepExample = StepExample;
+declare const step_consentRevoke: typeof consentRevoke;
 declare const step_customDimensions: typeof customDimensions;
 declare const step_customEvent: typeof customEvent;
 declare const step_ecommerceCartUpdate: typeof ecommerceCartUpdate;
@@ -170,9 +172,11 @@ declare const step_init: typeof init;
 declare const step_pageView: typeof pageView;
 declare const step_pageViewWithGoal: typeof pageViewWithGoal;
 declare const step_productDetailView: typeof productDetailView;
+declare const step_silentRule: typeof silentRule;
 declare const step_siteSearch: typeof siteSearch;
+declare const step_unmappedEvent: typeof unmappedEvent;
 declare namespace step {
-  export { type step_StepExample as StepExample, step_customDimensions as customDimensions, step_customEvent as customEvent, step_ecommerceCartUpdate as ecommerceCartUpdate, step_ecommerceOrder as ecommerceOrder, step_goalTracking as goalTracking, step_init as init, step_pageView as pageView, step_pageViewWithGoal as pageViewWithGoal, step_productDetailView as productDetailView, step_siteSearch as siteSearch };
+  export { type step_StepExample as StepExample, step_consentRevoke as consentRevoke, step_customDimensions as customDimensions, step_customEvent as customEvent, step_ecommerceCartUpdate as ecommerceCartUpdate, step_ecommerceOrder as ecommerceOrder, step_goalTracking as goalTracking, step_init as init, step_pageView as pageView, step_pageViewWithGoal as pageViewWithGoal, step_productDetailView as productDetailView, step_silentRule as silentRule, step_siteSearch as siteSearch, step_unmappedEvent as unmappedEvent };
 }
 
 declare const index_env: typeof env;

package/dist/dev.d.ts

@@ -10,7 +10,7 @@ declare const SettingsSchema: z.ZodObject<{
     enableLinkTracking: z.ZodDefault<z.ZodBoolean>;
     enableHeartBeatTimer: z.ZodOptional<z.ZodNumber>;
     customDimensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 type Settings$1 = z.infer<typeof SettingsSchema>;
 
 declare const MappingSchema: z.ZodObject<{
@@ -63,23 +63,12 @@ interface Env extends DestinationWeb.Env {
             href?: string;
         };
     };
-    document: {
-        createElement: (tagName: string) => {
-            type: string;
-            src: string;
-            async?: boolean;
-            defer?: boolean;
-        };
-        head: {
-            appendChild: (node: unknown) => void;
-        };
-    };
 }
 
 /**
  * Example environment configurations for Matomo destination.
- * Mocks the _paq command queue and DOM elements for testing
- * without requiring real browser or network.
+ * Mocks the _paq command queue for testing without requiring real browser
+ * or network.
  */
 declare const init$1: Env | undefined;
 declare const push: Env;
@@ -159,8 +148,21 @@ declare const goalTracking: StepExample;
  * example stays out of them.
  */
 declare const customDimensions: StepExample;
+/** A silent rule without a goal sends nothing. */
+declare const silentRule: StepExample;
+/**
+ * An event no rule maps: Matomo has no command for it, so the push fails
+ * instead of counting as delivered.
+ */
+declare const unmappedEvent: StepExample;
+/**
+ * A revocation of the consent the destination requires stops Matomo:
+ * config.consent { marketing: true }, granted first, then revoked.
+ */
+declare const consentRevoke: StepExample;
 
 type step_StepExample = StepExample;
+declare const step_consentRevoke: typeof consentRevoke;
 declare const step_customDimensions: typeof customDimensions;
 declare const step_customEvent: typeof customEvent;
 declare const step_ecommerceCartUpdate: typeof ecommerceCartUpdate;
@@ -170,9 +172,11 @@ declare const step_init: typeof init;
 declare const step_pageView: typeof pageView;
 declare const step_pageViewWithGoal: typeof pageViewWithGoal;
 declare const step_productDetailView: typeof productDetailView;
+declare const step_silentRule: typeof silentRule;
 declare const step_siteSearch: typeof siteSearch;
+declare const step_unmappedEvent: typeof unmappedEvent;
 declare namespace step {
-  export { type step_StepExample as StepExample, step_customDimensions as customDimensions, step_customEvent as customEvent, step_ecommerceCartUpdate as ecommerceCartUpdate, step_ecommerceOrder as ecommerceOrder, step_goalTracking as goalTracking, step_init as init, step_pageView as pageView, step_pageViewWithGoal as pageViewWithGoal, step_productDetailView as productDetailView, step_siteSearch as siteSearch };
+  export { type step_StepExample as StepExample, step_consentRevoke as consentRevoke, step_customDimensions as customDimensions, step_customEvent as customEvent, step_ecommerceCartUpdate as ecommerceCartUpdate, step_ecommerceOrder as ecommerceOrder, step_goalTracking as goalTracking, step_init as init, step_pageView as pageView, step_pageViewWithGoal as pageViewWithGoal, step_productDetailView as productDetailView, step_silentRule as silentRule, step_siteSearch as siteSearch, step_unmappedEvent as unmappedEvent };
 }
 
 declare const index_env: typeof env;

package/dist/dev.js

@@ -1 +1 @@
-"use strict";var e,t=Object.defineProperty,a=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,o=Object.prototype.hasOwnProperty,n=(e,a)=>{for(var i in a)t(e,i,{get:a[i],enumerable:!0})},r={};n(r,{examples:()=>v,schemas:()=>s}),module.exports=(e=r,((e,n,r,s)=>{if(n&&"object"==typeof n||"function"==typeof n)for(let c of i(n))o.call(e,c)||c===r||t(e,c,{get:()=>n[c],enumerable:!(s=a(n,c))||s.enumerable});return e})(t({},"__esModule",{value:!0}),e));var s={};n(s,{MappingSchema:()=>g,SettingsSchema:()=>m,mapping:()=>k,settings:()=>h});var c=require("@walkeros/core/dev"),p=require("@walkeros/core/dev"),{ValueSchema:d}=p.schemas,l=p.z.record(p.z.string().regex(/^\d+$/,'Dimension keys are bare numeric ids like "1"'),d),m=p.z.object({siteId:p.z.string().min(1).describe("Matomo Site ID (like 1, 2, etc.). Required when loadScript is true").optional(),url:p.z.string().url().describe("Base URL of your Matomo instance, normalized to one trailing slash (like https://analytics.example.com/ or https://yourname.matomo.cloud/). Required when loadScript is true").optional(),disableCookies:p.z.boolean().default(!1).describe("Disable all tracking cookies for cookie-free analytics"),enableLinkTracking:p.z.boolean().default(!0).describe("Enable automatic outlink and download tracking"),enableHeartBeatTimer:p.z.number().int().positive().optional().describe("Enable heart beat timer with interval in seconds for accurate time-on-page"),customDimensions:l.describe('Custom dimensions applied to every hit, keyed by bare dimension id (like { "1": "data.userType" }). Each value is resolved per event. Rule-level customDimensions win per key.').optional()}),u=require("@walkeros/core/dev"),g=u.z.object({goalId:u.z.union([u.z.string().regex(/^[1-9]\d*$/,'Goal IDs are positive integers like "1"'),u.z.number().int().positive()]).optional().describe("Matomo goal ID, a positive integer like 1. Adds a trackGoal conversion alongside this event"),goalValue:u.schemas.ValueSchema.describe('Goal revenue, resolved from the event (like "data.revenue"), passed as the trackGoal revenue').optional(),siteSearch:u.z.boolean().optional().describe("Track as internal site search using trackSiteSearch"),contentImpression:u.z.boolean().optional().describe("Track as content impression using trackContentImpression"),contentInteraction:u.z.boolean().optional().describe("Track as content interaction using trackContentInteraction"),customDimensions:l.describe('Custom dimensions for this rule, keyed by bare dimension id (like { "3": "data.category" }). Set just before the hit and removed after it; wins per key over the destination customDimensions.').optional()}),h=(0,c.zodToSchema)(m),k=(0,c.zodToSchema)(g),v={};n(v,{env:()=>y,step:()=>q});var y={};n(y,{init:()=>w,push:()=>b,simulation:()=>f});var w={window:{location:{href:"https://www.example.com/page"}},document:{createElement:()=>({type:"",src:"",async:!1,defer:!1}),head:{appendChild:()=>{}}}},b={window:{_paq:[],location:{href:"https://www.example.com/page"}},document:{createElement:()=>({type:"",src:"",async:!1,defer:!1}),head:{appendChild:()=>{}}}},f=["call:window._paq.push"],q={};n(q,{customDimensions:()=>x,customEvent:()=>D,ecommerceCartUpdate:()=>I,ecommerceOrder:()=>z,goalTracking:()=>V,init:()=>E,pageView:()=>_,pageViewWithGoal:()=>C,productDetailView:()=>T,siteSearch:()=>M});var S=require("@walkeros/core"),E={title:"Initialization",description:"Destination bootstrap loads the Matomo tracker script and configures the tracker URL and site id.",in:{loadScript:!0,settings:{siteId:"1",url:"https://analytics.example.com/"}},out:[["_paq.push",["setTrackerUrl","https://analytics.example.com/matomo.php"]],["_paq.push",["setSiteId","1"]],["_paq.push",["enableLinkTracking"]]]},_={title:"Page view",description:"A page view is tracked in Matomo via trackPageView with the page title from event data.",in:(0,S.getEvent)("page view",{timestamp:1700000400}),mapping:{data:"data.title"},out:[["_paq.push",["trackPageView","walkerOS documentation"]]]},C={title:"Page view with goal",description:"A page view rule with a goal keeps the default trackPageView and adds a trackGoal conversion.",in:(0,S.getEvent)("page view",{timestamp:1700000407}),mapping:{settings:{goalId:"1"}},out:[["_paq.push",["trackPageView","walkerOS documentation"]],["_paq.push",["trackGoal","1",void 0]]]},D={title:"Custom event with goal",description:"A promotion visible event fires Matomo trackEvent and then trackGoal to record a goal conversion.",in:(0,S.getEvent)("promotion visible",{timestamp:1700000401}),mapping:{name:"trackEvent",settings:{goalId:"1"},data:{set:["data.name","data.position"]}},out:[["_paq.push",["trackEvent","Setting up tracking easily","hero"]],["_paq.push",["trackGoal","1",void 0]]]},z={public:!1,title:"Ecommerce order",description:"Test fixture for nested product mapping, not a valid Matomo call: Matomo records an order's products only after an addEcommerceItem call per product.",in:(0,S.getEvent)("order complete",{timestamp:1700000402}),mapping:{name:"trackEcommerceOrder",data:{set:[{loop:["nested",{condition:e=>"object"==typeof e&&null!==e&&"entity"in e&&"product"===e.entity,map:{sku:"data.id",name:"data.name",category:{value:""},price:"data.price",quantity:{value:1}}}]},{map:{orderId:"data.id",grandTotal:"data.total",tax:"data.taxes",shipping:"data.shipping"}}]}},out:[["_paq.push",["trackEcommerceOrder",[{sku:"ers",name:"Everyday Ruck Snack",category:"",price:420,quantity:1},{sku:"cc",name:"Cool Cap",category:"",price:42,quantity:1}],{orderId:"0rd3r1d",grandTotal:555,tax:73.76,shipping:5.22}]]]},I={public:!1,title:"Cart update",description:"Test fixture for nested product mapping, not a valid Matomo call: Matomo takes trackEcommerceCartUpdate(grandTotal) after an addEcommerceItem call per product.",in:(0,S.getEvent)("cart view",{timestamp:1700000403}),mapping:{name:"trackEcommerceCartUpdate",data:{set:[{loop:["nested",{condition:e=>"object"==typeof e&&null!==e&&"entity"in e&&"product"===e.entity,map:{sku:"data.id",name:"data.name",category:{value:""},price:"data.price",quantity:{value:1}}}]},"data.value"]}},out:[["_paq.push",["trackEcommerceCartUpdate",[{sku:"ers",name:"Everyday Ruck Snack",category:"",price:420,quantity:1}],840]]]},T={public:!1,title:"Product detail view",description:"Test fixture for a single-product mapping, not a valid Matomo call: Matomo tracks a product view with setEcommerceView followed by trackPageView.",in:(0,S.getEvent)("product view",{timestamp:1700000404}),mapping:{name:"ecommerceProductDetailView",data:{set:[{set:[{map:{sku:"data.id",name:"data.name",price:"data.price",quantity:{value:1}}}]}]}},out:[["_paq.push",["ecommerceProductDetailView",[{sku:"ers",name:"Everyday Ruck Snack",price:420,quantity:1}]]]]},M={title:"Site search",description:"A search submit fires Matomo trackSiteSearch with the keyword, category, and number of results.",in:(0,S.getEvent)("search submit",{timestamp:1700000405,data:{query:"shoes",category:"products",resultsCount:42}}),mapping:{name:"trackSiteSearch",settings:{siteSearch:!0},data:{set:["data.query","data.category","data.resultsCount"]}},out:[["_paq.push",["trackSiteSearch","shoes","products",42]]]},V={title:"Goal with value",description:"A promotion event fires Matomo trackEvent and then trackGoal with a monetary goal value from event data.",in:(0,S.getEvent)("promotion visible",{timestamp:1700000406,data:{name:"Setting up tracking easily",position:"hero",value:50}}),mapping:{name:"trackEvent",settings:{goalId:"1",goalValue:"data.value"},data:{set:["data.name"]}},out:[["_paq.push",["trackEvent","Setting up tracking easily"]],["_paq.push",["trackGoal","1",50]]]},x={title:"Custom dimensions",description:"Destination and rule custom dimensions are set right before the page view; afterwards the rule-only dimension is deleted and the destination value is set again.",public:!1,in:(0,S.getEvent)("page view",{timestamp:1700000408}),settings:{customDimensions:{1:"globals.pagegroup"}},mapping:{settings:{customDimensions:{2:"data.id"}}},out:[["_paq.push",["setCustomDimension",1,"docs"]],["_paq.push",["setCustomDimension",2,"/docs/"]],["_paq.push",["trackPageView","walkerOS documentation"]],["_paq.push",["deleteCustomDimension",2]],["_paq.push",["setCustomDimension",1,"docs"]]]};//# sourceMappingURL=dev.js.map
+"use strict";var e,t=Object.defineProperty,a=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,o=Object.prototype.hasOwnProperty,n=(e,a)=>{for(var i in a)t(e,i,{get:a[i],enumerable:!0})},r={};n(r,{examples:()=>k,schemas:()=>s}),module.exports=(e=r,((e,n,r,s)=>{if(n&&"object"==typeof n||"function"==typeof n)for(let c of i(n))o.call(e,c)||c===r||t(e,c,{get:()=>n[c],enumerable:!(s=a(n,c))||s.enumerable});return e})(t({},"__esModule",{value:!0}),e));var s={};n(s,{MappingSchema:()=>g,SettingsSchema:()=>m,mapping:()=>v,settings:()=>h});var c=require("@walkeros/core/dev"),p=require("@walkeros/core/dev"),{ValueSchema:d}=p.schemas,l=p.z.record(p.z.string().regex(/^\d+$/,'Dimension keys are bare numeric ids like "1"'),d),m=p.z.object({siteId:p.z.string().min(1).describe("Matomo Site ID (like 1, 2, etc.). Required when loadScript is true").optional(),url:p.z.string().url().describe("Base URL of your Matomo instance, normalized to one trailing slash (like https://analytics.example.com/ or https://yourname.matomo.cloud/). Required when loadScript is true").optional(),disableCookies:p.z.boolean().default(!1).describe("Disable all tracking cookies for cookie-free analytics"),enableLinkTracking:p.z.boolean().default(!0).describe("Enable automatic outlink and download tracking"),enableHeartBeatTimer:p.z.number().int().positive().optional().describe("Enable heart beat timer with interval in seconds for accurate time-on-page"),customDimensions:l.describe('Custom dimensions applied to every hit, keyed by bare dimension id (like { "1": "data.userType" }). Each value is resolved per event. Rule-level customDimensions win per key.').optional()}).strict(),u=require("@walkeros/core/dev"),g=u.z.object({goalId:u.z.union([u.z.string().regex(/^[1-9]\d*$/,'Goal IDs are positive integers like "1"'),u.z.number().int().positive()]).optional().describe("Matomo goal ID, a positive integer like 1. Adds a trackGoal conversion alongside this event"),goalValue:u.schemas.ValueSchema.describe('Goal revenue, resolved from the event (like "data.revenue"), passed as the trackGoal revenue').optional(),siteSearch:u.z.boolean().optional().describe("Track as internal site search using trackSiteSearch"),contentImpression:u.z.boolean().optional().describe("Track as content impression using trackContentImpression"),contentInteraction:u.z.boolean().optional().describe("Track as content interaction using trackContentInteraction"),customDimensions:l.describe('Custom dimensions for this rule, keyed by bare dimension id (like { "3": "data.category" }). Set just before the hit and removed after it; wins per key over the destination customDimensions.').optional()}),h=(0,c.zodToSchema)(m),v=(0,c.zodToSchema)(g),k={};n(k,{env:()=>w,step:()=>q});var w={};n(w,{init:()=>b,push:()=>y,simulation:()=>f});var b={window:{location:{href:"https://www.example.com/page"}}},y={window:{_paq:[],location:{href:"https://www.example.com/page"}}},f=["call:window._paq.push"],q={};n(q,{consentRevoke:()=>O,customDimensions:()=>x,customEvent:()=>D,ecommerceCartUpdate:()=>I,ecommerceOrder:()=>z,goalTracking:()=>V,init:()=>S,pageView:()=>_,pageViewWithGoal:()=>C,productDetailView:()=>M,silentRule:()=>P,siteSearch:()=>T,unmappedEvent:()=>G});var E=require("@walkeros/core"),S={title:"Initialization",description:"Destination bootstrap loads the Matomo tracker script and configures the tracker URL and site id.",in:{loadScript:!0,settings:{siteId:"1",url:"https://analytics.example.com/"}},out:[["_paq.push",["setTrackerUrl","https://analytics.example.com/matomo.php"]],["_paq.push",["setSiteId","1"]],["_paq.push",["enableLinkTracking"]]]},_={title:"Page view",description:"A page view is tracked in Matomo via trackPageView with the page title from event data.",in:(0,E.getEvent)("page view",{timestamp:1700000400}),mapping:{data:"data.title"},out:[["_paq.push",["trackPageView","walkerOS documentation"]]]},C={title:"Page view with goal",description:"A page view rule with a goal keeps the default trackPageView and adds a trackGoal conversion.",in:(0,E.getEvent)("page view",{timestamp:1700000407}),mapping:{settings:{goalId:"1"}},out:[["_paq.push",["trackPageView","walkerOS documentation"]],["_paq.push",["trackGoal","1",void 0]]]},D={title:"Custom event with goal",description:"A promotion visible event fires Matomo trackEvent and then trackGoal to record a goal conversion.",in:(0,E.getEvent)("promotion visible",{timestamp:1700000401}),mapping:{name:"trackEvent",settings:{goalId:"1"},data:{set:["data.name","data.position"]}},out:[["_paq.push",["trackEvent","Setting up tracking easily","hero"]],["_paq.push",["trackGoal","1",void 0]]]},z={public:!1,title:"Ecommerce order",description:"Test fixture for nested product mapping, not a valid Matomo call: Matomo records an order's products only after an addEcommerceItem call per product.",in:(0,E.getEvent)("order complete",{timestamp:1700000402}),mapping:{name:"trackEcommerceOrder",data:{set:[{loop:["nested",{condition:e=>"object"==typeof e&&null!==e&&"entity"in e&&"product"===e.entity,map:{sku:"data.id",name:"data.name",category:{value:""},price:"data.price",quantity:{value:1}}}]},{map:{orderId:"data.id",grandTotal:"data.value",tax:"data.taxes",shipping:"data.shipping"}}]}},out:[["_paq.push",["trackEcommerceOrder",[{sku:"ers",name:"Everyday Ruck Snack",category:"",price:420,quantity:1},{sku:"cc",name:"Cool Cap",category:"",price:42,quantity:1}],{orderId:"0rd3r1d",grandTotal:555,tax:73.76,shipping:5.22}]]]},I={public:!1,title:"Cart update",description:"Test fixture for nested product mapping, not a valid Matomo call: Matomo takes trackEcommerceCartUpdate(grandTotal) after an addEcommerceItem call per product.",in:(0,E.getEvent)("cart view",{timestamp:1700000403}),mapping:{name:"trackEcommerceCartUpdate",data:{set:[{loop:["nested",{condition:e=>"object"==typeof e&&null!==e&&"entity"in e&&"product"===e.entity,map:{sku:"data.id",name:"data.name",category:{value:""},price:"data.price",quantity:{value:1}}}]},"data.value"]}},out:[["_paq.push",["trackEcommerceCartUpdate",[{sku:"ers",name:"Everyday Ruck Snack",category:"",price:420,quantity:1}],840]]]},M={public:!1,title:"Product detail view",description:"Test fixture for a single-product mapping, not a valid Matomo call: Matomo tracks a product view with setEcommerceView followed by trackPageView.",in:(0,E.getEvent)("product view",{timestamp:1700000404}),mapping:{name:"ecommerceProductDetailView",data:{set:[{set:[{map:{sku:"data.id",name:"data.name",price:"data.price",quantity:{value:1}}}]}]}},out:[["_paq.push",["ecommerceProductDetailView",[{sku:"ers",name:"Everyday Ruck Snack",price:420,quantity:1}]]]]},T={title:"Site search",description:"A search submit fires Matomo trackSiteSearch with the keyword, category, and number of results.",in:(0,E.createEvent)({name:"search submit",timestamp:1700000405,data:{query:"shoes",category:"products",resultsCount:42}}),mapping:{name:"trackSiteSearch",settings:{siteSearch:!0},data:{set:["data.query","data.category","data.resultsCount"]}},out:[["_paq.push",["trackSiteSearch","shoes","products",42]]]},V={title:"Goal with value",description:"A promotion event fires Matomo trackEvent and then trackGoal with a monetary goal value from event data.",in:(0,E.getEvent)("promotion visible",{timestamp:1700000406,data:{name:"Setting up tracking easily",position:"hero",value:50}}),mapping:{name:"trackEvent",settings:{goalId:"1",goalValue:"data.value"},data:{set:["data.name"]}},out:[["_paq.push",["trackEvent","Setting up tracking easily"]],["_paq.push",["trackGoal","1",50]]]},x={title:"Custom dimensions",description:"Destination and rule custom dimensions are set right before the page view; afterwards the rule-only dimension is deleted and the destination value is set again.",public:!1,in:(0,E.getEvent)("page view",{timestamp:1700000408}),settings:{customDimensions:{1:"globals.pagegroup"}},mapping:{settings:{customDimensions:{2:"data.id"}}},out:[["_paq.push",["setCustomDimension",1,"docs"]],["_paq.push",["setCustomDimension",2,"/docs/"]],["_paq.push",["trackPageView","walkerOS documentation"]],["_paq.push",["deleteCustomDimension",2]],["_paq.push",["setCustomDimension",1,"docs"]]]},P={public:!1,description:"A rule with silent: true and no goal sends no command, its dimensions included.",in:(0,E.getEvent)("page view",{timestamp:1700000300}),mapping:{silent:!0},out:[]},G={public:!1,description:"An event without a rule name, a tracking flag or a goal, and not a page view, has no Matomo command: the push fails with missing-input.",in:(0,E.getEvent)("product view",{timestamp:1700000301}),out:[],outcome:{status:"failed",code:"missing-input",retryable:!1}},O={public:!1,description:"For a destination with config.consent { marketing: true }, revoking marketing pushes forgetConsentGiven, which stops every tracking request of the page, link tracking included.",command:"consent",in:{marketing:!1},out:[["window._paq.push",["forgetConsentGiven"]]]};//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/dev.ts","../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/examples/index.ts","../src/examples/env.ts","../src/examples/step.ts"],"sourcesContent":["export * as schemas from './schemas';\nexport * as examples from './examples';\n","import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nexport { SettingsSchema, type Settings } from './settings';\nexport { MappingSchema, type Mapping } from './mapping';\n\n// JSON Schema\nexport const settings = zodToSchema(SettingsSchema);\nexport const mapping = zodToSchema(MappingSchema);\n","import { schemas, z } from '@walkeros/core/dev';\n\nconst { ValueSchema } = schemas;\n\nexport const CustomDimensionsSchema = z.record(\n  z.string().regex(/^\\d+$/, 'Dimension keys are bare numeric ids like \"1\"'),\n  ValueSchema,\n);\n\nexport const SettingsSchema = z.object({\n  siteId: z\n    .string()\n    .min(1)\n    .describe(\n      'Matomo Site ID (like 1, 2, etc.). Required when loadScript is true',\n    )\n    .optional(),\n  url: z\n    .string()\n    .url()\n    .describe(\n      'Base URL of your Matomo instance, normalized to one trailing slash (like https://analytics.example.com/ or https://yourname.matomo.cloud/). Required when loadScript is true',\n    )\n    .optional(),\n  disableCookies: z\n    .boolean()\n    .default(false)\n    .describe('Disable all tracking cookies for cookie-free analytics'),\n  enableLinkTracking: z\n    .boolean()\n    .default(true)\n    .describe('Enable automatic outlink and download tracking'),\n  enableHeartBeatTimer: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(\n      'Enable heart beat timer with interval in seconds for accurate time-on-page',\n    ),\n  customDimensions: CustomDimensionsSchema.describe(\n    'Custom dimensions applied to every hit, keyed by bare dimension id (like { \"1\": \"data.userType\" }). Each value is resolved per event. Rule-level customDimensions win per key.',\n  ).optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { schemas, z } from '@walkeros/core/dev';\nimport { CustomDimensionsSchema } from './settings';\n\nexport const MappingSchema = z.object({\n  goalId: z\n    .union([\n      z.string().regex(/^[1-9]\\d*$/, 'Goal IDs are positive integers like \"1\"'),\n      z.number().int().positive(),\n    ])\n    .optional()\n    .describe(\n      'Matomo goal ID, a positive integer like 1. Adds a trackGoal conversion alongside this event',\n    ),\n  goalValue: schemas.ValueSchema.describe(\n    'Goal revenue, resolved from the event (like \"data.revenue\"), passed as the trackGoal revenue',\n  ).optional(),\n  siteSearch: z\n    .boolean()\n    .optional()\n    .describe('Track as internal site search using trackSiteSearch'),\n  contentImpression: z\n    .boolean()\n    .optional()\n    .describe('Track as content impression using trackContentImpression'),\n  contentInteraction: z\n    .boolean()\n    .optional()\n    .describe('Track as content interaction using trackContentInteraction'),\n  customDimensions: CustomDimensionsSchema.describe(\n    'Custom dimensions for this rule, keyed by bare dimension id (like { \"3\": \"data.category\" }). Set just before the hit and removed after it; wins per key over the destination customDimensions.',\n  ).optional(),\n});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * as env from './env';\nexport * as step from './step';\n","import type { Env } from '../types';\n\n/**\n * Example environment configurations for Matomo destination.\n * Mocks the _paq command queue and DOM elements for testing\n * without requiring real browser or network.\n */\n\nexport const init: Env | undefined = {\n  window: {\n    // _paq absent: init() is expected to install the queue.\n    location: { href: 'https://www.example.com/page' },\n  },\n  document: {\n    createElement: () => ({\n      type: '',\n      src: '',\n      async: false,\n      defer: false,\n    }),\n    head: { appendChild: () => {} },\n  },\n};\n\nexport const push: Env = {\n  window: {\n    _paq: [],\n    location: { href: 'https://www.example.com/page' },\n  },\n  document: {\n    createElement: () => ({\n      type: '',\n      src: '',\n      async: false,\n      defer: false,\n    }),\n    head: { appendChild: () => {} },\n  },\n};\n\n/**\n * Simulation tracking paths.\n * Specifies which function calls to track during simulation.\n */\nexport const simulation = [\n  'call:window._paq.push', // Track _paq.push calls\n];\n","import type { Flow } from '@walkeros/core';\nimport type { Settings } from '../types';\nimport { getEvent } from '@walkeros/core';\n\n/**\n * Matomo step example. The test runner registers the destination with the\n * init example's config and merges an example's optional `settings` on top.\n */\nexport type StepExample = Flow.StepExample & {\n  /** Destination settings merged over the init example's settings. */\n  settings?: Settings;\n};\n\n/**\n * Destination bootstrap.\n * Given the canonical settings, init loads the Matomo script and configures\n * the tracker URL, site ID, and link tracking. Reproduce by passing the same\n * settings to `startFlow` as the destination config.\n */\nexport const init: StepExample = {\n  title: 'Initialization',\n  description:\n    'Destination bootstrap loads the Matomo tracker script and configures the tracker URL and site id.',\n  in: {\n    loadScript: true,\n    settings: {\n      siteId: '1',\n      url: 'https://analytics.example.com/',\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      ['setTrackerUrl', 'https://analytics.example.com/matomo.php'],\n    ],\n    ['_paq.push', ['setSiteId', '1']],\n    ['_paq.push', ['enableLinkTracking']],\n  ],\n};\n\n/**\n * Default page view -- no mapping name needed.\n * Destination auto-calls trackPageView with the page title.\n */\nexport const pageView: StepExample = {\n  title: 'Page view',\n  description:\n    'A page view is tracked in Matomo via trackPageView with the page title from event data.',\n  in: getEvent('page view', { timestamp: 1700000400 }),\n  mapping: {\n    data: 'data.title',\n  },\n  out: [['_paq.push', ['trackPageView', 'walkerOS documentation']]],\n};\n\n/**\n * Page view rule with a goal -- the default trackPageView stays and the goal\n * follows it.\n */\nexport const pageViewWithGoal: StepExample = {\n  title: 'Page view with goal',\n  description:\n    'A page view rule with a goal keeps the default trackPageView and adds a trackGoal conversion.',\n  in: getEvent('page view', { timestamp: 1700000407 }),\n  mapping: {\n    settings: {\n      goalId: '1',\n    },\n  },\n  out: [\n    ['_paq.push', ['trackPageView', 'walkerOS documentation']],\n    ['_paq.push', ['trackGoal', '1', undefined]],\n  ],\n};\n\n/**\n * Custom event tracking with goal conversion.\n * Uses trackEvent with mapped name, followed by trackGoal.\n */\nexport const customEvent: StepExample = {\n  title: 'Custom event with goal',\n  description:\n    'A promotion visible event fires Matomo trackEvent and then trackGoal to record a goal conversion.',\n  in: getEvent('promotion visible', { timestamp: 1700000401 }),\n  mapping: {\n    name: 'trackEvent',\n    settings: {\n      goalId: '1',\n    },\n    data: {\n      set: ['data.name', 'data.position'],\n    },\n  },\n  out: [\n    ['_paq.push', ['trackEvent', 'Setting up tracking easily', 'hero']],\n    ['_paq.push', ['trackGoal', '1', undefined]],\n  ],\n};\n\n/**\n * Ecommerce order -- one call with cart items array and order totals.\n * Not public: Matomo records an order's products only after an\n * addEcommerceItem call per product, which one rule cannot send, so this\n * shows mapping mechanics only.\n */\nexport const ecommerceOrder: StepExample = {\n  public: false,\n  title: 'Ecommerce order',\n  description:\n    \"Test fixture for nested product mapping, not a valid Matomo call: Matomo records an order's products only after an addEcommerceItem call per product.\",\n  in: getEvent('order complete', { timestamp: 1700000402 }),\n  mapping: {\n    name: 'trackEcommerceOrder',\n    data: {\n      set: [\n        {\n          loop: [\n            'nested',\n            {\n              condition: (entity: unknown) =>\n                typeof entity === 'object' &&\n                entity !== null &&\n                'entity' in entity &&\n                entity.entity === 'product',\n              map: {\n                sku: 'data.id',\n                name: 'data.name',\n                category: { value: '' },\n                price: 'data.price',\n                quantity: { value: 1 },\n              },\n            },\n          ],\n        },\n        {\n          map: {\n            orderId: 'data.id',\n            grandTotal: 'data.total',\n            tax: 'data.taxes',\n            shipping: 'data.shipping',\n          },\n        },\n      ],\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      [\n        'trackEcommerceOrder',\n        [\n          {\n            sku: 'ers',\n            name: 'Everyday Ruck Snack',\n            category: '',\n            price: 420,\n            quantity: 1,\n          },\n          {\n            sku: 'cc',\n            name: 'Cool Cap',\n            category: '',\n            price: 42,\n            quantity: 1,\n          },\n        ],\n        {\n          orderId: '0rd3r1d',\n          grandTotal: 555,\n          tax: 73.76,\n          shipping: 5.22,\n        },\n      ],\n    ],\n  ],\n};\n\n/**\n * Ecommerce cart update -- nested products and the cart total in one call.\n * Not public: Matomo takes trackEcommerceCartUpdate(grandTotal) after an\n * addEcommerceItem call per product, which one rule cannot send.\n */\nexport const ecommerceCartUpdate: StepExample = {\n  public: false,\n  title: 'Cart update',\n  description:\n    'Test fixture for nested product mapping, not a valid Matomo call: Matomo takes trackEcommerceCartUpdate(grandTotal) after an addEcommerceItem call per product.',\n  in: getEvent('cart view', { timestamp: 1700000403 }),\n  mapping: {\n    name: 'trackEcommerceCartUpdate',\n    data: {\n      set: [\n        {\n          loop: [\n            'nested',\n            {\n              condition: (entity: unknown) =>\n                typeof entity === 'object' &&\n                entity !== null &&\n                'entity' in entity &&\n                entity.entity === 'product',\n              map: {\n                sku: 'data.id',\n                name: 'data.name',\n                category: { value: '' },\n                price: 'data.price',\n                quantity: { value: 1 },\n              },\n            },\n          ],\n        },\n        'data.value',\n      ],\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      [\n        'trackEcommerceCartUpdate',\n        [\n          {\n            sku: 'ers',\n            name: 'Everyday Ruck Snack',\n            category: '',\n            price: 420,\n            quantity: 1,\n          },\n        ],\n        840,\n      ],\n    ],\n  ],\n};\n\n/**\n * Product detail view with a single product array.\n * Not public: Matomo has no ecommerceProductDetailView; it tracks a product\n * view with setEcommerceView followed by trackPageView, two commands.\n */\nexport const productDetailView: StepExample = {\n  public: false,\n  title: 'Product detail view',\n  description:\n    'Test fixture for a single-product mapping, not a valid Matomo call: Matomo tracks a product view with setEcommerceView followed by trackPageView.',\n  in: getEvent('product view', { timestamp: 1700000404 }),\n  mapping: {\n    name: 'ecommerceProductDetailView',\n    data: {\n      set: [\n        {\n          set: [\n            {\n              map: {\n                sku: 'data.id',\n                name: 'data.name',\n                price: 'data.price',\n                quantity: { value: 1 },\n              },\n            },\n          ],\n        },\n      ],\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      [\n        'ecommerceProductDetailView',\n        [\n          {\n            sku: 'ers',\n            name: 'Everyday Ruck Snack',\n            price: 420,\n            quantity: 1,\n          },\n        ],\n      ],\n    ],\n  ],\n};\n\n/**\n * Site search -- trackSiteSearch with keyword, category, result count.\n */\nexport const siteSearch: StepExample = {\n  title: 'Site search',\n  description:\n    'A search submit fires Matomo trackSiteSearch with the keyword, category, and number of results.',\n  in: getEvent('search submit', {\n    timestamp: 1700000405,\n    data: { query: 'shoes', category: 'products', resultsCount: 42 },\n  }),\n  mapping: {\n    name: 'trackSiteSearch',\n    settings: {\n      siteSearch: true,\n    },\n    data: {\n      set: ['data.query', 'data.category', 'data.resultsCount'],\n    },\n  },\n  out: [['_paq.push', ['trackSiteSearch', 'shoes', 'products', 42]]],\n};\n\n/**\n * Goal tracking alongside a tracked event.\n * Uses a known fixture event (promotion visible) so data paths resolve.\n */\nexport const goalTracking: StepExample = {\n  title: 'Goal with value',\n  description:\n    'A promotion event fires Matomo trackEvent and then trackGoal with a monetary goal value from event data.',\n  in: getEvent('promotion visible', {\n    timestamp: 1700000406,\n    data: { name: 'Setting up tracking easily', position: 'hero', value: 50 },\n  }),\n  mapping: {\n    name: 'trackEvent',\n    settings: {\n      goalId: '1',\n      goalValue: 'data.value',\n    },\n    data: {\n      set: ['data.name'],\n    },\n  },\n  out: [\n    ['_paq.push', ['trackEvent', 'Setting up tracking easily']],\n    ['_paq.push', ['trackGoal', '1', 50]],\n  ],\n};\n\n/**\n * Destination and rule custom dimensions, resolved per event. The destination\n * dimensions come from `settings`, which the docs do not show, so this\n * example stays out of them.\n */\nexport const customDimensions: StepExample = {\n  title: 'Custom dimensions',\n  description:\n    'Destination and rule custom dimensions are set right before the page view; afterwards the rule-only dimension is deleted and the destination value is set again.',\n  public: false,\n  in: getEvent('page view', { timestamp: 1700000408 }),\n  settings: {\n    customDimensions: { '1': 'globals.pagegroup' },\n  },\n  mapping: {\n    settings: {\n      customDimensions: { '2': 'data.id' },\n    },\n  },\n  out: [\n    ['_paq.push', ['setCustomDimension', 1, 'docs']],\n    ['_paq.push', ['setCustomDimension', 2, '/docs/']],\n    ['_paq.push', ['trackPageView', 'walkerOS documentation']],\n    ['_paq.push', ['deleteCustomDimension', 2]],\n    ['_paq.push', ['setCustomDimension', 1, 'docs']],\n  ],\n};\n"],"mappings":"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","names":["import_dev","import_dev","init"]}
+{"version":3,"sources":["../src/dev.ts","../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/examples/index.ts","../src/examples/env.ts","../src/examples/step.ts"],"sourcesContent":["export * as schemas from './schemas';\nexport * as examples from './examples';\n","import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nexport { SettingsSchema, type Settings } from './settings';\nexport { MappingSchema, type Mapping } from './mapping';\n\n// JSON Schema\nexport const settings = zodToSchema(SettingsSchema);\nexport const mapping = zodToSchema(MappingSchema);\n","import { schemas, z } from '@walkeros/core/dev';\n\nconst { ValueSchema } = schemas;\n\nexport const CustomDimensionsSchema = z.record(\n  z.string().regex(/^\\d+$/, 'Dimension keys are bare numeric ids like \"1\"'),\n  ValueSchema,\n);\n\nexport const SettingsSchema = z\n  .object({\n    siteId: z\n      .string()\n      .min(1)\n      .describe(\n        'Matomo Site ID (like 1, 2, etc.). Required when loadScript is true',\n      )\n      .optional(),\n    url: z\n      .string()\n      .url()\n      .describe(\n        'Base URL of your Matomo instance, normalized to one trailing slash (like https://analytics.example.com/ or https://yourname.matomo.cloud/). Required when loadScript is true',\n      )\n      .optional(),\n    disableCookies: z\n      .boolean()\n      .default(false)\n      .describe('Disable all tracking cookies for cookie-free analytics'),\n    enableLinkTracking: z\n      .boolean()\n      .default(true)\n      .describe('Enable automatic outlink and download tracking'),\n    enableHeartBeatTimer: z\n      .number()\n      .int()\n      .positive()\n      .optional()\n      .describe(\n        'Enable heart beat timer with interval in seconds for accurate time-on-page',\n      ),\n    customDimensions: CustomDimensionsSchema.describe(\n      'Custom dimensions applied to every hit, keyed by bare dimension id (like { \"1\": \"data.userType\" }). Each value is resolved per event. Rule-level customDimensions win per key.',\n    ).optional(),\n  })\n  .strict();\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { schemas, z } from '@walkeros/core/dev';\nimport { CustomDimensionsSchema } from './settings';\n\nexport const MappingSchema = z.object({\n  goalId: z\n    .union([\n      z.string().regex(/^[1-9]\\d*$/, 'Goal IDs are positive integers like \"1\"'),\n      z.number().int().positive(),\n    ])\n    .optional()\n    .describe(\n      'Matomo goal ID, a positive integer like 1. Adds a trackGoal conversion alongside this event',\n    ),\n  goalValue: schemas.ValueSchema.describe(\n    'Goal revenue, resolved from the event (like \"data.revenue\"), passed as the trackGoal revenue',\n  ).optional(),\n  siteSearch: z\n    .boolean()\n    .optional()\n    .describe('Track as internal site search using trackSiteSearch'),\n  contentImpression: z\n    .boolean()\n    .optional()\n    .describe('Track as content impression using trackContentImpression'),\n  contentInteraction: z\n    .boolean()\n    .optional()\n    .describe('Track as content interaction using trackContentInteraction'),\n  customDimensions: CustomDimensionsSchema.describe(\n    'Custom dimensions for this rule, keyed by bare dimension id (like { \"3\": \"data.category\" }). Set just before the hit and removed after it; wins per key over the destination customDimensions.',\n  ).optional(),\n});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * as env from './env';\nexport * as step from './step';\n","import type { Env } from '../types';\n\n/**\n * Example environment configurations for Matomo destination.\n * Mocks the _paq command queue for testing without requiring real browser\n * or network.\n */\n\nexport const init: Env | undefined = {\n  window: {\n    // _paq absent: init() is expected to install the queue.\n    location: { href: 'https://www.example.com/page' },\n  },\n};\n\nexport const push: Env = {\n  window: {\n    _paq: [],\n    location: { href: 'https://www.example.com/page' },\n  },\n};\n\n/**\n * Simulation tracking paths.\n * Specifies which function calls to track during simulation.\n */\nexport const simulation = [\n  'call:window._paq.push', // Track _paq.push calls\n];\n","import type { Flow } from '@walkeros/core';\nimport type { Settings } from '../types';\nimport { createEvent, getEvent } from '@walkeros/core';\n\n/**\n * Matomo step example. The test runner registers the destination with the\n * init example's config and merges an example's optional `settings` on top.\n */\nexport type StepExample = Flow.StepExample & {\n  /** Destination settings merged over the init example's settings. */\n  settings?: Settings;\n};\n\n/**\n * Destination bootstrap.\n * Given the canonical settings, init loads the Matomo script and configures\n * the tracker URL, site ID, and link tracking. Reproduce by passing the same\n * settings to `startFlow` as the destination config.\n */\nexport const init: StepExample = {\n  title: 'Initialization',\n  description:\n    'Destination bootstrap loads the Matomo tracker script and configures the tracker URL and site id.',\n  in: {\n    loadScript: true,\n    settings: {\n      siteId: '1',\n      url: 'https://analytics.example.com/',\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      ['setTrackerUrl', 'https://analytics.example.com/matomo.php'],\n    ],\n    ['_paq.push', ['setSiteId', '1']],\n    ['_paq.push', ['enableLinkTracking']],\n  ],\n};\n\n/**\n * Default page view -- no mapping name needed.\n * Destination auto-calls trackPageView with the page title.\n */\nexport const pageView: StepExample = {\n  title: 'Page view',\n  description:\n    'A page view is tracked in Matomo via trackPageView with the page title from event data.',\n  in: getEvent('page view', { timestamp: 1700000400 }),\n  mapping: {\n    data: 'data.title',\n  },\n  out: [['_paq.push', ['trackPageView', 'walkerOS documentation']]],\n};\n\n/**\n * Page view rule with a goal -- the default trackPageView stays and the goal\n * follows it.\n */\nexport const pageViewWithGoal: StepExample = {\n  title: 'Page view with goal',\n  description:\n    'A page view rule with a goal keeps the default trackPageView and adds a trackGoal conversion.',\n  in: getEvent('page view', { timestamp: 1700000407 }),\n  mapping: {\n    settings: {\n      goalId: '1',\n    },\n  },\n  out: [\n    ['_paq.push', ['trackPageView', 'walkerOS documentation']],\n    ['_paq.push', ['trackGoal', '1', undefined]],\n  ],\n};\n\n/**\n * Custom event tracking with goal conversion.\n * Uses trackEvent with mapped name, followed by trackGoal.\n */\nexport const customEvent: StepExample = {\n  title: 'Custom event with goal',\n  description:\n    'A promotion visible event fires Matomo trackEvent and then trackGoal to record a goal conversion.',\n  in: getEvent('promotion visible', { timestamp: 1700000401 }),\n  mapping: {\n    name: 'trackEvent',\n    settings: {\n      goalId: '1',\n    },\n    data: {\n      set: ['data.name', 'data.position'],\n    },\n  },\n  out: [\n    ['_paq.push', ['trackEvent', 'Setting up tracking easily', 'hero']],\n    ['_paq.push', ['trackGoal', '1', undefined]],\n  ],\n};\n\n/**\n * Ecommerce order -- one call with cart items array and order totals.\n * Not public: Matomo records an order's products only after an\n * addEcommerceItem call per product, which one rule cannot send, so this\n * shows mapping mechanics only.\n */\nexport const ecommerceOrder: StepExample = {\n  public: false,\n  title: 'Ecommerce order',\n  description:\n    \"Test fixture for nested product mapping, not a valid Matomo call: Matomo records an order's products only after an addEcommerceItem call per product.\",\n  in: getEvent('order complete', { timestamp: 1700000402 }),\n  mapping: {\n    name: 'trackEcommerceOrder',\n    data: {\n      set: [\n        {\n          loop: [\n            'nested',\n            {\n              condition: (entity: unknown) =>\n                typeof entity === 'object' &&\n                entity !== null &&\n                'entity' in entity &&\n                entity.entity === 'product',\n              map: {\n                sku: 'data.id',\n                name: 'data.name',\n                category: { value: '' },\n                price: 'data.price',\n                quantity: { value: 1 },\n              },\n            },\n          ],\n        },\n        {\n          map: {\n            orderId: 'data.id',\n            grandTotal: 'data.value',\n            tax: 'data.taxes',\n            shipping: 'data.shipping',\n          },\n        },\n      ],\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      [\n        'trackEcommerceOrder',\n        [\n          {\n            sku: 'ers',\n            name: 'Everyday Ruck Snack',\n            category: '',\n            price: 420,\n            quantity: 1,\n          },\n          {\n            sku: 'cc',\n            name: 'Cool Cap',\n            category: '',\n            price: 42,\n            quantity: 1,\n          },\n        ],\n        {\n          orderId: '0rd3r1d',\n          grandTotal: 555,\n          tax: 73.76,\n          shipping: 5.22,\n        },\n      ],\n    ],\n  ],\n};\n\n/**\n * Ecommerce cart update -- nested products and the cart total in one call.\n * Not public: Matomo takes trackEcommerceCartUpdate(grandTotal) after an\n * addEcommerceItem call per product, which one rule cannot send.\n */\nexport const ecommerceCartUpdate: StepExample = {\n  public: false,\n  title: 'Cart update',\n  description:\n    'Test fixture for nested product mapping, not a valid Matomo call: Matomo takes trackEcommerceCartUpdate(grandTotal) after an addEcommerceItem call per product.',\n  in: getEvent('cart view', { timestamp: 1700000403 }),\n  mapping: {\n    name: 'trackEcommerceCartUpdate',\n    data: {\n      set: [\n        {\n          loop: [\n            'nested',\n            {\n              condition: (entity: unknown) =>\n                typeof entity === 'object' &&\n                entity !== null &&\n                'entity' in entity &&\n                entity.entity === 'product',\n              map: {\n                sku: 'data.id',\n                name: 'data.name',\n                category: { value: '' },\n                price: 'data.price',\n                quantity: { value: 1 },\n              },\n            },\n          ],\n        },\n        'data.value',\n      ],\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      [\n        'trackEcommerceCartUpdate',\n        [\n          {\n            sku: 'ers',\n            name: 'Everyday Ruck Snack',\n            category: '',\n            price: 420,\n            quantity: 1,\n          },\n        ],\n        840,\n      ],\n    ],\n  ],\n};\n\n/**\n * Product detail view with a single product array.\n * Not public: Matomo has no ecommerceProductDetailView; it tracks a product\n * view with setEcommerceView followed by trackPageView, two commands.\n */\nexport const productDetailView: StepExample = {\n  public: false,\n  title: 'Product detail view',\n  description:\n    'Test fixture for a single-product mapping, not a valid Matomo call: Matomo tracks a product view with setEcommerceView followed by trackPageView.',\n  in: getEvent('product view', { timestamp: 1700000404 }),\n  mapping: {\n    name: 'ecommerceProductDetailView',\n    data: {\n      set: [\n        {\n          set: [\n            {\n              map: {\n                sku: 'data.id',\n                name: 'data.name',\n                price: 'data.price',\n                quantity: { value: 1 },\n              },\n            },\n          ],\n        },\n      ],\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      [\n        'ecommerceProductDetailView',\n        [\n          {\n            sku: 'ers',\n            name: 'Everyday Ruck Snack',\n            price: 420,\n            quantity: 1,\n          },\n        ],\n      ],\n    ],\n  ],\n};\n\n/**\n * Site search -- trackSiteSearch with keyword, category, result count.\n */\nexport const siteSearch: StepExample = {\n  title: 'Site search',\n  description:\n    'A search submit fires Matomo trackSiteSearch with the keyword, category, and number of results.',\n  in: createEvent({\n    name: 'search submit',\n    timestamp: 1700000405,\n    data: { query: 'shoes', category: 'products', resultsCount: 42 },\n  }),\n  mapping: {\n    name: 'trackSiteSearch',\n    settings: {\n      siteSearch: true,\n    },\n    data: {\n      set: ['data.query', 'data.category', 'data.resultsCount'],\n    },\n  },\n  out: [['_paq.push', ['trackSiteSearch', 'shoes', 'products', 42]]],\n};\n\n/**\n * Goal tracking alongside a tracked event.\n * Uses a known fixture event (promotion visible) so data paths resolve.\n */\nexport const goalTracking: StepExample = {\n  title: 'Goal with value',\n  description:\n    'A promotion event fires Matomo trackEvent and then trackGoal with a monetary goal value from event data.',\n  in: getEvent('promotion visible', {\n    timestamp: 1700000406,\n    data: { name: 'Setting up tracking easily', position: 'hero', value: 50 },\n  }),\n  mapping: {\n    name: 'trackEvent',\n    settings: {\n      goalId: '1',\n      goalValue: 'data.value',\n    },\n    data: {\n      set: ['data.name'],\n    },\n  },\n  out: [\n    ['_paq.push', ['trackEvent', 'Setting up tracking easily']],\n    ['_paq.push', ['trackGoal', '1', 50]],\n  ],\n};\n\n/**\n * Destination and rule custom dimensions, resolved per event. The destination\n * dimensions come from `settings`, which the docs do not show, so this\n * example stays out of them.\n */\nexport const customDimensions: StepExample = {\n  title: 'Custom dimensions',\n  description:\n    'Destination and rule custom dimensions are set right before the page view; afterwards the rule-only dimension is deleted and the destination value is set again.',\n  public: false,\n  in: getEvent('page view', { timestamp: 1700000408 }),\n  settings: {\n    customDimensions: { '1': 'globals.pagegroup' },\n  },\n  mapping: {\n    settings: {\n      customDimensions: { '2': 'data.id' },\n    },\n  },\n  out: [\n    ['_paq.push', ['setCustomDimension', 1, 'docs']],\n    ['_paq.push', ['setCustomDimension', 2, '/docs/']],\n    ['_paq.push', ['trackPageView', 'walkerOS documentation']],\n    ['_paq.push', ['deleteCustomDimension', 2]],\n    ['_paq.push', ['setCustomDimension', 1, 'docs']],\n  ],\n};\n\n/** A silent rule without a goal sends nothing. */\nexport const silentRule: StepExample = {\n  public: false,\n  description:\n    'A rule with silent: true and no goal sends no command, its dimensions included.',\n  in: getEvent('page view', { timestamp: 1700000300 }),\n  mapping: { silent: true },\n  out: [],\n};\n\n/**\n * An event no rule maps: Matomo has no command for it, so the push fails\n * instead of counting as delivered.\n */\nexport const unmappedEvent: StepExample = {\n  public: false,\n  description:\n    'An event without a rule name, a tracking flag or a goal, and not a page view, has no Matomo command: the push fails with missing-input.',\n  in: getEvent('product view', { timestamp: 1700000301 }),\n  out: [],\n  outcome: { status: 'failed', code: 'missing-input', retryable: false },\n};\n\n/**\n * A revocation of the consent the destination requires stops Matomo:\n * config.consent { marketing: true }, granted first, then revoked.\n */\nexport const consentRevoke: StepExample = {\n  public: false,\n  description:\n    'For a destination with config.consent { marketing: true }, revoking marketing pushes forgetConsentGiven, which stops every tracking request of the page, link tracking included.',\n  command: 'consent',\n  in: { marketing: false },\n  out: [['window._paq.push', ['forgetConsentGiven']]],\n};\n"],"mappings":"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","names":["import_dev","import_dev","init"]}

package/dist/dev.mjs

@@ -1 +1 @@
-var e=Object.defineProperty,t=(t,a)=>{for(var i in a)e(t,i,{get:a[i],enumerable:!0})},a={};t(a,{MappingSchema:()=>m,SettingsSchema:()=>c,mapping:()=>u,settings:()=>l});import{zodToSchema as i}from"@walkeros/core/dev";import{schemas as o,z as n}from"@walkeros/core/dev";var{ValueSchema:r}=o,s=n.record(n.string().regex(/^\d+$/,'Dimension keys are bare numeric ids like "1"'),r),c=n.object({siteId:n.string().min(1).describe("Matomo Site ID (like 1, 2, etc.). Required when loadScript is true").optional(),url:n.string().url().describe("Base URL of your Matomo instance, normalized to one trailing slash (like https://analytics.example.com/ or https://yourname.matomo.cloud/). Required when loadScript is true").optional(),disableCookies:n.boolean().default(!1).describe("Disable all tracking cookies for cookie-free analytics"),enableLinkTracking:n.boolean().default(!0).describe("Enable automatic outlink and download tracking"),enableHeartBeatTimer:n.number().int().positive().optional().describe("Enable heart beat timer with interval in seconds for accurate time-on-page"),customDimensions:s.describe('Custom dimensions applied to every hit, keyed by bare dimension id (like { "1": "data.userType" }). Each value is resolved per event. Rule-level customDimensions win per key.').optional()});import{schemas as p,z as d}from"@walkeros/core/dev";var m=d.object({goalId:d.union([d.string().regex(/^[1-9]\d*$/,'Goal IDs are positive integers like "1"'),d.number().int().positive()]).optional().describe("Matomo goal ID, a positive integer like 1. Adds a trackGoal conversion alongside this event"),goalValue:p.ValueSchema.describe('Goal revenue, resolved from the event (like "data.revenue"), passed as the trackGoal revenue').optional(),siteSearch:d.boolean().optional().describe("Track as internal site search using trackSiteSearch"),contentImpression:d.boolean().optional().describe("Track as content impression using trackContentImpression"),contentInteraction:d.boolean().optional().describe("Track as content interaction using trackContentInteraction"),customDimensions:s.describe('Custom dimensions for this rule, keyed by bare dimension id (like { "3": "data.category" }). Set just before the hit and removed after it; wins per key over the destination customDimensions.').optional()}),l=i(c),u=i(m),g={};t(g,{env:()=>h,step:()=>y});var h={};t(h,{init:()=>k,push:()=>v,simulation:()=>w});var k={window:{location:{href:"https://www.example.com/page"}},document:{createElement:()=>({type:"",src:"",async:!1,defer:!1}),head:{appendChild:()=>{}}}},v={window:{_paq:[],location:{href:"https://www.example.com/page"}},document:{createElement:()=>({type:"",src:"",async:!1,defer:!1}),head:{appendChild:()=>{}}}},w=["call:window._paq.push"],y={};t(y,{customDimensions:()=>x,customEvent:()=>E,ecommerceCartUpdate:()=>D,ecommerceOrder:()=>C,goalTracking:()=>V,init:()=>f,pageView:()=>q,pageViewWithGoal:()=>S,productDetailView:()=>_,siteSearch:()=>I});import{getEvent as b}from"@walkeros/core";var f={title:"Initialization",description:"Destination bootstrap loads the Matomo tracker script and configures the tracker URL and site id.",in:{loadScript:!0,settings:{siteId:"1",url:"https://analytics.example.com/"}},out:[["_paq.push",["setTrackerUrl","https://analytics.example.com/matomo.php"]],["_paq.push",["setSiteId","1"]],["_paq.push",["enableLinkTracking"]]]},q={title:"Page view",description:"A page view is tracked in Matomo via trackPageView with the page title from event data.",in:b("page view",{timestamp:1700000400}),mapping:{data:"data.title"},out:[["_paq.push",["trackPageView","walkerOS documentation"]]]},S={title:"Page view with goal",description:"A page view rule with a goal keeps the default trackPageView and adds a trackGoal conversion.",in:b("page view",{timestamp:1700000407}),mapping:{settings:{goalId:"1"}},out:[["_paq.push",["trackPageView","walkerOS documentation"]],["_paq.push",["trackGoal","1",void 0]]]},E={title:"Custom event with goal",description:"A promotion visible event fires Matomo trackEvent and then trackGoal to record a goal conversion.",in:b("promotion visible",{timestamp:1700000401}),mapping:{name:"trackEvent",settings:{goalId:"1"},data:{set:["data.name","data.position"]}},out:[["_paq.push",["trackEvent","Setting up tracking easily","hero"]],["_paq.push",["trackGoal","1",void 0]]]},C={public:!1,title:"Ecommerce order",description:"Test fixture for nested product mapping, not a valid Matomo call: Matomo records an order's products only after an addEcommerceItem call per product.",in:b("order complete",{timestamp:1700000402}),mapping:{name:"trackEcommerceOrder",data:{set:[{loop:["nested",{condition:e=>"object"==typeof e&&null!==e&&"entity"in e&&"product"===e.entity,map:{sku:"data.id",name:"data.name",category:{value:""},price:"data.price",quantity:{value:1}}}]},{map:{orderId:"data.id",grandTotal:"data.total",tax:"data.taxes",shipping:"data.shipping"}}]}},out:[["_paq.push",["trackEcommerceOrder",[{sku:"ers",name:"Everyday Ruck Snack",category:"",price:420,quantity:1},{sku:"cc",name:"Cool Cap",category:"",price:42,quantity:1}],{orderId:"0rd3r1d",grandTotal:555,tax:73.76,shipping:5.22}]]]},D={public:!1,title:"Cart update",description:"Test fixture for nested product mapping, not a valid Matomo call: Matomo takes trackEcommerceCartUpdate(grandTotal) after an addEcommerceItem call per product.",in:b("cart view",{timestamp:1700000403}),mapping:{name:"trackEcommerceCartUpdate",data:{set:[{loop:["nested",{condition:e=>"object"==typeof e&&null!==e&&"entity"in e&&"product"===e.entity,map:{sku:"data.id",name:"data.name",category:{value:""},price:"data.price",quantity:{value:1}}}]},"data.value"]}},out:[["_paq.push",["trackEcommerceCartUpdate",[{sku:"ers",name:"Everyday Ruck Snack",category:"",price:420,quantity:1}],840]]]},_={public:!1,title:"Product detail view",description:"Test fixture for a single-product mapping, not a valid Matomo call: Matomo tracks a product view with setEcommerceView followed by trackPageView.",in:b("product view",{timestamp:1700000404}),mapping:{name:"ecommerceProductDetailView",data:{set:[{set:[{map:{sku:"data.id",name:"data.name",price:"data.price",quantity:{value:1}}}]}]}},out:[["_paq.push",["ecommerceProductDetailView",[{sku:"ers",name:"Everyday Ruck Snack",price:420,quantity:1}]]]]},I={title:"Site search",description:"A search submit fires Matomo trackSiteSearch with the keyword, category, and number of results.",in:b("search submit",{timestamp:1700000405,data:{query:"shoes",category:"products",resultsCount:42}}),mapping:{name:"trackSiteSearch",settings:{siteSearch:!0},data:{set:["data.query","data.category","data.resultsCount"]}},out:[["_paq.push",["trackSiteSearch","shoes","products",42]]]},V={title:"Goal with value",description:"A promotion event fires Matomo trackEvent and then trackGoal with a monetary goal value from event data.",in:b("promotion visible",{timestamp:1700000406,data:{name:"Setting up tracking easily",position:"hero",value:50}}),mapping:{name:"trackEvent",settings:{goalId:"1",goalValue:"data.value"},data:{set:["data.name"]}},out:[["_paq.push",["trackEvent","Setting up tracking easily"]],["_paq.push",["trackGoal","1",50]]]},x={title:"Custom dimensions",description:"Destination and rule custom dimensions are set right before the page view; afterwards the rule-only dimension is deleted and the destination value is set again.",public:!1,in:b("page view",{timestamp:1700000408}),settings:{customDimensions:{1:"globals.pagegroup"}},mapping:{settings:{customDimensions:{2:"data.id"}}},out:[["_paq.push",["setCustomDimension",1,"docs"]],["_paq.push",["setCustomDimension",2,"/docs/"]],["_paq.push",["trackPageView","walkerOS documentation"]],["_paq.push",["deleteCustomDimension",2]],["_paq.push",["setCustomDimension",1,"docs"]]]};export{g as examples,a as schemas};//# sourceMappingURL=dev.mjs.map
+var e=Object.defineProperty,t=(t,a)=>{for(var i in a)e(t,i,{get:a[i],enumerable:!0})},a={};t(a,{MappingSchema:()=>m,SettingsSchema:()=>c,mapping:()=>u,settings:()=>l});import{zodToSchema as i}from"@walkeros/core/dev";import{schemas as o,z as n}from"@walkeros/core/dev";var{ValueSchema:r}=o,s=n.record(n.string().regex(/^\d+$/,'Dimension keys are bare numeric ids like "1"'),r),c=n.object({siteId:n.string().min(1).describe("Matomo Site ID (like 1, 2, etc.). Required when loadScript is true").optional(),url:n.string().url().describe("Base URL of your Matomo instance, normalized to one trailing slash (like https://analytics.example.com/ or https://yourname.matomo.cloud/). Required when loadScript is true").optional(),disableCookies:n.boolean().default(!1).describe("Disable all tracking cookies for cookie-free analytics"),enableLinkTracking:n.boolean().default(!0).describe("Enable automatic outlink and download tracking"),enableHeartBeatTimer:n.number().int().positive().optional().describe("Enable heart beat timer with interval in seconds for accurate time-on-page"),customDimensions:s.describe('Custom dimensions applied to every hit, keyed by bare dimension id (like { "1": "data.userType" }). Each value is resolved per event. Rule-level customDimensions win per key.').optional()}).strict();import{schemas as p,z as d}from"@walkeros/core/dev";var m=d.object({goalId:d.union([d.string().regex(/^[1-9]\d*$/,'Goal IDs are positive integers like "1"'),d.number().int().positive()]).optional().describe("Matomo goal ID, a positive integer like 1. Adds a trackGoal conversion alongside this event"),goalValue:p.ValueSchema.describe('Goal revenue, resolved from the event (like "data.revenue"), passed as the trackGoal revenue').optional(),siteSearch:d.boolean().optional().describe("Track as internal site search using trackSiteSearch"),contentImpression:d.boolean().optional().describe("Track as content impression using trackContentImpression"),contentInteraction:d.boolean().optional().describe("Track as content interaction using trackContentInteraction"),customDimensions:s.describe('Custom dimensions for this rule, keyed by bare dimension id (like { "3": "data.category" }). Set just before the hit and removed after it; wins per key over the destination customDimensions.').optional()}),l=i(c),u=i(m),g={};t(g,{env:()=>h,step:()=>b});var h={};t(h,{init:()=>k,push:()=>v,simulation:()=>w});var k={window:{location:{href:"https://www.example.com/page"}}},v={window:{_paq:[],location:{href:"https://www.example.com/page"}}},w=["call:window._paq.push"],b={};t(b,{consentRevoke:()=>P,customDimensions:()=>x,customEvent:()=>C,ecommerceCartUpdate:()=>D,ecommerceOrder:()=>_,goalTracking:()=>V,init:()=>q,pageView:()=>S,pageViewWithGoal:()=>E,productDetailView:()=>I,silentRule:()=>T,siteSearch:()=>M,unmappedEvent:()=>G});import{createEvent as y,getEvent as f}from"@walkeros/core";var q={title:"Initialization",description:"Destination bootstrap loads the Matomo tracker script and configures the tracker URL and site id.",in:{loadScript:!0,settings:{siteId:"1",url:"https://analytics.example.com/"}},out:[["_paq.push",["setTrackerUrl","https://analytics.example.com/matomo.php"]],["_paq.push",["setSiteId","1"]],["_paq.push",["enableLinkTracking"]]]},S={title:"Page view",description:"A page view is tracked in Matomo via trackPageView with the page title from event data.",in:f("page view",{timestamp:1700000400}),mapping:{data:"data.title"},out:[["_paq.push",["trackPageView","walkerOS documentation"]]]},E={title:"Page view with goal",description:"A page view rule with a goal keeps the default trackPageView and adds a trackGoal conversion.",in:f("page view",{timestamp:1700000407}),mapping:{settings:{goalId:"1"}},out:[["_paq.push",["trackPageView","walkerOS documentation"]],["_paq.push",["trackGoal","1",void 0]]]},C={title:"Custom event with goal",description:"A promotion visible event fires Matomo trackEvent and then trackGoal to record a goal conversion.",in:f("promotion visible",{timestamp:1700000401}),mapping:{name:"trackEvent",settings:{goalId:"1"},data:{set:["data.name","data.position"]}},out:[["_paq.push",["trackEvent","Setting up tracking easily","hero"]],["_paq.push",["trackGoal","1",void 0]]]},_={public:!1,title:"Ecommerce order",description:"Test fixture for nested product mapping, not a valid Matomo call: Matomo records an order's products only after an addEcommerceItem call per product.",in:f("order complete",{timestamp:1700000402}),mapping:{name:"trackEcommerceOrder",data:{set:[{loop:["nested",{condition:e=>"object"==typeof e&&null!==e&&"entity"in e&&"product"===e.entity,map:{sku:"data.id",name:"data.name",category:{value:""},price:"data.price",quantity:{value:1}}}]},{map:{orderId:"data.id",grandTotal:"data.value",tax:"data.taxes",shipping:"data.shipping"}}]}},out:[["_paq.push",["trackEcommerceOrder",[{sku:"ers",name:"Everyday Ruck Snack",category:"",price:420,quantity:1},{sku:"cc",name:"Cool Cap",category:"",price:42,quantity:1}],{orderId:"0rd3r1d",grandTotal:555,tax:73.76,shipping:5.22}]]]},D={public:!1,title:"Cart update",description:"Test fixture for nested product mapping, not a valid Matomo call: Matomo takes trackEcommerceCartUpdate(grandTotal) after an addEcommerceItem call per product.",in:f("cart view",{timestamp:1700000403}),mapping:{name:"trackEcommerceCartUpdate",data:{set:[{loop:["nested",{condition:e=>"object"==typeof e&&null!==e&&"entity"in e&&"product"===e.entity,map:{sku:"data.id",name:"data.name",category:{value:""},price:"data.price",quantity:{value:1}}}]},"data.value"]}},out:[["_paq.push",["trackEcommerceCartUpdate",[{sku:"ers",name:"Everyday Ruck Snack",category:"",price:420,quantity:1}],840]]]},I={public:!1,title:"Product detail view",description:"Test fixture for a single-product mapping, not a valid Matomo call: Matomo tracks a product view with setEcommerceView followed by trackPageView.",in:f("product view",{timestamp:1700000404}),mapping:{name:"ecommerceProductDetailView",data:{set:[{set:[{map:{sku:"data.id",name:"data.name",price:"data.price",quantity:{value:1}}}]}]}},out:[["_paq.push",["ecommerceProductDetailView",[{sku:"ers",name:"Everyday Ruck Snack",price:420,quantity:1}]]]]},M={title:"Site search",description:"A search submit fires Matomo trackSiteSearch with the keyword, category, and number of results.",in:y({name:"search submit",timestamp:1700000405,data:{query:"shoes",category:"products",resultsCount:42}}),mapping:{name:"trackSiteSearch",settings:{siteSearch:!0},data:{set:["data.query","data.category","data.resultsCount"]}},out:[["_paq.push",["trackSiteSearch","shoes","products",42]]]},V={title:"Goal with value",description:"A promotion event fires Matomo trackEvent and then trackGoal with a monetary goal value from event data.",in:f("promotion visible",{timestamp:1700000406,data:{name:"Setting up tracking easily",position:"hero",value:50}}),mapping:{name:"trackEvent",settings:{goalId:"1",goalValue:"data.value"},data:{set:["data.name"]}},out:[["_paq.push",["trackEvent","Setting up tracking easily"]],["_paq.push",["trackGoal","1",50]]]},x={title:"Custom dimensions",description:"Destination and rule custom dimensions are set right before the page view; afterwards the rule-only dimension is deleted and the destination value is set again.",public:!1,in:f("page view",{timestamp:1700000408}),settings:{customDimensions:{1:"globals.pagegroup"}},mapping:{settings:{customDimensions:{2:"data.id"}}},out:[["_paq.push",["setCustomDimension",1,"docs"]],["_paq.push",["setCustomDimension",2,"/docs/"]],["_paq.push",["trackPageView","walkerOS documentation"]],["_paq.push",["deleteCustomDimension",2]],["_paq.push",["setCustomDimension",1,"docs"]]]},T={public:!1,description:"A rule with silent: true and no goal sends no command, its dimensions included.",in:f("page view",{timestamp:1700000300}),mapping:{silent:!0},out:[]},G={public:!1,description:"An event without a rule name, a tracking flag or a goal, and not a page view, has no Matomo command: the push fails with missing-input.",in:f("product view",{timestamp:1700000301}),out:[],outcome:{status:"failed",code:"missing-input",retryable:!1}},P={public:!1,description:"For a destination with config.consent { marketing: true }, revoking marketing pushes forgetConsentGiven, which stops every tracking request of the page, link tracking included.",command:"consent",in:{marketing:!1},out:[["window._paq.push",["forgetConsentGiven"]]]};export{g as examples,a as schemas};//# sourceMappingURL=dev.mjs.map

package/dist/dev.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/examples/index.ts","../src/examples/env.ts","../src/examples/step.ts"],"sourcesContent":["import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nexport { SettingsSchema, type Settings } from './settings';\nexport { MappingSchema, type Mapping } from './mapping';\n\n// JSON Schema\nexport const settings = zodToSchema(SettingsSchema);\nexport const mapping = zodToSchema(MappingSchema);\n","import { schemas, z } from '@walkeros/core/dev';\n\nconst { ValueSchema } = schemas;\n\nexport const CustomDimensionsSchema = z.record(\n  z.string().regex(/^\\d+$/, 'Dimension keys are bare numeric ids like \"1\"'),\n  ValueSchema,\n);\n\nexport const SettingsSchema = z.object({\n  siteId: z\n    .string()\n    .min(1)\n    .describe(\n      'Matomo Site ID (like 1, 2, etc.). Required when loadScript is true',\n    )\n    .optional(),\n  url: z\n    .string()\n    .url()\n    .describe(\n      'Base URL of your Matomo instance, normalized to one trailing slash (like https://analytics.example.com/ or https://yourname.matomo.cloud/). Required when loadScript is true',\n    )\n    .optional(),\n  disableCookies: z\n    .boolean()\n    .default(false)\n    .describe('Disable all tracking cookies for cookie-free analytics'),\n  enableLinkTracking: z\n    .boolean()\n    .default(true)\n    .describe('Enable automatic outlink and download tracking'),\n  enableHeartBeatTimer: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(\n      'Enable heart beat timer with interval in seconds for accurate time-on-page',\n    ),\n  customDimensions: CustomDimensionsSchema.describe(\n    'Custom dimensions applied to every hit, keyed by bare dimension id (like { \"1\": \"data.userType\" }). Each value is resolved per event. Rule-level customDimensions win per key.',\n  ).optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { schemas, z } from '@walkeros/core/dev';\nimport { CustomDimensionsSchema } from './settings';\n\nexport const MappingSchema = z.object({\n  goalId: z\n    .union([\n      z.string().regex(/^[1-9]\\d*$/, 'Goal IDs are positive integers like \"1\"'),\n      z.number().int().positive(),\n    ])\n    .optional()\n    .describe(\n      'Matomo goal ID, a positive integer like 1. Adds a trackGoal conversion alongside this event',\n    ),\n  goalValue: schemas.ValueSchema.describe(\n    'Goal revenue, resolved from the event (like \"data.revenue\"), passed as the trackGoal revenue',\n  ).optional(),\n  siteSearch: z\n    .boolean()\n    .optional()\n    .describe('Track as internal site search using trackSiteSearch'),\n  contentImpression: z\n    .boolean()\n    .optional()\n    .describe('Track as content impression using trackContentImpression'),\n  contentInteraction: z\n    .boolean()\n    .optional()\n    .describe('Track as content interaction using trackContentInteraction'),\n  customDimensions: CustomDimensionsSchema.describe(\n    'Custom dimensions for this rule, keyed by bare dimension id (like { \"3\": \"data.category\" }). Set just before the hit and removed after it; wins per key over the destination customDimensions.',\n  ).optional(),\n});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * as env from './env';\nexport * as step from './step';\n","import type { Env } from '../types';\n\n/**\n * Example environment configurations for Matomo destination.\n * Mocks the _paq command queue and DOM elements for testing\n * without requiring real browser or network.\n */\n\nexport const init: Env | undefined = {\n  window: {\n    // _paq absent: init() is expected to install the queue.\n    location: { href: 'https://www.example.com/page' },\n  },\n  document: {\n    createElement: () => ({\n      type: '',\n      src: '',\n      async: false,\n      defer: false,\n    }),\n    head: { appendChild: () => {} },\n  },\n};\n\nexport const push: Env = {\n  window: {\n    _paq: [],\n    location: { href: 'https://www.example.com/page' },\n  },\n  document: {\n    createElement: () => ({\n      type: '',\n      src: '',\n      async: false,\n      defer: false,\n    }),\n    head: { appendChild: () => {} },\n  },\n};\n\n/**\n * Simulation tracking paths.\n * Specifies which function calls to track during simulation.\n */\nexport const simulation = [\n  'call:window._paq.push', // Track _paq.push calls\n];\n","import type { Flow } from '@walkeros/core';\nimport type { Settings } from '../types';\nimport { getEvent } from '@walkeros/core';\n\n/**\n * Matomo step example. The test runner registers the destination with the\n * init example's config and merges an example's optional `settings` on top.\n */\nexport type StepExample = Flow.StepExample & {\n  /** Destination settings merged over the init example's settings. */\n  settings?: Settings;\n};\n\n/**\n * Destination bootstrap.\n * Given the canonical settings, init loads the Matomo script and configures\n * the tracker URL, site ID, and link tracking. Reproduce by passing the same\n * settings to `startFlow` as the destination config.\n */\nexport const init: StepExample = {\n  title: 'Initialization',\n  description:\n    'Destination bootstrap loads the Matomo tracker script and configures the tracker URL and site id.',\n  in: {\n    loadScript: true,\n    settings: {\n      siteId: '1',\n      url: 'https://analytics.example.com/',\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      ['setTrackerUrl', 'https://analytics.example.com/matomo.php'],\n    ],\n    ['_paq.push', ['setSiteId', '1']],\n    ['_paq.push', ['enableLinkTracking']],\n  ],\n};\n\n/**\n * Default page view -- no mapping name needed.\n * Destination auto-calls trackPageView with the page title.\n */\nexport const pageView: StepExample = {\n  title: 'Page view',\n  description:\n    'A page view is tracked in Matomo via trackPageView with the page title from event data.',\n  in: getEvent('page view', { timestamp: 1700000400 }),\n  mapping: {\n    data: 'data.title',\n  },\n  out: [['_paq.push', ['trackPageView', 'walkerOS documentation']]],\n};\n\n/**\n * Page view rule with a goal -- the default trackPageView stays and the goal\n * follows it.\n */\nexport const pageViewWithGoal: StepExample = {\n  title: 'Page view with goal',\n  description:\n    'A page view rule with a goal keeps the default trackPageView and adds a trackGoal conversion.',\n  in: getEvent('page view', { timestamp: 1700000407 }),\n  mapping: {\n    settings: {\n      goalId: '1',\n    },\n  },\n  out: [\n    ['_paq.push', ['trackPageView', 'walkerOS documentation']],\n    ['_paq.push', ['trackGoal', '1', undefined]],\n  ],\n};\n\n/**\n * Custom event tracking with goal conversion.\n * Uses trackEvent with mapped name, followed by trackGoal.\n */\nexport const customEvent: StepExample = {\n  title: 'Custom event with goal',\n  description:\n    'A promotion visible event fires Matomo trackEvent and then trackGoal to record a goal conversion.',\n  in: getEvent('promotion visible', { timestamp: 1700000401 }),\n  mapping: {\n    name: 'trackEvent',\n    settings: {\n      goalId: '1',\n    },\n    data: {\n      set: ['data.name', 'data.position'],\n    },\n  },\n  out: [\n    ['_paq.push', ['trackEvent', 'Setting up tracking easily', 'hero']],\n    ['_paq.push', ['trackGoal', '1', undefined]],\n  ],\n};\n\n/**\n * Ecommerce order -- one call with cart items array and order totals.\n * Not public: Matomo records an order's products only after an\n * addEcommerceItem call per product, which one rule cannot send, so this\n * shows mapping mechanics only.\n */\nexport const ecommerceOrder: StepExample = {\n  public: false,\n  title: 'Ecommerce order',\n  description:\n    \"Test fixture for nested product mapping, not a valid Matomo call: Matomo records an order's products only after an addEcommerceItem call per product.\",\n  in: getEvent('order complete', { timestamp: 1700000402 }),\n  mapping: {\n    name: 'trackEcommerceOrder',\n    data: {\n      set: [\n        {\n          loop: [\n            'nested',\n            {\n              condition: (entity: unknown) =>\n                typeof entity === 'object' &&\n                entity !== null &&\n                'entity' in entity &&\n                entity.entity === 'product',\n              map: {\n                sku: 'data.id',\n                name: 'data.name',\n                category: { value: '' },\n                price: 'data.price',\n                quantity: { value: 1 },\n              },\n            },\n          ],\n        },\n        {\n          map: {\n            orderId: 'data.id',\n            grandTotal: 'data.total',\n            tax: 'data.taxes',\n            shipping: 'data.shipping',\n          },\n        },\n      ],\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      [\n        'trackEcommerceOrder',\n        [\n          {\n            sku: 'ers',\n            name: 'Everyday Ruck Snack',\n            category: '',\n            price: 420,\n            quantity: 1,\n          },\n          {\n            sku: 'cc',\n            name: 'Cool Cap',\n            category: '',\n            price: 42,\n            quantity: 1,\n          },\n        ],\n        {\n          orderId: '0rd3r1d',\n          grandTotal: 555,\n          tax: 73.76,\n          shipping: 5.22,\n        },\n      ],\n    ],\n  ],\n};\n\n/**\n * Ecommerce cart update -- nested products and the cart total in one call.\n * Not public: Matomo takes trackEcommerceCartUpdate(grandTotal) after an\n * addEcommerceItem call per product, which one rule cannot send.\n */\nexport const ecommerceCartUpdate: StepExample = {\n  public: false,\n  title: 'Cart update',\n  description:\n    'Test fixture for nested product mapping, not a valid Matomo call: Matomo takes trackEcommerceCartUpdate(grandTotal) after an addEcommerceItem call per product.',\n  in: getEvent('cart view', { timestamp: 1700000403 }),\n  mapping: {\n    name: 'trackEcommerceCartUpdate',\n    data: {\n      set: [\n        {\n          loop: [\n            'nested',\n            {\n              condition: (entity: unknown) =>\n                typeof entity === 'object' &&\n                entity !== null &&\n                'entity' in entity &&\n                entity.entity === 'product',\n              map: {\n                sku: 'data.id',\n                name: 'data.name',\n                category: { value: '' },\n                price: 'data.price',\n                quantity: { value: 1 },\n              },\n            },\n          ],\n        },\n        'data.value',\n      ],\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      [\n        'trackEcommerceCartUpdate',\n        [\n          {\n            sku: 'ers',\n            name: 'Everyday Ruck Snack',\n            category: '',\n            price: 420,\n            quantity: 1,\n          },\n        ],\n        840,\n      ],\n    ],\n  ],\n};\n\n/**\n * Product detail view with a single product array.\n * Not public: Matomo has no ecommerceProductDetailView; it tracks a product\n * view with setEcommerceView followed by trackPageView, two commands.\n */\nexport const productDetailView: StepExample = {\n  public: false,\n  title: 'Product detail view',\n  description:\n    'Test fixture for a single-product mapping, not a valid Matomo call: Matomo tracks a product view with setEcommerceView followed by trackPageView.',\n  in: getEvent('product view', { timestamp: 1700000404 }),\n  mapping: {\n    name: 'ecommerceProductDetailView',\n    data: {\n      set: [\n        {\n          set: [\n            {\n              map: {\n                sku: 'data.id',\n                name: 'data.name',\n                price: 'data.price',\n                quantity: { value: 1 },\n              },\n            },\n          ],\n        },\n      ],\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      [\n        'ecommerceProductDetailView',\n        [\n          {\n            sku: 'ers',\n            name: 'Everyday Ruck Snack',\n            price: 420,\n            quantity: 1,\n          },\n        ],\n      ],\n    ],\n  ],\n};\n\n/**\n * Site search -- trackSiteSearch with keyword, category, result count.\n */\nexport const siteSearch: StepExample = {\n  title: 'Site search',\n  description:\n    'A search submit fires Matomo trackSiteSearch with the keyword, category, and number of results.',\n  in: getEvent('search submit', {\n    timestamp: 1700000405,\n    data: { query: 'shoes', category: 'products', resultsCount: 42 },\n  }),\n  mapping: {\n    name: 'trackSiteSearch',\n    settings: {\n      siteSearch: true,\n    },\n    data: {\n      set: ['data.query', 'data.category', 'data.resultsCount'],\n    },\n  },\n  out: [['_paq.push', ['trackSiteSearch', 'shoes', 'products', 42]]],\n};\n\n/**\n * Goal tracking alongside a tracked event.\n * Uses a known fixture event (promotion visible) so data paths resolve.\n */\nexport const goalTracking: StepExample = {\n  title: 'Goal with value',\n  description:\n    'A promotion event fires Matomo trackEvent and then trackGoal with a monetary goal value from event data.',\n  in: getEvent('promotion visible', {\n    timestamp: 1700000406,\n    data: { name: 'Setting up tracking easily', position: 'hero', value: 50 },\n  }),\n  mapping: {\n    name: 'trackEvent',\n    settings: {\n      goalId: '1',\n      goalValue: 'data.value',\n    },\n    data: {\n      set: ['data.name'],\n    },\n  },\n  out: [\n    ['_paq.push', ['trackEvent', 'Setting up tracking easily']],\n    ['_paq.push', ['trackGoal', '1', 50]],\n  ],\n};\n\n/**\n * Destination and rule custom dimensions, resolved per event. The destination\n * dimensions come from `settings`, which the docs do not show, so this\n * example stays out of them.\n */\nexport const customDimensions: StepExample = {\n  title: 'Custom dimensions',\n  description:\n    'Destination and rule custom dimensions are set right before the page view; afterwards the rule-only dimension is deleted and the destination value is set again.',\n  public: false,\n  in: getEvent('page view', { timestamp: 1700000408 }),\n  settings: {\n    customDimensions: { '1': 'globals.pagegroup' },\n  },\n  mapping: {\n    settings: {\n      customDimensions: { '2': 'data.id' },\n    },\n  },\n  out: [\n    ['_paq.push', ['setCustomDimension', 1, 'docs']],\n    ['_paq.push', ['setCustomDimension', 2, '/docs/']],\n    ['_paq.push', ['trackPageView', 'walkerOS documentation']],\n    ['_paq.push', ['deleteCustomDimension', 2]],\n    ['_paq.push', ['setCustomDimension', 1, 'docs']],\n  ],\n};\n"],"mappings":"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","names":["schemas","z","z","schemas","init"]}
+{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/examples/index.ts","../src/examples/env.ts","../src/examples/step.ts"],"sourcesContent":["import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nexport { SettingsSchema, type Settings } from './settings';\nexport { MappingSchema, type Mapping } from './mapping';\n\n// JSON Schema\nexport const settings = zodToSchema(SettingsSchema);\nexport const mapping = zodToSchema(MappingSchema);\n","import { schemas, z } from '@walkeros/core/dev';\n\nconst { ValueSchema } = schemas;\n\nexport const CustomDimensionsSchema = z.record(\n  z.string().regex(/^\\d+$/, 'Dimension keys are bare numeric ids like \"1\"'),\n  ValueSchema,\n);\n\nexport const SettingsSchema = z\n  .object({\n    siteId: z\n      .string()\n      .min(1)\n      .describe(\n        'Matomo Site ID (like 1, 2, etc.). Required when loadScript is true',\n      )\n      .optional(),\n    url: z\n      .string()\n      .url()\n      .describe(\n        'Base URL of your Matomo instance, normalized to one trailing slash (like https://analytics.example.com/ or https://yourname.matomo.cloud/). Required when loadScript is true',\n      )\n      .optional(),\n    disableCookies: z\n      .boolean()\n      .default(false)\n      .describe('Disable all tracking cookies for cookie-free analytics'),\n    enableLinkTracking: z\n      .boolean()\n      .default(true)\n      .describe('Enable automatic outlink and download tracking'),\n    enableHeartBeatTimer: z\n      .number()\n      .int()\n      .positive()\n      .optional()\n      .describe(\n        'Enable heart beat timer with interval in seconds for accurate time-on-page',\n      ),\n    customDimensions: CustomDimensionsSchema.describe(\n      'Custom dimensions applied to every hit, keyed by bare dimension id (like { \"1\": \"data.userType\" }). Each value is resolved per event. Rule-level customDimensions win per key.',\n    ).optional(),\n  })\n  .strict();\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { schemas, z } from '@walkeros/core/dev';\nimport { CustomDimensionsSchema } from './settings';\n\nexport const MappingSchema = z.object({\n  goalId: z\n    .union([\n      z.string().regex(/^[1-9]\\d*$/, 'Goal IDs are positive integers like \"1\"'),\n      z.number().int().positive(),\n    ])\n    .optional()\n    .describe(\n      'Matomo goal ID, a positive integer like 1. Adds a trackGoal conversion alongside this event',\n    ),\n  goalValue: schemas.ValueSchema.describe(\n    'Goal revenue, resolved from the event (like \"data.revenue\"), passed as the trackGoal revenue',\n  ).optional(),\n  siteSearch: z\n    .boolean()\n    .optional()\n    .describe('Track as internal site search using trackSiteSearch'),\n  contentImpression: z\n    .boolean()\n    .optional()\n    .describe('Track as content impression using trackContentImpression'),\n  contentInteraction: z\n    .boolean()\n    .optional()\n    .describe('Track as content interaction using trackContentInteraction'),\n  customDimensions: CustomDimensionsSchema.describe(\n    'Custom dimensions for this rule, keyed by bare dimension id (like { \"3\": \"data.category\" }). Set just before the hit and removed after it; wins per key over the destination customDimensions.',\n  ).optional(),\n});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * as env from './env';\nexport * as step from './step';\n","import type { Env } from '../types';\n\n/**\n * Example environment configurations for Matomo destination.\n * Mocks the _paq command queue for testing without requiring real browser\n * or network.\n */\n\nexport const init: Env | undefined = {\n  window: {\n    // _paq absent: init() is expected to install the queue.\n    location: { href: 'https://www.example.com/page' },\n  },\n};\n\nexport const push: Env = {\n  window: {\n    _paq: [],\n    location: { href: 'https://www.example.com/page' },\n  },\n};\n\n/**\n * Simulation tracking paths.\n * Specifies which function calls to track during simulation.\n */\nexport const simulation = [\n  'call:window._paq.push', // Track _paq.push calls\n];\n","import type { Flow } from '@walkeros/core';\nimport type { Settings } from '../types';\nimport { createEvent, getEvent } from '@walkeros/core';\n\n/**\n * Matomo step example. The test runner registers the destination with the\n * init example's config and merges an example's optional `settings` on top.\n */\nexport type StepExample = Flow.StepExample & {\n  /** Destination settings merged over the init example's settings. */\n  settings?: Settings;\n};\n\n/**\n * Destination bootstrap.\n * Given the canonical settings, init loads the Matomo script and configures\n * the tracker URL, site ID, and link tracking. Reproduce by passing the same\n * settings to `startFlow` as the destination config.\n */\nexport const init: StepExample = {\n  title: 'Initialization',\n  description:\n    'Destination bootstrap loads the Matomo tracker script and configures the tracker URL and site id.',\n  in: {\n    loadScript: true,\n    settings: {\n      siteId: '1',\n      url: 'https://analytics.example.com/',\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      ['setTrackerUrl', 'https://analytics.example.com/matomo.php'],\n    ],\n    ['_paq.push', ['setSiteId', '1']],\n    ['_paq.push', ['enableLinkTracking']],\n  ],\n};\n\n/**\n * Default page view -- no mapping name needed.\n * Destination auto-calls trackPageView with the page title.\n */\nexport const pageView: StepExample = {\n  title: 'Page view',\n  description:\n    'A page view is tracked in Matomo via trackPageView with the page title from event data.',\n  in: getEvent('page view', { timestamp: 1700000400 }),\n  mapping: {\n    data: 'data.title',\n  },\n  out: [['_paq.push', ['trackPageView', 'walkerOS documentation']]],\n};\n\n/**\n * Page view rule with a goal -- the default trackPageView stays and the goal\n * follows it.\n */\nexport const pageViewWithGoal: StepExample = {\n  title: 'Page view with goal',\n  description:\n    'A page view rule with a goal keeps the default trackPageView and adds a trackGoal conversion.',\n  in: getEvent('page view', { timestamp: 1700000407 }),\n  mapping: {\n    settings: {\n      goalId: '1',\n    },\n  },\n  out: [\n    ['_paq.push', ['trackPageView', 'walkerOS documentation']],\n    ['_paq.push', ['trackGoal', '1', undefined]],\n  ],\n};\n\n/**\n * Custom event tracking with goal conversion.\n * Uses trackEvent with mapped name, followed by trackGoal.\n */\nexport const customEvent: StepExample = {\n  title: 'Custom event with goal',\n  description:\n    'A promotion visible event fires Matomo trackEvent and then trackGoal to record a goal conversion.',\n  in: getEvent('promotion visible', { timestamp: 1700000401 }),\n  mapping: {\n    name: 'trackEvent',\n    settings: {\n      goalId: '1',\n    },\n    data: {\n      set: ['data.name', 'data.position'],\n    },\n  },\n  out: [\n    ['_paq.push', ['trackEvent', 'Setting up tracking easily', 'hero']],\n    ['_paq.push', ['trackGoal', '1', undefined]],\n  ],\n};\n\n/**\n * Ecommerce order -- one call with cart items array and order totals.\n * Not public: Matomo records an order's products only after an\n * addEcommerceItem call per product, which one rule cannot send, so this\n * shows mapping mechanics only.\n */\nexport const ecommerceOrder: StepExample = {\n  public: false,\n  title: 'Ecommerce order',\n  description:\n    \"Test fixture for nested product mapping, not a valid Matomo call: Matomo records an order's products only after an addEcommerceItem call per product.\",\n  in: getEvent('order complete', { timestamp: 1700000402 }),\n  mapping: {\n    name: 'trackEcommerceOrder',\n    data: {\n      set: [\n        {\n          loop: [\n            'nested',\n            {\n              condition: (entity: unknown) =>\n                typeof entity === 'object' &&\n                entity !== null &&\n                'entity' in entity &&\n                entity.entity === 'product',\n              map: {\n                sku: 'data.id',\n                name: 'data.name',\n                category: { value: '' },\n                price: 'data.price',\n                quantity: { value: 1 },\n              },\n            },\n          ],\n        },\n        {\n          map: {\n            orderId: 'data.id',\n            grandTotal: 'data.value',\n            tax: 'data.taxes',\n            shipping: 'data.shipping',\n          },\n        },\n      ],\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      [\n        'trackEcommerceOrder',\n        [\n          {\n            sku: 'ers',\n            name: 'Everyday Ruck Snack',\n            category: '',\n            price: 420,\n            quantity: 1,\n          },\n          {\n            sku: 'cc',\n            name: 'Cool Cap',\n            category: '',\n            price: 42,\n            quantity: 1,\n          },\n        ],\n        {\n          orderId: '0rd3r1d',\n          grandTotal: 555,\n          tax: 73.76,\n          shipping: 5.22,\n        },\n      ],\n    ],\n  ],\n};\n\n/**\n * Ecommerce cart update -- nested products and the cart total in one call.\n * Not public: Matomo takes trackEcommerceCartUpdate(grandTotal) after an\n * addEcommerceItem call per product, which one rule cannot send.\n */\nexport const ecommerceCartUpdate: StepExample = {\n  public: false,\n  title: 'Cart update',\n  description:\n    'Test fixture for nested product mapping, not a valid Matomo call: Matomo takes trackEcommerceCartUpdate(grandTotal) after an addEcommerceItem call per product.',\n  in: getEvent('cart view', { timestamp: 1700000403 }),\n  mapping: {\n    name: 'trackEcommerceCartUpdate',\n    data: {\n      set: [\n        {\n          loop: [\n            'nested',\n            {\n              condition: (entity: unknown) =>\n                typeof entity === 'object' &&\n                entity !== null &&\n                'entity' in entity &&\n                entity.entity === 'product',\n              map: {\n                sku: 'data.id',\n                name: 'data.name',\n                category: { value: '' },\n                price: 'data.price',\n                quantity: { value: 1 },\n              },\n            },\n          ],\n        },\n        'data.value',\n      ],\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      [\n        'trackEcommerceCartUpdate',\n        [\n          {\n            sku: 'ers',\n            name: 'Everyday Ruck Snack',\n            category: '',\n            price: 420,\n            quantity: 1,\n          },\n        ],\n        840,\n      ],\n    ],\n  ],\n};\n\n/**\n * Product detail view with a single product array.\n * Not public: Matomo has no ecommerceProductDetailView; it tracks a product\n * view with setEcommerceView followed by trackPageView, two commands.\n */\nexport const productDetailView: StepExample = {\n  public: false,\n  title: 'Product detail view',\n  description:\n    'Test fixture for a single-product mapping, not a valid Matomo call: Matomo tracks a product view with setEcommerceView followed by trackPageView.',\n  in: getEvent('product view', { timestamp: 1700000404 }),\n  mapping: {\n    name: 'ecommerceProductDetailView',\n    data: {\n      set: [\n        {\n          set: [\n            {\n              map: {\n                sku: 'data.id',\n                name: 'data.name',\n                price: 'data.price',\n                quantity: { value: 1 },\n              },\n            },\n          ],\n        },\n      ],\n    },\n  },\n  out: [\n    [\n      '_paq.push',\n      [\n        'ecommerceProductDetailView',\n        [\n          {\n            sku: 'ers',\n            name: 'Everyday Ruck Snack',\n            price: 420,\n            quantity: 1,\n          },\n        ],\n      ],\n    ],\n  ],\n};\n\n/**\n * Site search -- trackSiteSearch with keyword, category, result count.\n */\nexport const siteSearch: StepExample = {\n  title: 'Site search',\n  description:\n    'A search submit fires Matomo trackSiteSearch with the keyword, category, and number of results.',\n  in: createEvent({\n    name: 'search submit',\n    timestamp: 1700000405,\n    data: { query: 'shoes', category: 'products', resultsCount: 42 },\n  }),\n  mapping: {\n    name: 'trackSiteSearch',\n    settings: {\n      siteSearch: true,\n    },\n    data: {\n      set: ['data.query', 'data.category', 'data.resultsCount'],\n    },\n  },\n  out: [['_paq.push', ['trackSiteSearch', 'shoes', 'products', 42]]],\n};\n\n/**\n * Goal tracking alongside a tracked event.\n * Uses a known fixture event (promotion visible) so data paths resolve.\n */\nexport const goalTracking: StepExample = {\n  title: 'Goal with value',\n  description:\n    'A promotion event fires Matomo trackEvent and then trackGoal with a monetary goal value from event data.',\n  in: getEvent('promotion visible', {\n    timestamp: 1700000406,\n    data: { name: 'Setting up tracking easily', position: 'hero', value: 50 },\n  }),\n  mapping: {\n    name: 'trackEvent',\n    settings: {\n      goalId: '1',\n      goalValue: 'data.value',\n    },\n    data: {\n      set: ['data.name'],\n    },\n  },\n  out: [\n    ['_paq.push', ['trackEvent', 'Setting up tracking easily']],\n    ['_paq.push', ['trackGoal', '1', 50]],\n  ],\n};\n\n/**\n * Destination and rule custom dimensions, resolved per event. The destination\n * dimensions come from `settings`, which the docs do not show, so this\n * example stays out of them.\n */\nexport const customDimensions: StepExample = {\n  title: 'Custom dimensions',\n  description:\n    'Destination and rule custom dimensions are set right before the page view; afterwards the rule-only dimension is deleted and the destination value is set again.',\n  public: false,\n  in: getEvent('page view', { timestamp: 1700000408 }),\n  settings: {\n    customDimensions: { '1': 'globals.pagegroup' },\n  },\n  mapping: {\n    settings: {\n      customDimensions: { '2': 'data.id' },\n    },\n  },\n  out: [\n    ['_paq.push', ['setCustomDimension', 1, 'docs']],\n    ['_paq.push', ['setCustomDimension', 2, '/docs/']],\n    ['_paq.push', ['trackPageView', 'walkerOS documentation']],\n    ['_paq.push', ['deleteCustomDimension', 2]],\n    ['_paq.push', ['setCustomDimension', 1, 'docs']],\n  ],\n};\n\n/** A silent rule without a goal sends nothing. */\nexport const silentRule: StepExample = {\n  public: false,\n  description:\n    'A rule with silent: true and no goal sends no command, its dimensions included.',\n  in: getEvent('page view', { timestamp: 1700000300 }),\n  mapping: { silent: true },\n  out: [],\n};\n\n/**\n * An event no rule maps: Matomo has no command for it, so the push fails\n * instead of counting as delivered.\n */\nexport const unmappedEvent: StepExample = {\n  public: false,\n  description:\n    'An event without a rule name, a tracking flag or a goal, and not a page view, has no Matomo command: the push fails with missing-input.',\n  in: getEvent('product view', { timestamp: 1700000301 }),\n  out: [],\n  outcome: { status: 'failed', code: 'missing-input', retryable: false },\n};\n\n/**\n * A revocation of the consent the destination requires stops Matomo:\n * config.consent { marketing: true }, granted first, then revoked.\n */\nexport const consentRevoke: StepExample = {\n  public: false,\n  description:\n    'For a destination with config.consent { marketing: true }, revoking marketing pushes forgetConsentGiven, which stops every tracking request of the page, link tracking included.',\n  command: 'consent',\n  in: { marketing: false },\n  out: [['window._paq.push', ['forgetConsentGiven']]],\n};\n"],"mappings":"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","names":["schemas","z","z","schemas","init"]}

package/dist/examples/index.d.mts

@@ -29,23 +29,12 @@ interface Env extends DestinationWeb.Env {
             href?: string;
         };
     };
-    document: {
-        createElement: (tagName: string) => {
-            type: string;
-            src: string;
-            async?: boolean;
-            defer?: boolean;
-        };
-        head: {
-            appendChild: (node: unknown) => void;
-        };
-    };
 }
 
 /**
  * Example environment configurations for Matomo destination.
- * Mocks the _paq command queue and DOM elements for testing
- * without requiring real browser or network.
+ * Mocks the _paq command queue for testing without requiring real browser
+ * or network.
  */
 declare const init$1: Env | undefined;
 declare const push: Env;
@@ -125,8 +114,21 @@ declare const goalTracking: StepExample;
  * example stays out of them.
  */
 declare const customDimensions: StepExample;
+/** A silent rule without a goal sends nothing. */
+declare const silentRule: StepExample;
+/**
+ * An event no rule maps: Matomo has no command for it, so the push fails
+ * instead of counting as delivered.
+ */
+declare const unmappedEvent: StepExample;
+/**
+ * A revocation of the consent the destination requires stops Matomo:
+ * config.consent { marketing: true }, granted first, then revoked.
+ */
+declare const consentRevoke: StepExample;
 
 type step_StepExample = StepExample;
+declare const step_consentRevoke: typeof consentRevoke;
 declare const step_customDimensions: typeof customDimensions;
 declare const step_customEvent: typeof customEvent;
 declare const step_ecommerceCartUpdate: typeof ecommerceCartUpdate;
@@ -136,9 +138,11 @@ declare const step_init: typeof init;
 declare const step_pageView: typeof pageView;
 declare const step_pageViewWithGoal: typeof pageViewWithGoal;
 declare const step_productDetailView: typeof productDetailView;
+declare const step_silentRule: typeof silentRule;
 declare const step_siteSearch: typeof siteSearch;
+declare const step_unmappedEvent: typeof unmappedEvent;
 declare namespace step {
-  export { type step_StepExample as StepExample, step_customDimensions as customDimensions, step_customEvent as customEvent, step_ecommerceCartUpdate as ecommerceCartUpdate, step_ecommerceOrder as ecommerceOrder, step_goalTracking as goalTracking, step_init as init, step_pageView as pageView, step_pageViewWithGoal as pageViewWithGoal, step_productDetailView as productDetailView, step_siteSearch as siteSearch };
+  export { type step_StepExample as StepExample, step_consentRevoke as consentRevoke, step_customDimensions as customDimensions, step_customEvent as customEvent, step_ecommerceCartUpdate as ecommerceCartUpdate, step_ecommerceOrder as ecommerceOrder, step_goalTracking as goalTracking, step_init as init, step_pageView as pageView, step_pageViewWithGoal as pageViewWithGoal, step_productDetailView as productDetailView, step_silentRule as silentRule, step_siteSearch as siteSearch, step_unmappedEvent as unmappedEvent };
 }
 
 export { env, step };