@walkeros/web-destination-matomo 3.4.0-next-1776749829492

package/README.md

@@ -0,0 +1,66 @@
+# @walkeros/web-destination-matomo
+
+Matomo web destination for [walkerOS](https://github.com/elbwalker/walkerOS).
+Forwards browser events to a self-hosted or cloud Matomo instance via the
+`_paq.push()` command queue with support for page views, custom events,
+ecommerce, goals, site search, content tracking, and custom dimensions.
+
+## Installation
+
+```bash
+npm install @walkeros/web-destination-matomo
+```
+
+## Quick Start
+
+```json
+{
+  "destinations": {
+    "matomo": {
+      "package": "@walkeros/web-destination-matomo",
+      "config": {
+        "loadScript": true,
+        "settings": {
+          "siteId": "1",
+          "url": "https://analytics.example.com/"
+        }
+      }
+    }
+  }
+}
+```
+
+## Settings
+
+| Setting                | Type    | Required | Default | Description                                         |
+| ---------------------- | ------- | -------- | ------- | --------------------------------------------------- |
+| `siteId`               | string  | Yes      | --      | Matomo Site ID                                      |
+| `url`                  | string  | Yes      | --      | Base URL of your Matomo instance                    |
+| `disableCookies`       | boolean | No       | `false` | Disable tracking cookies for cookie-free analytics  |
+| `enableLinkTracking`   | boolean | No       | `true`  | Auto-track outlinks and downloads                   |
+| `enableHeartBeatTimer` | number  | No       | --      | Heart beat timer interval in seconds                |
+| `customDimensions`     | Record  | No       | --      | Visit-scope custom dimensions (ID to property path) |
+
+## Mapping Settings
+
+Per-event mapping settings control specialized tracking methods:
+
+| Setting              | Type    | Effect                                        |
+| -------------------- | ------- | --------------------------------------------- |
+| `goalId`             | string  | Fire `trackGoal` alongside the event          |
+| `goalValue`          | string  | Property path for goal revenue value          |
+| `siteSearch`         | boolean | Use `trackSiteSearch` instead of `trackEvent` |
+| `contentImpression`  | boolean | Use `trackContentImpression`                  |
+| `contentInteraction` | boolean | Use `trackContentInteraction`                 |
+| `customDimensions`   | Record  | Action-scope custom dimensions per event      |
+
+## Event Mapping
+
+| walkerOS Event   | Matomo Method                | Notes                                               |
+| ---------------- | ---------------------------- | --------------------------------------------------- |
+| `page view`      | `trackPageView`              | Default, no mapping needed                          |
+| Any event        | `trackEvent`                 | Default for non-page-view events via `mapping.name` |
+| `order complete` | `trackEcommerceOrder`        | Via `mapping.name`                                  |
+| `cart *`         | `trackEcommerceCartUpdate`   | Via `mapping.name`                                  |
+| `product view`   | `ecommerceProductDetailView` | Via `mapping.name`                                  |
+| `search *`       | `trackSiteSearch`            | Via `mapping.settings.siteSearch`                   |

package/dist/dev.d.mts

@@ -0,0 +1,141 @@
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+import { z } from '@walkeros/core/dev';
+import { DestinationWeb } from '@walkeros/web-core';
+import { Flow } from '@walkeros/core';
+
+declare const SettingsSchema: z.ZodObject<{
+    siteId: z.ZodString;
+    url: z.ZodString;
+    disableCookies: z.ZodDefault<z.ZodBoolean>;
+    enableLinkTracking: z.ZodDefault<z.ZodBoolean>;
+    enableHeartBeatTimer: z.ZodOptional<z.ZodNumber>;
+    customDimensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+type Settings = z.infer<typeof SettingsSchema>;
+
+declare const MappingSchema: z.ZodObject<{
+    goalId: z.ZodOptional<z.ZodString>;
+    goalValue: z.ZodOptional<z.ZodString>;
+    siteSearch: z.ZodOptional<z.ZodBoolean>;
+    contentImpression: z.ZodOptional<z.ZodBoolean>;
+    contentInteraction: z.ZodOptional<z.ZodBoolean>;
+    customDimensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+type Mapping = z.infer<typeof MappingSchema>;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+declare const mapping: _walkeros_core_dev.JSONSchema;
+
+type index$1_Mapping = Mapping;
+declare const index$1_MappingSchema: typeof MappingSchema;
+type index$1_Settings = Settings;
+declare const index$1_SettingsSchema: typeof SettingsSchema;
+declare const index$1_mapping: typeof mapping;
+declare const index$1_settings: typeof settings;
+declare namespace index$1 {
+  export { type index$1_Mapping as Mapping, index$1_MappingSchema as MappingSchema, type index$1_Settings as Settings, index$1_SettingsSchema as SettingsSchema, index$1_mapping as mapping, index$1_settings as settings };
+}
+
+declare global {
+    interface Window {
+        _paq?: Array<unknown>;
+    }
+}
+interface Env extends DestinationWeb.Env {
+    window: {
+        _paq: Array<unknown>;
+        location?: {
+            href?: string;
+        };
+    };
+    document: {
+        createElement: (tagName: string) => {
+            type: string;
+            src: string;
+            async?: boolean;
+            defer?: boolean;
+        };
+        head: {
+            appendChild: (node: unknown) => void;
+        };
+    };
+}
+
+/**
+ * Example environment configurations for Matomo destination.
+ * Mocks the _paq command queue and DOM elements for testing
+ * without requiring real browser or network.
+ */
+declare const init$1: Env | undefined;
+declare const push: Env;
+/**
+ * Simulation tracking paths.
+ * Specifies which function calls to track during simulation.
+ */
+declare const simulation: string[];
+
+declare const env_push: typeof push;
+declare const env_simulation: typeof simulation;
+declare namespace env {
+  export { init$1 as init, env_push as push, env_simulation as simulation };
+}
+
+/**
+ * Destination bootstrap.
+ * Given the canonical settings, init loads the Matomo script and configures
+ * the tracker URL, site ID, and link tracking. Reproduce by passing the same
+ * settings to `startFlow` as the destination config.
+ */
+declare const init: Flow.StepExample;
+/**
+ * Default page view -- no mapping name needed.
+ * Destination auto-calls trackPageView with the page title.
+ */
+declare const pageView: Flow.StepExample;
+/**
+ * Custom event tracking with goal conversion.
+ * Uses trackEvent with mapped name, followed by trackGoal.
+ */
+declare const customEvent: Flow.StepExample;
+/**
+ * Ecommerce order -- one call with cart items array and order totals.
+ */
+declare const ecommerceOrder: Flow.StepExample;
+/**
+ * Ecommerce cart update -- addEcommerceItem per nested product,
+ * then trackEcommerceCartUpdate with cart total.
+ */
+declare const ecommerceCartUpdate: Flow.StepExample;
+/**
+ * Product detail view -- setEcommerceView equivalent with a single product array.
+ */
+declare const productDetailView: Flow.StepExample;
+/**
+ * Site search -- trackSiteSearch with keyword, category, result count.
+ */
+declare const siteSearch: Flow.StepExample;
+/**
+ * Goal tracking alongside a tracked event.
+ * Uses a known fixture event (promotion visible) so data paths resolve.
+ */
+declare const goalTracking: Flow.StepExample;
+
+declare const step_customEvent: typeof customEvent;
+declare const step_ecommerceCartUpdate: typeof ecommerceCartUpdate;
+declare const step_ecommerceOrder: typeof ecommerceOrder;
+declare const step_goalTracking: typeof goalTracking;
+declare const step_init: typeof init;
+declare const step_pageView: typeof pageView;
+declare const step_productDetailView: typeof productDetailView;
+declare const step_siteSearch: typeof siteSearch;
+declare namespace step {
+  export { step_customEvent as customEvent, step_ecommerceCartUpdate as ecommerceCartUpdate, step_ecommerceOrder as ecommerceOrder, step_goalTracking as goalTracking, step_init as init, step_pageView as pageView, step_productDetailView as productDetailView, step_siteSearch as siteSearch };
+}
+
+declare const index_env: typeof env;
+declare const index_step: typeof step;
+declare namespace index {
+  export { index_env as env, index_step as step };
+}
+
+export { index as examples, index$1 as schemas };

package/dist/dev.d.ts

@@ -0,0 +1,141 @@
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+import { z } from '@walkeros/core/dev';
+import { DestinationWeb } from '@walkeros/web-core';
+import { Flow } from '@walkeros/core';
+
+declare const SettingsSchema: z.ZodObject<{
+    siteId: z.ZodString;
+    url: z.ZodString;
+    disableCookies: z.ZodDefault<z.ZodBoolean>;
+    enableLinkTracking: z.ZodDefault<z.ZodBoolean>;
+    enableHeartBeatTimer: z.ZodOptional<z.ZodNumber>;
+    customDimensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+type Settings = z.infer<typeof SettingsSchema>;
+
+declare const MappingSchema: z.ZodObject<{
+    goalId: z.ZodOptional<z.ZodString>;
+    goalValue: z.ZodOptional<z.ZodString>;
+    siteSearch: z.ZodOptional<z.ZodBoolean>;
+    contentImpression: z.ZodOptional<z.ZodBoolean>;
+    contentInteraction: z.ZodOptional<z.ZodBoolean>;
+    customDimensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+type Mapping = z.infer<typeof MappingSchema>;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+declare const mapping: _walkeros_core_dev.JSONSchema;
+
+type index$1_Mapping = Mapping;
+declare const index$1_MappingSchema: typeof MappingSchema;
+type index$1_Settings = Settings;
+declare const index$1_SettingsSchema: typeof SettingsSchema;
+declare const index$1_mapping: typeof mapping;
+declare const index$1_settings: typeof settings;
+declare namespace index$1 {
+  export { type index$1_Mapping as Mapping, index$1_MappingSchema as MappingSchema, type index$1_Settings as Settings, index$1_SettingsSchema as SettingsSchema, index$1_mapping as mapping, index$1_settings as settings };
+}
+
+declare global {
+    interface Window {
+        _paq?: Array<unknown>;
+    }
+}
+interface Env extends DestinationWeb.Env {
+    window: {
+        _paq: Array<unknown>;
+        location?: {
+            href?: string;
+        };
+    };
+    document: {
+        createElement: (tagName: string) => {
+            type: string;
+            src: string;
+            async?: boolean;
+            defer?: boolean;
+        };
+        head: {
+            appendChild: (node: unknown) => void;
+        };
+    };
+}
+
+/**
+ * Example environment configurations for Matomo destination.
+ * Mocks the _paq command queue and DOM elements for testing
+ * without requiring real browser or network.
+ */
+declare const init$1: Env | undefined;
+declare const push: Env;
+/**
+ * Simulation tracking paths.
+ * Specifies which function calls to track during simulation.
+ */
+declare const simulation: string[];
+
+declare const env_push: typeof push;
+declare const env_simulation: typeof simulation;
+declare namespace env {
+  export { init$1 as init, env_push as push, env_simulation as simulation };
+}
+
+/**
+ * Destination bootstrap.
+ * Given the canonical settings, init loads the Matomo script and configures
+ * the tracker URL, site ID, and link tracking. Reproduce by passing the same
+ * settings to `startFlow` as the destination config.
+ */
+declare const init: Flow.StepExample;
+/**
+ * Default page view -- no mapping name needed.
+ * Destination auto-calls trackPageView with the page title.
+ */
+declare const pageView: Flow.StepExample;
+/**
+ * Custom event tracking with goal conversion.
+ * Uses trackEvent with mapped name, followed by trackGoal.
+ */
+declare const customEvent: Flow.StepExample;
+/**
+ * Ecommerce order -- one call with cart items array and order totals.
+ */
+declare const ecommerceOrder: Flow.StepExample;
+/**
+ * Ecommerce cart update -- addEcommerceItem per nested product,
+ * then trackEcommerceCartUpdate with cart total.
+ */
+declare const ecommerceCartUpdate: Flow.StepExample;
+/**
+ * Product detail view -- setEcommerceView equivalent with a single product array.
+ */
+declare const productDetailView: Flow.StepExample;
+/**
+ * Site search -- trackSiteSearch with keyword, category, result count.
+ */
+declare const siteSearch: Flow.StepExample;
+/**
+ * Goal tracking alongside a tracked event.
+ * Uses a known fixture event (promotion visible) so data paths resolve.
+ */
+declare const goalTracking: Flow.StepExample;
+
+declare const step_customEvent: typeof customEvent;
+declare const step_ecommerceCartUpdate: typeof ecommerceCartUpdate;
+declare const step_ecommerceOrder: typeof ecommerceOrder;
+declare const step_goalTracking: typeof goalTracking;
+declare const step_init: typeof init;
+declare const step_pageView: typeof pageView;
+declare const step_productDetailView: typeof productDetailView;
+declare const step_siteSearch: typeof siteSearch;
+declare namespace step {
+  export { step_customEvent as customEvent, step_ecommerceCartUpdate as ecommerceCartUpdate, step_ecommerceOrder as ecommerceOrder, step_goalTracking as goalTracking, step_init as init, step_pageView as pageView, step_productDetailView as productDetailView, step_siteSearch as siteSearch };
+}
+
+declare const index_env: typeof env;
+declare const index_step: typeof step;
+declare namespace index {
+  export { index_env as env, index_step as step };
+}
+
+export { index as examples, index$1 as schemas };

package/dist/dev.js

@@ -0,0 +1 @@
+"use strict";var e,a=Object.defineProperty,t=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,r=Object.prototype.hasOwnProperty,o=(e,t)=>{for(var i in t)a(e,i,{get:t[i],enumerable:!0})},n={};o(n,{examples:()=>k,schemas:()=>s}),module.exports=(e=n,((e,o,n,s)=>{if(o&&"object"==typeof o||"function"==typeof o)for(let c of i(o))r.call(e,c)||c===n||a(e,c,{get:()=>o[c],enumerable:!(s=t(o,c))||s.enumerable});return e})(a({},"__esModule",{value:!0}),e));var s={};o(s,{MappingSchema:()=>l,SettingsSchema:()=>d,mapping:()=>g,settings:()=>u});var c=require("@walkeros/core/dev"),p=require("@walkeros/core/dev"),d=p.z.object({siteId:p.z.string().min(1).describe("Matomo Site ID (like 1, 2, etc.)"),url:p.z.string().url().describe("Base URL of your Matomo instance (like https://analytics.example.com/ or https://yourname.matomo.cloud/)"),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:p.z.record(p.z.string(),p.z.string()).optional().describe('Custom dimension ID to property path mapping applied to all events (like { "1": "data.userType" })')}),m=require("@walkeros/core/dev"),l=m.z.object({goalId:m.z.string().optional().describe("Goal ID to track a conversion alongside this event (like 1)"),goalValue:m.z.string().optional().describe("Property path for goal revenue value (like data.revenue)"),siteSearch:m.z.boolean().optional().describe("Track as internal site search using trackSiteSearch"),contentImpression:m.z.boolean().optional().describe("Track as content impression using trackContentImpression"),contentInteraction:m.z.boolean().optional().describe("Track as content interaction using trackContentInteraction"),customDimensions:m.z.record(m.z.string(),m.z.string()).optional().describe('Per-event custom dimension ID to property path mapping (like { "3": "data.category" })')}),u=(0,c.zodToSchema)(d),g=(0,c.zodToSchema)(l),k={};o(k,{env:()=>h,step:()=>w});var h={};o(h,{init:()=>v,push:()=>y,simulation:()=>b});var v={window:{_paq:void 0,location:{href:"https://www.example.com/page"}},document:{createElement:()=>({type:"",src:"",async:!1,defer:!1}),head:{appendChild:()=>{}}}},y={window:{_paq:[],location:{href:"https://www.example.com/page"}},document:{createElement:()=>({type:"",src:"",async:!1,defer:!1}),head:{appendChild:()=>{}}}},b=["call:window._paq.push"],w={};o(w,{customEvent:()=>z,ecommerceCartUpdate:()=>_,ecommerceOrder:()=>f,goalTracking:()=>O,init:()=>S,pageView:()=>E,productDetailView:()=>I,siteSearch:()=>C});var q=require("@walkeros/core"),S={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"]]]},E={in:(0,q.getEvent)("page view",{timestamp:1700000400}),mapping:{data:"data.title"},out:[["_paq.push",["trackPageView","walkerOS documentation"]]]},z={in:(0,q.getEvent)("promotion visible",{timestamp:1700000401}),mapping:{name:"trackEvent",settings:{goalId:"goal_1"},data:{set:["data.name","data.position"]}},out:[["_paq.push",["trackEvent","Setting up tracking easily","hero"]],["_paq.push",["trackGoal","goal_1",void 0]]]},f={in:(0,q.getEvent)("order complete",{timestamp:1700000402}),mapping:{name:"trackEcommerceOrder",data:{set:[{loop:["nested",{condition:e=>(0,q.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}]]]},_={in:(0,q.getEvent)("cart view",{timestamp:1700000403}),mapping:{name:"trackEcommerceCartUpdate",data:{set:[{loop:["nested",{condition:e=>(0,q.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]]]},I={in:(0,q.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}]]]]},C={in:(0,q.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]]]},O={in:(0,q.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]]]};//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -0,0 +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 { z } from '@walkeros/core/dev';\n\nexport const SettingsSchema = z.object({\n  siteId: z.string().min(1).describe('Matomo Site ID (like 1, 2, etc.)'),\n  url: z\n    .string()\n    .url()\n    .describe(\n      'Base URL of your Matomo instance (like https://analytics.example.com/ or https://yourname.matomo.cloud/)',\n    ),\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: z\n    .record(z.string(), z.string())\n    .optional()\n    .describe(\n      'Custom dimension ID to property path mapping applied to all events (like { \"1\": \"data.userType\" })',\n    ),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  goalId: z\n    .string()\n    .optional()\n    .describe('Goal ID to track a conversion alongside this event (like 1)'),\n  goalValue: z\n    .string()\n    .optional()\n    .describe('Property path for goal revenue value (like data.revenue)'),\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: z\n    .record(z.string(), z.string())\n    .optional()\n    .describe(\n      'Per-event custom dimension ID to property path mapping (like { \"3\": \"data.category\" })',\n    ),\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: undefined as unknown as Env['window']['_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\nexport const push: Env = {\n  window: {\n    _paq: [] as unknown[],\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 { getEvent, isObject } from '@walkeros/core';\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: Flow.StepExample = {\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: Flow.StepExample = {\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 * Custom event tracking with goal conversion.\n * Uses trackEvent with mapped name, followed by trackGoal.\n */\nexport const customEvent: Flow.StepExample = {\n  in: getEvent('promotion visible', { timestamp: 1700000401 }),\n  mapping: {\n    name: 'trackEvent',\n    settings: {\n      goalId: 'goal_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', 'goal_1', undefined]],\n  ],\n};\n\n/**\n * Ecommerce order -- one call with cart items array and order totals.\n */\nexport const ecommerceOrder: Flow.StepExample = {\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: Flow.StepExample = {\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: Flow.StepExample = {\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: Flow.StepExample = {\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: Flow.StepExample = {\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"],"mappings":"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","names":["import_dev","import_dev","init"]}

package/dist/dev.mjs

@@ -0,0 +1 @@
+var e=Object.defineProperty,a=(a,t)=>{for(var i in t)e(a,i,{get:t[i],enumerable:!0})},t={};a(t,{MappingSchema:()=>s,SettingsSchema:()=>r,mapping:()=>p,settings:()=>c});import{zodToSchema as i}from"@walkeros/core/dev";import{z as o}from"@walkeros/core/dev";var r=o.object({siteId:o.string().min(1).describe("Matomo Site ID (like 1, 2, etc.)"),url:o.string().url().describe("Base URL of your Matomo instance (like https://analytics.example.com/ or https://yourname.matomo.cloud/)"),disableCookies:o.boolean().default(!1).describe("Disable all tracking cookies for cookie-free analytics"),enableLinkTracking:o.boolean().default(!0).describe("Enable automatic outlink and download tracking"),enableHeartBeatTimer:o.number().int().positive().optional().describe("Enable heart beat timer with interval in seconds for accurate time-on-page"),customDimensions:o.record(o.string(),o.string()).optional().describe('Custom dimension ID to property path mapping applied to all events (like { "1": "data.userType" })')});import{z as n}from"@walkeros/core/dev";var s=n.object({goalId:n.string().optional().describe("Goal ID to track a conversion alongside this event (like 1)"),goalValue:n.string().optional().describe("Property path for goal revenue value (like data.revenue)"),siteSearch:n.boolean().optional().describe("Track as internal site search using trackSiteSearch"),contentImpression:n.boolean().optional().describe("Track as content impression using trackContentImpression"),contentInteraction:n.boolean().optional().describe("Track as content interaction using trackContentInteraction"),customDimensions:n.record(n.string(),n.string()).optional().describe('Per-event custom dimension ID to property path mapping (like { "3": "data.category" })')}),c=i(r),p=i(s),d={};a(d,{env:()=>m,step:()=>k});var m={};a(m,{init:()=>l,push:()=>u,simulation:()=>g});var l={window:{_paq:void 0,location:{href:"https://www.example.com/page"}},document:{createElement:()=>({type:"",src:"",async:!1,defer:!1}),head:{appendChild:()=>{}}}},u={window:{_paq:[],location:{href:"https://www.example.com/page"}},document:{createElement:()=>({type:"",src:"",async:!1,defer:!1}),head:{appendChild:()=>{}}}},g=["call:window._paq.push"],k={};a(k,{customEvent:()=>w,ecommerceCartUpdate:()=>S,ecommerceOrder:()=>q,goalTracking:()=>E,init:()=>y,pageView:()=>b,productDetailView:()=>f,siteSearch:()=>_});import{getEvent as h,isObject as v}from"@walkeros/core";var y={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"]]]},b={in:h("page view",{timestamp:1700000400}),mapping:{data:"data.title"},out:[["_paq.push",["trackPageView","walkerOS documentation"]]]},w={in:h("promotion visible",{timestamp:1700000401}),mapping:{name:"trackEvent",settings:{goalId:"goal_1"},data:{set:["data.name","data.position"]}},out:[["_paq.push",["trackEvent","Setting up tracking easily","hero"]],["_paq.push",["trackGoal","goal_1",void 0]]]},q={in:h("order complete",{timestamp:1700000402}),mapping:{name:"trackEcommerceOrder",data:{set:[{loop:["nested",{condition:e=>v(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}]]]},S={in:h("cart view",{timestamp:1700000403}),mapping:{name:"trackEcommerceCartUpdate",data:{set:[{loop:["nested",{condition:e=>v(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]]]},f={in:h("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}]]]]},_={in:h("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]]]},E={in:h("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]]]};export{d as examples,t as schemas};//# sourceMappingURL=dev.mjs.map

package/dist/dev.mjs.map

@@ -0,0 +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 { z } from '@walkeros/core/dev';\n\nexport const SettingsSchema = z.object({\n  siteId: z.string().min(1).describe('Matomo Site ID (like 1, 2, etc.)'),\n  url: z\n    .string()\n    .url()\n    .describe(\n      'Base URL of your Matomo instance (like https://analytics.example.com/ or https://yourname.matomo.cloud/)',\n    ),\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: z\n    .record(z.string(), z.string())\n    .optional()\n    .describe(\n      'Custom dimension ID to property path mapping applied to all events (like { \"1\": \"data.userType\" })',\n    ),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  goalId: z\n    .string()\n    .optional()\n    .describe('Goal ID to track a conversion alongside this event (like 1)'),\n  goalValue: z\n    .string()\n    .optional()\n    .describe('Property path for goal revenue value (like data.revenue)'),\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: z\n    .record(z.string(), z.string())\n    .optional()\n    .describe(\n      'Per-event custom dimension ID to property path mapping (like { \"3\": \"data.category\" })',\n    ),\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: undefined as unknown as Env['window']['_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\nexport const push: Env = {\n  window: {\n    _paq: [] as unknown[],\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 { getEvent, isObject } from '@walkeros/core';\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: Flow.StepExample = {\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: Flow.StepExample = {\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 * Custom event tracking with goal conversion.\n * Uses trackEvent with mapped name, followed by trackGoal.\n */\nexport const customEvent: Flow.StepExample = {\n  in: getEvent('promotion visible', { timestamp: 1700000401 }),\n  mapping: {\n    name: 'trackEvent',\n    settings: {\n      goalId: 'goal_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', 'goal_1', undefined]],\n  ],\n};\n\n/**\n * Ecommerce order -- one call with cart items array and order totals.\n */\nexport const ecommerceOrder: Flow.StepExample = {\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: Flow.StepExample = {\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: Flow.StepExample = {\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: Flow.StepExample = {\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: Flow.StepExample = {\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"],"mappings":"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","names":["z","init"]}

package/dist/examples/index.d.mts

@@ -0,0 +1,100 @@
+import { DestinationWeb } from '@walkeros/web-core';
+import { Flow } from '@walkeros/core';
+
+declare global {
+    interface Window {
+        _paq?: Array<unknown>;
+    }
+}
+interface Env extends DestinationWeb.Env {
+    window: {
+        _paq: Array<unknown>;
+        location?: {
+            href?: string;
+        };
+    };
+    document: {
+        createElement: (tagName: string) => {
+            type: string;
+            src: string;
+            async?: boolean;
+            defer?: boolean;
+        };
+        head: {
+            appendChild: (node: unknown) => void;
+        };
+    };
+}
+
+/**
+ * Example environment configurations for Matomo destination.
+ * Mocks the _paq command queue and DOM elements for testing
+ * without requiring real browser or network.
+ */
+declare const init$1: Env | undefined;
+declare const push: Env;
+/**
+ * Simulation tracking paths.
+ * Specifies which function calls to track during simulation.
+ */
+declare const simulation: string[];
+
+declare const env_push: typeof push;
+declare const env_simulation: typeof simulation;
+declare namespace env {
+  export { init$1 as init, env_push as push, env_simulation as simulation };
+}
+
+/**
+ * Destination bootstrap.
+ * Given the canonical settings, init loads the Matomo script and configures
+ * the tracker URL, site ID, and link tracking. Reproduce by passing the same
+ * settings to `startFlow` as the destination config.
+ */
+declare const init: Flow.StepExample;
+/**
+ * Default page view -- no mapping name needed.
+ * Destination auto-calls trackPageView with the page title.
+ */
+declare const pageView: Flow.StepExample;
+/**
+ * Custom event tracking with goal conversion.
+ * Uses trackEvent with mapped name, followed by trackGoal.
+ */
+declare const customEvent: Flow.StepExample;
+/**
+ * Ecommerce order -- one call with cart items array and order totals.
+ */
+declare const ecommerceOrder: Flow.StepExample;
+/**
+ * Ecommerce cart update -- addEcommerceItem per nested product,
+ * then trackEcommerceCartUpdate with cart total.
+ */
+declare const ecommerceCartUpdate: Flow.StepExample;
+/**
+ * Product detail view -- setEcommerceView equivalent with a single product array.
+ */
+declare const productDetailView: Flow.StepExample;
+/**
+ * Site search -- trackSiteSearch with keyword, category, result count.
+ */
+declare const siteSearch: Flow.StepExample;
+/**
+ * Goal tracking alongside a tracked event.
+ * Uses a known fixture event (promotion visible) so data paths resolve.
+ */
+declare const goalTracking: Flow.StepExample;
+
+declare const step_customEvent: typeof customEvent;
+declare const step_ecommerceCartUpdate: typeof ecommerceCartUpdate;
+declare const step_ecommerceOrder: typeof ecommerceOrder;
+declare const step_goalTracking: typeof goalTracking;
+declare const step_init: typeof init;
+declare const step_pageView: typeof pageView;
+declare const step_productDetailView: typeof productDetailView;
+declare const step_siteSearch: typeof siteSearch;
+declare namespace step {
+  export { step_customEvent as customEvent, step_ecommerceCartUpdate as ecommerceCartUpdate, step_ecommerceOrder as ecommerceOrder, step_goalTracking as goalTracking, step_init as init, step_pageView as pageView, step_productDetailView as productDetailView, step_siteSearch as siteSearch };
+}
+
+export { env, step };

package/dist/examples/index.d.ts

@@ -0,0 +1,100 @@
+import { DestinationWeb } from '@walkeros/web-core';
+import { Flow } from '@walkeros/core';
+
+declare global {
+    interface Window {
+        _paq?: Array<unknown>;
+    }
+}
+interface Env extends DestinationWeb.Env {
+    window: {
+        _paq: Array<unknown>;
+        location?: {
+            href?: string;
+        };
+    };
+    document: {
+        createElement: (tagName: string) => {
+            type: string;
+            src: string;
+            async?: boolean;
+            defer?: boolean;
+        };
+        head: {
+            appendChild: (node: unknown) => void;
+        };
+    };
+}
+
+/**
+ * Example environment configurations for Matomo destination.
+ * Mocks the _paq command queue and DOM elements for testing
+ * without requiring real browser or network.
+ */
+declare const init$1: Env | undefined;
+declare const push: Env;
+/**
+ * Simulation tracking paths.
+ * Specifies which function calls to track during simulation.
+ */
+declare const simulation: string[];
+
+declare const env_push: typeof push;
+declare const env_simulation: typeof simulation;
+declare namespace env {
+  export { init$1 as init, env_push as push, env_simulation as simulation };
+}
+
+/**
+ * Destination bootstrap.
+ * Given the canonical settings, init loads the Matomo script and configures
+ * the tracker URL, site ID, and link tracking. Reproduce by passing the same
+ * settings to `startFlow` as the destination config.
+ */
+declare const init: Flow.StepExample;
+/**
+ * Default page view -- no mapping name needed.
+ * Destination auto-calls trackPageView with the page title.
+ */
+declare const pageView: Flow.StepExample;
+/**
+ * Custom event tracking with goal conversion.
+ * Uses trackEvent with mapped name, followed by trackGoal.
+ */
+declare const customEvent: Flow.StepExample;
+/**
+ * Ecommerce order -- one call with cart items array and order totals.
+ */
+declare const ecommerceOrder: Flow.StepExample;
+/**
+ * Ecommerce cart update -- addEcommerceItem per nested product,
+ * then trackEcommerceCartUpdate with cart total.
+ */
+declare const ecommerceCartUpdate: Flow.StepExample;
+/**
+ * Product detail view -- setEcommerceView equivalent with a single product array.
+ */
+declare const productDetailView: Flow.StepExample;
+/**
+ * Site search -- trackSiteSearch with keyword, category, result count.
+ */
+declare const siteSearch: Flow.StepExample;
+/**
+ * Goal tracking alongside a tracked event.
+ * Uses a known fixture event (promotion visible) so data paths resolve.
+ */
+declare const goalTracking: Flow.StepExample;
+
+declare const step_customEvent: typeof customEvent;
+declare const step_ecommerceCartUpdate: typeof ecommerceCartUpdate;
+declare const step_ecommerceOrder: typeof ecommerceOrder;
+declare const step_goalTracking: typeof goalTracking;
+declare const step_init: typeof init;
+declare const step_pageView: typeof pageView;
+declare const step_productDetailView: typeof productDetailView;
+declare const step_siteSearch: typeof siteSearch;
+declare namespace step {
+  export { step_customEvent as customEvent, step_ecommerceCartUpdate as ecommerceCartUpdate, step_ecommerceOrder as ecommerceOrder, step_goalTracking as goalTracking, step_init as init, step_pageView as pageView, step_productDetailView as productDetailView, step_siteSearch as siteSearch };
+}
+
+export { env, step };