@walkeros/web-destination-clarity 4.2.0 → 4.2.1-next-1781538735002

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @walkeros/web-destination-clarity
 
+## 4.2.1-next-1781538735002
+
+### Patch Changes
+
+- Updated dependencies [5cbcd23]
+  - @walkeros/core@4.2.1-next-1781538735002
+  - @walkeros/web-core@4.2.1-next-1781538735002
+
 ## 4.2.0
 
 ### Patch Changes

package/dist/dev.d.mts

@@ -1,6 +1,6 @@
 import * as _walkeros_core_dev from '@walkeros/core/dev';
 import { z } from '@walkeros/core/dev';
-import { Mapping as Mapping$1, Flow } from '@walkeros/core';
+import { Mapping as Mapping$1, Flow, WalkerOS } from '@walkeros/core';
 import { DestinationWeb } from '@walkeros/web-core';
 
 declare const SettingsSchema: z.ZodObject<{
@@ -100,6 +100,8 @@ declare namespace env {
 type ClarityStepExample = Flow.StepExample & {
     settings?: Partial<Settings>;
     configInclude?: string[];
+    /** Consent granted before `in` so a gated destination is loaded first. */
+    before?: WalkerOS.Consent;
 };
 /**
  * Default event forwarding - every walkerOS event becomes Clarity.event(name).
@@ -174,9 +176,12 @@ declare const pageViewSilent: ClarityStepExample;
  */
 declare const consentGrantBoth: ClarityStepExample;
 /**
- * Consent revocation - denied categories call Clarity.consentV2(...) with
- * denied flags. The destination does NOT call the legacy `Clarity.consent(false)`
- * API at all - consentV2 is the single source of truth for consent state.
+ * Consent revocation - after analytics and marketing are granted (Clarity
+ * loads), revoking them calls Clarity.consentV2(...) with denied flags. The
+ * destination does NOT call the legacy `Clarity.consent(false)` API at all -
+ * consentV2 is the single source of truth for consent state. The destination
+ * is never loaded under denied consent, so the revoke acts on an
+ * already-granted destination.
  */
 declare const consentRevoke: ClarityStepExample;
 

package/dist/dev.d.ts

@@ -1,6 +1,6 @@
 import * as _walkeros_core_dev from '@walkeros/core/dev';
 import { z } from '@walkeros/core/dev';
-import { Mapping as Mapping$1, Flow } from '@walkeros/core';
+import { Mapping as Mapping$1, Flow, WalkerOS } from '@walkeros/core';
 import { DestinationWeb } from '@walkeros/web-core';
 
 declare const SettingsSchema: z.ZodObject<{
@@ -100,6 +100,8 @@ declare namespace env {
 type ClarityStepExample = Flow.StepExample & {
     settings?: Partial<Settings>;
     configInclude?: string[];
+    /** Consent granted before `in` so a gated destination is loaded first. */
+    before?: WalkerOS.Consent;
 };
 /**
  * Default event forwarding - every walkerOS event becomes Clarity.event(name).
@@ -174,9 +176,12 @@ declare const pageViewSilent: ClarityStepExample;
  */
 declare const consentGrantBoth: ClarityStepExample;
 /**
- * Consent revocation - denied categories call Clarity.consentV2(...) with
- * denied flags. The destination does NOT call the legacy `Clarity.consent(false)`
- * API at all - consentV2 is the single source of truth for consent state.
+ * Consent revocation - after analytics and marketing are granted (Clarity
+ * loads), revoking them calls Clarity.consentV2(...) with denied flags. The
+ * destination does NOT call the legacy `Clarity.consent(false)` API at all -
+ * consentV2 is the single source of truth for consent state. The destination
+ * is never loaded under denied consent, so the revoke acts on an
+ * already-granted destination.
  */
 declare const consentRevoke: ClarityStepExample;
 

package/dist/dev.js

@@ -1 +1 @@
-"use strict";var e,t=Object.defineProperty,a=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,n=Object.prototype.hasOwnProperty,r=(e,a)=>{for(var i in a)t(e,i,{get:a[i],enumerable:!0})},s={};r(s,{examples:()=>m,schemas:()=>o}),module.exports=(e=s,((e,r,s,o)=>{if(r&&"object"==typeof r||"function"==typeof r)for(let d of i(r))n.call(e,d)||d===s||t(e,d,{get:()=>r[d],enumerable:!(o=a(r,d))||o.enumerable});return e})(t({},"__esModule",{value:!0}),e));var o={};r(o,{MappingSchema:()=>p,SettingsSchema:()=>c,mapping:()=>y,settings:()=>u});var d=require("@walkeros/core/dev"),l=require("@walkeros/core/dev"),c=l.z.object({apiKey:l.z.string().min(1).describe('Your Microsoft Clarity project ID (e.g. "3t0wlogvdz"). Find it in your Clarity dashboard under Settings → Setup.'),consent:l.z.record(l.z.string(),l.z.enum(["analytics_Storage","ad_Storage"])).describe('Translation table from walkerOS consent keys to Clarity ConsentV2 categories. Example: { "analytics": "analytics_Storage", "marketing": "ad_Storage" }. Required to get meaningful consent behavior — Clarity expects its own category names.').optional(),identify:l.z.unknown().describe("walkerOS mapping value resolving to positional arguments for Clarity.identify(). Keys: customId (required), customSessionId?, customPageId?, friendlyName?.").optional()}),g=require("@walkeros/core/dev"),p=g.z.object({identify:g.z.unknown().describe("Per-event identity mapping. Resolves to { customId, customSessionId?, customPageId?, friendlyName? } → Clarity.identify(...).").optional(),set:g.z.unknown().describe("Explicit custom tag mapping. Resolved object keys become Clarity.setTag(key, value) calls. Array values pass through as string[] unchanged.").optional(),upgrade:g.z.unknown().describe("Session priority reason. Resolves to a string → Clarity.upgrade(reason). Used to flag important sessions for retention beyond sampling.").optional()}),u=(0,d.zodToSchema)(c),y=(0,d.zodToSchema)(p),m={};r(m,{env:()=>v,step:()=>k});var v={};r(v,{init:()=>f,push:()=>w,simulation:()=>b});var h=()=>{},f={clarity:{init:h,identify:h,setTag:h,event:h,consentV2:h,upgrade:h}},w={clarity:{init:h,identify:h,setTag:h,event:h,consentV2:h,upgrade:h}},b=["call:clarity.init","call:clarity.identify","call:clarity.setTag","call:clarity.event","call:clarity.consentV2","call:clarity.upgrade"],k={};r(k,{arrayTagValue:()=>z,combinedFeatures:()=>V,consentGrantBoth:()=>O,consentRevoke:()=>D,defaultEventForwarding:()=>_,destinationLevelIdentify:()=>I,orderCompleteInclude:()=>P,orderCompleteUpgrade:()=>A,pageViewSilent:()=>j,productViewWithTags:()=>E,userLoginIdentify:()=>T,wildcardIgnored:()=>S});var C=require("@walkeros/core"),_={title:"Default event",description:"A walker event becomes a Clarity.event call with the event name as the Clarity custom event.",in:(0,C.getEvent)("product view",{timestamp:1700000100}),out:[["clarity.event","product view"]]},S={public:!1,in:(0,C.getEvent)("debug noise",{timestamp:1700000101}),mapping:{ignore:!0},out:[]},T={title:"User login identify",description:"A user login fires Clarity.identify with custom id, session id, page id, and friendly name then tracks the event.",in:(0,C.getEvent)("user login",{timestamp:1700000102,data:{id:"u-123",name:"Jane Doe"},globals:{pagegroup:"shop",pagetype:"home"}}),mapping:{settings:{identify:{map:{customId:"data.id",customSessionId:"user.session",customPageId:"globals.pagetype",friendlyName:"data.name"}}}},out:[["clarity.identify","u-123","s3ss10n","home","Jane Doe"],["clarity.event","user login"]]},I={title:"Destination identify",description:"Destination-level identify calls Clarity.identify with the user id on every push as Clarity recommends.",in:(0,C.getEvent)("page view",{timestamp:1700000103}),settings:{identify:{map:{customId:"user.id"}}},out:[["clarity.identify","us3r"],["clarity.event","page view"]]},E={title:"Custom tags",description:"A product view sets Clarity session tags such as product color and id before firing the event.",in:(0,C.getEvent)("product view",{timestamp:1700000104}),mapping:{settings:{set:{map:{product_color:"data.color",product_id:"data.id"}}}},out:[["clarity.setTag","product_color","black"],["clarity.setTag","product_id","ers"],["clarity.event","product view"]]},z={title:"Array tag values",description:"Array values such as product tags are passed through to Clarity.setTag preserving the array shape.",in:(0,C.getEvent)("product view",{timestamp:1700000105,data:{id:"ers",name:"Everyday Ruck Snack",color:"black",size:"l",price:420,tags:["sale","featured"]}}),mapping:{settings:{set:{map:{product_tags:"data.tags"}}}},out:[["clarity.setTag","product_tags",["sale","featured"]],["clarity.event","product view"]]},A={title:"Upgrade session",description:"A completed order upgrades the Clarity session priority so it is retained beyond the sampling cap.",in:(0,C.getEvent)("order complete",{timestamp:1700000106}),mapping:{name:"Purchase",settings:{upgrade:{value:"purchase"}}},out:[["clarity.upgrade","purchase"],["clarity.event","Purchase"]]},P={title:"Include data as tags",description:"A mapping include flattens the event data section into Clarity.setTag calls before the event fires.",in:(0,C.getEvent)("order complete",{timestamp:1700000107}),mapping:{include:["data"]},out:[["clarity.setTag","data_id","0rd3r1d"],["clarity.setTag","data_currency","EUR"],["clarity.setTag","data_shipping","5.22"],["clarity.setTag","data_taxes","73.76"],["clarity.setTag","data_total","555"],["clarity.event","order complete"]]},V={title:"Combined features",description:"A purchase identifies the user, sets an order tag, upgrades the session, and fires the Clarity event in order.",in:(0,C.getEvent)("order complete",{timestamp:1700000108}),mapping:{name:"Purchase",settings:{identify:{map:{customId:"user.id"}},set:{map:{order_id:"data.id"}},upgrade:{value:"purchase"}}},out:[["clarity.identify","us3r"],["clarity.setTag","order_id","0rd3r1d"],["clarity.upgrade","purchase"],["clarity.event","Purchase"]]},j={title:"Tags without event",description:"A page view sets Clarity tags while silent suppresses the event, letting Clarity handle page tracking itself.",in:(0,C.getEvent)("page view",{timestamp:1700000109}),mapping:{silent:!0,settings:{set:{map:{page_id:"data.id"}}}},out:[["clarity.setTag","page_id","/docs/"]]},O={title:"Consent granted",description:"A walker consent command translates analytics and marketing grants into a Clarity.consentV2 call.",command:"consent",in:{analytics:!0,marketing:!0},settings:{consent:{analytics:"analytics_Storage",marketing:"ad_Storage"}},out:[["clarity.consentV2",{analytics_Storage:"granted",ad_Storage:"granted"}]]},D={title:"Consent revoked",description:"A walker consent command with analytics and marketing denied calls Clarity.consentV2 with denied flags.",command:"consent",in:{analytics:!1,marketing:!1},settings:{consent:{analytics:"analytics_Storage",marketing:"ad_Storage"}},out:[["clarity.consentV2",{analytics_Storage:"denied",ad_Storage:"denied"}]]};//# sourceMappingURL=dev.js.map
+"use strict";var e,t=Object.defineProperty,a=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,n=Object.prototype.hasOwnProperty,r=(e,a)=>{for(var i in a)t(e,i,{get:a[i],enumerable:!0})},s={};r(s,{examples:()=>m,schemas:()=>o}),module.exports=(e=s,((e,r,s,o)=>{if(r&&"object"==typeof r||"function"==typeof r)for(let d of i(r))n.call(e,d)||d===s||t(e,d,{get:()=>r[d],enumerable:!(o=a(r,d))||o.enumerable});return e})(t({},"__esModule",{value:!0}),e));var o={};r(o,{MappingSchema:()=>p,SettingsSchema:()=>c,mapping:()=>y,settings:()=>u});var d=require("@walkeros/core/dev"),l=require("@walkeros/core/dev"),c=l.z.object({apiKey:l.z.string().min(1).describe('Your Microsoft Clarity project ID (e.g. "3t0wlogvdz"). Find it in your Clarity dashboard under Settings → Setup.'),consent:l.z.record(l.z.string(),l.z.enum(["analytics_Storage","ad_Storage"])).describe('Translation table from walkerOS consent keys to Clarity ConsentV2 categories. Example: { "analytics": "analytics_Storage", "marketing": "ad_Storage" }. Required to get meaningful consent behavior — Clarity expects its own category names.').optional(),identify:l.z.unknown().describe("walkerOS mapping value resolving to positional arguments for Clarity.identify(). Keys: customId (required), customSessionId?, customPageId?, friendlyName?.").optional()}),g=require("@walkeros/core/dev"),p=g.z.object({identify:g.z.unknown().describe("Per-event identity mapping. Resolves to { customId, customSessionId?, customPageId?, friendlyName? } → Clarity.identify(...).").optional(),set:g.z.unknown().describe("Explicit custom tag mapping. Resolved object keys become Clarity.setTag(key, value) calls. Array values pass through as string[] unchanged.").optional(),upgrade:g.z.unknown().describe("Session priority reason. Resolves to a string → Clarity.upgrade(reason). Used to flag important sessions for retention beyond sampling.").optional()}),u=(0,d.zodToSchema)(c),y=(0,d.zodToSchema)(p),m={};r(m,{env:()=>v,step:()=>k});var v={};r(v,{init:()=>f,push:()=>w,simulation:()=>b});var h=()=>{},f={clarity:{init:h,identify:h,setTag:h,event:h,consentV2:h,upgrade:h}},w={clarity:{init:h,identify:h,setTag:h,event:h,consentV2:h,upgrade:h}},b=["call:clarity.init","call:clarity.identify","call:clarity.setTag","call:clarity.event","call:clarity.consentV2","call:clarity.upgrade"],k={};r(k,{arrayTagValue:()=>z,combinedFeatures:()=>V,consentGrantBoth:()=>O,consentRevoke:()=>D,defaultEventForwarding:()=>C,destinationLevelIdentify:()=>I,orderCompleteInclude:()=>P,orderCompleteUpgrade:()=>A,pageViewSilent:()=>j,productViewWithTags:()=>E,userLoginIdentify:()=>T,wildcardIgnored:()=>S});var _=require("@walkeros/core"),C={title:"Default event",description:"A walker event becomes a Clarity.event call with the event name as the Clarity custom event.",in:(0,_.getEvent)("product view",{timestamp:1700000100}),out:[["clarity.event","product view"]]},S={public:!1,in:(0,_.getEvent)("debug noise",{timestamp:1700000101}),mapping:{ignore:!0},out:[]},T={title:"User login identify",description:"A user login fires Clarity.identify with custom id, session id, page id, and friendly name then tracks the event.",in:(0,_.getEvent)("user login",{timestamp:1700000102,data:{id:"u-123",name:"Jane Doe"},globals:{pagegroup:"shop",pagetype:"home"}}),mapping:{settings:{identify:{map:{customId:"data.id",customSessionId:"user.session",customPageId:"globals.pagetype",friendlyName:"data.name"}}}},out:[["clarity.identify","u-123","s3ss10n","home","Jane Doe"],["clarity.event","user login"]]},I={title:"Destination identify",description:"Destination-level identify calls Clarity.identify with the user id on every push as Clarity recommends.",in:(0,_.getEvent)("page view",{timestamp:1700000103}),settings:{identify:{map:{customId:"user.id"}}},out:[["clarity.identify","us3r"],["clarity.event","page view"]]},E={title:"Custom tags",description:"A product view sets Clarity session tags such as product color and id before firing the event.",in:(0,_.getEvent)("product view",{timestamp:1700000104}),mapping:{settings:{set:{map:{product_color:"data.color",product_id:"data.id"}}}},out:[["clarity.setTag","product_color","black"],["clarity.setTag","product_id","ers"],["clarity.event","product view"]]},z={title:"Array tag values",description:"Array values such as product tags are passed through to Clarity.setTag preserving the array shape.",in:(0,_.getEvent)("product view",{timestamp:1700000105,data:{id:"ers",name:"Everyday Ruck Snack",color:"black",size:"l",price:420,tags:["sale","featured"]}}),mapping:{settings:{set:{map:{product_tags:"data.tags"}}}},out:[["clarity.setTag","product_tags",["sale","featured"]],["clarity.event","product view"]]},A={title:"Upgrade session",description:"A completed order upgrades the Clarity session priority so it is retained beyond the sampling cap.",in:(0,_.getEvent)("order complete",{timestamp:1700000106}),mapping:{name:"Purchase",settings:{upgrade:{value:"purchase"}}},out:[["clarity.upgrade","purchase"],["clarity.event","Purchase"]]},P={title:"Include data as tags",description:"A mapping include flattens the event data section into Clarity.setTag calls before the event fires.",in:(0,_.getEvent)("order complete",{timestamp:1700000107}),mapping:{include:["data"]},out:[["clarity.setTag","data_id","0rd3r1d"],["clarity.setTag","data_currency","EUR"],["clarity.setTag","data_shipping","5.22"],["clarity.setTag","data_taxes","73.76"],["clarity.setTag","data_total","555"],["clarity.event","order complete"]]},V={title:"Combined features",description:"A purchase identifies the user, sets an order tag, upgrades the session, and fires the Clarity event in order.",in:(0,_.getEvent)("order complete",{timestamp:1700000108}),mapping:{name:"Purchase",settings:{identify:{map:{customId:"user.id"}},set:{map:{order_id:"data.id"}},upgrade:{value:"purchase"}}},out:[["clarity.identify","us3r"],["clarity.setTag","order_id","0rd3r1d"],["clarity.upgrade","purchase"],["clarity.event","Purchase"]]},j={title:"Tags without event",description:"A page view sets Clarity tags while silent suppresses the event, letting Clarity handle page tracking itself.",in:(0,_.getEvent)("page view",{timestamp:1700000109}),mapping:{silent:!0,settings:{set:{map:{page_id:"data.id"}}}},out:[["clarity.setTag","page_id","/docs/"]]},O={title:"Consent granted",description:"A walker consent command translates analytics and marketing grants into a Clarity.consentV2 call.",command:"consent",in:{analytics:!0,marketing:!0},settings:{consent:{analytics:"analytics_Storage",marketing:"ad_Storage"}},out:[["clarity.consentV2",{analytics_Storage:"granted",ad_Storage:"granted"}]]},D={title:"Consent revoked",description:"A walker consent command with analytics and marketing denied calls Clarity.consentV2 with denied flags.",command:"consent",before:{analytics:!0,marketing:!0},in:{analytics:!1,marketing:!1},settings:{consent:{analytics:"analytics_Storage",marketing:"ad_Storage"}},out:[["clarity.consentV2",{analytics_Storage:"granted",ad_Storage:"granted"}],["clarity.consentV2",{analytics_Storage:"denied",ad_Storage:"denied"}]]};//# 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 { z } from '@walkeros/core/dev';\n\nexport const SettingsSchema = z.object({\n  apiKey: z\n    .string()\n    .min(1)\n    .describe(\n      'Your Microsoft Clarity project ID (e.g. \"3t0wlogvdz\"). Find it in your Clarity dashboard under Settings → Setup.',\n    ),\n  consent: z\n    .record(z.string(), z.enum(['analytics_Storage', 'ad_Storage']))\n    .describe(\n      'Translation table from walkerOS consent keys to Clarity ConsentV2 categories. Example: { \"analytics\": \"analytics_Storage\", \"marketing\": \"ad_Storage\" }. Required to get meaningful consent behavior — Clarity expects its own category names.',\n    )\n    .optional(),\n  identify: z\n    .unknown()\n    .describe(\n      'walkerOS mapping value resolving to positional arguments for Clarity.identify(). Keys: customId (required), customSessionId?, customPageId?, friendlyName?.',\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  identify: z\n    .unknown()\n    .describe(\n      'Per-event identity mapping. Resolves to { customId, customSessionId?, customPageId?, friendlyName? } → Clarity.identify(...).',\n    )\n    .optional(),\n  set: z\n    .unknown()\n    .describe(\n      'Explicit custom tag mapping. Resolved object keys become Clarity.setTag(key, value) calls. Array values pass through as string[] unchanged.',\n    )\n    .optional(),\n  upgrade: z\n    .unknown()\n    .describe(\n      'Session priority reason. Resolves to a string → Clarity.upgrade(reason). Used to flag important sessions for retention beyond sampling.',\n    )\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 Microsoft Clarity destination.\n *\n * Tests clone `push` and replace individual methods with jest spies.\n * Production leaves `env.clarity` undefined — the destination falls back\n * to the real `@microsoft/clarity` default export.\n */\n\nconst noop = () => {};\n\n/**\n * Pre-init environment — Clarity SDK methods are no-ops until init wires them.\n */\nexport const init: Env | undefined = {\n  clarity: {\n    init: noop,\n    identify: noop,\n    setTag: noop,\n    event: noop,\n    consentV2: noop,\n    upgrade: noop,\n  },\n};\n\n/**\n * Post-init environment — Clarity SDK methods are spy-able no-ops.\n * Tests clone this and replace individual methods with jest.fn() for assertions.\n */\nexport const push: Env = {\n  clarity: {\n    init: noop,\n    identify: noop,\n    setTag: noop,\n    event: noop,\n    consentV2: noop,\n    upgrade: noop,\n  },\n};\n\n/**\n * Simulation tracking paths for CLI --simulate\n */\nexport const simulation = [\n  'call:clarity.init',\n  'call:clarity.identify',\n  'call:clarity.setTag',\n  'call:clarity.event',\n  'call:clarity.consentV2',\n  'call:clarity.upgrade',\n];\n","import type { Flow, WalkerOS } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * Examples may optionally override destination-level settings for a test.\n * The test runner reads `settings` from the example and merges it into the\n * base destination settings (on top of the fixed `apiKey`). `configInclude`\n * is passed as config-level include when registering the destination.\n */\nexport type ClarityStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n  configInclude?: string[];\n};\n\n/**\n * Default event forwarding - every walkerOS event becomes Clarity.event(name).\n * No mapping rule; the destination's default push behavior fires.\n */\nexport const defaultEventForwarding: ClarityStepExample = {\n  title: 'Default event',\n  description:\n    'A walker event becomes a Clarity.event call with the event name as the Clarity custom event.',\n  in: getEvent('product view', { timestamp: 1700000100 }),\n  out: [['clarity.event', 'product view']],\n};\n\n/**\n * Wildcard ignore pattern - the standard walkerOS way to suppress noisy events.\n * The destination forwards by default; users opt OUT via `\"*\": { \"*\": { ignore: true } }`\n * plus explicit allows. This example IS an ignored event - the destination\n * must produce zero calls.\n */\nexport const wildcardIgnored: ClarityStepExample = {\n  public: false,\n  in: getEvent('debug noise', { timestamp: 1700000101 }),\n  mapping: { ignore: true },\n  out: [],\n};\n\n/**\n * Identity via settings.identify (per-event, user login).\n * Resolves positional args for Clarity.identify(customId, sessionId, pageId, friendlyName).\n * Trailing undefined args are omitted, so all four args are passed when friendlyName is set.\n * Then fires the default Clarity.event(...) forwarding.\n */\nexport const userLoginIdentify: ClarityStepExample = {\n  title: 'User login identify',\n  description:\n    'A user login fires Clarity.identify with custom id, session id, page id, and friendly name then tracks the event.',\n  in: getEvent('user login', {\n    timestamp: 1700000102,\n    data: { id: 'u-123', name: 'Jane Doe' },\n    globals: { pagegroup: 'shop', pagetype: 'home' },\n  }),\n  mapping: {\n    settings: {\n      identify: {\n        map: {\n          customId: 'data.id',\n          customSessionId: 'user.session',\n          customPageId: 'globals.pagetype',\n          friendlyName: 'data.name',\n        },\n      },\n    },\n  },\n  out: [\n    ['clarity.identify', 'u-123', 's3ss10n', 'home', 'Jane Doe'],\n    ['clarity.event', 'user login'],\n  ],\n};\n\n/**\n * Destination-level settings.identify - Clarity officially recommends calling\n * identify() on every page load. walkerOS expresses this via destination-level\n * `settings.identify`, which fires on every push.\n */\nexport const destinationLevelIdentify: ClarityStepExample = {\n  title: 'Destination identify',\n  description:\n    'Destination-level identify calls Clarity.identify with the user id on every push as Clarity recommends.',\n  in: getEvent('page view', { timestamp: 1700000103 }),\n  settings: {\n    identify: {\n      map: {\n        customId: 'user.id',\n      },\n    },\n  },\n  out: [\n    ['clarity.identify', 'us3r'],\n    ['clarity.event', 'page view'],\n  ],\n};\n\n/**\n * Explicit custom tags via mapping.settings.set.\n * Each resolved key → Clarity.setTag(key, value). Tags fire after identify\n * but before the default event.\n */\nexport const productViewWithTags: ClarityStepExample = {\n  title: 'Custom tags',\n  description:\n    'A product view sets Clarity session tags such as product color and id before firing the event.',\n  in: getEvent('product view', { timestamp: 1700000104 }),\n  mapping: {\n    settings: {\n      set: {\n        map: {\n          product_color: 'data.color',\n          product_id: 'data.id',\n        },\n      },\n    },\n  },\n  out: [\n    ['clarity.setTag', 'product_color', 'black'],\n    ['clarity.setTag', 'product_id', 'ers'],\n    ['clarity.event', 'product view'],\n  ],\n};\n\n/**\n * Array tag values - Clarity.setTag(key, value) natively accepts string[].\n * walkerOS array values are passed through unchanged (each element is\n * coerced to string, but the array shape is preserved - no flattening,\n * no splitting into multiple calls).\n */\nexport const arrayTagValue: ClarityStepExample = {\n  title: 'Array tag values',\n  description:\n    'Array values such as product tags are passed through to Clarity.setTag preserving the array shape.',\n  in: getEvent('product view', {\n    timestamp: 1700000105,\n    data: {\n      id: 'ers',\n      name: 'Everyday Ruck Snack',\n      color: 'black',\n      size: 'l',\n      price: 420,\n      tags: ['sale', 'featured'],\n    },\n  }),\n  mapping: {\n    settings: {\n      set: {\n        map: {\n          product_tags: 'data.tags',\n        },\n      },\n    },\n  },\n  out: [\n    ['clarity.setTag', 'product_tags', ['sale', 'featured']],\n    ['clarity.event', 'product view'],\n  ],\n};\n\n/**\n * Session priority upgrade - mark this session as important so Clarity retains\n * it beyond the sampling cap. upgrade fires before the default event.\n */\nexport const orderCompleteUpgrade: ClarityStepExample = {\n  title: 'Upgrade session',\n  description:\n    'A completed order upgrades the Clarity session priority so it is retained beyond the sampling cap.',\n  in: getEvent('order complete', { timestamp: 1700000106 }),\n  mapping: {\n    name: 'Purchase',\n    settings: {\n      upgrade: { value: 'purchase' },\n    },\n  },\n  out: [\n    ['clarity.upgrade', 'purchase'],\n    ['clarity.event', 'Purchase'],\n  ],\n};\n\n/**\n * settings.include flattens a walkerOS event section into Clarity.setTag calls.\n * Primitives coerce to strings; arrays pass through as string[].\n * The example includes `data` only; keys become `data_<field>`.\n */\nexport const orderCompleteInclude: ClarityStepExample = {\n  title: 'Include data as tags',\n  description:\n    'A mapping include flattens the event data section into Clarity.setTag calls before the event fires.',\n  in: getEvent('order complete', { timestamp: 1700000107 }),\n  mapping: {\n    include: ['data'],\n  },\n  out: [\n    ['clarity.setTag', 'data_id', '0rd3r1d'],\n    ['clarity.setTag', 'data_currency', 'EUR'],\n    ['clarity.setTag', 'data_shipping', '5.22'],\n    ['clarity.setTag', 'data_taxes', '73.76'],\n    ['clarity.setTag', 'data_total', '555'],\n    ['clarity.event', 'order complete'],\n  ],\n};\n\n/**\n * Combined-feature rule - Clarity's canonical usage pattern: identify the\n * user, set session tags, upgrade session priority, then fire the event.\n * This is the authoritative test for the push execution order\n * (identify → tags → upgrade → event).\n */\nexport const combinedFeatures: ClarityStepExample = {\n  title: 'Combined features',\n  description:\n    'A purchase identifies the user, sets an order tag, upgrades the session, and fires the Clarity event in order.',\n  in: getEvent('order complete', { timestamp: 1700000108 }),\n  mapping: {\n    name: 'Purchase',\n    settings: {\n      identify: { map: { customId: 'user.id' } },\n      set: { map: { order_id: 'data.id' } },\n      upgrade: { value: 'purchase' },\n    },\n  },\n  out: [\n    ['clarity.identify', 'us3r'],\n    ['clarity.setTag', 'order_id', '0rd3r1d'],\n    ['clarity.upgrade', 'purchase'],\n    ['clarity.event', 'Purchase'],\n  ],\n};\n\n/**\n * mapping.silent - the rule runs (set/identify/upgrade all execute) but the\n * default Clarity.event(...) call is suppressed. Useful for page view, where\n * Clarity has its own page tracking and you only want to set tags.\n */\nexport const pageViewSilent: ClarityStepExample = {\n  title: 'Tags without event',\n  description:\n    'A page view sets Clarity tags while silent suppresses the event, letting Clarity handle page tracking itself.',\n  in: getEvent('page view', { timestamp: 1700000109 }),\n  mapping: {\n    silent: true,\n    settings: {\n      set: {\n        map: {\n          page_id: 'data.id',\n        },\n      },\n    },\n  },\n  out: [['clarity.setTag', 'page_id', '/docs/']],\n};\n\n/**\n * Consent translation via settings.consent.\n * walkerOS consent { analytics: true, marketing: true } with the mapping\n * { analytics: 'analytics_Storage', marketing: 'ad_Storage' } fires:\n *   Clarity.consentV2({ analytics_Storage: 'granted', ad_Storage: 'granted' })\n *\n * Uses the canonical StepExample.command='consent' pattern: the test runner\n * dispatches via elb('walker consent', in) instead of pushing an event.\n */\nexport const consentGrantBoth: ClarityStepExample = {\n  title: 'Consent granted',\n  description:\n    'A walker consent command translates analytics and marketing grants into a Clarity.consentV2 call.',\n  command: 'consent',\n  in: { analytics: true, marketing: true } as WalkerOS.Consent,\n  settings: {\n    consent: {\n      analytics: 'analytics_Storage',\n      marketing: 'ad_Storage',\n    },\n  },\n  out: [\n    [\n      'clarity.consentV2',\n      { analytics_Storage: 'granted', ad_Storage: 'granted' },\n    ],\n  ],\n};\n\n/**\n * Consent revocation - denied categories call Clarity.consentV2(...) with\n * denied flags. The destination does NOT call the legacy `Clarity.consent(false)`\n * API at all - consentV2 is the single source of truth for consent state.\n */\nexport const consentRevoke: ClarityStepExample = {\n  title: 'Consent revoked',\n  description:\n    'A walker consent command with analytics and marketing denied calls Clarity.consentV2 with denied flags.',\n  command: 'consent',\n  in: { analytics: false, marketing: false } as WalkerOS.Consent,\n  settings: {\n    consent: {\n      analytics: 'analytics_Storage',\n      marketing: 'ad_Storage',\n    },\n  },\n  out: [\n    [\n      'clarity.consentV2',\n      { analytics_Storage: 'denied', ad_Storage: 'denied' },\n    ],\n  ],\n};\n"],"mappings":"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","names":["import_dev","import_dev"]}
+{"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  apiKey: z\n    .string()\n    .min(1)\n    .describe(\n      'Your Microsoft Clarity project ID (e.g. \"3t0wlogvdz\"). Find it in your Clarity dashboard under Settings → Setup.',\n    ),\n  consent: z\n    .record(z.string(), z.enum(['analytics_Storage', 'ad_Storage']))\n    .describe(\n      'Translation table from walkerOS consent keys to Clarity ConsentV2 categories. Example: { \"analytics\": \"analytics_Storage\", \"marketing\": \"ad_Storage\" }. Required to get meaningful consent behavior — Clarity expects its own category names.',\n    )\n    .optional(),\n  identify: z\n    .unknown()\n    .describe(\n      'walkerOS mapping value resolving to positional arguments for Clarity.identify(). Keys: customId (required), customSessionId?, customPageId?, friendlyName?.',\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  identify: z\n    .unknown()\n    .describe(\n      'Per-event identity mapping. Resolves to { customId, customSessionId?, customPageId?, friendlyName? } → Clarity.identify(...).',\n    )\n    .optional(),\n  set: z\n    .unknown()\n    .describe(\n      'Explicit custom tag mapping. Resolved object keys become Clarity.setTag(key, value) calls. Array values pass through as string[] unchanged.',\n    )\n    .optional(),\n  upgrade: z\n    .unknown()\n    .describe(\n      'Session priority reason. Resolves to a string → Clarity.upgrade(reason). Used to flag important sessions for retention beyond sampling.',\n    )\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 Microsoft Clarity destination.\n *\n * Tests clone `push` and replace individual methods with jest spies.\n * Production leaves `env.clarity` undefined — the destination falls back\n * to the real `@microsoft/clarity` default export.\n */\n\nconst noop = () => {};\n\n/**\n * Pre-init environment — Clarity SDK methods are no-ops until init wires them.\n */\nexport const init: Env | undefined = {\n  clarity: {\n    init: noop,\n    identify: noop,\n    setTag: noop,\n    event: noop,\n    consentV2: noop,\n    upgrade: noop,\n  },\n};\n\n/**\n * Post-init environment — Clarity SDK methods are spy-able no-ops.\n * Tests clone this and replace individual methods with jest.fn() for assertions.\n */\nexport const push: Env = {\n  clarity: {\n    init: noop,\n    identify: noop,\n    setTag: noop,\n    event: noop,\n    consentV2: noop,\n    upgrade: noop,\n  },\n};\n\n/**\n * Simulation tracking paths for CLI --simulate\n */\nexport const simulation = [\n  'call:clarity.init',\n  'call:clarity.identify',\n  'call:clarity.setTag',\n  'call:clarity.event',\n  'call:clarity.consentV2',\n  'call:clarity.upgrade',\n];\n","import type { Flow, WalkerOS } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * Examples may optionally override destination-level settings for a test.\n * The test runner reads `settings` from the example and merges it into the\n * base destination settings (on top of the fixed `apiKey`). `configInclude`\n * is passed as config-level include when registering the destination.\n */\nexport type ClarityStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n  configInclude?: string[];\n  /** Consent granted before `in` so a gated destination is loaded first. */\n  before?: WalkerOS.Consent;\n};\n\n/**\n * Default event forwarding - every walkerOS event becomes Clarity.event(name).\n * No mapping rule; the destination's default push behavior fires.\n */\nexport const defaultEventForwarding: ClarityStepExample = {\n  title: 'Default event',\n  description:\n    'A walker event becomes a Clarity.event call with the event name as the Clarity custom event.',\n  in: getEvent('product view', { timestamp: 1700000100 }),\n  out: [['clarity.event', 'product view']],\n};\n\n/**\n * Wildcard ignore pattern - the standard walkerOS way to suppress noisy events.\n * The destination forwards by default; users opt OUT via `\"*\": { \"*\": { ignore: true } }`\n * plus explicit allows. This example IS an ignored event - the destination\n * must produce zero calls.\n */\nexport const wildcardIgnored: ClarityStepExample = {\n  public: false,\n  in: getEvent('debug noise', { timestamp: 1700000101 }),\n  mapping: { ignore: true },\n  out: [],\n};\n\n/**\n * Identity via settings.identify (per-event, user login).\n * Resolves positional args for Clarity.identify(customId, sessionId, pageId, friendlyName).\n * Trailing undefined args are omitted, so all four args are passed when friendlyName is set.\n * Then fires the default Clarity.event(...) forwarding.\n */\nexport const userLoginIdentify: ClarityStepExample = {\n  title: 'User login identify',\n  description:\n    'A user login fires Clarity.identify with custom id, session id, page id, and friendly name then tracks the event.',\n  in: getEvent('user login', {\n    timestamp: 1700000102,\n    data: { id: 'u-123', name: 'Jane Doe' },\n    globals: { pagegroup: 'shop', pagetype: 'home' },\n  }),\n  mapping: {\n    settings: {\n      identify: {\n        map: {\n          customId: 'data.id',\n          customSessionId: 'user.session',\n          customPageId: 'globals.pagetype',\n          friendlyName: 'data.name',\n        },\n      },\n    },\n  },\n  out: [\n    ['clarity.identify', 'u-123', 's3ss10n', 'home', 'Jane Doe'],\n    ['clarity.event', 'user login'],\n  ],\n};\n\n/**\n * Destination-level settings.identify - Clarity officially recommends calling\n * identify() on every page load. walkerOS expresses this via destination-level\n * `settings.identify`, which fires on every push.\n */\nexport const destinationLevelIdentify: ClarityStepExample = {\n  title: 'Destination identify',\n  description:\n    'Destination-level identify calls Clarity.identify with the user id on every push as Clarity recommends.',\n  in: getEvent('page view', { timestamp: 1700000103 }),\n  settings: {\n    identify: {\n      map: {\n        customId: 'user.id',\n      },\n    },\n  },\n  out: [\n    ['clarity.identify', 'us3r'],\n    ['clarity.event', 'page view'],\n  ],\n};\n\n/**\n * Explicit custom tags via mapping.settings.set.\n * Each resolved key → Clarity.setTag(key, value). Tags fire after identify\n * but before the default event.\n */\nexport const productViewWithTags: ClarityStepExample = {\n  title: 'Custom tags',\n  description:\n    'A product view sets Clarity session tags such as product color and id before firing the event.',\n  in: getEvent('product view', { timestamp: 1700000104 }),\n  mapping: {\n    settings: {\n      set: {\n        map: {\n          product_color: 'data.color',\n          product_id: 'data.id',\n        },\n      },\n    },\n  },\n  out: [\n    ['clarity.setTag', 'product_color', 'black'],\n    ['clarity.setTag', 'product_id', 'ers'],\n    ['clarity.event', 'product view'],\n  ],\n};\n\n/**\n * Array tag values - Clarity.setTag(key, value) natively accepts string[].\n * walkerOS array values are passed through unchanged (each element is\n * coerced to string, but the array shape is preserved - no flattening,\n * no splitting into multiple calls).\n */\nexport const arrayTagValue: ClarityStepExample = {\n  title: 'Array tag values',\n  description:\n    'Array values such as product tags are passed through to Clarity.setTag preserving the array shape.',\n  in: getEvent('product view', {\n    timestamp: 1700000105,\n    data: {\n      id: 'ers',\n      name: 'Everyday Ruck Snack',\n      color: 'black',\n      size: 'l',\n      price: 420,\n      tags: ['sale', 'featured'],\n    },\n  }),\n  mapping: {\n    settings: {\n      set: {\n        map: {\n          product_tags: 'data.tags',\n        },\n      },\n    },\n  },\n  out: [\n    ['clarity.setTag', 'product_tags', ['sale', 'featured']],\n    ['clarity.event', 'product view'],\n  ],\n};\n\n/**\n * Session priority upgrade - mark this session as important so Clarity retains\n * it beyond the sampling cap. upgrade fires before the default event.\n */\nexport const orderCompleteUpgrade: ClarityStepExample = {\n  title: 'Upgrade session',\n  description:\n    'A completed order upgrades the Clarity session priority so it is retained beyond the sampling cap.',\n  in: getEvent('order complete', { timestamp: 1700000106 }),\n  mapping: {\n    name: 'Purchase',\n    settings: {\n      upgrade: { value: 'purchase' },\n    },\n  },\n  out: [\n    ['clarity.upgrade', 'purchase'],\n    ['clarity.event', 'Purchase'],\n  ],\n};\n\n/**\n * settings.include flattens a walkerOS event section into Clarity.setTag calls.\n * Primitives coerce to strings; arrays pass through as string[].\n * The example includes `data` only; keys become `data_<field>`.\n */\nexport const orderCompleteInclude: ClarityStepExample = {\n  title: 'Include data as tags',\n  description:\n    'A mapping include flattens the event data section into Clarity.setTag calls before the event fires.',\n  in: getEvent('order complete', { timestamp: 1700000107 }),\n  mapping: {\n    include: ['data'],\n  },\n  out: [\n    ['clarity.setTag', 'data_id', '0rd3r1d'],\n    ['clarity.setTag', 'data_currency', 'EUR'],\n    ['clarity.setTag', 'data_shipping', '5.22'],\n    ['clarity.setTag', 'data_taxes', '73.76'],\n    ['clarity.setTag', 'data_total', '555'],\n    ['clarity.event', 'order complete'],\n  ],\n};\n\n/**\n * Combined-feature rule - Clarity's canonical usage pattern: identify the\n * user, set session tags, upgrade session priority, then fire the event.\n * This is the authoritative test for the push execution order\n * (identify → tags → upgrade → event).\n */\nexport const combinedFeatures: ClarityStepExample = {\n  title: 'Combined features',\n  description:\n    'A purchase identifies the user, sets an order tag, upgrades the session, and fires the Clarity event in order.',\n  in: getEvent('order complete', { timestamp: 1700000108 }),\n  mapping: {\n    name: 'Purchase',\n    settings: {\n      identify: { map: { customId: 'user.id' } },\n      set: { map: { order_id: 'data.id' } },\n      upgrade: { value: 'purchase' },\n    },\n  },\n  out: [\n    ['clarity.identify', 'us3r'],\n    ['clarity.setTag', 'order_id', '0rd3r1d'],\n    ['clarity.upgrade', 'purchase'],\n    ['clarity.event', 'Purchase'],\n  ],\n};\n\n/**\n * mapping.silent - the rule runs (set/identify/upgrade all execute) but the\n * default Clarity.event(...) call is suppressed. Useful for page view, where\n * Clarity has its own page tracking and you only want to set tags.\n */\nexport const pageViewSilent: ClarityStepExample = {\n  title: 'Tags without event',\n  description:\n    'A page view sets Clarity tags while silent suppresses the event, letting Clarity handle page tracking itself.',\n  in: getEvent('page view', { timestamp: 1700000109 }),\n  mapping: {\n    silent: true,\n    settings: {\n      set: {\n        map: {\n          page_id: 'data.id',\n        },\n      },\n    },\n  },\n  out: [['clarity.setTag', 'page_id', '/docs/']],\n};\n\n/**\n * Consent translation via settings.consent.\n * walkerOS consent { analytics: true, marketing: true } with the mapping\n * { analytics: 'analytics_Storage', marketing: 'ad_Storage' } fires:\n *   Clarity.consentV2({ analytics_Storage: 'granted', ad_Storage: 'granted' })\n *\n * Uses the canonical StepExample.command='consent' pattern: the test runner\n * dispatches via elb('walker consent', in) instead of pushing an event.\n */\nexport const consentGrantBoth: ClarityStepExample = {\n  title: 'Consent granted',\n  description:\n    'A walker consent command translates analytics and marketing grants into a Clarity.consentV2 call.',\n  command: 'consent',\n  in: { analytics: true, marketing: true } as WalkerOS.Consent,\n  settings: {\n    consent: {\n      analytics: 'analytics_Storage',\n      marketing: 'ad_Storage',\n    },\n  },\n  out: [\n    [\n      'clarity.consentV2',\n      { analytics_Storage: 'granted', ad_Storage: 'granted' },\n    ],\n  ],\n};\n\n/**\n * Consent revocation - after analytics and marketing are granted (Clarity\n * loads), revoking them calls Clarity.consentV2(...) with denied flags. The\n * destination does NOT call the legacy `Clarity.consent(false)` API at all -\n * consentV2 is the single source of truth for consent state. The destination\n * is never loaded under denied consent, so the revoke acts on an\n * already-granted destination.\n */\nexport const consentRevoke: ClarityStepExample = {\n  title: 'Consent revoked',\n  description:\n    'A walker consent command with analytics and marketing denied calls Clarity.consentV2 with denied flags.',\n  command: 'consent',\n  before: { analytics: true, marketing: true },\n  in: { analytics: false, marketing: false } as WalkerOS.Consent,\n  settings: {\n    consent: {\n      analytics: 'analytics_Storage',\n      marketing: 'ad_Storage',\n    },\n  },\n  out: [\n    [\n      'clarity.consentV2',\n      { analytics_Storage: 'granted', ad_Storage: 'granted' },\n    ],\n    [\n      'clarity.consentV2',\n      { analytics_Storage: 'denied', ad_Storage: 'denied' },\n    ],\n  ],\n};\n"],"mappings":"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","names":["import_dev","import_dev"]}

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:()=>o,SettingsSchema:()=>s,mapping:()=>l,settings:()=>d});import{zodToSchema as i}from"@walkeros/core/dev";import{z as n}from"@walkeros/core/dev";var s=n.object({apiKey:n.string().min(1).describe('Your Microsoft Clarity project ID (e.g. "3t0wlogvdz"). Find it in your Clarity dashboard under Settings → Setup.'),consent:n.record(n.string(),n.enum(["analytics_Storage","ad_Storage"])).describe('Translation table from walkerOS consent keys to Clarity ConsentV2 categories. Example: { "analytics": "analytics_Storage", "marketing": "ad_Storage" }. Required to get meaningful consent behavior — Clarity expects its own category names.').optional(),identify:n.unknown().describe("walkerOS mapping value resolving to positional arguments for Clarity.identify(). Keys: customId (required), customSessionId?, customPageId?, friendlyName?.").optional()});import{z as r}from"@walkeros/core/dev";var o=r.object({identify:r.unknown().describe("Per-event identity mapping. Resolves to { customId, customSessionId?, customPageId?, friendlyName? } → Clarity.identify(...).").optional(),set:r.unknown().describe("Explicit custom tag mapping. Resolved object keys become Clarity.setTag(key, value) calls. Array values pass through as string[] unchanged.").optional(),upgrade:r.unknown().describe("Session priority reason. Resolves to a string → Clarity.upgrade(reason). Used to flag important sessions for retention beyond sampling.").optional()}),d=i(s),l=i(o),c={};t(c,{env:()=>p,step:()=>v});var p={};t(p,{init:()=>u,push:()=>m,simulation:()=>y});var g=()=>{},u={clarity:{init:g,identify:g,setTag:g,event:g,consentV2:g,upgrade:g}},m={clarity:{init:g,identify:g,setTag:g,event:g,consentV2:g,upgrade:g}},y=["call:clarity.init","call:clarity.identify","call:clarity.setTag","call:clarity.event","call:clarity.consentV2","call:clarity.upgrade"],v={};t(v,{arrayTagValue:()=>_,combinedFeatures:()=>I,consentGrantBoth:()=>V,consentRevoke:()=>P,defaultEventForwarding:()=>f,destinationLevelIdentify:()=>C,orderCompleteInclude:()=>T,orderCompleteUpgrade:()=>S,pageViewSilent:()=>A,productViewWithTags:()=>b,userLoginIdentify:()=>k,wildcardIgnored:()=>w});import{getEvent as h}from"@walkeros/core";var f={title:"Default event",description:"A walker event becomes a Clarity.event call with the event name as the Clarity custom event.",in:h("product view",{timestamp:1700000100}),out:[["clarity.event","product view"]]},w={public:!1,in:h("debug noise",{timestamp:1700000101}),mapping:{ignore:!0},out:[]},k={title:"User login identify",description:"A user login fires Clarity.identify with custom id, session id, page id, and friendly name then tracks the event.",in:h("user login",{timestamp:1700000102,data:{id:"u-123",name:"Jane Doe"},globals:{pagegroup:"shop",pagetype:"home"}}),mapping:{settings:{identify:{map:{customId:"data.id",customSessionId:"user.session",customPageId:"globals.pagetype",friendlyName:"data.name"}}}},out:[["clarity.identify","u-123","s3ss10n","home","Jane Doe"],["clarity.event","user login"]]},C={title:"Destination identify",description:"Destination-level identify calls Clarity.identify with the user id on every push as Clarity recommends.",in:h("page view",{timestamp:1700000103}),settings:{identify:{map:{customId:"user.id"}}},out:[["clarity.identify","us3r"],["clarity.event","page view"]]},b={title:"Custom tags",description:"A product view sets Clarity session tags such as product color and id before firing the event.",in:h("product view",{timestamp:1700000104}),mapping:{settings:{set:{map:{product_color:"data.color",product_id:"data.id"}}}},out:[["clarity.setTag","product_color","black"],["clarity.setTag","product_id","ers"],["clarity.event","product view"]]},_={title:"Array tag values",description:"Array values such as product tags are passed through to Clarity.setTag preserving the array shape.",in:h("product view",{timestamp:1700000105,data:{id:"ers",name:"Everyday Ruck Snack",color:"black",size:"l",price:420,tags:["sale","featured"]}}),mapping:{settings:{set:{map:{product_tags:"data.tags"}}}},out:[["clarity.setTag","product_tags",["sale","featured"]],["clarity.event","product view"]]},S={title:"Upgrade session",description:"A completed order upgrades the Clarity session priority so it is retained beyond the sampling cap.",in:h("order complete",{timestamp:1700000106}),mapping:{name:"Purchase",settings:{upgrade:{value:"purchase"}}},out:[["clarity.upgrade","purchase"],["clarity.event","Purchase"]]},T={title:"Include data as tags",description:"A mapping include flattens the event data section into Clarity.setTag calls before the event fires.",in:h("order complete",{timestamp:1700000107}),mapping:{include:["data"]},out:[["clarity.setTag","data_id","0rd3r1d"],["clarity.setTag","data_currency","EUR"],["clarity.setTag","data_shipping","5.22"],["clarity.setTag","data_taxes","73.76"],["clarity.setTag","data_total","555"],["clarity.event","order complete"]]},I={title:"Combined features",description:"A purchase identifies the user, sets an order tag, upgrades the session, and fires the Clarity event in order.",in:h("order complete",{timestamp:1700000108}),mapping:{name:"Purchase",settings:{identify:{map:{customId:"user.id"}},set:{map:{order_id:"data.id"}},upgrade:{value:"purchase"}}},out:[["clarity.identify","us3r"],["clarity.setTag","order_id","0rd3r1d"],["clarity.upgrade","purchase"],["clarity.event","Purchase"]]},A={title:"Tags without event",description:"A page view sets Clarity tags while silent suppresses the event, letting Clarity handle page tracking itself.",in:h("page view",{timestamp:1700000109}),mapping:{silent:!0,settings:{set:{map:{page_id:"data.id"}}}},out:[["clarity.setTag","page_id","/docs/"]]},V={title:"Consent granted",description:"A walker consent command translates analytics and marketing grants into a Clarity.consentV2 call.",command:"consent",in:{analytics:!0,marketing:!0},settings:{consent:{analytics:"analytics_Storage",marketing:"ad_Storage"}},out:[["clarity.consentV2",{analytics_Storage:"granted",ad_Storage:"granted"}]]},P={title:"Consent revoked",description:"A walker consent command with analytics and marketing denied calls Clarity.consentV2 with denied flags.",command:"consent",in:{analytics:!1,marketing:!1},settings:{consent:{analytics:"analytics_Storage",marketing:"ad_Storage"}},out:[["clarity.consentV2",{analytics_Storage:"denied",ad_Storage:"denied"}]]};export{c 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:()=>o,SettingsSchema:()=>r,mapping:()=>l,settings:()=>d});import{zodToSchema as i}from"@walkeros/core/dev";import{z as n}from"@walkeros/core/dev";var r=n.object({apiKey:n.string().min(1).describe('Your Microsoft Clarity project ID (e.g. "3t0wlogvdz"). Find it in your Clarity dashboard under Settings → Setup.'),consent:n.record(n.string(),n.enum(["analytics_Storage","ad_Storage"])).describe('Translation table from walkerOS consent keys to Clarity ConsentV2 categories. Example: { "analytics": "analytics_Storage", "marketing": "ad_Storage" }. Required to get meaningful consent behavior — Clarity expects its own category names.').optional(),identify:n.unknown().describe("walkerOS mapping value resolving to positional arguments for Clarity.identify(). Keys: customId (required), customSessionId?, customPageId?, friendlyName?.").optional()});import{z as s}from"@walkeros/core/dev";var o=s.object({identify:s.unknown().describe("Per-event identity mapping. Resolves to { customId, customSessionId?, customPageId?, friendlyName? } → Clarity.identify(...).").optional(),set:s.unknown().describe("Explicit custom tag mapping. Resolved object keys become Clarity.setTag(key, value) calls. Array values pass through as string[] unchanged.").optional(),upgrade:s.unknown().describe("Session priority reason. Resolves to a string → Clarity.upgrade(reason). Used to flag important sessions for retention beyond sampling.").optional()}),d=i(r),l=i(o),c={};t(c,{env:()=>p,step:()=>v});var p={};t(p,{init:()=>u,push:()=>m,simulation:()=>y});var g=()=>{},u={clarity:{init:g,identify:g,setTag:g,event:g,consentV2:g,upgrade:g}},m={clarity:{init:g,identify:g,setTag:g,event:g,consentV2:g,upgrade:g}},y=["call:clarity.init","call:clarity.identify","call:clarity.setTag","call:clarity.event","call:clarity.consentV2","call:clarity.upgrade"],v={};t(v,{arrayTagValue:()=>_,combinedFeatures:()=>I,consentGrantBoth:()=>V,consentRevoke:()=>P,defaultEventForwarding:()=>f,destinationLevelIdentify:()=>b,orderCompleteInclude:()=>T,orderCompleteUpgrade:()=>S,pageViewSilent:()=>A,productViewWithTags:()=>C,userLoginIdentify:()=>k,wildcardIgnored:()=>w});import{getEvent as h}from"@walkeros/core";var f={title:"Default event",description:"A walker event becomes a Clarity.event call with the event name as the Clarity custom event.",in:h("product view",{timestamp:1700000100}),out:[["clarity.event","product view"]]},w={public:!1,in:h("debug noise",{timestamp:1700000101}),mapping:{ignore:!0},out:[]},k={title:"User login identify",description:"A user login fires Clarity.identify with custom id, session id, page id, and friendly name then tracks the event.",in:h("user login",{timestamp:1700000102,data:{id:"u-123",name:"Jane Doe"},globals:{pagegroup:"shop",pagetype:"home"}}),mapping:{settings:{identify:{map:{customId:"data.id",customSessionId:"user.session",customPageId:"globals.pagetype",friendlyName:"data.name"}}}},out:[["clarity.identify","u-123","s3ss10n","home","Jane Doe"],["clarity.event","user login"]]},b={title:"Destination identify",description:"Destination-level identify calls Clarity.identify with the user id on every push as Clarity recommends.",in:h("page view",{timestamp:1700000103}),settings:{identify:{map:{customId:"user.id"}}},out:[["clarity.identify","us3r"],["clarity.event","page view"]]},C={title:"Custom tags",description:"A product view sets Clarity session tags such as product color and id before firing the event.",in:h("product view",{timestamp:1700000104}),mapping:{settings:{set:{map:{product_color:"data.color",product_id:"data.id"}}}},out:[["clarity.setTag","product_color","black"],["clarity.setTag","product_id","ers"],["clarity.event","product view"]]},_={title:"Array tag values",description:"Array values such as product tags are passed through to Clarity.setTag preserving the array shape.",in:h("product view",{timestamp:1700000105,data:{id:"ers",name:"Everyday Ruck Snack",color:"black",size:"l",price:420,tags:["sale","featured"]}}),mapping:{settings:{set:{map:{product_tags:"data.tags"}}}},out:[["clarity.setTag","product_tags",["sale","featured"]],["clarity.event","product view"]]},S={title:"Upgrade session",description:"A completed order upgrades the Clarity session priority so it is retained beyond the sampling cap.",in:h("order complete",{timestamp:1700000106}),mapping:{name:"Purchase",settings:{upgrade:{value:"purchase"}}},out:[["clarity.upgrade","purchase"],["clarity.event","Purchase"]]},T={title:"Include data as tags",description:"A mapping include flattens the event data section into Clarity.setTag calls before the event fires.",in:h("order complete",{timestamp:1700000107}),mapping:{include:["data"]},out:[["clarity.setTag","data_id","0rd3r1d"],["clarity.setTag","data_currency","EUR"],["clarity.setTag","data_shipping","5.22"],["clarity.setTag","data_taxes","73.76"],["clarity.setTag","data_total","555"],["clarity.event","order complete"]]},I={title:"Combined features",description:"A purchase identifies the user, sets an order tag, upgrades the session, and fires the Clarity event in order.",in:h("order complete",{timestamp:1700000108}),mapping:{name:"Purchase",settings:{identify:{map:{customId:"user.id"}},set:{map:{order_id:"data.id"}},upgrade:{value:"purchase"}}},out:[["clarity.identify","us3r"],["clarity.setTag","order_id","0rd3r1d"],["clarity.upgrade","purchase"],["clarity.event","Purchase"]]},A={title:"Tags without event",description:"A page view sets Clarity tags while silent suppresses the event, letting Clarity handle page tracking itself.",in:h("page view",{timestamp:1700000109}),mapping:{silent:!0,settings:{set:{map:{page_id:"data.id"}}}},out:[["clarity.setTag","page_id","/docs/"]]},V={title:"Consent granted",description:"A walker consent command translates analytics and marketing grants into a Clarity.consentV2 call.",command:"consent",in:{analytics:!0,marketing:!0},settings:{consent:{analytics:"analytics_Storage",marketing:"ad_Storage"}},out:[["clarity.consentV2",{analytics_Storage:"granted",ad_Storage:"granted"}]]},P={title:"Consent revoked",description:"A walker consent command with analytics and marketing denied calls Clarity.consentV2 with denied flags.",command:"consent",before:{analytics:!0,marketing:!0},in:{analytics:!1,marketing:!1},settings:{consent:{analytics:"analytics_Storage",marketing:"ad_Storage"}},out:[["clarity.consentV2",{analytics_Storage:"granted",ad_Storage:"granted"}],["clarity.consentV2",{analytics_Storage:"denied",ad_Storage:"denied"}]]};export{c 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 { z } from '@walkeros/core/dev';\n\nexport const SettingsSchema = z.object({\n  apiKey: z\n    .string()\n    .min(1)\n    .describe(\n      'Your Microsoft Clarity project ID (e.g. \"3t0wlogvdz\"). Find it in your Clarity dashboard under Settings → Setup.',\n    ),\n  consent: z\n    .record(z.string(), z.enum(['analytics_Storage', 'ad_Storage']))\n    .describe(\n      'Translation table from walkerOS consent keys to Clarity ConsentV2 categories. Example: { \"analytics\": \"analytics_Storage\", \"marketing\": \"ad_Storage\" }. Required to get meaningful consent behavior — Clarity expects its own category names.',\n    )\n    .optional(),\n  identify: z\n    .unknown()\n    .describe(\n      'walkerOS mapping value resolving to positional arguments for Clarity.identify(). Keys: customId (required), customSessionId?, customPageId?, friendlyName?.',\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  identify: z\n    .unknown()\n    .describe(\n      'Per-event identity mapping. Resolves to { customId, customSessionId?, customPageId?, friendlyName? } → Clarity.identify(...).',\n    )\n    .optional(),\n  set: z\n    .unknown()\n    .describe(\n      'Explicit custom tag mapping. Resolved object keys become Clarity.setTag(key, value) calls. Array values pass through as string[] unchanged.',\n    )\n    .optional(),\n  upgrade: z\n    .unknown()\n    .describe(\n      'Session priority reason. Resolves to a string → Clarity.upgrade(reason). Used to flag important sessions for retention beyond sampling.',\n    )\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 Microsoft Clarity destination.\n *\n * Tests clone `push` and replace individual methods with jest spies.\n * Production leaves `env.clarity` undefined — the destination falls back\n * to the real `@microsoft/clarity` default export.\n */\n\nconst noop = () => {};\n\n/**\n * Pre-init environment — Clarity SDK methods are no-ops until init wires them.\n */\nexport const init: Env | undefined = {\n  clarity: {\n    init: noop,\n    identify: noop,\n    setTag: noop,\n    event: noop,\n    consentV2: noop,\n    upgrade: noop,\n  },\n};\n\n/**\n * Post-init environment — Clarity SDK methods are spy-able no-ops.\n * Tests clone this and replace individual methods with jest.fn() for assertions.\n */\nexport const push: Env = {\n  clarity: {\n    init: noop,\n    identify: noop,\n    setTag: noop,\n    event: noop,\n    consentV2: noop,\n    upgrade: noop,\n  },\n};\n\n/**\n * Simulation tracking paths for CLI --simulate\n */\nexport const simulation = [\n  'call:clarity.init',\n  'call:clarity.identify',\n  'call:clarity.setTag',\n  'call:clarity.event',\n  'call:clarity.consentV2',\n  'call:clarity.upgrade',\n];\n","import type { Flow, WalkerOS } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * Examples may optionally override destination-level settings for a test.\n * The test runner reads `settings` from the example and merges it into the\n * base destination settings (on top of the fixed `apiKey`). `configInclude`\n * is passed as config-level include when registering the destination.\n */\nexport type ClarityStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n  configInclude?: string[];\n};\n\n/**\n * Default event forwarding - every walkerOS event becomes Clarity.event(name).\n * No mapping rule; the destination's default push behavior fires.\n */\nexport const defaultEventForwarding: ClarityStepExample = {\n  title: 'Default event',\n  description:\n    'A walker event becomes a Clarity.event call with the event name as the Clarity custom event.',\n  in: getEvent('product view', { timestamp: 1700000100 }),\n  out: [['clarity.event', 'product view']],\n};\n\n/**\n * Wildcard ignore pattern - the standard walkerOS way to suppress noisy events.\n * The destination forwards by default; users opt OUT via `\"*\": { \"*\": { ignore: true } }`\n * plus explicit allows. This example IS an ignored event - the destination\n * must produce zero calls.\n */\nexport const wildcardIgnored: ClarityStepExample = {\n  public: false,\n  in: getEvent('debug noise', { timestamp: 1700000101 }),\n  mapping: { ignore: true },\n  out: [],\n};\n\n/**\n * Identity via settings.identify (per-event, user login).\n * Resolves positional args for Clarity.identify(customId, sessionId, pageId, friendlyName).\n * Trailing undefined args are omitted, so all four args are passed when friendlyName is set.\n * Then fires the default Clarity.event(...) forwarding.\n */\nexport const userLoginIdentify: ClarityStepExample = {\n  title: 'User login identify',\n  description:\n    'A user login fires Clarity.identify with custom id, session id, page id, and friendly name then tracks the event.',\n  in: getEvent('user login', {\n    timestamp: 1700000102,\n    data: { id: 'u-123', name: 'Jane Doe' },\n    globals: { pagegroup: 'shop', pagetype: 'home' },\n  }),\n  mapping: {\n    settings: {\n      identify: {\n        map: {\n          customId: 'data.id',\n          customSessionId: 'user.session',\n          customPageId: 'globals.pagetype',\n          friendlyName: 'data.name',\n        },\n      },\n    },\n  },\n  out: [\n    ['clarity.identify', 'u-123', 's3ss10n', 'home', 'Jane Doe'],\n    ['clarity.event', 'user login'],\n  ],\n};\n\n/**\n * Destination-level settings.identify - Clarity officially recommends calling\n * identify() on every page load. walkerOS expresses this via destination-level\n * `settings.identify`, which fires on every push.\n */\nexport const destinationLevelIdentify: ClarityStepExample = {\n  title: 'Destination identify',\n  description:\n    'Destination-level identify calls Clarity.identify with the user id on every push as Clarity recommends.',\n  in: getEvent('page view', { timestamp: 1700000103 }),\n  settings: {\n    identify: {\n      map: {\n        customId: 'user.id',\n      },\n    },\n  },\n  out: [\n    ['clarity.identify', 'us3r'],\n    ['clarity.event', 'page view'],\n  ],\n};\n\n/**\n * Explicit custom tags via mapping.settings.set.\n * Each resolved key → Clarity.setTag(key, value). Tags fire after identify\n * but before the default event.\n */\nexport const productViewWithTags: ClarityStepExample = {\n  title: 'Custom tags',\n  description:\n    'A product view sets Clarity session tags such as product color and id before firing the event.',\n  in: getEvent('product view', { timestamp: 1700000104 }),\n  mapping: {\n    settings: {\n      set: {\n        map: {\n          product_color: 'data.color',\n          product_id: 'data.id',\n        },\n      },\n    },\n  },\n  out: [\n    ['clarity.setTag', 'product_color', 'black'],\n    ['clarity.setTag', 'product_id', 'ers'],\n    ['clarity.event', 'product view'],\n  ],\n};\n\n/**\n * Array tag values - Clarity.setTag(key, value) natively accepts string[].\n * walkerOS array values are passed through unchanged (each element is\n * coerced to string, but the array shape is preserved - no flattening,\n * no splitting into multiple calls).\n */\nexport const arrayTagValue: ClarityStepExample = {\n  title: 'Array tag values',\n  description:\n    'Array values such as product tags are passed through to Clarity.setTag preserving the array shape.',\n  in: getEvent('product view', {\n    timestamp: 1700000105,\n    data: {\n      id: 'ers',\n      name: 'Everyday Ruck Snack',\n      color: 'black',\n      size: 'l',\n      price: 420,\n      tags: ['sale', 'featured'],\n    },\n  }),\n  mapping: {\n    settings: {\n      set: {\n        map: {\n          product_tags: 'data.tags',\n        },\n      },\n    },\n  },\n  out: [\n    ['clarity.setTag', 'product_tags', ['sale', 'featured']],\n    ['clarity.event', 'product view'],\n  ],\n};\n\n/**\n * Session priority upgrade - mark this session as important so Clarity retains\n * it beyond the sampling cap. upgrade fires before the default event.\n */\nexport const orderCompleteUpgrade: ClarityStepExample = {\n  title: 'Upgrade session',\n  description:\n    'A completed order upgrades the Clarity session priority so it is retained beyond the sampling cap.',\n  in: getEvent('order complete', { timestamp: 1700000106 }),\n  mapping: {\n    name: 'Purchase',\n    settings: {\n      upgrade: { value: 'purchase' },\n    },\n  },\n  out: [\n    ['clarity.upgrade', 'purchase'],\n    ['clarity.event', 'Purchase'],\n  ],\n};\n\n/**\n * settings.include flattens a walkerOS event section into Clarity.setTag calls.\n * Primitives coerce to strings; arrays pass through as string[].\n * The example includes `data` only; keys become `data_<field>`.\n */\nexport const orderCompleteInclude: ClarityStepExample = {\n  title: 'Include data as tags',\n  description:\n    'A mapping include flattens the event data section into Clarity.setTag calls before the event fires.',\n  in: getEvent('order complete', { timestamp: 1700000107 }),\n  mapping: {\n    include: ['data'],\n  },\n  out: [\n    ['clarity.setTag', 'data_id', '0rd3r1d'],\n    ['clarity.setTag', 'data_currency', 'EUR'],\n    ['clarity.setTag', 'data_shipping', '5.22'],\n    ['clarity.setTag', 'data_taxes', '73.76'],\n    ['clarity.setTag', 'data_total', '555'],\n    ['clarity.event', 'order complete'],\n  ],\n};\n\n/**\n * Combined-feature rule - Clarity's canonical usage pattern: identify the\n * user, set session tags, upgrade session priority, then fire the event.\n * This is the authoritative test for the push execution order\n * (identify → tags → upgrade → event).\n */\nexport const combinedFeatures: ClarityStepExample = {\n  title: 'Combined features',\n  description:\n    'A purchase identifies the user, sets an order tag, upgrades the session, and fires the Clarity event in order.',\n  in: getEvent('order complete', { timestamp: 1700000108 }),\n  mapping: {\n    name: 'Purchase',\n    settings: {\n      identify: { map: { customId: 'user.id' } },\n      set: { map: { order_id: 'data.id' } },\n      upgrade: { value: 'purchase' },\n    },\n  },\n  out: [\n    ['clarity.identify', 'us3r'],\n    ['clarity.setTag', 'order_id', '0rd3r1d'],\n    ['clarity.upgrade', 'purchase'],\n    ['clarity.event', 'Purchase'],\n  ],\n};\n\n/**\n * mapping.silent - the rule runs (set/identify/upgrade all execute) but the\n * default Clarity.event(...) call is suppressed. Useful for page view, where\n * Clarity has its own page tracking and you only want to set tags.\n */\nexport const pageViewSilent: ClarityStepExample = {\n  title: 'Tags without event',\n  description:\n    'A page view sets Clarity tags while silent suppresses the event, letting Clarity handle page tracking itself.',\n  in: getEvent('page view', { timestamp: 1700000109 }),\n  mapping: {\n    silent: true,\n    settings: {\n      set: {\n        map: {\n          page_id: 'data.id',\n        },\n      },\n    },\n  },\n  out: [['clarity.setTag', 'page_id', '/docs/']],\n};\n\n/**\n * Consent translation via settings.consent.\n * walkerOS consent { analytics: true, marketing: true } with the mapping\n * { analytics: 'analytics_Storage', marketing: 'ad_Storage' } fires:\n *   Clarity.consentV2({ analytics_Storage: 'granted', ad_Storage: 'granted' })\n *\n * Uses the canonical StepExample.command='consent' pattern: the test runner\n * dispatches via elb('walker consent', in) instead of pushing an event.\n */\nexport const consentGrantBoth: ClarityStepExample = {\n  title: 'Consent granted',\n  description:\n    'A walker consent command translates analytics and marketing grants into a Clarity.consentV2 call.',\n  command: 'consent',\n  in: { analytics: true, marketing: true } as WalkerOS.Consent,\n  settings: {\n    consent: {\n      analytics: 'analytics_Storage',\n      marketing: 'ad_Storage',\n    },\n  },\n  out: [\n    [\n      'clarity.consentV2',\n      { analytics_Storage: 'granted', ad_Storage: 'granted' },\n    ],\n  ],\n};\n\n/**\n * Consent revocation - denied categories call Clarity.consentV2(...) with\n * denied flags. The destination does NOT call the legacy `Clarity.consent(false)`\n * API at all - consentV2 is the single source of truth for consent state.\n */\nexport const consentRevoke: ClarityStepExample = {\n  title: 'Consent revoked',\n  description:\n    'A walker consent command with analytics and marketing denied calls Clarity.consentV2 with denied flags.',\n  command: 'consent',\n  in: { analytics: false, marketing: false } as WalkerOS.Consent,\n  settings: {\n    consent: {\n      analytics: 'analytics_Storage',\n      marketing: 'ad_Storage',\n    },\n  },\n  out: [\n    [\n      'clarity.consentV2',\n      { analytics_Storage: 'denied', ad_Storage: 'denied' },\n    ],\n  ],\n};\n"],"mappings":"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","names":["z"]}
+{"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  apiKey: z\n    .string()\n    .min(1)\n    .describe(\n      'Your Microsoft Clarity project ID (e.g. \"3t0wlogvdz\"). Find it in your Clarity dashboard under Settings → Setup.',\n    ),\n  consent: z\n    .record(z.string(), z.enum(['analytics_Storage', 'ad_Storage']))\n    .describe(\n      'Translation table from walkerOS consent keys to Clarity ConsentV2 categories. Example: { \"analytics\": \"analytics_Storage\", \"marketing\": \"ad_Storage\" }. Required to get meaningful consent behavior — Clarity expects its own category names.',\n    )\n    .optional(),\n  identify: z\n    .unknown()\n    .describe(\n      'walkerOS mapping value resolving to positional arguments for Clarity.identify(). Keys: customId (required), customSessionId?, customPageId?, friendlyName?.',\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  identify: z\n    .unknown()\n    .describe(\n      'Per-event identity mapping. Resolves to { customId, customSessionId?, customPageId?, friendlyName? } → Clarity.identify(...).',\n    )\n    .optional(),\n  set: z\n    .unknown()\n    .describe(\n      'Explicit custom tag mapping. Resolved object keys become Clarity.setTag(key, value) calls. Array values pass through as string[] unchanged.',\n    )\n    .optional(),\n  upgrade: z\n    .unknown()\n    .describe(\n      'Session priority reason. Resolves to a string → Clarity.upgrade(reason). Used to flag important sessions for retention beyond sampling.',\n    )\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 Microsoft Clarity destination.\n *\n * Tests clone `push` and replace individual methods with jest spies.\n * Production leaves `env.clarity` undefined — the destination falls back\n * to the real `@microsoft/clarity` default export.\n */\n\nconst noop = () => {};\n\n/**\n * Pre-init environment — Clarity SDK methods are no-ops until init wires them.\n */\nexport const init: Env | undefined = {\n  clarity: {\n    init: noop,\n    identify: noop,\n    setTag: noop,\n    event: noop,\n    consentV2: noop,\n    upgrade: noop,\n  },\n};\n\n/**\n * Post-init environment — Clarity SDK methods are spy-able no-ops.\n * Tests clone this and replace individual methods with jest.fn() for assertions.\n */\nexport const push: Env = {\n  clarity: {\n    init: noop,\n    identify: noop,\n    setTag: noop,\n    event: noop,\n    consentV2: noop,\n    upgrade: noop,\n  },\n};\n\n/**\n * Simulation tracking paths for CLI --simulate\n */\nexport const simulation = [\n  'call:clarity.init',\n  'call:clarity.identify',\n  'call:clarity.setTag',\n  'call:clarity.event',\n  'call:clarity.consentV2',\n  'call:clarity.upgrade',\n];\n","import type { Flow, WalkerOS } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * Examples may optionally override destination-level settings for a test.\n * The test runner reads `settings` from the example and merges it into the\n * base destination settings (on top of the fixed `apiKey`). `configInclude`\n * is passed as config-level include when registering the destination.\n */\nexport type ClarityStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n  configInclude?: string[];\n  /** Consent granted before `in` so a gated destination is loaded first. */\n  before?: WalkerOS.Consent;\n};\n\n/**\n * Default event forwarding - every walkerOS event becomes Clarity.event(name).\n * No mapping rule; the destination's default push behavior fires.\n */\nexport const defaultEventForwarding: ClarityStepExample = {\n  title: 'Default event',\n  description:\n    'A walker event becomes a Clarity.event call with the event name as the Clarity custom event.',\n  in: getEvent('product view', { timestamp: 1700000100 }),\n  out: [['clarity.event', 'product view']],\n};\n\n/**\n * Wildcard ignore pattern - the standard walkerOS way to suppress noisy events.\n * The destination forwards by default; users opt OUT via `\"*\": { \"*\": { ignore: true } }`\n * plus explicit allows. This example IS an ignored event - the destination\n * must produce zero calls.\n */\nexport const wildcardIgnored: ClarityStepExample = {\n  public: false,\n  in: getEvent('debug noise', { timestamp: 1700000101 }),\n  mapping: { ignore: true },\n  out: [],\n};\n\n/**\n * Identity via settings.identify (per-event, user login).\n * Resolves positional args for Clarity.identify(customId, sessionId, pageId, friendlyName).\n * Trailing undefined args are omitted, so all four args are passed when friendlyName is set.\n * Then fires the default Clarity.event(...) forwarding.\n */\nexport const userLoginIdentify: ClarityStepExample = {\n  title: 'User login identify',\n  description:\n    'A user login fires Clarity.identify with custom id, session id, page id, and friendly name then tracks the event.',\n  in: getEvent('user login', {\n    timestamp: 1700000102,\n    data: { id: 'u-123', name: 'Jane Doe' },\n    globals: { pagegroup: 'shop', pagetype: 'home' },\n  }),\n  mapping: {\n    settings: {\n      identify: {\n        map: {\n          customId: 'data.id',\n          customSessionId: 'user.session',\n          customPageId: 'globals.pagetype',\n          friendlyName: 'data.name',\n        },\n      },\n    },\n  },\n  out: [\n    ['clarity.identify', 'u-123', 's3ss10n', 'home', 'Jane Doe'],\n    ['clarity.event', 'user login'],\n  ],\n};\n\n/**\n * Destination-level settings.identify - Clarity officially recommends calling\n * identify() on every page load. walkerOS expresses this via destination-level\n * `settings.identify`, which fires on every push.\n */\nexport const destinationLevelIdentify: ClarityStepExample = {\n  title: 'Destination identify',\n  description:\n    'Destination-level identify calls Clarity.identify with the user id on every push as Clarity recommends.',\n  in: getEvent('page view', { timestamp: 1700000103 }),\n  settings: {\n    identify: {\n      map: {\n        customId: 'user.id',\n      },\n    },\n  },\n  out: [\n    ['clarity.identify', 'us3r'],\n    ['clarity.event', 'page view'],\n  ],\n};\n\n/**\n * Explicit custom tags via mapping.settings.set.\n * Each resolved key → Clarity.setTag(key, value). Tags fire after identify\n * but before the default event.\n */\nexport const productViewWithTags: ClarityStepExample = {\n  title: 'Custom tags',\n  description:\n    'A product view sets Clarity session tags such as product color and id before firing the event.',\n  in: getEvent('product view', { timestamp: 1700000104 }),\n  mapping: {\n    settings: {\n      set: {\n        map: {\n          product_color: 'data.color',\n          product_id: 'data.id',\n        },\n      },\n    },\n  },\n  out: [\n    ['clarity.setTag', 'product_color', 'black'],\n    ['clarity.setTag', 'product_id', 'ers'],\n    ['clarity.event', 'product view'],\n  ],\n};\n\n/**\n * Array tag values - Clarity.setTag(key, value) natively accepts string[].\n * walkerOS array values are passed through unchanged (each element is\n * coerced to string, but the array shape is preserved - no flattening,\n * no splitting into multiple calls).\n */\nexport const arrayTagValue: ClarityStepExample = {\n  title: 'Array tag values',\n  description:\n    'Array values such as product tags are passed through to Clarity.setTag preserving the array shape.',\n  in: getEvent('product view', {\n    timestamp: 1700000105,\n    data: {\n      id: 'ers',\n      name: 'Everyday Ruck Snack',\n      color: 'black',\n      size: 'l',\n      price: 420,\n      tags: ['sale', 'featured'],\n    },\n  }),\n  mapping: {\n    settings: {\n      set: {\n        map: {\n          product_tags: 'data.tags',\n        },\n      },\n    },\n  },\n  out: [\n    ['clarity.setTag', 'product_tags', ['sale', 'featured']],\n    ['clarity.event', 'product view'],\n  ],\n};\n\n/**\n * Session priority upgrade - mark this session as important so Clarity retains\n * it beyond the sampling cap. upgrade fires before the default event.\n */\nexport const orderCompleteUpgrade: ClarityStepExample = {\n  title: 'Upgrade session',\n  description:\n    'A completed order upgrades the Clarity session priority so it is retained beyond the sampling cap.',\n  in: getEvent('order complete', { timestamp: 1700000106 }),\n  mapping: {\n    name: 'Purchase',\n    settings: {\n      upgrade: { value: 'purchase' },\n    },\n  },\n  out: [\n    ['clarity.upgrade', 'purchase'],\n    ['clarity.event', 'Purchase'],\n  ],\n};\n\n/**\n * settings.include flattens a walkerOS event section into Clarity.setTag calls.\n * Primitives coerce to strings; arrays pass through as string[].\n * The example includes `data` only; keys become `data_<field>`.\n */\nexport const orderCompleteInclude: ClarityStepExample = {\n  title: 'Include data as tags',\n  description:\n    'A mapping include flattens the event data section into Clarity.setTag calls before the event fires.',\n  in: getEvent('order complete', { timestamp: 1700000107 }),\n  mapping: {\n    include: ['data'],\n  },\n  out: [\n    ['clarity.setTag', 'data_id', '0rd3r1d'],\n    ['clarity.setTag', 'data_currency', 'EUR'],\n    ['clarity.setTag', 'data_shipping', '5.22'],\n    ['clarity.setTag', 'data_taxes', '73.76'],\n    ['clarity.setTag', 'data_total', '555'],\n    ['clarity.event', 'order complete'],\n  ],\n};\n\n/**\n * Combined-feature rule - Clarity's canonical usage pattern: identify the\n * user, set session tags, upgrade session priority, then fire the event.\n * This is the authoritative test for the push execution order\n * (identify → tags → upgrade → event).\n */\nexport const combinedFeatures: ClarityStepExample = {\n  title: 'Combined features',\n  description:\n    'A purchase identifies the user, sets an order tag, upgrades the session, and fires the Clarity event in order.',\n  in: getEvent('order complete', { timestamp: 1700000108 }),\n  mapping: {\n    name: 'Purchase',\n    settings: {\n      identify: { map: { customId: 'user.id' } },\n      set: { map: { order_id: 'data.id' } },\n      upgrade: { value: 'purchase' },\n    },\n  },\n  out: [\n    ['clarity.identify', 'us3r'],\n    ['clarity.setTag', 'order_id', '0rd3r1d'],\n    ['clarity.upgrade', 'purchase'],\n    ['clarity.event', 'Purchase'],\n  ],\n};\n\n/**\n * mapping.silent - the rule runs (set/identify/upgrade all execute) but the\n * default Clarity.event(...) call is suppressed. Useful for page view, where\n * Clarity has its own page tracking and you only want to set tags.\n */\nexport const pageViewSilent: ClarityStepExample = {\n  title: 'Tags without event',\n  description:\n    'A page view sets Clarity tags while silent suppresses the event, letting Clarity handle page tracking itself.',\n  in: getEvent('page view', { timestamp: 1700000109 }),\n  mapping: {\n    silent: true,\n    settings: {\n      set: {\n        map: {\n          page_id: 'data.id',\n        },\n      },\n    },\n  },\n  out: [['clarity.setTag', 'page_id', '/docs/']],\n};\n\n/**\n * Consent translation via settings.consent.\n * walkerOS consent { analytics: true, marketing: true } with the mapping\n * { analytics: 'analytics_Storage', marketing: 'ad_Storage' } fires:\n *   Clarity.consentV2({ analytics_Storage: 'granted', ad_Storage: 'granted' })\n *\n * Uses the canonical StepExample.command='consent' pattern: the test runner\n * dispatches via elb('walker consent', in) instead of pushing an event.\n */\nexport const consentGrantBoth: ClarityStepExample = {\n  title: 'Consent granted',\n  description:\n    'A walker consent command translates analytics and marketing grants into a Clarity.consentV2 call.',\n  command: 'consent',\n  in: { analytics: true, marketing: true } as WalkerOS.Consent,\n  settings: {\n    consent: {\n      analytics: 'analytics_Storage',\n      marketing: 'ad_Storage',\n    },\n  },\n  out: [\n    [\n      'clarity.consentV2',\n      { analytics_Storage: 'granted', ad_Storage: 'granted' },\n    ],\n  ],\n};\n\n/**\n * Consent revocation - after analytics and marketing are granted (Clarity\n * loads), revoking them calls Clarity.consentV2(...) with denied flags. The\n * destination does NOT call the legacy `Clarity.consent(false)` API at all -\n * consentV2 is the single source of truth for consent state. The destination\n * is never loaded under denied consent, so the revoke acts on an\n * already-granted destination.\n */\nexport const consentRevoke: ClarityStepExample = {\n  title: 'Consent revoked',\n  description:\n    'A walker consent command with analytics and marketing denied calls Clarity.consentV2 with denied flags.',\n  command: 'consent',\n  before: { analytics: true, marketing: true },\n  in: { analytics: false, marketing: false } as WalkerOS.Consent,\n  settings: {\n    consent: {\n      analytics: 'analytics_Storage',\n      marketing: 'ad_Storage',\n    },\n  },\n  out: [\n    [\n      'clarity.consentV2',\n      { analytics_Storage: 'granted', ad_Storage: 'granted' },\n    ],\n    [\n      'clarity.consentV2',\n      { analytics_Storage: 'denied', ad_Storage: 'denied' },\n    ],\n  ],\n};\n"],"mappings":"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","names":["z"]}

package/dist/examples/index.d.mts

@@ -1,4 +1,4 @@
-import { Mapping, Flow } from '@walkeros/core';
+import { Mapping, Flow, WalkerOS } from '@walkeros/core';
 import { DestinationWeb } from '@walkeros/web-core';
 
 /**
@@ -69,6 +69,8 @@ declare namespace env {
 type ClarityStepExample = Flow.StepExample & {
     settings?: Partial<Settings>;
     configInclude?: string[];
+    /** Consent granted before `in` so a gated destination is loaded first. */
+    before?: WalkerOS.Consent;
 };
 /**
  * Default event forwarding - every walkerOS event becomes Clarity.event(name).
@@ -143,9 +145,12 @@ declare const pageViewSilent: ClarityStepExample;
  */
 declare const consentGrantBoth: ClarityStepExample;
 /**
- * Consent revocation - denied categories call Clarity.consentV2(...) with
- * denied flags. The destination does NOT call the legacy `Clarity.consent(false)`
- * API at all - consentV2 is the single source of truth for consent state.
+ * Consent revocation - after analytics and marketing are granted (Clarity
+ * loads), revoking them calls Clarity.consentV2(...) with denied flags. The
+ * destination does NOT call the legacy `Clarity.consent(false)` API at all -
+ * consentV2 is the single source of truth for consent state. The destination
+ * is never loaded under denied consent, so the revoke acts on an
+ * already-granted destination.
  */
 declare const consentRevoke: ClarityStepExample;
 

package/dist/examples/index.d.ts

@@ -1,4 +1,4 @@
-import { Mapping, Flow } from '@walkeros/core';
+import { Mapping, Flow, WalkerOS } from '@walkeros/core';
 import { DestinationWeb } from '@walkeros/web-core';
 
 /**
@@ -69,6 +69,8 @@ declare namespace env {
 type ClarityStepExample = Flow.StepExample & {
     settings?: Partial<Settings>;
     configInclude?: string[];
+    /** Consent granted before `in` so a gated destination is loaded first. */
+    before?: WalkerOS.Consent;
 };
 /**
  * Default event forwarding - every walkerOS event becomes Clarity.event(name).
@@ -143,9 +145,12 @@ declare const pageViewSilent: ClarityStepExample;
  */
 declare const consentGrantBoth: ClarityStepExample;
 /**
- * Consent revocation - denied categories call Clarity.consentV2(...) with
- * denied flags. The destination does NOT call the legacy `Clarity.consent(false)`
- * API at all - consentV2 is the single source of truth for consent state.
+ * Consent revocation - after analytics and marketing are granted (Clarity
+ * loads), revoking them calls Clarity.consentV2(...) with denied flags. The
+ * destination does NOT call the legacy `Clarity.consent(false)` API at all -
+ * consentV2 is the single source of truth for consent state. The destination
+ * is never loaded under denied consent, so the revoke acts on an
+ * already-granted destination.
  */
 declare const consentRevoke: ClarityStepExample;
 

package/dist/examples/index.js

@@ -269,6 +269,7 @@ var consentRevoke = {
   title: "Consent revoked",
   description: "A walker consent command with analytics and marketing denied calls Clarity.consentV2 with denied flags.",
   command: "consent",
+  before: { analytics: true, marketing: true },
   in: { analytics: false, marketing: false },
   settings: {
     consent: {
@@ -277,6 +278,10 @@ var consentRevoke = {
     }
   },
   out: [
+    [
+      "clarity.consentV2",
+      { analytics_Storage: "granted", ad_Storage: "granted" }
+    ],
     [
       "clarity.consentV2",
       { analytics_Storage: "denied", ad_Storage: "denied" }

package/dist/examples/index.mjs

@@ -248,6 +248,7 @@ var consentRevoke = {
   title: "Consent revoked",
   description: "A walker consent command with analytics and marketing denied calls Clarity.consentV2 with denied flags.",
   command: "consent",
+  before: { analytics: true, marketing: true },
   in: { analytics: false, marketing: false },
   settings: {
     consent: {
@@ -256,6 +257,10 @@ var consentRevoke = {
     }
   },
   out: [
+    [
+      "clarity.consentV2",
+      { analytics_Storage: "granted", ad_Storage: "granted" }
+    ],
     [
       "clarity.consentV2",
       { analytics_Storage: "denied", ad_Storage: "denied" }

package/dist/walkerOS.json

@@ -1,7 +1,7 @@
 {
   "$meta": {
     "package": "@walkeros/web-destination-clarity",
-    "version": "4.2.0",
+    "version": "4.2.1-next-1781538735002",
     "type": "destination",
     "platform": [
       "web"
@@ -152,7 +152,7 @@
           "consent": {
             "functional": true
           },
-          "id": "c171fed2ae74426c",
+          "id": "7162daecbc74bc5f",
           "trigger": "load",
           "entity": "product",
           "action": "view",
@@ -267,7 +267,7 @@
           "consent": {
             "functional": true
           },
-          "id": "4796d43ede2f4909",
+          "id": "9942077a8a4161c0",
           "trigger": "load",
           "entity": "order",
           "action": "complete",
@@ -344,6 +344,10 @@
         "title": "Consent revoked",
         "description": "A walker consent command with analytics and marketing denied calls Clarity.consentV2 with denied flags.",
         "command": "consent",
+        "before": {
+          "analytics": true,
+          "marketing": true
+        },
         "in": {
           "analytics": false,
           "marketing": false
@@ -355,6 +359,13 @@
           }
         },
         "out": [
+          [
+            "clarity.consentV2",
+            {
+              "analytics_Storage": "granted",
+              "ad_Storage": "granted"
+            }
+          ],
           [
             "clarity.consentV2",
             {
@@ -397,7 +408,7 @@
           "consent": {
             "functional": true
           },
-          "id": "d65da7cb2da52a0b",
+          "id": "030450c5a4cbf63e",
           "trigger": "load",
           "entity": "product",
           "action": "view",
@@ -456,7 +467,7 @@
           "consent": {
             "functional": true
           },
-          "id": "0a2a378d74265994",
+          "id": "23f0cf884e63af27",
           "trigger": "load",
           "entity": "page",
           "action": "view",
@@ -565,7 +576,7 @@
           "consent": {
             "functional": true
           },
-          "id": "449b586fea2cea6e",
+          "id": "21c9d9c9888b36bc",
           "trigger": "load",
           "entity": "order",
           "action": "complete",
@@ -693,7 +704,7 @@
           "consent": {
             "functional": true
           },
-          "id": "bc653e952c929cf2",
+          "id": "d1db186b4239325d",
           "trigger": "load",
           "entity": "order",
           "action": "complete",
@@ -764,7 +775,7 @@
           "consent": {
             "functional": true
           },
-          "id": "2027d208ca9ceeef",
+          "id": "8fe2f2fe8071e1e5",
           "trigger": "load",
           "entity": "page",
           "action": "view",
@@ -826,7 +837,7 @@
           "consent": {
             "functional": true
           },
-          "id": "19f359f70b15d19d",
+          "id": "c0a91f5c9ef76370",
           "trigger": "load",
           "entity": "product",
           "action": "view",
@@ -902,7 +913,7 @@
           "consent": {
             "functional": true
           },
-          "id": "d65d0bc025f7b1ca",
+          "id": "9b57ff8803578e26",
           "trigger": "test",
           "entity": "user",
           "action": "login",
@@ -981,7 +992,7 @@
           "consent": {
             "functional": true
           },
-          "id": "fd023ccc486ad003",
+          "id": "fe2c00168f3472c7",
           "trigger": "test",
           "entity": "debug",
           "action": "noise",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walkeros/web-destination-clarity",
   "description": "Microsoft Clarity web destination for walkerOS (session replay, heatmaps, smart events)",
-  "version": "4.2.0",
+  "version": "4.2.1-next-1781538735002",
   "license": "MIT",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -39,11 +39,11 @@
   },
   "dependencies": {
     "@microsoft/clarity": "^1.0.2",
-    "@walkeros/core": "4.2.0",
-    "@walkeros/web-core": "4.2.0"
+    "@walkeros/core": "4.2.1-next-1781538735002",
+    "@walkeros/web-core": "4.2.1-next-1781538735002"
   },
   "devDependencies": {
-    "@walkeros/collector": "4.2.0"
+    "@walkeros/collector": "4.2.1-next-1781538735002"
   },
   "repository": {
     "url": "git+https://github.com/elbwalker/walkerOS.git",