@walkeros/web-destination-matomo 4.7.2 → 4.8.0-next-1791441510508

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @walkeros/web-destination-matomo
 
+## 4.8.0-next-1791441510508
+
+### Patch Changes
+
+- 5593d7b: The ecommerce step examples are no longer published in the docs, and
+  their descriptions say they are test fixtures. Matomo needs an
+  `addEcommerceItem` call per product before a cart update, and before an order
+  to record its products, and tracks a product view as `setEcommerceView`
+  followed by a page view. One rule sends one command.
+- 5593d7b: The ecommerce step examples now test for a product entity without a
+  package helper. The published condition, shown in the docs and returned by
+  `package_get`, referenced a minified import and threw when copied into a flow;
+  it now runs on its own.
+- Updated dependencies [5593d7b]
+  - @walkeros/core@4.8.0-next-1791441510508
+  - @walkeros/web-core@4.8.0-next-1791441510508
+
 ## 4.7.2
 
 ### Patch Changes

package/README.md

@@ -32,7 +32,13 @@ npm install @walkeros/web-destination-matomo
       "destinations": {
         "matomo": {
           "package": "@walkeros/web-destination-matomo",
-          "config": {}
+          "config": {
+            "loadScript": true,
+            "settings": {
+              "siteId": "1",
+              "url": "https://analytics.example.com/"
+            }
+          }
         }
       }
     }

package/dist/dev.d.mts

@@ -127,15 +127,21 @@ declare const pageViewWithGoal: StepExample;
 declare const customEvent: StepExample;
 /**
  * Ecommerce order -- one call with cart items array and order totals.
+ * Not public: Matomo records an order's products only after an
+ * addEcommerceItem call per product, which one rule cannot send, so this
+ * shows mapping mechanics only.
  */
 declare const ecommerceOrder: StepExample;
 /**
- * Ecommerce cart update -- addEcommerceItem per nested product,
- * then trackEcommerceCartUpdate with cart total.
+ * Ecommerce cart update -- nested products and the cart total in one call.
+ * Not public: Matomo takes trackEcommerceCartUpdate(grandTotal) after an
+ * addEcommerceItem call per product, which one rule cannot send.
  */
 declare const ecommerceCartUpdate: StepExample;
 /**
- * Product detail view -- setEcommerceView equivalent with a single product array.
+ * Product detail view with a single product array.
+ * Not public: Matomo has no ecommerceProductDetailView; it tracks a product
+ * view with setEcommerceView followed by trackPageView, two commands.
  */
 declare const productDetailView: StepExample;
 /**

package/dist/dev.d.ts

@@ -127,15 +127,21 @@ declare const pageViewWithGoal: StepExample;
 declare const customEvent: StepExample;
 /**
  * Ecommerce order -- one call with cart items array and order totals.
+ * Not public: Matomo records an order's products only after an
+ * addEcommerceItem call per product, which one rule cannot send, so this
+ * shows mapping mechanics only.
  */
 declare const ecommerceOrder: StepExample;
 /**
- * Ecommerce cart update -- addEcommerceItem per nested product,
- * then trackEcommerceCartUpdate with cart total.
+ * Ecommerce cart update -- nested products and the cart total in one call.
+ * Not public: Matomo takes trackEcommerceCartUpdate(grandTotal) after an
+ * addEcommerceItem call per product, which one rule cannot send.
  */
 declare const ecommerceCartUpdate: StepExample;
 /**
- * Product detail view -- setEcommerceView equivalent with a single product array.
+ * Product detail view with a single product array.
+ * Not public: Matomo has no ecommerceProductDetailView; it tracks a product
+ * view with setEcommerceView followed by trackPageView, two commands.
  */
 declare const productDetailView: StepExample;
 /**

package/dist/dev.js

@@ -1 +1 @@
-"use strict";var e,t=Object.defineProperty,a=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,o=Object.prototype.hasOwnProperty,r=(e,a)=>{for(var i in a)t(e,i,{get:a[i],enumerable:!0})},n={};r(n,{examples:()=>v,schemas:()=>s}),module.exports=(e=n,((e,r,n,s)=>{if(r&&"object"==typeof r||"function"==typeof r)for(let c of i(r))o.call(e,c)||c===n||t(e,c,{get:()=>r[c],enumerable:!(s=a(r,c))||s.enumerable});return e})(t({},"__esModule",{value:!0}),e));var s={};r(s,{MappingSchema:()=>g,SettingsSchema:()=>l,mapping:()=>k,settings:()=>h});var c=require("@walkeros/core/dev"),p=require("@walkeros/core/dev"),{ValueSchema:d}=p.schemas,m=p.z.record(p.z.string().regex(/^\d+$/,'Dimension keys are bare numeric ids like "1"'),d),l=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:m.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:m.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)(l),k=(0,c.zodToSchema)(g),v={};r(v,{env:()=>w,step:()=>S});var w={};r(w,{init:()=>y,push:()=>b,simulation:()=>q});var y={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:()=>{}}}},q=["call:window._paq.push"],S={};r(S,{customDimensions:()=>M,customEvent:()=>C,ecommerceCartUpdate:()=>I,ecommerceOrder:()=>z,goalTracking:()=>V,init:()=>E,pageView:()=>D,pageViewWithGoal:()=>_,productDetailView:()=>O,siteSearch:()=>P});var f=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"]]]},D={title:"Page view",description:"A page view is tracked in Matomo via trackPageView with the page title from event data.",in:(0,f.getEvent)("page view",{timestamp:1700000400}),mapping:{data:"data.title"},out:[["_paq.push",["trackPageView","walkerOS documentation"]]]},_={title:"Page view with goal",description:"A page view rule with a goal keeps the default trackPageView and adds a trackGoal conversion.",in:(0,f.getEvent)("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:(0,f.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={title:"Ecommerce order",description:"A completed order calls Matomo trackEcommerceOrder with line items and order totals.",in:(0,f.getEvent)("order complete",{timestamp:1700000402}),mapping:{name:"trackEcommerceOrder",data:{set:[{loop:["nested",{condition:e=>(0,f.isObject)(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={title:"Cart update",description:"A cart view calls Matomo trackEcommerceCartUpdate with the nested product items and cart total.",in:(0,f.getEvent)("cart view",{timestamp:1700000403}),mapping:{name:"trackEcommerceCartUpdate",data:{set:[{loop:["nested",{condition:e=>(0,f.isObject)(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]]]},O={title:"Product detail view",description:"A product view fires Matomo ecommerceProductDetailView with a single-product array.",in:(0,f.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}]]]]},P={title:"Site search",description:"A search submit fires Matomo trackSiteSearch with the keyword, category, and number of results.",in:(0,f.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,f.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]]]},M={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,f.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:()=>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

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, isObject } 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 */\nexport const ecommerceOrder: StepExample = {\n  title: 'Ecommerce order',\n  description:\n    'A completed order calls Matomo trackEcommerceOrder with line items and order totals.',\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                isObject(entity) && 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 -- addEcommerceItem per nested product,\n * then trackEcommerceCartUpdate with cart total.\n */\nexport const ecommerceCartUpdate: StepExample = {\n  title: 'Cart update',\n  description:\n    'A cart view calls Matomo trackEcommerceCartUpdate with the nested product items and cart total.',\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                isObject(entity) && 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 -- setEcommerceView equivalent with a single product array.\n */\nexport const productDetailView: StepExample = {\n  title: 'Product detail view',\n  description:\n    'A product view fires Matomo ecommerceProductDetailView with a single-product array.',\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.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"]}

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 r}from"@walkeros/core/dev";var{ValueSchema:n}=o,s=r.record(r.string().regex(/^\d+$/,'Dimension keys are bare numeric ids like "1"'),n),c=r.object({siteId:r.string().min(1).describe("Matomo Site ID (like 1, 2, etc.). Required when loadScript is true").optional(),url:r.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:r.boolean().default(!1).describe("Disable all tracking cookies for cookie-free analytics"),enableLinkTracking:r.boolean().default(!0).describe("Enable automatic outlink and download tracking"),enableHeartBeatTimer:r.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:()=>G,customEvent:()=>D,ecommerceCartUpdate:()=>_,ecommerceOrder:()=>E,goalTracking:()=>x,init:()=>S,pageView:()=>f,pageViewWithGoal:()=>C,productDetailView:()=>I,siteSearch:()=>V});import{getEvent as b,isObject as q}from"@walkeros/core";var 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"]]]},f={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"]]]},C={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]]]},D={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]]]},E={title:"Ecommerce order",description:"A completed order calls Matomo trackEcommerceOrder with line items and order totals.",in:b("order complete",{timestamp:1700000402}),mapping:{name:"trackEcommerceOrder",data:{set:[{loop:["nested",{condition:e=>q(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}]]]},_={title:"Cart update",description:"A cart view calls Matomo trackEcommerceCartUpdate with the nested product items and cart total.",in:b("cart view",{timestamp:1700000403}),mapping:{name:"trackEcommerceCartUpdate",data:{set:[{loop:["nested",{condition:e=>q(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={title:"Product detail view",description:"A product view fires Matomo ecommerceProductDetailView with a single-product array.",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}]]]]},V={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]]]},x={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]]]},G={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()});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

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, isObject } 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 */\nexport const ecommerceOrder: StepExample = {\n  title: 'Ecommerce order',\n  description:\n    'A completed order calls Matomo trackEcommerceOrder with line items and order totals.',\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                isObject(entity) && 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 -- addEcommerceItem per nested product,\n * then trackEcommerceCartUpdate with cart total.\n */\nexport const ecommerceCartUpdate: StepExample = {\n  title: 'Cart update',\n  description:\n    'A cart view calls Matomo trackEcommerceCartUpdate with the nested product items and cart total.',\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                isObject(entity) && 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 -- setEcommerceView equivalent with a single product array.\n */\nexport const productDetailView: StepExample = {\n  title: 'Product detail view',\n  description:\n    'A product view fires Matomo ecommerceProductDetailView with a single-product array.',\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.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"]}

package/dist/examples/index.d.mts

@@ -93,15 +93,21 @@ declare const pageViewWithGoal: StepExample;
 declare const customEvent: StepExample;
 /**
  * Ecommerce order -- one call with cart items array and order totals.
+ * Not public: Matomo records an order's products only after an
+ * addEcommerceItem call per product, which one rule cannot send, so this
+ * shows mapping mechanics only.
  */
 declare const ecommerceOrder: StepExample;
 /**
- * Ecommerce cart update -- addEcommerceItem per nested product,
- * then trackEcommerceCartUpdate with cart total.
+ * Ecommerce cart update -- nested products and the cart total in one call.
+ * Not public: Matomo takes trackEcommerceCartUpdate(grandTotal) after an
+ * addEcommerceItem call per product, which one rule cannot send.
  */
 declare const ecommerceCartUpdate: StepExample;
 /**
- * Product detail view -- setEcommerceView equivalent with a single product array.
+ * Product detail view with a single product array.
+ * Not public: Matomo has no ecommerceProductDetailView; it tracks a product
+ * view with setEcommerceView followed by trackPageView, two commands.
  */
 declare const productDetailView: StepExample;
 /**

package/dist/examples/index.d.ts

@@ -93,15 +93,21 @@ declare const pageViewWithGoal: StepExample;
 declare const customEvent: StepExample;
 /**
  * Ecommerce order -- one call with cart items array and order totals.
+ * Not public: Matomo records an order's products only after an
+ * addEcommerceItem call per product, which one rule cannot send, so this
+ * shows mapping mechanics only.
  */
 declare const ecommerceOrder: StepExample;
 /**
- * Ecommerce cart update -- addEcommerceItem per nested product,
- * then trackEcommerceCartUpdate with cart total.
+ * Ecommerce cart update -- nested products and the cart total in one call.
+ * Not public: Matomo takes trackEcommerceCartUpdate(grandTotal) after an
+ * addEcommerceItem call per product, which one rule cannot send.
  */
 declare const ecommerceCartUpdate: StepExample;
 /**
- * Product detail view -- setEcommerceView equivalent with a single product array.
+ * Product detail view with a single product array.
+ * Not public: Matomo has no ecommerceProductDetailView; it tracks a product
+ * view with setEcommerceView followed by trackPageView, two commands.
  */
 declare const productDetailView: StepExample;
 /**

package/dist/examples/index.js

@@ -145,8 +145,9 @@ var customEvent = {
   ]
 };
 var ecommerceOrder = {
+  public: false,
   title: "Ecommerce order",
-  description: "A completed order calls Matomo trackEcommerceOrder with line items and order totals.",
+  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, import_core.getEvent)("order complete", { timestamp: 1700000402 }),
   mapping: {
     name: "trackEcommerceOrder",
@@ -156,7 +157,7 @@ var ecommerceOrder = {
           loop: [
             "nested",
             {
-              condition: (entity) => (0, import_core.isObject)(entity) && entity.entity === "product",
+              condition: (entity) => typeof entity === "object" && entity !== null && "entity" in entity && entity.entity === "product",
               map: {
                 sku: "data.id",
                 name: "data.name",
@@ -210,8 +211,9 @@ var ecommerceOrder = {
   ]
 };
 var ecommerceCartUpdate = {
+  public: false,
   title: "Cart update",
-  description: "A cart view calls Matomo trackEcommerceCartUpdate with the nested product items and cart total.",
+  description: "Test fixture for nested product mapping, not a valid Matomo call: Matomo takes trackEcommerceCartUpdate(grandTotal) after an addEcommerceItem call per product.",
   in: (0, import_core.getEvent)("cart view", { timestamp: 1700000403 }),
   mapping: {
     name: "trackEcommerceCartUpdate",
@@ -221,7 +223,7 @@ var ecommerceCartUpdate = {
           loop: [
             "nested",
             {
-              condition: (entity) => (0, import_core.isObject)(entity) && entity.entity === "product",
+              condition: (entity) => typeof entity === "object" && entity !== null && "entity" in entity && entity.entity === "product",
               map: {
                 sku: "data.id",
                 name: "data.name",
@@ -256,8 +258,9 @@ var ecommerceCartUpdate = {
   ]
 };
 var productDetailView = {
+  public: false,
   title: "Product detail view",
-  description: "A product view fires Matomo ecommerceProductDetailView with a single-product array.",
+  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, import_core.getEvent)("product view", { timestamp: 1700000404 }),
   mapping: {
     name: "ecommerceProductDetailView",

package/dist/examples/index.mjs

@@ -62,7 +62,7 @@ __export(step_exports, {
   productDetailView: () => productDetailView,
   siteSearch: () => siteSearch
 });
-import { getEvent, isObject } from "@walkeros/core";
+import { getEvent } from "@walkeros/core";
 var init2 = {
   title: "Initialization",
   description: "Destination bootstrap loads the Matomo tracker script and configures the tracker URL and site id.",
@@ -124,8 +124,9 @@ var customEvent = {
   ]
 };
 var ecommerceOrder = {
+  public: false,
   title: "Ecommerce order",
-  description: "A completed order calls Matomo trackEcommerceOrder with line items and order totals.",
+  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: getEvent("order complete", { timestamp: 1700000402 }),
   mapping: {
     name: "trackEcommerceOrder",
@@ -135,7 +136,7 @@ var ecommerceOrder = {
           loop: [
             "nested",
             {
-              condition: (entity) => isObject(entity) && entity.entity === "product",
+              condition: (entity) => typeof entity === "object" && entity !== null && "entity" in entity && entity.entity === "product",
               map: {
                 sku: "data.id",
                 name: "data.name",
@@ -189,8 +190,9 @@ var ecommerceOrder = {
   ]
 };
 var ecommerceCartUpdate = {
+  public: false,
   title: "Cart update",
-  description: "A cart view calls Matomo trackEcommerceCartUpdate with the nested product items and cart total.",
+  description: "Test fixture for nested product mapping, not a valid Matomo call: Matomo takes trackEcommerceCartUpdate(grandTotal) after an addEcommerceItem call per product.",
   in: getEvent("cart view", { timestamp: 1700000403 }),
   mapping: {
     name: "trackEcommerceCartUpdate",
@@ -200,7 +202,7 @@ var ecommerceCartUpdate = {
           loop: [
             "nested",
             {
-              condition: (entity) => isObject(entity) && entity.entity === "product",
+              condition: (entity) => typeof entity === "object" && entity !== null && "entity" in entity && entity.entity === "product",
               map: {
                 sku: "data.id",
                 name: "data.name",
@@ -235,8 +237,9 @@ var ecommerceCartUpdate = {
   ]
 };
 var productDetailView = {
+  public: false,
   title: "Product detail view",
-  description: "A product view fires Matomo ecommerceProductDetailView with a single-product array.",
+  description: "Test fixture for a single-product mapping, not a valid Matomo call: Matomo tracks a product view with setEcommerceView followed by trackPageView.",
   in: getEvent("product view", { timestamp: 1700000404 }),
   mapping: {
     name: "ecommerceProductDetailView",

package/dist/walkerOS.json

@@ -1,7 +1,7 @@
 {
   "$meta": {
     "package": "@walkeros/web-destination-matomo",
-    "version": "4.7.2",
+    "version": "4.8.0-next-1791441510508",
     "type": "destination",
     "platform": [
       "web"
@@ -505,7 +505,7 @@
           "consent": {
             "functional": true
           },
-          "id": "7a4349b3f95f68f5",
+          "id": "94575fd559d320b0",
           "trigger": "load",
           "entity": "page",
           "action": "view",
@@ -608,7 +608,7 @@
           "consent": {
             "functional": true
           },
-          "id": "668fa4b2b68ba1f0",
+          "id": "46b5e3e256ba7a54",
           "trigger": "visible",
           "entity": "promotion",
           "action": "visible",
@@ -653,8 +653,9 @@
         ]
       },
       "ecommerceCartUpdate": {
+        "public": false,
         "title": "Cart update",
-        "description": "A cart view calls Matomo trackEcommerceCartUpdate with the nested product items and cart total.",
+        "description": "Test fixture for nested product mapping, not a valid Matomo call: Matomo takes trackEcommerceCartUpdate(grandTotal) after an addEcommerceItem call per product.",
         "in": {
           "name": "cart view",
           "data": {
@@ -701,7 +702,7 @@
           "consent": {
             "functional": true
           },
-          "id": "524b3c3e4a17e030",
+          "id": "22fedc6f4ce95d40",
           "trigger": "load",
           "entity": "cart",
           "action": "view",
@@ -723,7 +724,7 @@
                   "nested",
                   {
                     "condition": {
-                      "$code": "e=>q(e)&&\"product\"===e.entity"
+                      "$code": "e=>\"object\"==typeof e&&null!==e&&\"entity\"in e&&\"product\"===e.entity"
                     },
                     "map": {
                       "sku": "data.id",
@@ -763,8 +764,9 @@
         ]
       },
       "ecommerceOrder": {
+        "public": false,
         "title": "Ecommerce order",
-        "description": "A completed order calls Matomo trackEcommerceOrder with line items and order totals.",
+        "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": {
           "name": "order complete",
           "data": {
@@ -842,7 +844,7 @@
           "consent": {
             "functional": true
           },
-          "id": "9a1513236db9b3f9",
+          "id": "2f43be8f2ff02e46",
           "trigger": "load",
           "entity": "order",
           "action": "complete",
@@ -864,7 +866,7 @@
                   "nested",
                   {
                     "condition": {
-                      "$code": "e=>q(e)&&\"product\"===e.entity"
+                      "$code": "e=>\"object\"==typeof e&&null!==e&&\"entity\"in e&&\"product\"===e.entity"
                     },
                     "map": {
                       "sku": "data.id",
@@ -960,7 +962,7 @@
           "consent": {
             "functional": true
           },
-          "id": "e199612be29e650b",
+          "id": "0fc83d09ba2ed0cd",
           "trigger": "visible",
           "entity": "promotion",
           "action": "visible",
@@ -1077,7 +1079,7 @@
           "consent": {
             "functional": true
           },
-          "id": "470ec9668a6eb173",
+          "id": "ec37329de0634822",
           "trigger": "load",
           "entity": "page",
           "action": "view",
@@ -1144,7 +1146,7 @@
           "consent": {
             "functional": true
           },
-          "id": "a2755b4b53383b31",
+          "id": "17612bd512e5eec9",
           "trigger": "load",
           "entity": "page",
           "action": "view",
@@ -1181,8 +1183,9 @@
         ]
       },
       "productDetailView": {
+        "public": false,
         "title": "Product detail view",
-        "description": "A product view fires Matomo ecommerceProductDetailView with a single-product array.",
+        "description": "Test fixture for a single-product mapping, not a valid Matomo call: Matomo tracks a product view with setEcommerceView followed by trackPageView.",
         "in": {
           "name": "product view",
           "data": {
@@ -1213,7 +1216,7 @@
           "consent": {
             "functional": true
           },
-          "id": "438f500006f29924",
+          "id": "156be12ec7a70312",
           "trigger": "load",
           "entity": "product",
           "action": "view",
@@ -1302,7 +1305,7 @@
           "consent": {
             "functional": true
           },
-          "id": "eaf3946c76e82555",
+          "id": "1f9bc32bcfe728ef",
           "trigger": "test",
           "entity": "search",
           "action": "submit",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walkeros/web-destination-matomo",
   "description": "Matomo web destination for walkerOS",
-  "version": "4.7.2",
+  "version": "4.8.0-next-1791441510508",
   "license": "MIT",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -38,11 +38,11 @@
     "update": "npx npm-check-updates -u && npm update"
   },
   "dependencies": {
-    "@walkeros/core": "4.7.2",
-    "@walkeros/web-core": "4.7.2"
+    "@walkeros/core": "4.8.0-next-1791441510508",
+    "@walkeros/web-core": "4.8.0-next-1791441510508"
   },
   "devDependencies": {
-    "@walkeros/collector": "4.7.2"
+    "@walkeros/collector": "4.8.0-next-1791441510508"
   },
   "repository": {
     "url": "git+https://github.com/elbwalker/walkerOS.git",