@walkeros/transformer-validator 4.0.0 → 4.0.1-next-1778068549946

package/dist/dev.d.mts

@@ -1,8 +1,8 @@
 import { JSONSchemaType } from 'ajv';
+import { Flow } from '@walkeros/core';
 
 /**
  * Partial JSON Schema type - we auto-add type: 'object'.
- * Can include: required, properties, additionalProperties, etc.
  */
 type JsonSchema = Partial<JSONSchemaType<unknown>>;
 
@@ -12,6 +12,22 @@ type JsonSchema = Partial<JSONSchemaType<unknown>>;
  */
 declare const formatSchema: JsonSchema;
 
+declare const validEvent: Flow.StepExample;
+declare const invalidFormat: Flow.StepExample;
+declare const contractValidationPass: Flow.StepExample;
+
+declare const step_contractValidationPass: typeof contractValidationPass;
+declare const step_invalidFormat: typeof invalidFormat;
+declare const step_validEvent: typeof validEvent;
+declare namespace step {
+  export { step_contractValidationPass as contractValidationPass, step_invalidFormat as invalidFormat, step_validEvent as validEvent };
+}
+
+declare const index_step: typeof step;
+declare namespace index {
+  export { index_step as step };
+}
+
 /**
  * Development exports for transformer-validator
  * Used by website documentation and examples
@@ -26,4 +42,4 @@ declare const schemas: {
     settings: JsonSchema;
 };
 
-export { formatSchema, schemas, settingsSchema };
+export { index as examples, formatSchema, schemas, settingsSchema };

package/dist/dev.d.ts

@@ -1,8 +1,8 @@
 import { JSONSchemaType } from 'ajv';
+import { Flow } from '@walkeros/core';
 
 /**
  * Partial JSON Schema type - we auto-add type: 'object'.
- * Can include: required, properties, additionalProperties, etc.
  */
 type JsonSchema = Partial<JSONSchemaType<unknown>>;
 
@@ -12,6 +12,22 @@ type JsonSchema = Partial<JSONSchemaType<unknown>>;
  */
 declare const formatSchema: JsonSchema;
 
+declare const validEvent: Flow.StepExample;
+declare const invalidFormat: Flow.StepExample;
+declare const contractValidationPass: Flow.StepExample;
+
+declare const step_contractValidationPass: typeof contractValidationPass;
+declare const step_invalidFormat: typeof invalidFormat;
+declare const step_validEvent: typeof validEvent;
+declare namespace step {
+  export { step_contractValidationPass as contractValidationPass, step_invalidFormat as invalidFormat, step_validEvent as validEvent };
+}
+
+declare const index_step: typeof step;
+declare namespace index {
+  export { index_step as step };
+}
+
 /**
  * Development exports for transformer-validator
  * Used by website documentation and examples
@@ -26,4 +42,4 @@ declare const schemas: {
     settings: JsonSchema;
 };
 
-export { formatSchema, schemas, settingsSchema };
+export { index as examples, formatSchema, schemas, settingsSchema };

package/dist/dev.js

@@ -1 +1 @@
-"use strict";var e,t=Object.defineProperty,r=Object.getOwnPropertyDescriptor,o=Object.getOwnPropertyNames,i=Object.prototype.hasOwnProperty,n={};((e,r)=>{for(var o in r)t(e,o,{get:r[o],enumerable:!0})})(n,{formatSchema:()=>p,schemas:()=>c,settingsSchema:()=>s}),module.exports=(e=n,((e,n,p,s)=>{if(n&&"object"==typeof n||"function"==typeof n)for(let c of o(n))i.call(e,c)||c===p||t(e,c,{get:()=>n[c],enumerable:!(s=r(n,c))||s.enumerable});return e})(t({},"__esModule",{value:!0}),e));var p={type:"object",required:["name","entity","action","data","context","globals","custom","user","nested","consent","id","trigger","timestamp","timing","group","count","version","source"],properties:{name:{type:"string",pattern:"^\\S+ \\S+$"},entity:{type:"string"},action:{type:"string"},data:{type:"object"},context:{type:"object"},globals:{type:"object"},custom:{type:"object"},user:{type:"object"},nested:{type:"array"},consent:{type:"object"},id:{type:"string"},trigger:{type:"string"},timestamp:{type:"number"},timing:{type:"number"},group:{type:"string"},count:{type:"number"},version:{type:"object",required:["source","tagging"],properties:{source:{type:"string"},tagging:{type:"number"}}},source:{type:"object",required:["type","id","previous_id"],properties:{type:{type:"string"},id:{type:"string"},previous_id:{type:"string"}}}}},s={type:"object",properties:{format:{type:"boolean",description:"Validate full WalkerOS.Event structure. Pre-compiled at init.",default:!0},contract:{type:"object",description:"Event-specific validation rules. Entity/action keyed, supports wildcards."}}},c={format:p,settings:s};//# sourceMappingURL=dev.js.map
+"use strict";var e,t=Object.defineProperty,r=Object.getOwnPropertyDescriptor,o=Object.getOwnPropertyNames,a=Object.prototype.hasOwnProperty,i=(e,r)=>{for(var o in r)t(e,o,{get:r[o],enumerable:!0})},n={};i(n,{examples:()=>s,formatSchema:()=>p,schemas:()=>b,settingsSchema:()=>y}),module.exports=(e=n,((e,i,n,p)=>{if(i&&"object"==typeof i||"function"==typeof i)for(let s of o(i))a.call(e,s)||s===n||t(e,s,{get:()=>i[s],enumerable:!(p=r(i,s))||p.enumerable});return e})(t({},"__esModule",{value:!0}),e));var p={type:"object",required:["name","entity","action","data","globals","custom","user","consent","id","trigger","timestamp","timing","source"],properties:{name:{type:"string",pattern:"^\\S+ \\S+$"},entity:{type:"string"},action:{type:"string"},data:{type:"object"},context:{type:"object"},globals:{type:"object"},custom:{type:"object"},user:{type:"object"},nested:{type:"array"},consent:{type:"object"},id:{type:"string"},trigger:{type:"string"},timestamp:{type:"number"},timing:{type:"number"},source:{type:"object",required:["type"],properties:{type:{type:"string"},platform:{type:"string"},url:{type:"string"},referrer:{type:"string"},schema:{type:"string"},version:{type:"string"},count:{type:"number"},trace:{type:"string"},tool:{type:"string"},command:{type:"string"}}}}},s={};i(s,{step:()=>c});var c={};i(c,{contractValidationPass:()=>u,invalidFormat:()=>l,validEvent:()=>d});var m=require("@walkeros/core"),d={title:"Valid event",description:"A well-formed product view passes validation and is returned unchanged for downstream destinations.",in:(0,m.getEvent)("product view",{id:"ev-1700000700",timestamp:1700000700,data:{id:"SKU-100",name:"Trail Runner Pro",price:129.99},source:{type:"browser",platform:"web",url:"https://example.com/"}}),out:[["return",(0,m.getEvent)("product view",{id:"ev-1700000700",timestamp:1700000700,data:{id:"SKU-100",name:"Trail Runner Pro",price:129.99},source:{type:"browser",platform:"web",url:"https://example.com/"}})]]},l={public:!1,in:{name:"invalid",data:{}},out:[["return",!1]]},u={title:"Contract validation",description:"Contract validation passes when event data matches the entity.action JSON Schema",in:(0,m.getEvent)("order complete",{id:"ev-1700000800",timestamp:1700000800,data:{id:"0rd3r1d",total:555,currency:"EUR"},source:{type:"browser",platform:"web",url:"https://shop.example.com/"}}),out:[["return",(0,m.getEvent)("order complete",{id:"ev-1700000800",timestamp:1700000800,data:{id:"0rd3r1d",total:555,currency:"EUR"},source:{type:"browser",platform:"web",url:"https://shop.example.com/"}})]]},y={type:"object",properties:{format:{type:"boolean",description:"Validate full WalkerOS.Event structure. Pre-compiled at init.",default:!0},contract:{type:"object",description:"Event-specific validation rules. Entity/action keyed, supports wildcards."}}},b={format:p,settings:y};//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/dev.ts","../src/format-schema.ts"],"sourcesContent":["/**\n * Development exports for transformer-validator\n * Used by website documentation and examples\n */\nimport { formatSchema } from './format-schema';\nimport type { JsonSchema } from './types';\n\nexport { formatSchema };\n\n/**\n * JSON Schema describing ValidatorSettings for documentation.\n */\nexport const settingsSchema: JsonSchema = {\n  type: 'object',\n  properties: {\n    format: {\n      type: 'boolean',\n      description:\n        'Validate full WalkerOS.Event structure. Pre-compiled at init.',\n      default: true,\n    },\n    contract: {\n      type: 'object',\n      description:\n        'Event-specific validation rules. Entity/action keyed, supports wildcards.',\n    },\n  },\n};\n\n// Re-export for convenience\nexport const schemas: { format: JsonSchema; settings: JsonSchema } = {\n  format: formatSchema,\n  settings: settingsSchema,\n};\n","import type { JsonSchema } from './types';\n\n/**\n * Pre-compiled JSON Schema for WalkerOS.Event structure validation.\n * Validates that all required fields exist with correct types.\n */\nexport const formatSchema: JsonSchema = {\n  type: 'object',\n  required: [\n    'name',\n    'entity',\n    'action',\n    'data',\n    'context',\n    'globals',\n    'custom',\n    'user',\n    'nested',\n    'consent',\n    'id',\n    'trigger',\n    'timestamp',\n    'timing',\n    'group',\n    'count',\n    'version',\n    'source',\n  ],\n  properties: {\n    name: { type: 'string', pattern: '^\\\\S+ \\\\S+$' }, // \"entity action\"\n    entity: { type: 'string' },\n    action: { type: 'string' },\n    data: { type: 'object' },\n    context: { type: 'object' },\n    globals: { type: 'object' },\n    custom: { type: 'object' },\n    user: { type: 'object' },\n    nested: { type: 'array' },\n    consent: { type: 'object' },\n    id: { type: 'string' },\n    trigger: { type: 'string' },\n    timestamp: { type: 'number' },\n    timing: { type: 'number' },\n    group: { type: 'string' },\n    count: { type: 'number' },\n    version: {\n      type: 'object',\n      required: ['source', 'tagging'],\n      properties: {\n        source: { type: 'string' },\n        tagging: { type: 'number' },\n      },\n    },\n    source: {\n      type: 'object',\n      required: ['type', 'id', 'previous_id'],\n      properties: {\n        type: { type: 'string' },\n        id: { type: 'string' },\n        previous_id: { type: 'string' },\n      },\n    },\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACMO,IAAM,eAA2B;AAAA,EACtC,MAAM;AAAA,EACN,UAAU;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,YAAY;AAAA,IACV,MAAM,EAAE,MAAM,UAAU,SAAS,cAAc;AAAA;AAAA,IAC/C,QAAQ,EAAE,MAAM,SAAS;AAAA,IACzB,QAAQ,EAAE,MAAM,SAAS;AAAA,IACzB,MAAM,EAAE,MAAM,SAAS;AAAA,IACvB,SAAS,EAAE,MAAM,SAAS;AAAA,IAC1B,SAAS,EAAE,MAAM,SAAS;AAAA,IAC1B,QAAQ,EAAE,MAAM,SAAS;AAAA,IACzB,MAAM,EAAE,MAAM,SAAS;AAAA,IACvB,QAAQ,EAAE,MAAM,QAAQ;AAAA,IACxB,SAAS,EAAE,MAAM,SAAS;AAAA,IAC1B,IAAI,EAAE,MAAM,SAAS;AAAA,IACrB,SAAS,EAAE,MAAM,SAAS;AAAA,IAC1B,WAAW,EAAE,MAAM,SAAS;AAAA,IAC5B,QAAQ,EAAE,MAAM,SAAS;AAAA,IACzB,OAAO,EAAE,MAAM,SAAS;AAAA,IACxB,OAAO,EAAE,MAAM,SAAS;AAAA,IACxB,SAAS;AAAA,MACP,MAAM;AAAA,MACN,UAAU,CAAC,UAAU,SAAS;AAAA,MAC9B,YAAY;AAAA,QACV,QAAQ,EAAE,MAAM,SAAS;AAAA,QACzB,SAAS,EAAE,MAAM,SAAS;AAAA,MAC5B;AAAA,IACF;AAAA,IACA,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,UAAU,CAAC,QAAQ,MAAM,aAAa;AAAA,MACtC,YAAY;AAAA,QACV,MAAM,EAAE,MAAM,SAAS;AAAA,QACvB,IAAI,EAAE,MAAM,SAAS;AAAA,QACrB,aAAa,EAAE,MAAM,SAAS;AAAA,MAChC;AAAA,IACF;AAAA,EACF;AACF;;;ADnDO,IAAM,iBAA6B;AAAA,EACxC,MAAM;AAAA,EACN,YAAY;AAAA,IACV,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,aACE;AAAA,MACF,SAAS;AAAA,IACX;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,IACJ;AAAA,EACF;AACF;AAGO,IAAM,UAAwD;AAAA,EACnE,QAAQ;AAAA,EACR,UAAU;AACZ;","names":[]}
+{"version":3,"sources":["../src/dev.ts","../src/format-schema.ts","../src/examples/index.ts","../src/examples/step.ts"],"sourcesContent":["/**\n * Development exports for transformer-validator\n * Used by website documentation and examples\n */\nimport { formatSchema } from './format-schema';\nimport type { JsonSchema } from './types';\n\nexport { formatSchema };\n\n/**\n * JSON Schema describing ValidatorSettings for documentation.\n */\nexport const settingsSchema: JsonSchema = {\n  type: 'object',\n  properties: {\n    format: {\n      type: 'boolean',\n      description:\n        'Validate full WalkerOS.Event structure. Pre-compiled at init.',\n      default: true,\n    },\n    contract: {\n      type: 'object',\n      description:\n        'Event-specific validation rules. Entity/action keyed, supports wildcards.',\n    },\n  },\n};\n\n// Re-export for convenience\nexport const schemas: { format: JsonSchema; settings: JsonSchema } = {\n  format: formatSchema,\n  settings: settingsSchema,\n};\n\nexport * as examples from './examples';\n","import type { JsonSchema } from './types';\n\n/**\n * Pre-compiled JSON Schema for WalkerOS.Event structure validation.\n * Validates that all required fields exist with correct types.\n */\nexport const formatSchema: JsonSchema = {\n  type: 'object',\n  required: [\n    'name',\n    'entity',\n    'action',\n    'data',\n    'globals',\n    'custom',\n    'user',\n    'consent',\n    'id',\n    'trigger',\n    'timestamp',\n    'timing',\n    'source',\n  ],\n  properties: {\n    name: { type: 'string', pattern: '^\\\\S+ \\\\S+$' }, // \"entity action\"\n    entity: { type: 'string' },\n    action: { type: 'string' },\n    data: { type: 'object' },\n    context: { type: 'object' },\n    globals: { type: 'object' },\n    custom: { type: 'object' },\n    user: { type: 'object' },\n    nested: { type: 'array' },\n    consent: { type: 'object' },\n    id: { type: 'string' },\n    trigger: { type: 'string' },\n    timestamp: { type: 'number' },\n    timing: { type: 'number' },\n    source: {\n      type: 'object',\n      required: ['type'],\n      properties: {\n        type: { type: 'string' },\n        platform: { type: 'string' },\n        url: { type: 'string' },\n        referrer: { type: 'string' },\n        schema: { type: 'string' },\n        version: { type: 'string' },\n        count: { type: 'number' },\n        trace: { type: 'string' },\n        tool: { type: 'string' },\n        command: { type: 'string' },\n      },\n    },\n  },\n};\n","export * as step from './step';\n","import type { Flow } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\n\nexport const validEvent: Flow.StepExample = {\n  title: 'Valid event',\n  description:\n    'A well-formed product view passes validation and is returned unchanged for downstream destinations.',\n  in: getEvent('product view', {\n    id: 'ev-1700000700',\n    timestamp: 1700000700,\n    data: { id: 'SKU-100', name: 'Trail Runner Pro', price: 129.99 },\n    source: { type: 'browser', platform: 'web', url: 'https://example.com/' },\n  }),\n  out: [\n    [\n      'return',\n      getEvent('product view', {\n        id: 'ev-1700000700',\n        timestamp: 1700000700,\n        data: { id: 'SKU-100', name: 'Trail Runner Pro', price: 129.99 },\n        source: {\n          type: 'browser',\n          platform: 'web',\n          url: 'https://example.com/',\n        },\n      }),\n    ],\n  ],\n};\n\nexport const invalidFormat: Flow.StepExample = {\n  public: false,\n  in: {\n    name: 'invalid',\n    data: {},\n  },\n  out: [['return', false]],\n};\n\nexport const contractValidationPass: Flow.StepExample = {\n  title: 'Contract validation',\n  description:\n    'Contract validation passes when event data matches the entity.action JSON Schema',\n  in: getEvent('order complete', {\n    id: 'ev-1700000800',\n    timestamp: 1700000800,\n    data: { id: '0rd3r1d', total: 555, currency: 'EUR' },\n    source: {\n      type: 'browser',\n      platform: 'web',\n      url: 'https://shop.example.com/',\n    },\n  }),\n  out: [\n    [\n      'return',\n      getEvent('order complete', {\n        id: 'ev-1700000800',\n        timestamp: 1700000800,\n        data: { id: '0rd3r1d', total: 555, currency: 'EUR' },\n        source: {\n          type: 'browser',\n          platform: 'web',\n          url: 'https://shop.example.com/',\n        },\n      }),\n    ],\n  ],\n};\n"],"mappings":"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","names":[]}

package/dist/dev.mjs

@@ -1 +1 @@
-var t={type:"object",required:["name","entity","action","data","context","globals","custom","user","nested","consent","id","trigger","timestamp","timing","group","count","version","source"],properties:{name:{type:"string",pattern:"^\\S+ \\S+$"},entity:{type:"string"},action:{type:"string"},data:{type:"object"},context:{type:"object"},globals:{type:"object"},custom:{type:"object"},user:{type:"object"},nested:{type:"array"},consent:{type:"object"},id:{type:"string"},trigger:{type:"string"},timestamp:{type:"number"},timing:{type:"number"},group:{type:"string"},count:{type:"number"},version:{type:"object",required:["source","tagging"],properties:{source:{type:"string"},tagging:{type:"number"}}},source:{type:"object",required:["type","id","previous_id"],properties:{type:{type:"string"},id:{type:"string"},previous_id:{type:"string"}}}}},e={type:"object",properties:{format:{type:"boolean",description:"Validate full WalkerOS.Event structure. Pre-compiled at init.",default:!0},contract:{type:"object",description:"Event-specific validation rules. Entity/action keyed, supports wildcards."}}},r={format:t,settings:e};export{t as formatSchema,r as schemas,e as settingsSchema};//# sourceMappingURL=dev.mjs.map
+var t=Object.defineProperty,e=(e,r)=>{for(var i in r)t(e,i,{get:r[i],enumerable:!0})},r={type:"object",required:["name","entity","action","data","globals","custom","user","consent","id","trigger","timestamp","timing","source"],properties:{name:{type:"string",pattern:"^\\S+ \\S+$"},entity:{type:"string"},action:{type:"string"},data:{type:"object"},context:{type:"object"},globals:{type:"object"},custom:{type:"object"},user:{type:"object"},nested:{type:"array"},consent:{type:"object"},id:{type:"string"},trigger:{type:"string"},timestamp:{type:"number"},timing:{type:"number"},source:{type:"object",required:["type"],properties:{type:{type:"string"},platform:{type:"string"},url:{type:"string"},referrer:{type:"string"},schema:{type:"string"},version:{type:"string"},count:{type:"number"},trace:{type:"string"},tool:{type:"string"},command:{type:"string"}}}}},i={};e(i,{step:()=>a});var a={};e(a,{contractValidationPass:()=>s,invalidFormat:()=>p,validEvent:()=>n});import{getEvent as o}from"@walkeros/core";var n={title:"Valid event",description:"A well-formed product view passes validation and is returned unchanged for downstream destinations.",in:o("product view",{id:"ev-1700000700",timestamp:1700000700,data:{id:"SKU-100",name:"Trail Runner Pro",price:129.99},source:{type:"browser",platform:"web",url:"https://example.com/"}}),out:[["return",o("product view",{id:"ev-1700000700",timestamp:1700000700,data:{id:"SKU-100",name:"Trail Runner Pro",price:129.99},source:{type:"browser",platform:"web",url:"https://example.com/"}})]]},p={public:!1,in:{name:"invalid",data:{}},out:[["return",!1]]},s={title:"Contract validation",description:"Contract validation passes when event data matches the entity.action JSON Schema",in:o("order complete",{id:"ev-1700000800",timestamp:1700000800,data:{id:"0rd3r1d",total:555,currency:"EUR"},source:{type:"browser",platform:"web",url:"https://shop.example.com/"}}),out:[["return",o("order complete",{id:"ev-1700000800",timestamp:1700000800,data:{id:"0rd3r1d",total:555,currency:"EUR"},source:{type:"browser",platform:"web",url:"https://shop.example.com/"}})]]},c={type:"object",properties:{format:{type:"boolean",description:"Validate full WalkerOS.Event structure. Pre-compiled at init.",default:!0},contract:{type:"object",description:"Event-specific validation rules. Entity/action keyed, supports wildcards."}}},d={format:r,settings:c};export{i as examples,r as formatSchema,d as schemas,c as settingsSchema};//# sourceMappingURL=dev.mjs.map

package/dist/dev.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/format-schema.ts","../src/dev.ts"],"sourcesContent":["import type { JsonSchema } from './types';\n\n/**\n * Pre-compiled JSON Schema for WalkerOS.Event structure validation.\n * Validates that all required fields exist with correct types.\n */\nexport const formatSchema: JsonSchema = {\n  type: 'object',\n  required: [\n    'name',\n    'entity',\n    'action',\n    'data',\n    'context',\n    'globals',\n    'custom',\n    'user',\n    'nested',\n    'consent',\n    'id',\n    'trigger',\n    'timestamp',\n    'timing',\n    'group',\n    'count',\n    'version',\n    'source',\n  ],\n  properties: {\n    name: { type: 'string', pattern: '^\\\\S+ \\\\S+$' }, // \"entity action\"\n    entity: { type: 'string' },\n    action: { type: 'string' },\n    data: { type: 'object' },\n    context: { type: 'object' },\n    globals: { type: 'object' },\n    custom: { type: 'object' },\n    user: { type: 'object' },\n    nested: { type: 'array' },\n    consent: { type: 'object' },\n    id: { type: 'string' },\n    trigger: { type: 'string' },\n    timestamp: { type: 'number' },\n    timing: { type: 'number' },\n    group: { type: 'string' },\n    count: { type: 'number' },\n    version: {\n      type: 'object',\n      required: ['source', 'tagging'],\n      properties: {\n        source: { type: 'string' },\n        tagging: { type: 'number' },\n      },\n    },\n    source: {\n      type: 'object',\n      required: ['type', 'id', 'previous_id'],\n      properties: {\n        type: { type: 'string' },\n        id: { type: 'string' },\n        previous_id: { type: 'string' },\n      },\n    },\n  },\n};\n","/**\n * Development exports for transformer-validator\n * Used by website documentation and examples\n */\nimport { formatSchema } from './format-schema';\nimport type { JsonSchema } from './types';\n\nexport { formatSchema };\n\n/**\n * JSON Schema describing ValidatorSettings for documentation.\n */\nexport const settingsSchema: JsonSchema = {\n  type: 'object',\n  properties: {\n    format: {\n      type: 'boolean',\n      description:\n        'Validate full WalkerOS.Event structure. Pre-compiled at init.',\n      default: true,\n    },\n    contract: {\n      type: 'object',\n      description:\n        'Event-specific validation rules. Entity/action keyed, supports wildcards.',\n    },\n  },\n};\n\n// Re-export for convenience\nexport const schemas: { format: JsonSchema; settings: JsonSchema } = {\n  format: formatSchema,\n  settings: settingsSchema,\n};\n"],"mappings":";AAMO,IAAM,eAA2B;AAAA,EACtC,MAAM;AAAA,EACN,UAAU;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,YAAY;AAAA,IACV,MAAM,EAAE,MAAM,UAAU,SAAS,cAAc;AAAA;AAAA,IAC/C,QAAQ,EAAE,MAAM,SAAS;AAAA,IACzB,QAAQ,EAAE,MAAM,SAAS;AAAA,IACzB,MAAM,EAAE,MAAM,SAAS;AAAA,IACvB,SAAS,EAAE,MAAM,SAAS;AAAA,IAC1B,SAAS,EAAE,MAAM,SAAS;AAAA,IAC1B,QAAQ,EAAE,MAAM,SAAS;AAAA,IACzB,MAAM,EAAE,MAAM,SAAS;AAAA,IACvB,QAAQ,EAAE,MAAM,QAAQ;AAAA,IACxB,SAAS,EAAE,MAAM,SAAS;AAAA,IAC1B,IAAI,EAAE,MAAM,SAAS;AAAA,IACrB,SAAS,EAAE,MAAM,SAAS;AAAA,IAC1B,WAAW,EAAE,MAAM,SAAS;AAAA,IAC5B,QAAQ,EAAE,MAAM,SAAS;AAAA,IACzB,OAAO,EAAE,MAAM,SAAS;AAAA,IACxB,OAAO,EAAE,MAAM,SAAS;AAAA,IACxB,SAAS;AAAA,MACP,MAAM;AAAA,MACN,UAAU,CAAC,UAAU,SAAS;AAAA,MAC9B,YAAY;AAAA,QACV,QAAQ,EAAE,MAAM,SAAS;AAAA,QACzB,SAAS,EAAE,MAAM,SAAS;AAAA,MAC5B;AAAA,IACF;AAAA,IACA,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,UAAU,CAAC,QAAQ,MAAM,aAAa;AAAA,MACtC,YAAY;AAAA,QACV,MAAM,EAAE,MAAM,SAAS;AAAA,QACvB,IAAI,EAAE,MAAM,SAAS;AAAA,QACrB,aAAa,EAAE,MAAM,SAAS;AAAA,MAChC;AAAA,IACF;AAAA,EACF;AACF;;;ACnDO,IAAM,iBAA6B;AAAA,EACxC,MAAM;AAAA,EACN,YAAY;AAAA,IACV,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,aACE;AAAA,MACF,SAAS;AAAA,IACX;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,IACJ;AAAA,EACF;AACF;AAGO,IAAM,UAAwD;AAAA,EACnE,QAAQ;AAAA,EACR,UAAU;AACZ;","names":[]}
+{"version":3,"sources":["../src/format-schema.ts","../src/examples/index.ts","../src/examples/step.ts","../src/dev.ts"],"sourcesContent":["import type { JsonSchema } from './types';\n\n/**\n * Pre-compiled JSON Schema for WalkerOS.Event structure validation.\n * Validates that all required fields exist with correct types.\n */\nexport const formatSchema: JsonSchema = {\n  type: 'object',\n  required: [\n    'name',\n    'entity',\n    'action',\n    'data',\n    'globals',\n    'custom',\n    'user',\n    'consent',\n    'id',\n    'trigger',\n    'timestamp',\n    'timing',\n    'source',\n  ],\n  properties: {\n    name: { type: 'string', pattern: '^\\\\S+ \\\\S+$' }, // \"entity action\"\n    entity: { type: 'string' },\n    action: { type: 'string' },\n    data: { type: 'object' },\n    context: { type: 'object' },\n    globals: { type: 'object' },\n    custom: { type: 'object' },\n    user: { type: 'object' },\n    nested: { type: 'array' },\n    consent: { type: 'object' },\n    id: { type: 'string' },\n    trigger: { type: 'string' },\n    timestamp: { type: 'number' },\n    timing: { type: 'number' },\n    source: {\n      type: 'object',\n      required: ['type'],\n      properties: {\n        type: { type: 'string' },\n        platform: { type: 'string' },\n        url: { type: 'string' },\n        referrer: { type: 'string' },\n        schema: { type: 'string' },\n        version: { type: 'string' },\n        count: { type: 'number' },\n        trace: { type: 'string' },\n        tool: { type: 'string' },\n        command: { type: 'string' },\n      },\n    },\n  },\n};\n","export * as step from './step';\n","import type { Flow } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\n\nexport const validEvent: Flow.StepExample = {\n  title: 'Valid event',\n  description:\n    'A well-formed product view passes validation and is returned unchanged for downstream destinations.',\n  in: getEvent('product view', {\n    id: 'ev-1700000700',\n    timestamp: 1700000700,\n    data: { id: 'SKU-100', name: 'Trail Runner Pro', price: 129.99 },\n    source: { type: 'browser', platform: 'web', url: 'https://example.com/' },\n  }),\n  out: [\n    [\n      'return',\n      getEvent('product view', {\n        id: 'ev-1700000700',\n        timestamp: 1700000700,\n        data: { id: 'SKU-100', name: 'Trail Runner Pro', price: 129.99 },\n        source: {\n          type: 'browser',\n          platform: 'web',\n          url: 'https://example.com/',\n        },\n      }),\n    ],\n  ],\n};\n\nexport const invalidFormat: Flow.StepExample = {\n  public: false,\n  in: {\n    name: 'invalid',\n    data: {},\n  },\n  out: [['return', false]],\n};\n\nexport const contractValidationPass: Flow.StepExample = {\n  title: 'Contract validation',\n  description:\n    'Contract validation passes when event data matches the entity.action JSON Schema',\n  in: getEvent('order complete', {\n    id: 'ev-1700000800',\n    timestamp: 1700000800,\n    data: { id: '0rd3r1d', total: 555, currency: 'EUR' },\n    source: {\n      type: 'browser',\n      platform: 'web',\n      url: 'https://shop.example.com/',\n    },\n  }),\n  out: [\n    [\n      'return',\n      getEvent('order complete', {\n        id: 'ev-1700000800',\n        timestamp: 1700000800,\n        data: { id: '0rd3r1d', total: 555, currency: 'EUR' },\n        source: {\n          type: 'browser',\n          platform: 'web',\n          url: 'https://shop.example.com/',\n        },\n      }),\n    ],\n  ],\n};\n","/**\n * Development exports for transformer-validator\n * Used by website documentation and examples\n */\nimport { formatSchema } from './format-schema';\nimport type { JsonSchema } from './types';\n\nexport { formatSchema };\n\n/**\n * JSON Schema describing ValidatorSettings for documentation.\n */\nexport const settingsSchema: JsonSchema = {\n  type: 'object',\n  properties: {\n    format: {\n      type: 'boolean',\n      description:\n        'Validate full WalkerOS.Event structure. Pre-compiled at init.',\n      default: true,\n    },\n    contract: {\n      type: 'object',\n      description:\n        'Event-specific validation rules. Entity/action keyed, supports wildcards.',\n    },\n  },\n};\n\n// Re-export for convenience\nexport const schemas: { format: JsonSchema; settings: JsonSchema } = {\n  format: formatSchema,\n  settings: settingsSchema,\n};\n\nexport * as examples from './examples';\n"],"mappings":"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","names":[]}

package/dist/index.d.mts

@@ -1,59 +1,43 @@
-import { Mapping, WalkerOS, Transformer } from '@walkeros/core';
+import { Transformer } from '@walkeros/core';
 import { JSONSchemaType } from 'ajv';
 
 /**
  * Partial JSON Schema type - we auto-add type: 'object'.
- * Can include: required, properties, additionalProperties, etc.
  */
 type JsonSchema = Partial<JSONSchemaType<unknown>>;
 /**
- * Contract rule for event-specific validation.
- * Extends the shape expected by getMappingEvent.
+ * Contract event rules — entity → action → JSON Schema.
+ * The validator matches events by entity-action and validates
+ * against the corresponding schema.
  */
-interface ContractRule {
-    /**
-     * Condition function - first matching rule wins.
-     * MUST be synchronous. getMappingEvent uses .find() which doesn't await.
-     * For async checks, validate in the schema or use a separate transformer.
-     */
-    condition?: (event: WalkerOS.DeepPartialEvent) => boolean;
-    /**
-     * JSON Schema (partial) - we auto-add type: 'object'.
-     * Can include: required, properties, additionalProperties, etc.
-     */
-    schema: JsonSchema;
-}
-/**
- * Contract extends Mapping.Rules for type compatibility with getMappingEvent.
- * This avoids `as any` casting and ensures strict typing.
- */
-type Contract = Mapping.Rules<ContractRule>;
+type ContractEvents = Record<string, Record<string, JsonSchema>>;
 /**
  * Validator transformer settings.
  */
 interface ValidatorSettings {
     /**
      * Validate full WalkerOS.Event structure.
-     * Pre-compiled at transformer init, runs on every event.
-     * Validates all fields exist with correct types.
      * @default true
      */
     format?: boolean;
     /**
-     * Event-specific validation rules.
-     * Entity/action keyed, supports wildcards and conditions.
-     * Schemas lazy-compiled on first match.
+     * Entity-action event validation schemas.
+     * Resolved from $contract.name.events.
+     * Supports wildcards via findEventSchema.
      */
-    contract?: Contract;
+    events?: ContractEvents;
+    /** JSON Schema for event.globals — validates on every event. */
+    globals?: JsonSchema;
+    /** JSON Schema for event.context — validates on every event. */
+    context?: JsonSchema;
+    /** JSON Schema for event.custom — validates on every event. */
+    custom?: JsonSchema;
+    /** JSON Schema for event.user — validates on every event. */
+    user?: JsonSchema;
+    /** JSON Schema for event.consent — validates on every event. */
+    consent?: JsonSchema;
 }
 
-/**
- * Event validation transformer using AJV with JSON Schema.
- *
- * Two validation modes:
- * - format: Pre-compiled WalkerOS.Event structure validation (runs on every event)
- * - contract: Entity/action keyed business rules with lazy compilation
- */
 declare const transformerValidator: Transformer.Init<Transformer.Types<ValidatorSettings>>;
 
-export { type Contract, type ContractRule, type JsonSchema, type ValidatorSettings, transformerValidator as default, transformerValidator };
+export { type ContractEvents, type JsonSchema, type ValidatorSettings, transformerValidator as default, transformerValidator };

package/dist/index.d.ts

@@ -1,59 +1,43 @@
-import { Mapping, WalkerOS, Transformer } from '@walkeros/core';
+import { Transformer } from '@walkeros/core';
 import { JSONSchemaType } from 'ajv';
 
 /**
  * Partial JSON Schema type - we auto-add type: 'object'.
- * Can include: required, properties, additionalProperties, etc.
  */
 type JsonSchema = Partial<JSONSchemaType<unknown>>;
 /**
- * Contract rule for event-specific validation.
- * Extends the shape expected by getMappingEvent.
+ * Contract event rules — entity → action → JSON Schema.
+ * The validator matches events by entity-action and validates
+ * against the corresponding schema.
  */
-interface ContractRule {
-    /**
-     * Condition function - first matching rule wins.
-     * MUST be synchronous. getMappingEvent uses .find() which doesn't await.
-     * For async checks, validate in the schema or use a separate transformer.
-     */
-    condition?: (event: WalkerOS.DeepPartialEvent) => boolean;
-    /**
-     * JSON Schema (partial) - we auto-add type: 'object'.
-     * Can include: required, properties, additionalProperties, etc.
-     */
-    schema: JsonSchema;
-}
-/**
- * Contract extends Mapping.Rules for type compatibility with getMappingEvent.
- * This avoids `as any` casting and ensures strict typing.
- */
-type Contract = Mapping.Rules<ContractRule>;
+type ContractEvents = Record<string, Record<string, JsonSchema>>;
 /**
  * Validator transformer settings.
  */
 interface ValidatorSettings {
     /**
      * Validate full WalkerOS.Event structure.
-     * Pre-compiled at transformer init, runs on every event.
-     * Validates all fields exist with correct types.
      * @default true
      */
     format?: boolean;
     /**
-     * Event-specific validation rules.
-     * Entity/action keyed, supports wildcards and conditions.
-     * Schemas lazy-compiled on first match.
+     * Entity-action event validation schemas.
+     * Resolved from $contract.name.events.
+     * Supports wildcards via findEventSchema.
      */
-    contract?: Contract;
+    events?: ContractEvents;
+    /** JSON Schema for event.globals — validates on every event. */
+    globals?: JsonSchema;
+    /** JSON Schema for event.context — validates on every event. */
+    context?: JsonSchema;
+    /** JSON Schema for event.custom — validates on every event. */
+    custom?: JsonSchema;
+    /** JSON Schema for event.user — validates on every event. */
+    user?: JsonSchema;
+    /** JSON Schema for event.consent — validates on every event. */
+    consent?: JsonSchema;
 }
 
-/**
- * Event validation transformer using AJV with JSON Schema.
- *
- * Two validation modes:
- * - format: Pre-compiled WalkerOS.Event structure validation (runs on every event)
- * - contract: Entity/action keyed business rules with lazy compilation
- */
 declare const transformerValidator: Transformer.Init<Transformer.Types<ValidatorSettings>>;
 
-export { type Contract, type ContractRule, type JsonSchema, type ValidatorSettings, transformerValidator as default, transformerValidator };
+export { type ContractEvents, type JsonSchema, type ValidatorSettings, transformerValidator as default, transformerValidator };

package/dist/index.js

@@ -1 +1 @@
-"use strict";var e,t=Object.create,r=Object.defineProperty,o=Object.getOwnPropertyDescriptor,n=Object.getOwnPropertyNames,i=Object.getPrototypeOf,s=Object.prototype.hasOwnProperty,a=(e,t,i,a)=>{if(t&&"object"==typeof t||"function"==typeof t)for(let p of n(t))s.call(e,p)||p===i||r(e,p,{get:()=>t[p],enumerable:!(a=o(t,p))||a.enumerable});return e},p={};((e,t)=>{for(var o in t)r(e,o,{get:t[o],enumerable:!0})})(p,{default:()=>y,transformerValidator:()=>y}),module.exports=(e=p,a(r({},"__esModule",{value:!0}),e));var c=((e,o,n)=>(n=null!=e?t(i(e)):{},a(!o&&e&&e.__esModule?n:r(n,"default",{value:e,enumerable:!0}),e)))(require("ajv")),u=require("@walkeros/core"),g={type:"object",required:["name","entity","action","data","context","globals","custom","user","nested","consent","id","trigger","timestamp","timing","group","count","version","source"],properties:{name:{type:"string",pattern:"^\\S+ \\S+$"},entity:{type:"string"},action:{type:"string"},data:{type:"object"},context:{type:"object"},globals:{type:"object"},custom:{type:"object"},user:{type:"object"},nested:{type:"array"},consent:{type:"object"},id:{type:"string"},trigger:{type:"string"},timestamp:{type:"number"},timing:{type:"number"},group:{type:"string"},count:{type:"number"},version:{type:"object",required:["source","tagging"],properties:{source:{type:"string"},tagging:{type:"number"}}},source:{type:"object",required:["type","id","previous_id"],properties:{type:{type:"string"},id:{type:"string"},previous_id:{type:"string"}}}}},y=e=>{const{config:t}=e,r=t.settings||{},{format:o=!0,contract:n}=r,i=new c.default({allErrors:!0,strict:!1}),s=o?i.compile(g):null,a=new WeakMap;return{type:"validator",config:t,async push(e,t){const{logger:r}=t;if(s&&!s(e))return r.error("Event format invalid",{errors:i.errorsText(s.errors)}),!1;if(n){const{eventMapping:t,mappingKey:o}=await(0,u.getMappingEvent)(e,n),s=t;if(null==s?void 0:s.schema){const t=function(e){if(!a.has(e)){const t={type:"object",...e};a.set(e,i.compile(t))}return a.get(e)}(s.schema);if(!t(e))return r.error("Contract validation failed",{rule:o,errors:i.errorsText(t.errors)}),!1;r.debug("Contract validation passed",{rule:o})}}return e}}};//# sourceMappingURL=index.js.map
+"use strict";var e,t=Object.create,r=Object.defineProperty,o=Object.getOwnPropertyDescriptor,n=Object.getOwnPropertyNames,s=Object.getPrototypeOf,i=Object.prototype.hasOwnProperty,a=(e,t,s,a)=>{if(t&&"object"==typeof t||"function"==typeof t)for(let c of n(t))i.call(e,c)||c===s||r(e,c,{get:()=>t[c],enumerable:!(a=o(t,c))||a.enumerable});return e},c={};((e,t)=>{for(var o in t)r(e,o,{get:t[o],enumerable:!0})})(c,{default:()=>l,transformerValidator:()=>l}),module.exports=(e=c,a(r({},"__esModule",{value:!0}),e));var p=((e,o,n)=>(n=null!=e?t(s(e)):{},a(!o&&e&&e.__esModule?n:r(n,"default",{value:e,enumerable:!0}),e)))(require("ajv")),y={type:"object",required:["name","entity","action","data","globals","custom","user","consent","id","trigger","timestamp","timing","source"],properties:{name:{type:"string",pattern:"^\\S+ \\S+$"},entity:{type:"string"},action:{type:"string"},data:{type:"object"},context:{type:"object"},globals:{type:"object"},custom:{type:"object"},user:{type:"object"},nested:{type:"array"},consent:{type:"object"},id:{type:"string"},trigger:{type:"string"},timestamp:{type:"number"},timing:{type:"number"},source:{type:"object",required:["type"],properties:{type:{type:"string"},platform:{type:"string"},url:{type:"string"},referrer:{type:"string"},schema:{type:"string"},version:{type:"string"},count:{type:"number"},trace:{type:"string"},tool:{type:"string"},command:{type:"string"}}}}},l=e=>{const{config:t}=e,r=t.settings||{},{format:o=!0,events:n,globals:s,context:i,custom:a,user:c,consent:l}=r,u=new p.default({allErrors:!0,strict:!1}),m=o?u.compile(y):null,g=[],f={globals:s,context:i,custom:a,user:c,consent:l};for(const[e,t]of Object.entries(f))t&&g.push({name:e,field:e,validate:u.compile({type:"object",...t})});const b=new Map;return{type:"validator",config:t,async push(e,t){const{logger:r}=t;if(m&&!m(e))return r.error("Event format invalid",{errors:u.errorsText(m.errors)}),!1;for(const{name:t,field:o,validate:n}of g){if(!n(e[o]))return r.error(`${t} validation failed`,{errors:u.errorsText(n.errors)}),!1}if(n&&e.entity&&e.action){const t=function(e,t){if(n)return n[e]?.[t]?{schema:n[e][t],key:`${e} ${t}`}:n[e]?.["*"]?{schema:n[e]["*"],key:`${e} *`}:n["*"]?.[t]?{schema:n["*"][t],key:`* ${t}`}:n["*"]?.["*"]?{schema:n["*"]["*"],key:"* *"}:void 0}(e.entity,e.action);if(t){const o=function(e,t,r){const o=`${e}.${t}`;return b.has(o)||b.set(o,u.compile({type:"object",...r})),b.get(o)}(e.entity,e.action,t.schema);if(!o(e))return r.error("Contract validation failed",{rule:t.key,errors:u.errorsText(o.errors)}),!1;r.debug("Contract validation passed",{rule:t.key})}}return{event:e}}}};//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/transformer.ts","../src/format-schema.ts"],"sourcesContent":["export { transformerValidator } from './transformer';\nexport type {\n  ValidatorSettings,\n  Contract,\n  ContractRule,\n  JsonSchema,\n} from './types';\n\nexport { transformerValidator as default } from './transformer';\n","import Ajv, { ValidateFunction } from 'ajv';\nimport { getMappingEvent } from '@walkeros/core';\nimport type { Mapping, Transformer } from '@walkeros/core';\nimport { formatSchema } from './format-schema';\nimport type { ValidatorSettings, ContractRule, JsonSchema } from './types';\n\n/**\n * Event validation transformer using AJV with JSON Schema.\n *\n * Two validation modes:\n * - format: Pre-compiled WalkerOS.Event structure validation (runs on every event)\n * - contract: Entity/action keyed business rules with lazy compilation\n */\nexport const transformerValidator: Transformer.Init<\n  Transformer.Types<ValidatorSettings>\n> = (context) => {\n  const { config } = context;\n  const settings = config.settings || {};\n  const { format = true, contract } = settings;\n\n  const ajv = new Ajv({ allErrors: true, strict: false });\n\n  // Pre-compile format validator (runs on every event)\n  const formatValidator = format ? ajv.compile(formatSchema) : null;\n\n  // Lazy-compiled contract validators - keyed by schema reference\n  // Using WeakMap to cache by schema object, handling array rules with conditions\n  const contractValidators = new WeakMap<JsonSchema, ValidateFunction>();\n\n  function getContractValidator(schema: JsonSchema) {\n    if (!contractValidators.has(schema)) {\n      // Auto-wrap with type: 'object'\n      const fullSchema = { type: 'object', ...schema };\n      contractValidators.set(schema, ajv.compile(fullSchema));\n    }\n    return contractValidators.get(schema)!;\n  }\n\n  return {\n    type: 'validator',\n    config,\n\n    async push(event, context) {\n      const { logger } = context;\n\n      // 1. Format validation (pre-compiled, fast)\n      if (formatValidator && !formatValidator(event)) {\n        logger.error('Event format invalid', {\n          errors: ajv.errorsText(formatValidator.errors),\n        });\n        return false;\n      }\n\n      // 2. Contract validation (lazy compiled)\n      if (contract) {\n        // Contract is typed as Mapping.Rules<ContractRule> - cast needed for getMappingEvent\n        const { eventMapping: rule, mappingKey } = await getMappingEvent(\n          event,\n          contract as Mapping.Rules,\n        );\n\n        // Type assertion: we know our rules have schema\n        const contractRule = rule as ContractRule | undefined;\n\n        if (contractRule?.schema) {\n          const validator = getContractValidator(contractRule.schema);\n\n          if (!validator(event)) {\n            logger.error('Contract validation failed', {\n              rule: mappingKey,\n              errors: ajv.errorsText(validator.errors),\n            });\n            return false;\n          }\n\n          logger.debug('Contract validation passed', { rule: mappingKey });\n        }\n      }\n\n      return event;\n    },\n  };\n};\n","import type { JsonSchema } from './types';\n\n/**\n * Pre-compiled JSON Schema for WalkerOS.Event structure validation.\n * Validates that all required fields exist with correct types.\n */\nexport const formatSchema: JsonSchema = {\n  type: 'object',\n  required: [\n    'name',\n    'entity',\n    'action',\n    'data',\n    'context',\n    'globals',\n    'custom',\n    'user',\n    'nested',\n    'consent',\n    'id',\n    'trigger',\n    'timestamp',\n    'timing',\n    'group',\n    'count',\n    'version',\n    'source',\n  ],\n  properties: {\n    name: { type: 'string', pattern: '^\\\\S+ \\\\S+$' }, // \"entity action\"\n    entity: { type: 'string' },\n    action: { type: 'string' },\n    data: { type: 'object' },\n    context: { type: 'object' },\n    globals: { type: 'object' },\n    custom: { type: 'object' },\n    user: { type: 'object' },\n    nested: { type: 'array' },\n    consent: { type: 'object' },\n    id: { type: 'string' },\n    trigger: { type: 'string' },\n    timestamp: { type: 'number' },\n    timing: { type: 'number' },\n    group: { type: 'string' },\n    count: { type: 'number' },\n    version: {\n      type: 'object',\n      required: ['source', 'tagging'],\n      properties: {\n        source: { type: 'string' },\n        tagging: { type: 'number' },\n      },\n    },\n    source: {\n      type: 'object',\n      required: ['type', 'id', 'previous_id'],\n      properties: {\n        type: { type: 'string' },\n        id: { type: 'string' },\n        previous_id: { type: 'string' },\n      },\n    },\n  },\n};\n"],"mappings":"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","names":["Ajv","context"]}
+{"version":3,"sources":["../src/index.ts","../src/transformer.ts","../src/format-schema.ts"],"sourcesContent":["export { transformerValidator } from './transformer';\nexport type { ValidatorSettings, ContractEvents, JsonSchema } from './types';\n\nexport { transformerValidator as default } from './transformer';\n","import Ajv, { ValidateFunction } from 'ajv';\nimport type { Transformer } from '@walkeros/core';\nimport { formatSchema } from './format-schema';\nimport type { ValidatorSettings, JsonSchema } from './types';\n\nexport const transformerValidator: Transformer.Init<\n  Transformer.Types<ValidatorSettings>\n> = (context) => {\n  const { config } = context;\n  const settings = config.settings || {};\n  const {\n    format = true,\n    events,\n    globals,\n    context: ctx,\n    custom,\n    user,\n    consent,\n  } = settings;\n\n  const ajv = new Ajv({ allErrors: true, strict: false });\n\n  // Pre-compile format validator\n  const formatValidator = format ? ajv.compile(formatSchema) : null;\n\n  // Pre-compile section validators (run on every event)\n  const sectionValidators: Array<{\n    name: string;\n    field: string;\n    validate: ValidateFunction;\n  }> = [];\n\n  const sectionSchemas = { globals, context: ctx, custom, user, consent };\n  for (const [name, schema] of Object.entries(sectionSchemas)) {\n    if (schema) {\n      sectionValidators.push({\n        name,\n        field: name,\n        validate: ajv.compile({ type: 'object', ...schema }),\n      });\n    }\n  }\n\n  // Lazy-compiled event validators\n  const eventValidators = new Map<string, ValidateFunction>();\n\n  function getEventValidator(\n    entity: string,\n    action: string,\n    schema: JsonSchema,\n  ) {\n    const key = `${entity}.${action}`;\n    if (!eventValidators.has(key)) {\n      eventValidators.set(key, ajv.compile({ type: 'object', ...schema }));\n    }\n    return eventValidators.get(key)!;\n  }\n\n  /**\n   * Find matching event schema using wildcard fallback.\n   * Checks: entity.action → entity.* → *.action → *.*\n   */\n  function findEventSchema(\n    entity: string,\n    action: string,\n  ): { schema: JsonSchema; key: string } | undefined {\n    if (!events) return undefined;\n\n    // Direct match\n    if (events[entity]?.[action]) {\n      return { schema: events[entity][action], key: `${entity} ${action}` };\n    }\n    // Entity wildcard\n    if (events[entity]?.['*']) {\n      return { schema: events[entity]['*'], key: `${entity} *` };\n    }\n    // Action wildcard\n    if (events['*']?.[action]) {\n      return { schema: events['*'][action], key: `* ${action}` };\n    }\n    // Global wildcard\n    if (events['*']?.['*']) {\n      return { schema: events['*']['*'], key: '* *' };\n    }\n    return undefined;\n  }\n\n  return {\n    type: 'validator',\n    config,\n\n    async push(event, context) {\n      const { logger } = context;\n\n      // 1. Format validation (pre-compiled, fast)\n      if (formatValidator && !formatValidator(event)) {\n        logger.error('Event format invalid', {\n          errors: ajv.errorsText(formatValidator.errors),\n        });\n        return false;\n      }\n\n      // 2. Section validation (pre-compiled, runs on every event)\n      for (const { name, field, validate } of sectionValidators) {\n        const value = (event as Record<string, unknown>)[field];\n        if (!validate(value)) {\n          logger.error(`${name} validation failed`, {\n            errors: ajv.errorsText(validate.errors),\n          });\n          return false;\n        }\n      }\n\n      // 3. Event validation (lazy compiled)\n      if (events && event.entity && event.action) {\n        const match = findEventSchema(event.entity, event.action);\n\n        if (match) {\n          const validator = getEventValidator(\n            event.entity,\n            event.action,\n            match.schema,\n          );\n\n          if (!validator(event)) {\n            logger.error('Contract validation failed', {\n              rule: match.key,\n              errors: ajv.errorsText(validator.errors),\n            });\n            return false;\n          }\n\n          logger.debug('Contract validation passed', { rule: match.key });\n        }\n      }\n\n      return { event };\n    },\n  };\n};\n","import type { JsonSchema } from './types';\n\n/**\n * Pre-compiled JSON Schema for WalkerOS.Event structure validation.\n * Validates that all required fields exist with correct types.\n */\nexport const formatSchema: JsonSchema = {\n  type: 'object',\n  required: [\n    'name',\n    'entity',\n    'action',\n    'data',\n    'globals',\n    'custom',\n    'user',\n    'consent',\n    'id',\n    'trigger',\n    'timestamp',\n    'timing',\n    'source',\n  ],\n  properties: {\n    name: { type: 'string', pattern: '^\\\\S+ \\\\S+$' }, // \"entity action\"\n    entity: { type: 'string' },\n    action: { type: 'string' },\n    data: { type: 'object' },\n    context: { type: 'object' },\n    globals: { type: 'object' },\n    custom: { type: 'object' },\n    user: { type: 'object' },\n    nested: { type: 'array' },\n    consent: { type: 'object' },\n    id: { type: 'string' },\n    trigger: { type: 'string' },\n    timestamp: { type: 'number' },\n    timing: { type: 'number' },\n    source: {\n      type: 'object',\n      required: ['type'],\n      properties: {\n        type: { type: 'string' },\n        platform: { type: 'string' },\n        url: { type: 'string' },\n        referrer: { type: 'string' },\n        schema: { type: 'string' },\n        version: { type: 'string' },\n        count: { type: 'number' },\n        trace: { type: 'string' },\n        tool: { type: 'string' },\n        command: { type: 'string' },\n      },\n    },\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,iBAAsC;;;ACM/B,IAAM,eAA2B;AAAA,EACtC,MAAM;AAAA,EACN,UAAU;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,YAAY;AAAA,IACV,MAAM,EAAE,MAAM,UAAU,SAAS,cAAc;AAAA;AAAA,IAC/C,QAAQ,EAAE,MAAM,SAAS;AAAA,IACzB,QAAQ,EAAE,MAAM,SAAS;AAAA,IACzB,MAAM,EAAE,MAAM,SAAS;AAAA,IACvB,SAAS,EAAE,MAAM,SAAS;AAAA,IAC1B,SAAS,EAAE,MAAM,SAAS;AAAA,IAC1B,QAAQ,EAAE,MAAM,SAAS;AAAA,IACzB,MAAM,EAAE,MAAM,SAAS;AAAA,IACvB,QAAQ,EAAE,MAAM,QAAQ;AAAA,IACxB,SAAS,EAAE,MAAM,SAAS;AAAA,IAC1B,IAAI,EAAE,MAAM,SAAS;AAAA,IACrB,SAAS,EAAE,MAAM,SAAS;AAAA,IAC1B,WAAW,EAAE,MAAM,SAAS;AAAA,IAC5B,QAAQ,EAAE,MAAM,SAAS;AAAA,IACzB,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,UAAU,CAAC,MAAM;AAAA,MACjB,YAAY;AAAA,QACV,MAAM,EAAE,MAAM,SAAS;AAAA,QACvB,UAAU,EAAE,MAAM,SAAS;AAAA,QAC3B,KAAK,EAAE,MAAM,SAAS;AAAA,QACtB,UAAU,EAAE,MAAM,SAAS;AAAA,QAC3B,QAAQ,EAAE,MAAM,SAAS;AAAA,QACzB,SAAS,EAAE,MAAM,SAAS;AAAA,QAC1B,OAAO,EAAE,MAAM,SAAS;AAAA,QACxB,OAAO,EAAE,MAAM,SAAS;AAAA,QACxB,MAAM,EAAE,MAAM,SAAS;AAAA,QACvB,SAAS,EAAE,MAAM,SAAS;AAAA,MAC5B;AAAA,IACF;AAAA,EACF;AACF;;;ADlDO,IAAM,uBAET,CAAC,YAAY;AACf,QAAM,EAAE,OAAO,IAAI;AACnB,QAAM,WAAW,OAAO,YAAY,CAAC;AACrC,QAAM;AAAA,IACJ,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,QAAM,MAAM,IAAI,WAAAA,QAAI,EAAE,WAAW,MAAM,QAAQ,MAAM,CAAC;AAGtD,QAAM,kBAAkB,SAAS,IAAI,QAAQ,YAAY,IAAI;AAG7D,QAAM,oBAID,CAAC;AAEN,QAAM,iBAAiB,EAAE,SAAS,SAAS,KAAK,QAAQ,MAAM,QAAQ;AACtE,aAAW,CAAC,MAAM,MAAM,KAAK,OAAO,QAAQ,cAAc,GAAG;AAC3D,QAAI,QAAQ;AACV,wBAAkB,KAAK;AAAA,QACrB;AAAA,QACA,OAAO;AAAA,QACP,UAAU,IAAI,QAAQ,EAAE,MAAM,UAAU,GAAG,OAAO,CAAC;AAAA,MACrD,CAAC;AAAA,IACH;AAAA,EACF;AAGA,QAAM,kBAAkB,oBAAI,IAA8B;AAE1D,WAAS,kBACP,QACA,QACA,QACA;AACA,UAAM,MAAM,GAAG,MAAM,IAAI,MAAM;AAC/B,QAAI,CAAC,gBAAgB,IAAI,GAAG,GAAG;AAC7B,sBAAgB,IAAI,KAAK,IAAI,QAAQ,EAAE,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC;AAAA,IACrE;AACA,WAAO,gBAAgB,IAAI,GAAG;AAAA,EAChC;AAMA,WAAS,gBACP,QACA,QACiD;AACjD,QAAI,CAAC,OAAQ,QAAO;AAGpB,QAAI,OAAO,MAAM,IAAI,MAAM,GAAG;AAC5B,aAAO,EAAE,QAAQ,OAAO,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,IAAI,MAAM,GAAG;AAAA,IACtE;AAEA,QAAI,OAAO,MAAM,IAAI,GAAG,GAAG;AACzB,aAAO,EAAE,QAAQ,OAAO,MAAM,EAAE,GAAG,GAAG,KAAK,GAAG,MAAM,KAAK;AAAA,IAC3D;AAEA,QAAI,OAAO,GAAG,IAAI,MAAM,GAAG;AACzB,aAAO,EAAE,QAAQ,OAAO,GAAG,EAAE,MAAM,GAAG,KAAK,KAAK,MAAM,GAAG;AAAA,IAC3D;AAEA,QAAI,OAAO,GAAG,IAAI,GAAG,GAAG;AACtB,aAAO,EAAE,QAAQ,OAAO,GAAG,EAAE,GAAG,GAAG,KAAK,MAAM;AAAA,IAChD;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IAEA,MAAM,KAAK,OAAOC,UAAS;AACzB,YAAM,EAAE,OAAO,IAAIA;AAGnB,UAAI,mBAAmB,CAAC,gBAAgB,KAAK,GAAG;AAC9C,eAAO,MAAM,wBAAwB;AAAA,UACnC,QAAQ,IAAI,WAAW,gBAAgB,MAAM;AAAA,QAC/C,CAAC;AACD,eAAO;AAAA,MACT;AAGA,iBAAW,EAAE,MAAM,OAAO,SAAS,KAAK,mBAAmB;AACzD,cAAM,QAAS,MAAkC,KAAK;AACtD,YAAI,CAAC,SAAS,KAAK,GAAG;AACpB,iBAAO,MAAM,GAAG,IAAI,sBAAsB;AAAA,YACxC,QAAQ,IAAI,WAAW,SAAS,MAAM;AAAA,UACxC,CAAC;AACD,iBAAO;AAAA,QACT;AAAA,MACF;AAGA,UAAI,UAAU,MAAM,UAAU,MAAM,QAAQ;AAC1C,cAAM,QAAQ,gBAAgB,MAAM,QAAQ,MAAM,MAAM;AAExD,YAAI,OAAO;AACT,gBAAM,YAAY;AAAA,YAChB,MAAM;AAAA,YACN,MAAM;AAAA,YACN,MAAM;AAAA,UACR;AAEA,cAAI,CAAC,UAAU,KAAK,GAAG;AACrB,mBAAO,MAAM,8BAA8B;AAAA,cACzC,MAAM,MAAM;AAAA,cACZ,QAAQ,IAAI,WAAW,UAAU,MAAM;AAAA,YACzC,CAAC;AACD,mBAAO;AAAA,UACT;AAEA,iBAAO,MAAM,8BAA8B,EAAE,MAAM,MAAM,IAAI,CAAC;AAAA,QAChE;AAAA,MACF;AAEA,aAAO,EAAE,MAAM;AAAA,IACjB;AAAA,EACF;AACF;","names":["Ajv","context"]}

package/dist/index.mjs

@@ -1 +1 @@
-import e from"ajv";import{getMappingEvent as t}from"@walkeros/core";var r={type:"object",required:["name","entity","action","data","context","globals","custom","user","nested","consent","id","trigger","timestamp","timing","group","count","version","source"],properties:{name:{type:"string",pattern:"^\\S+ \\S+$"},entity:{type:"string"},action:{type:"string"},data:{type:"object"},context:{type:"object"},globals:{type:"object"},custom:{type:"object"},user:{type:"object"},nested:{type:"array"},consent:{type:"object"},id:{type:"string"},trigger:{type:"string"},timestamp:{type:"number"},timing:{type:"number"},group:{type:"string"},count:{type:"number"},version:{type:"object",required:["source","tagging"],properties:{source:{type:"string"},tagging:{type:"number"}}},source:{type:"object",required:["type","id","previous_id"],properties:{type:{type:"string"},id:{type:"string"},previous_id:{type:"string"}}}}},o=o=>{const{config:n}=o,i=n.settings||{},{format:s=!0,contract:p}=i,a=new e({allErrors:!0,strict:!1}),c=s?a.compile(r):null,g=new WeakMap;return{type:"validator",config:n,async push(e,r){const{logger:o}=r;if(c&&!c(e))return o.error("Event format invalid",{errors:a.errorsText(c.errors)}),!1;if(p){const{eventMapping:r,mappingKey:n}=await t(e,p),i=r;if(null==i?void 0:i.schema){const t=function(e){if(!g.has(e)){const t={type:"object",...e};g.set(e,a.compile(t))}return g.get(e)}(i.schema);if(!t(e))return o.error("Contract validation failed",{rule:n,errors:a.errorsText(t.errors)}),!1;o.debug("Contract validation passed",{rule:n})}}return e}}};export{o as default,o as transformerValidator};//# sourceMappingURL=index.mjs.map
+import e from"ajv";var t={type:"object",required:["name","entity","action","data","globals","custom","user","consent","id","trigger","timestamp","timing","source"],properties:{name:{type:"string",pattern:"^\\S+ \\S+$"},entity:{type:"string"},action:{type:"string"},data:{type:"object"},context:{type:"object"},globals:{type:"object"},custom:{type:"object"},user:{type:"object"},nested:{type:"array"},consent:{type:"object"},id:{type:"string"},trigger:{type:"string"},timestamp:{type:"number"},timing:{type:"number"},source:{type:"object",required:["type"],properties:{type:{type:"string"},platform:{type:"string"},url:{type:"string"},referrer:{type:"string"},schema:{type:"string"},version:{type:"string"},count:{type:"number"},trace:{type:"string"},tool:{type:"string"},command:{type:"string"}}}}},r=r=>{const{config:n}=r,o=n.settings||{},{format:s=!0,events:i,globals:a,context:c,custom:p,user:y,consent:l}=o,m=new e({allErrors:!0,strict:!1}),u=s?m.compile(t):null,g=[],f={globals:a,context:c,custom:p,user:y,consent:l};for(const[e,t]of Object.entries(f))t&&g.push({name:e,field:e,validate:m.compile({type:"object",...t})});const d=new Map;return{type:"validator",config:n,async push(e,t){const{logger:r}=t;if(u&&!u(e))return r.error("Event format invalid",{errors:m.errorsText(u.errors)}),!1;for(const{name:t,field:n,validate:o}of g){if(!o(e[n]))return r.error(`${t} validation failed`,{errors:m.errorsText(o.errors)}),!1}if(i&&e.entity&&e.action){const t=function(e,t){if(i)return i[e]?.[t]?{schema:i[e][t],key:`${e} ${t}`}:i[e]?.["*"]?{schema:i[e]["*"],key:`${e} *`}:i["*"]?.[t]?{schema:i["*"][t],key:`* ${t}`}:i["*"]?.["*"]?{schema:i["*"]["*"],key:"* *"}:void 0}(e.entity,e.action);if(t){const n=function(e,t,r){const n=`${e}.${t}`;return d.has(n)||d.set(n,m.compile({type:"object",...r})),d.get(n)}(e.entity,e.action,t.schema);if(!n(e))return r.error("Contract validation failed",{rule:t.key,errors:m.errorsText(n.errors)}),!1;r.debug("Contract validation passed",{rule:t.key})}}return{event:e}}}};export{r as default,r as transformerValidator};//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/transformer.ts","../src/format-schema.ts"],"sourcesContent":["import Ajv, { ValidateFunction } from 'ajv';\nimport { getMappingEvent } from '@walkeros/core';\nimport type { Mapping, Transformer } from '@walkeros/core';\nimport { formatSchema } from './format-schema';\nimport type { ValidatorSettings, ContractRule, JsonSchema } from './types';\n\n/**\n * Event validation transformer using AJV with JSON Schema.\n *\n * Two validation modes:\n * - format: Pre-compiled WalkerOS.Event structure validation (runs on every event)\n * - contract: Entity/action keyed business rules with lazy compilation\n */\nexport const transformerValidator: Transformer.Init<\n  Transformer.Types<ValidatorSettings>\n> = (context) => {\n  const { config } = context;\n  const settings = config.settings || {};\n  const { format = true, contract } = settings;\n\n  const ajv = new Ajv({ allErrors: true, strict: false });\n\n  // Pre-compile format validator (runs on every event)\n  const formatValidator = format ? ajv.compile(formatSchema) : null;\n\n  // Lazy-compiled contract validators - keyed by schema reference\n  // Using WeakMap to cache by schema object, handling array rules with conditions\n  const contractValidators = new WeakMap<JsonSchema, ValidateFunction>();\n\n  function getContractValidator(schema: JsonSchema) {\n    if (!contractValidators.has(schema)) {\n      // Auto-wrap with type: 'object'\n      const fullSchema = { type: 'object', ...schema };\n      contractValidators.set(schema, ajv.compile(fullSchema));\n    }\n    return contractValidators.get(schema)!;\n  }\n\n  return {\n    type: 'validator',\n    config,\n\n    async push(event, context) {\n      const { logger } = context;\n\n      // 1. Format validation (pre-compiled, fast)\n      if (formatValidator && !formatValidator(event)) {\n        logger.error('Event format invalid', {\n          errors: ajv.errorsText(formatValidator.errors),\n        });\n        return false;\n      }\n\n      // 2. Contract validation (lazy compiled)\n      if (contract) {\n        // Contract is typed as Mapping.Rules<ContractRule> - cast needed for getMappingEvent\n        const { eventMapping: rule, mappingKey } = await getMappingEvent(\n          event,\n          contract as Mapping.Rules,\n        );\n\n        // Type assertion: we know our rules have schema\n        const contractRule = rule as ContractRule | undefined;\n\n        if (contractRule?.schema) {\n          const validator = getContractValidator(contractRule.schema);\n\n          if (!validator(event)) {\n            logger.error('Contract validation failed', {\n              rule: mappingKey,\n              errors: ajv.errorsText(validator.errors),\n            });\n            return false;\n          }\n\n          logger.debug('Contract validation passed', { rule: mappingKey });\n        }\n      }\n\n      return event;\n    },\n  };\n};\n","import type { JsonSchema } from './types';\n\n/**\n * Pre-compiled JSON Schema for WalkerOS.Event structure validation.\n * Validates that all required fields exist with correct types.\n */\nexport const formatSchema: JsonSchema = {\n  type: 'object',\n  required: [\n    'name',\n    'entity',\n    'action',\n    'data',\n    'context',\n    'globals',\n    'custom',\n    'user',\n    'nested',\n    'consent',\n    'id',\n    'trigger',\n    'timestamp',\n    'timing',\n    'group',\n    'count',\n    'version',\n    'source',\n  ],\n  properties: {\n    name: { type: 'string', pattern: '^\\\\S+ \\\\S+$' }, // \"entity action\"\n    entity: { type: 'string' },\n    action: { type: 'string' },\n    data: { type: 'object' },\n    context: { type: 'object' },\n    globals: { type: 'object' },\n    custom: { type: 'object' },\n    user: { type: 'object' },\n    nested: { type: 'array' },\n    consent: { type: 'object' },\n    id: { type: 'string' },\n    trigger: { type: 'string' },\n    timestamp: { type: 'number' },\n    timing: { type: 'number' },\n    group: { type: 'string' },\n    count: { type: 'number' },\n    version: {\n      type: 'object',\n      required: ['source', 'tagging'],\n      properties: {\n        source: { type: 'string' },\n        tagging: { type: 'number' },\n      },\n    },\n    source: {\n      type: 'object',\n      required: ['type', 'id', 'previous_id'],\n      properties: {\n        type: { type: 'string' },\n        id: { type: 'string' },\n        previous_id: { type: 'string' },\n      },\n    },\n  },\n};\n"],"mappings":"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","names":["context"]}
+{"version":3,"sources":["../src/transformer.ts","../src/format-schema.ts"],"sourcesContent":["import Ajv, { ValidateFunction } from 'ajv';\nimport type { Transformer } from '@walkeros/core';\nimport { formatSchema } from './format-schema';\nimport type { ValidatorSettings, JsonSchema } from './types';\n\nexport const transformerValidator: Transformer.Init<\n  Transformer.Types<ValidatorSettings>\n> = (context) => {\n  const { config } = context;\n  const settings = config.settings || {};\n  const {\n    format = true,\n    events,\n    globals,\n    context: ctx,\n    custom,\n    user,\n    consent,\n  } = settings;\n\n  const ajv = new Ajv({ allErrors: true, strict: false });\n\n  // Pre-compile format validator\n  const formatValidator = format ? ajv.compile(formatSchema) : null;\n\n  // Pre-compile section validators (run on every event)\n  const sectionValidators: Array<{\n    name: string;\n    field: string;\n    validate: ValidateFunction;\n  }> = [];\n\n  const sectionSchemas = { globals, context: ctx, custom, user, consent };\n  for (const [name, schema] of Object.entries(sectionSchemas)) {\n    if (schema) {\n      sectionValidators.push({\n        name,\n        field: name,\n        validate: ajv.compile({ type: 'object', ...schema }),\n      });\n    }\n  }\n\n  // Lazy-compiled event validators\n  const eventValidators = new Map<string, ValidateFunction>();\n\n  function getEventValidator(\n    entity: string,\n    action: string,\n    schema: JsonSchema,\n  ) {\n    const key = `${entity}.${action}`;\n    if (!eventValidators.has(key)) {\n      eventValidators.set(key, ajv.compile({ type: 'object', ...schema }));\n    }\n    return eventValidators.get(key)!;\n  }\n\n  /**\n   * Find matching event schema using wildcard fallback.\n   * Checks: entity.action → entity.* → *.action → *.*\n   */\n  function findEventSchema(\n    entity: string,\n    action: string,\n  ): { schema: JsonSchema; key: string } | undefined {\n    if (!events) return undefined;\n\n    // Direct match\n    if (events[entity]?.[action]) {\n      return { schema: events[entity][action], key: `${entity} ${action}` };\n    }\n    // Entity wildcard\n    if (events[entity]?.['*']) {\n      return { schema: events[entity]['*'], key: `${entity} *` };\n    }\n    // Action wildcard\n    if (events['*']?.[action]) {\n      return { schema: events['*'][action], key: `* ${action}` };\n    }\n    // Global wildcard\n    if (events['*']?.['*']) {\n      return { schema: events['*']['*'], key: '* *' };\n    }\n    return undefined;\n  }\n\n  return {\n    type: 'validator',\n    config,\n\n    async push(event, context) {\n      const { logger } = context;\n\n      // 1. Format validation (pre-compiled, fast)\n      if (formatValidator && !formatValidator(event)) {\n        logger.error('Event format invalid', {\n          errors: ajv.errorsText(formatValidator.errors),\n        });\n        return false;\n      }\n\n      // 2. Section validation (pre-compiled, runs on every event)\n      for (const { name, field, validate } of sectionValidators) {\n        const value = (event as Record<string, unknown>)[field];\n        if (!validate(value)) {\n          logger.error(`${name} validation failed`, {\n            errors: ajv.errorsText(validate.errors),\n          });\n          return false;\n        }\n      }\n\n      // 3. Event validation (lazy compiled)\n      if (events && event.entity && event.action) {\n        const match = findEventSchema(event.entity, event.action);\n\n        if (match) {\n          const validator = getEventValidator(\n            event.entity,\n            event.action,\n            match.schema,\n          );\n\n          if (!validator(event)) {\n            logger.error('Contract validation failed', {\n              rule: match.key,\n              errors: ajv.errorsText(validator.errors),\n            });\n            return false;\n          }\n\n          logger.debug('Contract validation passed', { rule: match.key });\n        }\n      }\n\n      return { event };\n    },\n  };\n};\n","import type { JsonSchema } from './types';\n\n/**\n * Pre-compiled JSON Schema for WalkerOS.Event structure validation.\n * Validates that all required fields exist with correct types.\n */\nexport const formatSchema: JsonSchema = {\n  type: 'object',\n  required: [\n    'name',\n    'entity',\n    'action',\n    'data',\n    'globals',\n    'custom',\n    'user',\n    'consent',\n    'id',\n    'trigger',\n    'timestamp',\n    'timing',\n    'source',\n  ],\n  properties: {\n    name: { type: 'string', pattern: '^\\\\S+ \\\\S+$' }, // \"entity action\"\n    entity: { type: 'string' },\n    action: { type: 'string' },\n    data: { type: 'object' },\n    context: { type: 'object' },\n    globals: { type: 'object' },\n    custom: { type: 'object' },\n    user: { type: 'object' },\n    nested: { type: 'array' },\n    consent: { type: 'object' },\n    id: { type: 'string' },\n    trigger: { type: 'string' },\n    timestamp: { type: 'number' },\n    timing: { type: 'number' },\n    source: {\n      type: 'object',\n      required: ['type'],\n      properties: {\n        type: { type: 'string' },\n        platform: { type: 'string' },\n        url: { type: 'string' },\n        referrer: { type: 'string' },\n        schema: { type: 'string' },\n        version: { type: 'string' },\n        count: { type: 'number' },\n        trace: { type: 'string' },\n        tool: { type: 'string' },\n        command: { type: 'string' },\n      },\n    },\n  },\n};\n"],"mappings":"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","names":["context"]}

package/dist/walkerOS.json

@@ -0,0 +1,419 @@
+{
+  "$meta": {
+    "package": "@walkeros/transformer-validator",
+    "version": "4.0.1-next-1778068549946",
+    "type": "transformer",
+    "platform": [
+      "web",
+      "server"
+    ],
+    "docs": "https://www.walkeros.io/docs/transformers/validator",
+    "source": "https://github.com/elbwalker/walkerOS/tree/main/packages/transformers/validator/src"
+  },
+  "schemas": {
+    "format": {
+      "type": "object",
+      "required": [
+        "name",
+        "entity",
+        "action",
+        "data",
+        "globals",
+        "custom",
+        "user",
+        "consent",
+        "id",
+        "trigger",
+        "timestamp",
+        "timing",
+        "source"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^\\S+ \\S+$"
+        },
+        "entity": {
+          "type": "string"
+        },
+        "action": {
+          "type": "string"
+        },
+        "data": {
+          "type": "object"
+        },
+        "context": {
+          "type": "object"
+        },
+        "globals": {
+          "type": "object"
+        },
+        "custom": {
+          "type": "object"
+        },
+        "user": {
+          "type": "object"
+        },
+        "nested": {
+          "type": "array"
+        },
+        "consent": {
+          "type": "object"
+        },
+        "id": {
+          "type": "string"
+        },
+        "trigger": {
+          "type": "string"
+        },
+        "timestamp": {
+          "type": "number"
+        },
+        "timing": {
+          "type": "number"
+        },
+        "source": {
+          "type": "object",
+          "required": [
+            "type"
+          ],
+          "properties": {
+            "type": {
+              "type": "string"
+            },
+            "platform": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            },
+            "referrer": {
+              "type": "string"
+            },
+            "schema": {
+              "type": "string"
+            },
+            "version": {
+              "type": "string"
+            },
+            "count": {
+              "type": "number"
+            },
+            "trace": {
+              "type": "string"
+            },
+            "tool": {
+              "type": "string"
+            },
+            "command": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "settings": {
+      "type": "object",
+      "properties": {
+        "format": {
+          "type": "boolean",
+          "description": "Validate full WalkerOS.Event structure. Pre-compiled at init.",
+          "default": true
+        },
+        "contract": {
+          "type": "object",
+          "description": "Event-specific validation rules. Entity/action keyed, supports wildcards."
+        }
+      }
+    }
+  },
+  "examples": {
+    "step": {
+      "contractValidationPass": {
+        "title": "Contract validation",
+        "description": "Contract validation passes when event data matches the entity.action JSON Schema",
+        "in": {
+          "name": "order complete",
+          "data": {
+            "id": "0rd3r1d",
+            "total": 555,
+            "currency": "EUR"
+          },
+          "context": {
+            "shopping": [
+              "complete",
+              0
+            ]
+          },
+          "globals": {
+            "pagegroup": "shop"
+          },
+          "custom": {
+            "completely": "random"
+          },
+          "user": {
+            "id": "us3r",
+            "device": "c00k13",
+            "session": "s3ss10n"
+          },
+          "nested": [
+            {
+              "entity": "product",
+              "data": {
+                "id": "ers",
+                "name": "Everyday Ruck Snack",
+                "color": "black",
+                "size": "l",
+                "price": 420
+              },
+              "context": {
+                "shopping": [
+                  "complete",
+                  0
+                ]
+              },
+              "nested": []
+            },
+            {
+              "entity": "product",
+              "data": {
+                "id": "cc",
+                "name": "Cool Cap",
+                "size": "one size",
+                "price": 42
+              },
+              "context": {
+                "shopping": [
+                  "complete",
+                  0
+                ]
+              },
+              "nested": []
+            },
+            {
+              "entity": "gift",
+              "data": {
+                "name": "Surprise"
+              },
+              "context": {
+                "shopping": [
+                  "complete",
+                  0
+                ]
+              },
+              "nested": []
+            }
+          ],
+          "consent": {
+            "functional": true
+          },
+          "id": "ev-1700000800",
+          "trigger": "load",
+          "entity": "order",
+          "action": "complete",
+          "timestamp": 1700000800,
+          "timing": 3.14,
+          "source": {
+            "type": "browser",
+            "platform": "web",
+            "url": "https://shop.example.com/"
+          }
+        },
+        "out": [
+          [
+            "return",
+            {
+              "name": "order complete",
+              "data": {
+                "id": "0rd3r1d",
+                "total": 555,
+                "currency": "EUR"
+              },
+              "context": {
+                "shopping": [
+                  "complete",
+                  0
+                ]
+              },
+              "globals": {
+                "pagegroup": "shop"
+              },
+              "custom": {
+                "completely": "random"
+              },
+              "user": {
+                "id": "us3r",
+                "device": "c00k13",
+                "session": "s3ss10n"
+              },
+              "nested": [
+                {
+                  "entity": "product",
+                  "data": {
+                    "id": "ers",
+                    "name": "Everyday Ruck Snack",
+                    "color": "black",
+                    "size": "l",
+                    "price": 420
+                  },
+                  "context": {
+                    "shopping": [
+                      "complete",
+                      0
+                    ]
+                  },
+                  "nested": []
+                },
+                {
+                  "entity": "product",
+                  "data": {
+                    "id": "cc",
+                    "name": "Cool Cap",
+                    "size": "one size",
+                    "price": 42
+                  },
+                  "context": {
+                    "shopping": [
+                      "complete",
+                      0
+                    ]
+                  },
+                  "nested": []
+                },
+                {
+                  "entity": "gift",
+                  "data": {
+                    "name": "Surprise"
+                  },
+                  "context": {
+                    "shopping": [
+                      "complete",
+                      0
+                    ]
+                  },
+                  "nested": []
+                }
+              ],
+              "consent": {
+                "functional": true
+              },
+              "id": "ev-1700000800",
+              "trigger": "load",
+              "entity": "order",
+              "action": "complete",
+              "timestamp": 1700000800,
+              "timing": 3.14,
+              "source": {
+                "type": "browser",
+                "platform": "web",
+                "url": "https://shop.example.com/"
+              }
+            }
+          ]
+        ]
+      },
+      "invalidFormat": {
+        "public": false,
+        "in": {
+          "name": "invalid",
+          "data": {}
+        },
+        "out": [
+          [
+            "return",
+            false
+          ]
+        ]
+      },
+      "validEvent": {
+        "title": "Valid event",
+        "description": "A well-formed product view passes validation and is returned unchanged for downstream destinations.",
+        "in": {
+          "name": "product view",
+          "data": {
+            "id": "SKU-100",
+            "name": "Trail Runner Pro",
+            "price": 129.99
+          },
+          "context": {
+            "shopping": [
+              "detail",
+              0
+            ]
+          },
+          "globals": {
+            "pagegroup": "shop"
+          },
+          "custom": {
+            "completely": "random"
+          },
+          "user": {
+            "id": "us3r",
+            "device": "c00k13",
+            "session": "s3ss10n"
+          },
+          "nested": [],
+          "consent": {
+            "functional": true
+          },
+          "id": "ev-1700000700",
+          "trigger": "load",
+          "entity": "product",
+          "action": "view",
+          "timestamp": 1700000700,
+          "timing": 3.14,
+          "source": {
+            "type": "browser",
+            "platform": "web",
+            "url": "https://example.com/"
+          }
+        },
+        "out": [
+          [
+            "return",
+            {
+              "name": "product view",
+              "data": {
+                "id": "SKU-100",
+                "name": "Trail Runner Pro",
+                "price": 129.99
+              },
+              "context": {
+                "shopping": [
+                  "detail",
+                  0
+                ]
+              },
+              "globals": {
+                "pagegroup": "shop"
+              },
+              "custom": {
+                "completely": "random"
+              },
+              "user": {
+                "id": "us3r",
+                "device": "c00k13",
+                "session": "s3ss10n"
+              },
+              "nested": [],
+              "consent": {
+                "functional": true
+              },
+              "id": "ev-1700000700",
+              "trigger": "load",
+              "entity": "product",
+              "action": "view",
+              "timestamp": 1700000700,
+              "timing": 3.14,
+              "source": {
+                "type": "browser",
+                "platform": "web",
+                "url": "https://example.com/"
+              }
+            }
+          ]
+        ]
+      }
+    }
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walkeros/transformer-validator",
   "description": "Event validation transformer for walkerOS using AJV and JSON Schema",
-  "version": "4.0.0",
+  "version": "4.0.1-next-1778068549946",
   "license": "MIT",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -16,7 +16,8 @@
       "types": "./dist/dev.d.ts",
       "import": "./dist/dev.mjs",
       "require": "./dist/dev.js"
-    }
+    },
+    "./walkerOS.json": "./dist/walkerOS.json"
   },
   "files": [
     "dist/**"
@@ -25,18 +26,17 @@
     "build": "tsup --silent",
     "clean": "rm -rf .turbo && rm -rf dist",
     "dev": "jest --watchAll --colors",
-    "lint": "tsc --noEmit && eslint \"**/*.ts*\"",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"**/*.ts*\"",
     "test": "jest",
     "update": "npx npm-check-updates -u && npm update"
   },
   "dependencies": {
-    "ajv": "^8.17.1"
-  },
-  "peerDependencies": {
-    "@walkeros/core": "^1.3.0"
+    "ajv": "^8.17.1",
+    "@walkeros/core": "4.0.1-next-1778068549946"
   },
   "devDependencies": {
-    "@walkeros/core": "1.3.0"
+    "@walkeros/core": "4.0.1-next-1778068549946"
   },
   "repository": {
     "url": "git+https://github.com/elbwalker/walkerOS.git",
@@ -47,13 +47,22 @@
   "bugs": {
     "url": "https://github.com/elbwalker/walkerOS/issues"
   },
+  "walkerOS": {
+    "type": "transformer",
+    "docs": "https://www.walkeros.io/docs/transformers/validator",
+    "platform": [
+      "web",
+      "server"
+    ]
+  },
   "keywords": [
-    "walker",
     "walkerOS",
+    "walkerOS-transformer",
     "transformer",
     "validator",
     "ajv",
-    "json-schema"
+    "json-schema",
+    "analytics"
   ],
   "funding": [
     {