@walkeros/transformer-validator 3.0.0 → 3.0.1

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,i=Object.getOwnPropertyNames,o=Object.prototype.hasOwnProperty,p=(e,r)=>{for(var i in r)t(e,i,{get:r[i],enumerable:!0})},a={};p(a,{examples:()=>s,formatSchema:()=>n,schemas:()=>g,settingsSchema:()=>l}),module.exports=(e=a,((e,p,a,n)=>{if(p&&"object"==typeof p||"function"==typeof p)for(let s of i(p))o.call(e,s)||s===a||t(e,s,{get:()=>p[s],enumerable:!(n=r(p,s))||n.enumerable});return e})(t({},"__esModule",{value:!0}),e));var n={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={};p(s,{step:()=>c});var c={};p(c,{contractValidationPass:()=>y,invalidFormat:()=>m,validEvent:()=>u});var d=require("@walkeros/core"),u={in:(0,d.getEvent)("product view",{timestamp:1700000700,data:{id:"SKU-100",name:"Trail Runner Pro",price:129.99},source:{type:"web",id:"https://example.com",previous_id:""}}),out:{event:(0,d.getEvent)("product view",{timestamp:1700000700,data:{id:"SKU-100",name:"Trail Runner Pro",price:129.99},source:{type:"web",id:"https://example.com",previous_id:""}})}},m={in:{name:"invalid",data:{}},out:!1},y={description:"Contract validation passes when event data matches the entity.action JSON Schema",in:(0,d.getEvent)("order complete",{timestamp:1700000800,data:{id:"0rd3r1d",total:555,currency:"EUR"},source:{type:"web",id:"https://shop.example.com",previous_id:""}}),out:{event:(0,d.getEvent)("order complete",{timestamp:1700000800,data:{id:"0rd3r1d",total:555,currency:"EUR"},source:{type:"web",id:"https://shop.example.com",previous_id:""}})}},l={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."}}},g={format:n,settings:l};//# 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    '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","export * as step from './step';\n","import type { Flow } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\n\nexport const validEvent: Flow.StepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000700,\n    data: { id: 'SKU-100', name: 'Trail Runner Pro', price: 129.99 },\n    source: { type: 'web', id: 'https://example.com', previous_id: '' },\n  }),\n  out: {\n    event: getEvent('product view', {\n      timestamp: 1700000700,\n      data: { id: 'SKU-100', name: 'Trail Runner Pro', price: 129.99 },\n      source: { type: 'web', id: 'https://example.com', previous_id: '' },\n    }),\n  },\n};\n\nexport const invalidFormat: Flow.StepExample = {\n  in: {\n    name: 'invalid',\n    data: {},\n  },\n  out: false,\n};\n\nexport const contractValidationPass: Flow.StepExample = {\n  description:\n    'Contract validation passes when event data matches the entity.action JSON Schema',\n  in: getEvent('order complete', {\n    timestamp: 1700000800,\n    data: { id: '0rd3r1d', total: 555, currency: 'EUR' },\n    source: { type: 'web', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  out: {\n    event: getEvent('order complete', {\n      timestamp: 1700000800,\n      data: { id: '0rd3r1d', total: 555, currency: 'EUR' },\n      source: { type: 'web', id: 'https://shop.example.com', previous_id: '' },\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 e=Object.defineProperty,t=(t,r)=>{for(var i in r)e(t,i,{get:r[i],enumerable:!0})},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"}}}}},i={};t(i,{step:()=>o});var o={};t(o,{contractValidationPass:()=>s,invalidFormat:()=>n,validEvent:()=>a});import{getEvent as p}from"@walkeros/core";var a={in:p("product view",{timestamp:1700000700,data:{id:"SKU-100",name:"Trail Runner Pro",price:129.99},source:{type:"web",id:"https://example.com",previous_id:""}}),out:{event:p("product view",{timestamp:1700000700,data:{id:"SKU-100",name:"Trail Runner Pro",price:129.99},source:{type:"web",id:"https://example.com",previous_id:""}})}},n={in:{name:"invalid",data:{}},out:!1},s={description:"Contract validation passes when event data matches the entity.action JSON Schema",in:p("order complete",{timestamp:1700000800,data:{id:"0rd3r1d",total:555,currency:"EUR"},source:{type:"web",id:"https://shop.example.com",previous_id:""}}),out:{event:p("order complete",{timestamp:1700000800,data:{id:"0rd3r1d",total:555,currency:"EUR"},source:{type:"web",id:"https://shop.example.com",previous_id:""}})}},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    '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","export * as step from './step';\n","import type { Flow } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\n\nexport const validEvent: Flow.StepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000700,\n    data: { id: 'SKU-100', name: 'Trail Runner Pro', price: 129.99 },\n    source: { type: 'web', id: 'https://example.com', previous_id: '' },\n  }),\n  out: {\n    event: getEvent('product view', {\n      timestamp: 1700000700,\n      data: { id: 'SKU-100', name: 'Trail Runner Pro', price: 129.99 },\n      source: { type: 'web', id: 'https://example.com', previous_id: '' },\n    }),\n  },\n};\n\nexport const invalidFormat: Flow.StepExample = {\n  in: {\n    name: 'invalid',\n    data: {},\n  },\n  out: false,\n};\n\nexport const contractValidationPass: Flow.StepExample = {\n  description:\n    'Contract validation passes when event data matches the entity.action JSON Schema',\n  in: getEvent('order complete', {\n    timestamp: 1700000800,\n    data: { id: '0rd3r1d', total: 555, currency: 'EUR' },\n    source: { type: 'web', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  out: {\n    event: getEvent('order complete', {\n      timestamp: 1700000800,\n      data: { id: '0rd3r1d', total: 555, currency: 'EUR' },\n      source: { type: 'web', id: 'https://shop.example.com', previous_id: '' },\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,i=Object.getPrototypeOf,s=Object.prototype.hasOwnProperty,a=(e,t,i,a)=>{if(t&&"object"==typeof t||"function"==typeof t)for(let c of n(t))s.call(e,c)||c===i||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 u=((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")),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"}}}}},l=e=>{const{config:t}=e,r=t.settings||{},{format:o=!0,events:n,globals:i,context:s,custom:a,user:c,consent:l}=r,y=new u.default({allErrors:!0,strict:!1}),g=o?y.compile(p):null,d=[],m={globals:i,context:s,custom:a,user:c,consent:l};for(const[e,t]of Object.entries(m))t&&d.push({name:e,field:e,validate:y.compile({type:"object",...t})});const f=new Map;return{type:"validator",config:t,async push(e,t){const{logger:r}=t;if(g&&!g(e))return r.error("Event format invalid",{errors:y.errorsText(g.errors)}),!1;for(const{name:t,field:o,validate:n}of d){if(!n(e[o]))return r.error(`${t} validation failed`,{errors:y.errorsText(n.errors)}),!1}if(n&&e.entity&&e.action){const t=function(e,t){var r,o,i,s;if(n)return(null==(r=n[e])?void 0:r[t])?{schema:n[e][t],key:`${e} ${t}`}:(null==(o=n[e])?void 0:o["*"])?{schema:n[e]["*"],key:`${e} *`}:(null==(i=n["*"])?void 0:i[t])?{schema:n["*"][t],key:`* ${t}`}:(null==(s=n["*"])?void 0:s["*"])?{schema:n["*"]["*"],key:"* *"}:void 0}(e.entity,e.action);if(t){const o=function(e,t,r){const o=`${e}.${t}`;return f.has(o)||f.set(o,y.compile({type:"object",...r})),f.get(o)}(e.entity,e.action,t.schema);if(!o(e))return r.error("Contract validation failed",{rule:t.key,errors:y.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    '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"]}

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","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"}}}}},r=r=>{const{config:o}=r,n=o.settings||{},{format:i=!0,events:s,globals:c,context:a,custom:p,user:u,consent:y}=n,l=new e({allErrors:!0,strict:!1}),g=i?l.compile(t):null,d=[],m={globals:c,context:a,custom:p,user:u,consent:y};for(const[e,t]of Object.entries(m))t&&d.push({name:e,field:e,validate:l.compile({type:"object",...t})});const f=new Map;return{type:"validator",config:o,async push(e,t){const{logger:r}=t;if(g&&!g(e))return r.error("Event format invalid",{errors:l.errorsText(g.errors)}),!1;for(const{name:t,field:o,validate:n}of d){if(!n(e[o]))return r.error(`${t} validation failed`,{errors:l.errorsText(n.errors)}),!1}if(s&&e.entity&&e.action){const t=function(e,t){var r,o,n,i;if(s)return(null==(r=s[e])?void 0:r[t])?{schema:s[e][t],key:`${e} ${t}`}:(null==(o=s[e])?void 0:o["*"])?{schema:s[e]["*"],key:`${e} *`}:(null==(n=s["*"])?void 0:n[t])?{schema:s["*"][t],key:`* ${t}`}:(null==(i=s["*"])?void 0:i["*"])?{schema:s["*"]["*"],key:"* *"}:void 0}(e.entity,e.action);if(t){const o=function(e,t,r){const o=`${e}.${t}`;return f.has(o)||f.set(o,l.compile({type:"object",...r})),f.get(o)}(e.entity,e.action,t.schema);if(!o(e))return r.error("Contract validation failed",{rule:t.key,errors:l.errorsText(o.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    '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,OAAO,SAA+B;;;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,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;;;AD1DO,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,IAAI,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;AAjErD;AAkEI,QAAI,CAAC,OAAQ,QAAO;AAGpB,SAAI,YAAO,MAAM,MAAb,mBAAiB,SAAS;AAC5B,aAAO,EAAE,QAAQ,OAAO,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,IAAI,MAAM,GAAG;AAAA,IACtE;AAEA,SAAI,YAAO,MAAM,MAAb,mBAAiB,MAAM;AACzB,aAAO,EAAE,QAAQ,OAAO,MAAM,EAAE,GAAG,GAAG,KAAK,GAAG,MAAM,KAAK;AAAA,IAC3D;AAEA,SAAI,YAAO,GAAG,MAAV,mBAAc,SAAS;AACzB,aAAO,EAAE,QAAQ,OAAO,GAAG,EAAE,MAAM,GAAG,KAAK,KAAK,MAAM,GAAG;AAAA,IAC3D;AAEA,SAAI,YAAO,GAAG,MAAV,mBAAc,MAAM;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,OAAOA,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":["context"]}

package/dist/walkerOS.json

@@ -0,0 +1,431 @@
+{
+  "$meta": {
+    "package": "@walkeros/transformer-validator",
+    "version": "3.0.0",
+    "type": "transformer",
+    "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",
+        "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"
+            }
+          }
+        }
+      }
+    },
+    "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": {
+        "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": "1700000800-gr0up-1",
+          "trigger": "load",
+          "entity": "order",
+          "action": "complete",
+          "timestamp": 1700000800,
+          "timing": 3.14,
+          "group": "gr0up",
+          "count": 1,
+          "version": {
+            "source": "3.0.0",
+            "tagging": 1
+          },
+          "source": {
+            "type": "web",
+            "id": "https://shop.example.com",
+            "previous_id": ""
+          }
+        },
+        "out": {
+          "event": {
+            "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": "1700000800-gr0up-1",
+            "trigger": "load",
+            "entity": "order",
+            "action": "complete",
+            "timestamp": 1700000800,
+            "timing": 3.14,
+            "group": "gr0up",
+            "count": 1,
+            "version": {
+              "source": "3.0.0",
+              "tagging": 1
+            },
+            "source": {
+              "type": "web",
+              "id": "https://shop.example.com",
+              "previous_id": ""
+            }
+          }
+        }
+      },
+      "invalidFormat": {
+        "in": {
+          "name": "invalid",
+          "data": {}
+        },
+        "out": false
+      },
+      "validEvent": {
+        "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": "1700000700-gr0up-1",
+          "trigger": "load",
+          "entity": "product",
+          "action": "view",
+          "timestamp": 1700000700,
+          "timing": 3.14,
+          "group": "gr0up",
+          "count": 1,
+          "version": {
+            "source": "3.0.0",
+            "tagging": 1
+          },
+          "source": {
+            "type": "web",
+            "id": "https://example.com",
+            "previous_id": ""
+          }
+        },
+        "out": {
+          "event": {
+            "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": "1700000700-gr0up-1",
+            "trigger": "load",
+            "entity": "product",
+            "action": "view",
+            "timestamp": 1700000700,
+            "timing": 3.14,
+            "group": "gr0up",
+            "count": 1,
+            "version": {
+              "source": "3.0.0",
+              "tagging": 1
+            },
+            "source": {
+              "type": "web",
+              "id": "https://example.com",
+              "previous_id": ""
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walkeros/transformer-validator",
   "description": "Event validation transformer for walkerOS using AJV and JSON Schema",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "license": "MIT",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -23,20 +23,19 @@
   ],
   "scripts": {
     "build": "tsup --silent",
-    "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist",
+    "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.2.0"
+    "ajv": "^8.17.1",
+    "@walkeros/core": "^3.0.1"
   },
   "devDependencies": {
-    "@walkeros/core": "1.2.0"
+    "@walkeros/core": "^3.0.1"
   },
   "repository": {
     "url": "git+https://github.com/elbwalker/walkerOS.git",
@@ -47,13 +46,18 @@
   "bugs": {
     "url": "https://github.com/elbwalker/walkerOS/issues"
   },
+  "walkerOS": {
+    "type": "transformer",
+    "docs": "https://www.walkeros.io/docs/transformers/validator"
+  },
   "keywords": [
-    "walker",
     "walkerOS",
+    "walkerOS-transformer",
     "transformer",
     "validator",
     "ajv",
-    "json-schema"
+    "json-schema",
+    "analytics"
   ],
   "funding": [
     {