@walkeros/server-destination-kafka 3.4.0-next-1776749829492

package/dist/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dev.ts","../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/examples/index.ts","../src/examples/env.ts","../src/examples/step.ts"],"sourcesContent":["export * as schemas from './schemas';\nexport * as examples from './examples';\n","import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nexport { SettingsSchema, KafkaSettingsSchema, type Settings } from './settings';\nexport { MappingSchema, type Mapping } from './mapping';\n\n// JSON Schema\nexport const settings = zodToSchema(SettingsSchema);\nexport const mapping = zodToSchema(MappingSchema);\n","import { z } from '@walkeros/core/dev';\n\nconst SASLSchema = z.object({\n  mechanism: z\n    .enum(['plain', 'scram-sha-256', 'scram-sha-512', 'aws', 'oauthbearer'])\n    .describe('SASL authentication mechanism.'),\n  username: z\n    .string()\n    .optional()\n    .describe('Username for plain/scram mechanisms.'),\n  password: z\n    .string()\n    .optional()\n    .describe('Password for plain/scram mechanisms.'),\n  accessKeyId: z\n    .string()\n    .optional()\n    .describe('AWS access key ID for IAM auth (mechanism: aws).'),\n  secretAccessKey: z\n    .string()\n    .optional()\n    .describe('AWS secret access key for IAM auth (mechanism: aws).'),\n  sessionToken: z\n    .string()\n    .optional()\n    .describe('AWS session token for temporary credentials (mechanism: aws).'),\n  authorizationIdentity: z\n    .string()\n    .optional()\n    .describe('AWS authorization identity (mechanism: aws).'),\n});\n\nconst RetrySchema = z.object({\n  maxRetryTime: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Max total retry wait in ms. Default: 30000.'),\n  initialRetryTime: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('First retry delay in ms. Default: 300.'),\n  retries: z\n    .number()\n    .int()\n    .min(0)\n    .optional()\n    .describe('Max retry count. Default: 5.'),\n});\n\nexport const KafkaSettingsSchema = z.object({\n  brokers: z\n    .array(z.string().min(1))\n    .min(1)\n    .describe('Kafka broker addresses (host:port). At least one required.'),\n  clientId: z\n    .string()\n    .optional()\n    .describe('Kafka client ID. Default: walkeros.'),\n  ssl: z\n    .union([z.boolean(), z.record(z.string(), z.unknown())])\n    .optional()\n    .describe(\n      'TLS configuration. Set true for default TLS, or provide a tls.ConnectionOptions object for mTLS.',\n    ),\n  sasl: SASLSchema.optional().describe(\n    'SASL authentication config. Required for Confluent Cloud, AWS MSK with IAM, etc.',\n  ),\n  connectionTimeout: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Connection timeout in ms. Default: 1000.'),\n  requestTimeout: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Request timeout in ms. Default: 30000.'),\n  topic: z.string().min(1).describe('Target Kafka topic name.'),\n  acks: z\n    .number()\n    .int()\n    .min(-1)\n    .max(1)\n    .optional()\n    .describe(\n      'Acknowledgement level. -1 = all replicas, 0 = fire-and-forget, 1 = leader only. Default: -1.',\n    ),\n  timeout: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Broker response timeout in ms. Default: 30000.'),\n  compression: z\n    .enum(['none', 'gzip', 'snappy', 'lz4', 'zstd'])\n    .optional()\n    .describe(\n      'Message compression codec. Default: gzip. Snappy/LZ4/ZSTD require additional npm packages.',\n    ),\n  idempotent: z\n    .boolean()\n    .optional()\n    .describe(\n      'Enable idempotent producer for exactly-once delivery. Default: false.',\n    ),\n  allowAutoTopicCreation: z\n    .boolean()\n    .optional()\n    .describe('Allow auto-creation of topics on the broker. Default: false.'),\n  key: z\n    .string()\n    .optional()\n    .describe(\n      'Mapping value path for message key derivation (e.g. user.id, data.userId). Default: entity_action.',\n    ),\n  headers: z\n    .record(z.string(), z.string())\n    .optional()\n    .describe('Static headers added to every message.'),\n  retry: RetrySchema.optional().describe(\n    'Retry configuration for transient failures.',\n  ),\n});\n\nexport const SettingsSchema = z.object({\n  kafka: KafkaSettingsSchema.describe(\n    'Kafka connection and producer settings.',\n  ),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  key: z\n    .string()\n    .optional()\n    .describe(\n      'Override message key mapping path for this rule (e.g. data.id). Takes precedence over settings.kafka.key.',\n    ),\n  topic: z\n    .string()\n    .optional()\n    .describe(\n      'Override Kafka topic for this rule. Takes precedence over settings.kafka.topic.',\n    ),\n});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * as env from './env';\nexport * as step from './step';\n","import type {\n  Env,\n  KafkaClientConstructor,\n  KafkaClientMock,\n  KafkaProducerMock,\n  ProducerRecord,\n  ProducerConfig,\n  KafkaClientConfig,\n  CompressionTypesMap,\n} from '../types';\n\n// Narrow helper type aliases so the mock SDK is typed explicitly without `any`.\ntype ProducerConnect = () => Promise<void>;\ntype ProducerDisconnect = () => Promise<void>;\ntype ProducerSend = (record: ProducerRecord) => Promise<unknown>;\ntype KafkaProducerFactory = (config?: ProducerConfig) => KafkaProducerMock;\n\nconst asyncConnect: ProducerConnect = () => Promise.resolve();\nconst asyncDisconnect: ProducerDisconnect = () => Promise.resolve();\nconst asyncSend: ProducerSend = () => Promise.resolve([]);\n\nfunction createMockProducer(): KafkaProducerMock {\n  return {\n    connect: asyncConnect,\n    disconnect: asyncDisconnect,\n    send: asyncSend,\n  };\n}\n\nconst mockProducerFactory: KafkaProducerFactory = () => createMockProducer();\n\nclass MockKafkaClient implements KafkaClientMock {\n  constructor(_config: KafkaClientConfig) {}\n  producer(config?: ProducerConfig): KafkaProducerMock {\n    return mockProducerFactory(config);\n  }\n}\n\nconst MockKafkaConstructor: KafkaClientConstructor = MockKafkaClient;\n\nconst MockCompressionTypes: CompressionTypesMap = {\n  None: 0,\n  GZIP: 1,\n  Snappy: 2,\n  LZ4: 3,\n  ZSTD: 4,\n};\n\nexport const push: Env = {\n  Kafka: {\n    Kafka: MockKafkaConstructor,\n    CompressionTypes: MockCompressionTypes,\n  },\n};\n\nexport const simulation = ['call:producer.send'];\n","import type { Flow } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * Extended step example that may carry destination-level settings overrides.\n */\nexport type KafkaStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n};\n\n/**\n * Default event -- full WalkerOS.Event serialized as JSON to the configured\n * topic. Message key defaults to entity_action when no key path is set.\n */\nexport const defaultEvent: KafkaStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000100,\n  }),\n  out: [\n    [\n      'producer.send',\n      {\n        topic: 'walkeros-events',\n        messages: [\n          {\n            key: 'page_view',\n            value: 'json:event',\n            headers: { 'content-type': 'application/json' },\n            timestamp: '1700000100',\n          },\n        ],\n        acks: -1,\n        compression: 1,\n      },\n    ],\n  ],\n};\n\n/**\n * Mapped event name -- rule.name renames the event, which also changes the\n * default message key when no key mapping is configured.\n */\nexport const mappedEventName: KafkaStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000101,\n  }),\n  mapping: {\n    name: 'purchase',\n  },\n  out: [\n    [\n      'producer.send',\n      {\n        topic: 'walkeros-events',\n        messages: [\n          {\n            key: 'purchase',\n            value: 'json:event',\n            headers: { 'content-type': 'application/json' },\n            timestamp: '1700000101',\n          },\n        ],\n        acks: -1,\n        compression: 1,\n      },\n    ],\n  ],\n};\n\n/**\n * Mapped data -- data.map transforms the event payload. Value is the mapped\n * object serialized as JSON.\n */\nexport const mappedData: KafkaStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000102,\n    data: { id: 'ORD-400', total: 99.99, currency: 'EUR' },\n  }),\n  mapping: {\n    name: 'purchase',\n    data: {\n      map: {\n        order_id: 'data.id',\n        revenue: 'data.total',\n        currency: 'data.currency',\n      },\n    },\n  },\n  out: [\n    [\n      'producer.send',\n      {\n        topic: 'walkeros-events',\n        messages: [\n          {\n            key: 'purchase',\n            value: 'json:data',\n            headers: { 'content-type': 'application/json' },\n            timestamp: '1700000102',\n          },\n        ],\n        acks: -1,\n        compression: 1,\n      },\n    ],\n  ],\n};\n\n/**\n * Key from user -- settings.kafka.key path resolves the message key from\n * the event (here user.id).\n */\nexport const keyFromUser: KafkaStepExample = {\n  in: getEvent('user signup', {\n    timestamp: 1700000103,\n    user: { id: 'usr-789' },\n    data: { plan: 'pro' },\n  }),\n  settings: {\n    kafka: {\n      brokers: ['localhost:9092'],\n      topic: 'walkeros-events',\n      key: 'user.id',\n    },\n  },\n  out: [\n    [\n      'producer.send',\n      {\n        topic: 'walkeros-events',\n        messages: [\n          {\n            key: 'usr-789',\n            value: 'json:event',\n            headers: { 'content-type': 'application/json' },\n            timestamp: '1700000103',\n          },\n        ],\n        acks: -1,\n        compression: 1,\n      },\n    ],\n  ],\n};\n\n/**\n * Topic override -- rule.settings.topic routes this rule to a different\n * topic than the destination default.\n */\nexport const topicOverride: KafkaStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000104,\n    data: { id: 'ORD-500', total: 42 },\n  }),\n  mapping: {\n    settings: {\n      topic: 'orders-stream',\n    },\n  },\n  out: [\n    [\n      'producer.send',\n      {\n        topic: 'orders-stream',\n        messages: [\n          {\n            key: 'order_complete',\n            value: 'json:event',\n            headers: { 'content-type': 'application/json' },\n            timestamp: '1700000104',\n          },\n        ],\n        acks: -1,\n        compression: 1,\n      },\n    ],\n  ],\n};\n\n/**\n * Ignored event -- mapping.ignore: true produces no producer.send call.\n */\nexport const ignoredEvent: KafkaStepExample = {\n  in: getEvent('debug noise', {\n    timestamp: 1700000105,\n  }),\n  mapping: { ignore: true },\n  out: [],\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAAA,cAA4B;;;ACA5B,iBAAkB;AAElB,IAAM,aAAa,aAAE,OAAO;AAAA,EAC1B,WAAW,aACR,KAAK,CAAC,SAAS,iBAAiB,iBAAiB,OAAO,aAAa,CAAC,EACtE,SAAS,gCAAgC;AAAA,EAC5C,UAAU,aACP,OAAO,EACP,SAAS,EACT,SAAS,sCAAsC;AAAA,EAClD,UAAU,aACP,OAAO,EACP,SAAS,EACT,SAAS,sCAAsC;AAAA,EAClD,aAAa,aACV,OAAO,EACP,SAAS,EACT,SAAS,kDAAkD;AAAA,EAC9D,iBAAiB,aACd,OAAO,EACP,SAAS,EACT,SAAS,sDAAsD;AAAA,EAClE,cAAc,aACX,OAAO,EACP,SAAS,EACT,SAAS,+DAA+D;AAAA,EAC3E,uBAAuB,aACpB,OAAO,EACP,SAAS,EACT,SAAS,8CAA8C;AAC5D,CAAC;AAED,IAAM,cAAc,aAAE,OAAO;AAAA,EAC3B,cAAc,aACX,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,6CAA6C;AAAA,EACzD,kBAAkB,aACf,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,wCAAwC;AAAA,EACpD,SAAS,aACN,OAAO,EACP,IAAI,EACJ,IAAI,CAAC,EACL,SAAS,EACT,SAAS,8BAA8B;AAC5C,CAAC;AAEM,IAAM,sBAAsB,aAAE,OAAO;AAAA,EAC1C,SAAS,aACN,MAAM,aAAE,OAAO,EAAE,IAAI,CAAC,CAAC,EACvB,IAAI,CAAC,EACL,SAAS,4DAA4D;AAAA,EACxE,UAAU,aACP,OAAO,EACP,SAAS,EACT,SAAS,qCAAqC;AAAA,EACjD,KAAK,aACF,MAAM,CAAC,aAAE,QAAQ,GAAG,aAAE,OAAO,aAAE,OAAO,GAAG,aAAE,QAAQ,CAAC,CAAC,CAAC,EACtD,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,MAAM,WAAW,SAAS,EAAE;AAAA,IAC1B;AAAA,EACF;AAAA,EACA,mBAAmB,aAChB,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,0CAA0C;AAAA,EACtD,gBAAgB,aACb,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,wCAAwC;AAAA,EACpD,OAAO,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,0BAA0B;AAAA,EAC5D,MAAM,aACH,OAAO,EACP,IAAI,EACJ,IAAI,EAAE,EACN,IAAI,CAAC,EACL,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,SAAS,aACN,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,gDAAgD;AAAA,EAC5D,aAAa,aACV,KAAK,CAAC,QAAQ,QAAQ,UAAU,OAAO,MAAM,CAAC,EAC9C,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,YAAY,aACT,QAAQ,EACR,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,wBAAwB,aACrB,QAAQ,EACR,SAAS,EACT,SAAS,8DAA8D;AAAA,EAC1E,KAAK,aACF,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,SAAS,aACN,OAAO,aAAE,OAAO,GAAG,aAAE,OAAO,CAAC,EAC7B,SAAS,EACT,SAAS,wCAAwC;AAAA,EACpD,OAAO,YAAY,SAAS,EAAE;AAAA,IAC5B;AAAA,EACF;AACF,CAAC;AAEM,IAAM,iBAAiB,aAAE,OAAO;AAAA,EACrC,OAAO,oBAAoB;AAAA,IACzB;AAAA,EACF;AACF,CAAC;;;ACtID,IAAAC,cAAkB;AAEX,IAAM,gBAAgB,cAAE,OAAO;AAAA,EACpC,KAAK,cACF,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,OAAO,cACJ,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ,CAAC;;;AFPM,IAAM,eAAW,yBAAY,cAAc;AAC3C,IAAM,cAAU,yBAAY,aAAa;;;AGThD;AAAA;AAAA;AAAA;AAAA;;;ACAA;AAAA;AAAA;AAAA;AAAA;AAiBA,IAAM,eAAgC,MAAM,QAAQ,QAAQ;AAC5D,IAAM,kBAAsC,MAAM,QAAQ,QAAQ;AAClE,IAAM,YAA0B,MAAM,QAAQ,QAAQ,CAAC,CAAC;AAExD,SAAS,qBAAwC;AAC/C,SAAO;AAAA,IACL,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,MAAM;AAAA,EACR;AACF;AAEA,IAAM,sBAA4C,MAAM,mBAAmB;AAE3E,IAAM,kBAAN,MAAiD;AAAA,EAC/C,YAAY,SAA4B;AAAA,EAAC;AAAA,EACzC,SAAS,QAA4C;AACnD,WAAO,oBAAoB,MAAM;AAAA,EACnC;AACF;AAEA,IAAM,uBAA+C;AAErD,IAAM,uBAA4C;AAAA,EAChD,MAAM;AAAA,EACN,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,MAAM;AACR;AAEO,IAAM,OAAY;AAAA,EACvB,OAAO;AAAA,IACL,OAAO;AAAA,IACP,kBAAkB;AAAA,EACpB;AACF;AAEO,IAAM,aAAa,CAAC,oBAAoB;;;ACvD/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,kBAAyB;AAclB,IAAM,eAAiC;AAAA,EAC5C,QAAI,sBAAS,aAAa;AAAA,IACxB,WAAW;AAAA,EACb,CAAC;AAAA,EACD,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,UAAU;AAAA,UACR;AAAA,YACE,KAAK;AAAA,YACL,OAAO;AAAA,YACP,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,YAC9C,WAAW;AAAA,UACb;AAAA,QACF;AAAA,QACA,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,IACF;AAAA,EACF;AACF;AAMO,IAAM,kBAAoC;AAAA,EAC/C,QAAI,sBAAS,kBAAkB;AAAA,IAC7B,WAAW;AAAA,EACb,CAAC;AAAA,EACD,SAAS;AAAA,IACP,MAAM;AAAA,EACR;AAAA,EACA,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,UAAU;AAAA,UACR;AAAA,YACE,KAAK;AAAA,YACL,OAAO;AAAA,YACP,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,YAC9C,WAAW;AAAA,UACb;AAAA,QACF;AAAA,QACA,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,IACF;AAAA,EACF;AACF;AAMO,IAAM,aAA+B;AAAA,EAC1C,QAAI,sBAAS,kBAAkB;AAAA,IAC7B,WAAW;AAAA,IACX,MAAM,EAAE,IAAI,WAAW,OAAO,OAAO,UAAU,MAAM;AAAA,EACvD,CAAC;AAAA,EACD,SAAS;AAAA,IACP,MAAM;AAAA,IACN,MAAM;AAAA,MACJ,KAAK;AAAA,QACH,UAAU;AAAA,QACV,SAAS;AAAA,QACT,UAAU;AAAA,MACZ;AAAA,IACF;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,UAAU;AAAA,UACR;AAAA,YACE,KAAK;AAAA,YACL,OAAO;AAAA,YACP,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,YAC9C,WAAW;AAAA,UACb;AAAA,QACF;AAAA,QACA,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,IACF;AAAA,EACF;AACF;AAMO,IAAM,cAAgC;AAAA,EAC3C,QAAI,sBAAS,eAAe;AAAA,IAC1B,WAAW;AAAA,IACX,MAAM,EAAE,IAAI,UAAU;AAAA,IACtB,MAAM,EAAE,MAAM,MAAM;AAAA,EACtB,CAAC;AAAA,EACD,UAAU;AAAA,IACR,OAAO;AAAA,MACL,SAAS,CAAC,gBAAgB;AAAA,MAC1B,OAAO;AAAA,MACP,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,UAAU;AAAA,UACR;AAAA,YACE,KAAK;AAAA,YACL,OAAO;AAAA,YACP,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,YAC9C,WAAW;AAAA,UACb;AAAA,QACF;AAAA,QACA,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,IACF;AAAA,EACF;AACF;AAMO,IAAM,gBAAkC;AAAA,EAC7C,QAAI,sBAAS,kBAAkB;AAAA,IAC7B,WAAW;AAAA,IACX,MAAM,EAAE,IAAI,WAAW,OAAO,GAAG;AAAA,EACnC,CAAC;AAAA,EACD,SAAS;AAAA,IACP,UAAU;AAAA,MACR,OAAO;AAAA,IACT;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,UAAU;AAAA,UACR;AAAA,YACE,KAAK;AAAA,YACL,OAAO;AAAA,YACP,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,YAC9C,WAAW;AAAA,UACb;AAAA,QACF;AAAA,QACA,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,IACF;AAAA,EACF;AACF;AAKO,IAAM,eAAiC;AAAA,EAC5C,QAAI,sBAAS,eAAe;AAAA,IAC1B,WAAW;AAAA,EACb,CAAC;AAAA,EACD,SAAS,EAAE,QAAQ,KAAK;AAAA,EACxB,KAAK,CAAC;AACR;","names":["import_dev","import_dev"]}

package/dist/dev.mjs

@@ -0,0 +1 @@
+var e=Object.defineProperty,t=(t,a)=>{for(var o in a)e(t,o,{get:a[o],enumerable:!0})},a={};t(a,{KafkaSettingsSchema:()=>n,MappingSchema:()=>m,SettingsSchema:()=>c,mapping:()=>l,settings:()=>d});import{zodToSchema as o}from"@walkeros/core/dev";import{z as s}from"@walkeros/core/dev";var i=s.object({mechanism:s.enum(["plain","scram-sha-256","scram-sha-512","aws","oauthbearer"]).describe("SASL authentication mechanism."),username:s.string().optional().describe("Username for plain/scram mechanisms."),password:s.string().optional().describe("Password for plain/scram mechanisms."),accessKeyId:s.string().optional().describe("AWS access key ID for IAM auth (mechanism: aws)."),secretAccessKey:s.string().optional().describe("AWS secret access key for IAM auth (mechanism: aws)."),sessionToken:s.string().optional().describe("AWS session token for temporary credentials (mechanism: aws)."),authorizationIdentity:s.string().optional().describe("AWS authorization identity (mechanism: aws).")}),r=s.object({maxRetryTime:s.number().int().positive().optional().describe("Max total retry wait in ms. Default: 30000."),initialRetryTime:s.number().int().positive().optional().describe("First retry delay in ms. Default: 300."),retries:s.number().int().min(0).optional().describe("Max retry count. Default: 5.")}),n=s.object({brokers:s.array(s.string().min(1)).min(1).describe("Kafka broker addresses (host:port). At least one required."),clientId:s.string().optional().describe("Kafka client ID. Default: walkeros."),ssl:s.union([s.boolean(),s.record(s.string(),s.unknown())]).optional().describe("TLS configuration. Set true for default TLS, or provide a tls.ConnectionOptions object for mTLS."),sasl:i.optional().describe("SASL authentication config. Required for Confluent Cloud, AWS MSK with IAM, etc."),connectionTimeout:s.number().int().positive().optional().describe("Connection timeout in ms. Default: 1000."),requestTimeout:s.number().int().positive().optional().describe("Request timeout in ms. Default: 30000."),topic:s.string().min(1).describe("Target Kafka topic name."),acks:s.number().int().min(-1).max(1).optional().describe("Acknowledgement level. -1 = all replicas, 0 = fire-and-forget, 1 = leader only. Default: -1."),timeout:s.number().int().positive().optional().describe("Broker response timeout in ms. Default: 30000."),compression:s.enum(["none","gzip","snappy","lz4","zstd"]).optional().describe("Message compression codec. Default: gzip. Snappy/LZ4/ZSTD require additional npm packages."),idempotent:s.boolean().optional().describe("Enable idempotent producer for exactly-once delivery. Default: false."),allowAutoTopicCreation:s.boolean().optional().describe("Allow auto-creation of topics on the broker. Default: false."),key:s.string().optional().describe("Mapping value path for message key derivation (e.g. user.id, data.userId). Default: entity_action."),headers:s.record(s.string(),s.string()).optional().describe("Static headers added to every message."),retry:r.optional().describe("Retry configuration for transient failures.")}),c=s.object({kafka:n.describe("Kafka connection and producer settings.")});import{z as p}from"@walkeros/core/dev";var m=p.object({key:p.string().optional().describe("Override message key mapping path for this rule (e.g. data.id). Takes precedence over settings.kafka.key."),topic:p.string().optional().describe("Override Kafka topic for this rule. Takes precedence over settings.kafka.topic.")}),d=o(c),l=o(m),u={};t(u,{env:()=>g,step:()=>w});var g={};t(g,{push:()=>y,simulation:()=>h});var k=()=>Promise.resolve(),f=()=>Promise.resolve(),b=()=>Promise.resolve([]);var v=()=>({connect:k,disconnect:f,send:b}),y={Kafka:{Kafka:class{constructor(e){}producer(e){return v()}},CompressionTypes:{None:0,GZIP:1,Snappy:2,LZ4:3,ZSTD:4}}},h=["call:producer.send"],w={};t(w,{defaultEvent:()=>D,ignoredEvent:()=>I,keyFromUser:()=>T,mappedData:()=>A,mappedEventName:()=>j,topicOverride:()=>K});import{getEvent as S}from"@walkeros/core";var D={in:S("page view",{timestamp:1700000100}),out:[["producer.send",{topic:"walkeros-events",messages:[{key:"page_view",value:"json:event",headers:{"content-type":"application/json"},timestamp:"1700000100"}],acks:-1,compression:1}]]},j={in:S("order complete",{timestamp:1700000101}),mapping:{name:"purchase"},out:[["producer.send",{topic:"walkeros-events",messages:[{key:"purchase",value:"json:event",headers:{"content-type":"application/json"},timestamp:"1700000101"}],acks:-1,compression:1}]]},A={in:S("order complete",{timestamp:1700000102,data:{id:"ORD-400",total:99.99,currency:"EUR"}}),mapping:{name:"purchase",data:{map:{order_id:"data.id",revenue:"data.total",currency:"data.currency"}}},out:[["producer.send",{topic:"walkeros-events",messages:[{key:"purchase",value:"json:data",headers:{"content-type":"application/json"},timestamp:"1700000102"}],acks:-1,compression:1}]]},T={in:S("user signup",{timestamp:1700000103,user:{id:"usr-789"},data:{plan:"pro"}}),settings:{kafka:{brokers:["localhost:9092"],topic:"walkeros-events",key:"user.id"}},out:[["producer.send",{topic:"walkeros-events",messages:[{key:"usr-789",value:"json:event",headers:{"content-type":"application/json"},timestamp:"1700000103"}],acks:-1,compression:1}]]},K={in:S("order complete",{timestamp:1700000104,data:{id:"ORD-500",total:42}}),mapping:{settings:{topic:"orders-stream"}},out:[["producer.send",{topic:"orders-stream",messages:[{key:"order_complete",value:"json:event",headers:{"content-type":"application/json"},timestamp:"1700000104"}],acks:-1,compression:1}]]},I={in:S("debug noise",{timestamp:1700000105}),mapping:{ignore:!0},out:[]};export{u as examples,a as schemas};//# sourceMappingURL=dev.mjs.map

package/dist/dev.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/examples/index.ts","../src/examples/env.ts","../src/examples/step.ts"],"sourcesContent":["import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nexport { SettingsSchema, KafkaSettingsSchema, type Settings } from './settings';\nexport { MappingSchema, type Mapping } from './mapping';\n\n// JSON Schema\nexport const settings = zodToSchema(SettingsSchema);\nexport const mapping = zodToSchema(MappingSchema);\n","import { z } from '@walkeros/core/dev';\n\nconst SASLSchema = z.object({\n  mechanism: z\n    .enum(['plain', 'scram-sha-256', 'scram-sha-512', 'aws', 'oauthbearer'])\n    .describe('SASL authentication mechanism.'),\n  username: z\n    .string()\n    .optional()\n    .describe('Username for plain/scram mechanisms.'),\n  password: z\n    .string()\n    .optional()\n    .describe('Password for plain/scram mechanisms.'),\n  accessKeyId: z\n    .string()\n    .optional()\n    .describe('AWS access key ID for IAM auth (mechanism: aws).'),\n  secretAccessKey: z\n    .string()\n    .optional()\n    .describe('AWS secret access key for IAM auth (mechanism: aws).'),\n  sessionToken: z\n    .string()\n    .optional()\n    .describe('AWS session token for temporary credentials (mechanism: aws).'),\n  authorizationIdentity: z\n    .string()\n    .optional()\n    .describe('AWS authorization identity (mechanism: aws).'),\n});\n\nconst RetrySchema = z.object({\n  maxRetryTime: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Max total retry wait in ms. Default: 30000.'),\n  initialRetryTime: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('First retry delay in ms. Default: 300.'),\n  retries: z\n    .number()\n    .int()\n    .min(0)\n    .optional()\n    .describe('Max retry count. Default: 5.'),\n});\n\nexport const KafkaSettingsSchema = z.object({\n  brokers: z\n    .array(z.string().min(1))\n    .min(1)\n    .describe('Kafka broker addresses (host:port). At least one required.'),\n  clientId: z\n    .string()\n    .optional()\n    .describe('Kafka client ID. Default: walkeros.'),\n  ssl: z\n    .union([z.boolean(), z.record(z.string(), z.unknown())])\n    .optional()\n    .describe(\n      'TLS configuration. Set true for default TLS, or provide a tls.ConnectionOptions object for mTLS.',\n    ),\n  sasl: SASLSchema.optional().describe(\n    'SASL authentication config. Required for Confluent Cloud, AWS MSK with IAM, etc.',\n  ),\n  connectionTimeout: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Connection timeout in ms. Default: 1000.'),\n  requestTimeout: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Request timeout in ms. Default: 30000.'),\n  topic: z.string().min(1).describe('Target Kafka topic name.'),\n  acks: z\n    .number()\n    .int()\n    .min(-1)\n    .max(1)\n    .optional()\n    .describe(\n      'Acknowledgement level. -1 = all replicas, 0 = fire-and-forget, 1 = leader only. Default: -1.',\n    ),\n  timeout: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Broker response timeout in ms. Default: 30000.'),\n  compression: z\n    .enum(['none', 'gzip', 'snappy', 'lz4', 'zstd'])\n    .optional()\n    .describe(\n      'Message compression codec. Default: gzip. Snappy/LZ4/ZSTD require additional npm packages.',\n    ),\n  idempotent: z\n    .boolean()\n    .optional()\n    .describe(\n      'Enable idempotent producer for exactly-once delivery. Default: false.',\n    ),\n  allowAutoTopicCreation: z\n    .boolean()\n    .optional()\n    .describe('Allow auto-creation of topics on the broker. Default: false.'),\n  key: z\n    .string()\n    .optional()\n    .describe(\n      'Mapping value path for message key derivation (e.g. user.id, data.userId). Default: entity_action.',\n    ),\n  headers: z\n    .record(z.string(), z.string())\n    .optional()\n    .describe('Static headers added to every message.'),\n  retry: RetrySchema.optional().describe(\n    'Retry configuration for transient failures.',\n  ),\n});\n\nexport const SettingsSchema = z.object({\n  kafka: KafkaSettingsSchema.describe(\n    'Kafka connection and producer settings.',\n  ),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  key: z\n    .string()\n    .optional()\n    .describe(\n      'Override message key mapping path for this rule (e.g. data.id). Takes precedence over settings.kafka.key.',\n    ),\n  topic: z\n    .string()\n    .optional()\n    .describe(\n      'Override Kafka topic for this rule. Takes precedence over settings.kafka.topic.',\n    ),\n});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * as env from './env';\nexport * as step from './step';\n","import type {\n  Env,\n  KafkaClientConstructor,\n  KafkaClientMock,\n  KafkaProducerMock,\n  ProducerRecord,\n  ProducerConfig,\n  KafkaClientConfig,\n  CompressionTypesMap,\n} from '../types';\n\n// Narrow helper type aliases so the mock SDK is typed explicitly without `any`.\ntype ProducerConnect = () => Promise<void>;\ntype ProducerDisconnect = () => Promise<void>;\ntype ProducerSend = (record: ProducerRecord) => Promise<unknown>;\ntype KafkaProducerFactory = (config?: ProducerConfig) => KafkaProducerMock;\n\nconst asyncConnect: ProducerConnect = () => Promise.resolve();\nconst asyncDisconnect: ProducerDisconnect = () => Promise.resolve();\nconst asyncSend: ProducerSend = () => Promise.resolve([]);\n\nfunction createMockProducer(): KafkaProducerMock {\n  return {\n    connect: asyncConnect,\n    disconnect: asyncDisconnect,\n    send: asyncSend,\n  };\n}\n\nconst mockProducerFactory: KafkaProducerFactory = () => createMockProducer();\n\nclass MockKafkaClient implements KafkaClientMock {\n  constructor(_config: KafkaClientConfig) {}\n  producer(config?: ProducerConfig): KafkaProducerMock {\n    return mockProducerFactory(config);\n  }\n}\n\nconst MockKafkaConstructor: KafkaClientConstructor = MockKafkaClient;\n\nconst MockCompressionTypes: CompressionTypesMap = {\n  None: 0,\n  GZIP: 1,\n  Snappy: 2,\n  LZ4: 3,\n  ZSTD: 4,\n};\n\nexport const push: Env = {\n  Kafka: {\n    Kafka: MockKafkaConstructor,\n    CompressionTypes: MockCompressionTypes,\n  },\n};\n\nexport const simulation = ['call:producer.send'];\n","import type { Flow } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * Extended step example that may carry destination-level settings overrides.\n */\nexport type KafkaStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n};\n\n/**\n * Default event -- full WalkerOS.Event serialized as JSON to the configured\n * topic. Message key defaults to entity_action when no key path is set.\n */\nexport const defaultEvent: KafkaStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000100,\n  }),\n  out: [\n    [\n      'producer.send',\n      {\n        topic: 'walkeros-events',\n        messages: [\n          {\n            key: 'page_view',\n            value: 'json:event',\n            headers: { 'content-type': 'application/json' },\n            timestamp: '1700000100',\n          },\n        ],\n        acks: -1,\n        compression: 1,\n      },\n    ],\n  ],\n};\n\n/**\n * Mapped event name -- rule.name renames the event, which also changes the\n * default message key when no key mapping is configured.\n */\nexport const mappedEventName: KafkaStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000101,\n  }),\n  mapping: {\n    name: 'purchase',\n  },\n  out: [\n    [\n      'producer.send',\n      {\n        topic: 'walkeros-events',\n        messages: [\n          {\n            key: 'purchase',\n            value: 'json:event',\n            headers: { 'content-type': 'application/json' },\n            timestamp: '1700000101',\n          },\n        ],\n        acks: -1,\n        compression: 1,\n      },\n    ],\n  ],\n};\n\n/**\n * Mapped data -- data.map transforms the event payload. Value is the mapped\n * object serialized as JSON.\n */\nexport const mappedData: KafkaStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000102,\n    data: { id: 'ORD-400', total: 99.99, currency: 'EUR' },\n  }),\n  mapping: {\n    name: 'purchase',\n    data: {\n      map: {\n        order_id: 'data.id',\n        revenue: 'data.total',\n        currency: 'data.currency',\n      },\n    },\n  },\n  out: [\n    [\n      'producer.send',\n      {\n        topic: 'walkeros-events',\n        messages: [\n          {\n            key: 'purchase',\n            value: 'json:data',\n            headers: { 'content-type': 'application/json' },\n            timestamp: '1700000102',\n          },\n        ],\n        acks: -1,\n        compression: 1,\n      },\n    ],\n  ],\n};\n\n/**\n * Key from user -- settings.kafka.key path resolves the message key from\n * the event (here user.id).\n */\nexport const keyFromUser: KafkaStepExample = {\n  in: getEvent('user signup', {\n    timestamp: 1700000103,\n    user: { id: 'usr-789' },\n    data: { plan: 'pro' },\n  }),\n  settings: {\n    kafka: {\n      brokers: ['localhost:9092'],\n      topic: 'walkeros-events',\n      key: 'user.id',\n    },\n  },\n  out: [\n    [\n      'producer.send',\n      {\n        topic: 'walkeros-events',\n        messages: [\n          {\n            key: 'usr-789',\n            value: 'json:event',\n            headers: { 'content-type': 'application/json' },\n            timestamp: '1700000103',\n          },\n        ],\n        acks: -1,\n        compression: 1,\n      },\n    ],\n  ],\n};\n\n/**\n * Topic override -- rule.settings.topic routes this rule to a different\n * topic than the destination default.\n */\nexport const topicOverride: KafkaStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000104,\n    data: { id: 'ORD-500', total: 42 },\n  }),\n  mapping: {\n    settings: {\n      topic: 'orders-stream',\n    },\n  },\n  out: [\n    [\n      'producer.send',\n      {\n        topic: 'orders-stream',\n        messages: [\n          {\n            key: 'order_complete',\n            value: 'json:event',\n            headers: { 'content-type': 'application/json' },\n            timestamp: '1700000104',\n          },\n        ],\n        acks: -1,\n        compression: 1,\n      },\n    ],\n  ],\n};\n\n/**\n * Ignored event -- mapping.ignore: true produces no producer.send call.\n */\nexport const ignoredEvent: KafkaStepExample = {\n  in: getEvent('debug noise', {\n    timestamp: 1700000105,\n  }),\n  mapping: { ignore: true },\n  out: [],\n};\n"],"mappings":"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","names":["z"]}

package/dist/examples/index.d.mts

@@ -0,0 +1,163 @@
+import { DestinationServer } from '@walkeros/server-core';
+import { Flow } from '@walkeros/core';
+
+/**
+ * Mock-friendly Producer interface used by the destination.
+ * Tests provide this via env.Kafka; production creates a real
+ * kafkajs Producer and adapts it through settings._producer.
+ */
+interface KafkaProducerMock {
+    connect: () => Promise<void>;
+    disconnect: () => Promise<void>;
+    send: (record: ProducerRecord) => Promise<unknown>;
+}
+/**
+ * Mock-friendly Kafka client interface (subset of kafkajs.Kafka).
+ */
+interface KafkaClientMock {
+    producer: (config?: ProducerConfig) => KafkaProducerMock;
+}
+/**
+ * Constructor signature for the Kafka client. Accepts a config
+ * object and returns a client with producer() factory.
+ */
+type KafkaClientConstructor = new (config: KafkaClientConfig) => KafkaClientMock;
+interface KafkaClientConfig {
+    clientId?: string;
+    brokers: string[];
+    ssl?: boolean | Record<string, unknown>;
+    sasl?: SASLConfig;
+    connectionTimeout?: number;
+    requestTimeout?: number;
+    retry?: RetryConfig;
+}
+interface ProducerConfig {
+    allowAutoTopicCreation?: boolean;
+    idempotent?: boolean;
+}
+interface ProducerRecord {
+    topic: string;
+    messages: ProducerMessage[];
+    acks?: number;
+    compression?: number;
+    timeout?: number;
+}
+interface ProducerMessage {
+    key?: string;
+    value: string;
+    headers?: Record<string, string>;
+    timestamp?: string;
+    partition?: number;
+}
+interface CompressionTypesMap {
+    None: number;
+    GZIP: number;
+    Snappy: number;
+    LZ4: number;
+    ZSTD: number;
+}
+type CompressionType = 'none' | 'gzip' | 'snappy' | 'lz4' | 'zstd';
+interface SASLConfig {
+    mechanism: 'plain' | 'scram-sha-256' | 'scram-sha-512' | 'aws' | 'oauthbearer';
+    username?: string;
+    password?: string;
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    sessionToken?: string;
+    authorizationIdentity?: string;
+}
+interface RetryConfig {
+    maxRetryTime?: number;
+    initialRetryTime?: number;
+    retries?: number;
+}
+interface KafkaSettings {
+    brokers: string[];
+    clientId?: string;
+    ssl?: boolean | Record<string, unknown>;
+    sasl?: SASLConfig;
+    connectionTimeout?: number;
+    requestTimeout?: number;
+    topic: string;
+    acks?: number;
+    timeout?: number;
+    compression?: CompressionType;
+    idempotent?: boolean;
+    allowAutoTopicCreation?: boolean;
+    key?: string;
+    headers?: Record<string, string>;
+    retry?: RetryConfig;
+    _producer?: KafkaProducerMock;
+}
+interface Settings {
+    kafka: KafkaSettings;
+}
+/**
+ * Env -- optional Kafka SDK override. Production leaves this undefined
+ * and the destination creates real Kafka client instances. Tests provide
+ * mocks via env.Kafka.
+ */
+interface Env extends DestinationServer.Env {
+    Kafka?: {
+        Kafka: KafkaClientConstructor;
+        CompressionTypes: CompressionTypesMap;
+    };
+}
+
+declare const push: Env;
+declare const simulation: string[];
+
+declare const env_push: typeof push;
+declare const env_simulation: typeof simulation;
+declare namespace env {
+  export { env_push as push, env_simulation as simulation };
+}
+
+/**
+ * Extended step example that may carry destination-level settings overrides.
+ */
+type KafkaStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+};
+/**
+ * Default event -- full WalkerOS.Event serialized as JSON to the configured
+ * topic. Message key defaults to entity_action when no key path is set.
+ */
+declare const defaultEvent: KafkaStepExample;
+/**
+ * Mapped event name -- rule.name renames the event, which also changes the
+ * default message key when no key mapping is configured.
+ */
+declare const mappedEventName: KafkaStepExample;
+/**
+ * Mapped data -- data.map transforms the event payload. Value is the mapped
+ * object serialized as JSON.
+ */
+declare const mappedData: KafkaStepExample;
+/**
+ * Key from user -- settings.kafka.key path resolves the message key from
+ * the event (here user.id).
+ */
+declare const keyFromUser: KafkaStepExample;
+/**
+ * Topic override -- rule.settings.topic routes this rule to a different
+ * topic than the destination default.
+ */
+declare const topicOverride: KafkaStepExample;
+/**
+ * Ignored event -- mapping.ignore: true produces no producer.send call.
+ */
+declare const ignoredEvent: KafkaStepExample;
+
+type step_KafkaStepExample = KafkaStepExample;
+declare const step_defaultEvent: typeof defaultEvent;
+declare const step_ignoredEvent: typeof ignoredEvent;
+declare const step_keyFromUser: typeof keyFromUser;
+declare const step_mappedData: typeof mappedData;
+declare const step_mappedEventName: typeof mappedEventName;
+declare const step_topicOverride: typeof topicOverride;
+declare namespace step {
+  export { type step_KafkaStepExample as KafkaStepExample, step_defaultEvent as defaultEvent, step_ignoredEvent as ignoredEvent, step_keyFromUser as keyFromUser, step_mappedData as mappedData, step_mappedEventName as mappedEventName, step_topicOverride as topicOverride };
+}
+
+export { env, step };

package/dist/examples/index.d.ts

@@ -0,0 +1,163 @@
+import { DestinationServer } from '@walkeros/server-core';
+import { Flow } from '@walkeros/core';
+
+/**
+ * Mock-friendly Producer interface used by the destination.
+ * Tests provide this via env.Kafka; production creates a real
+ * kafkajs Producer and adapts it through settings._producer.
+ */
+interface KafkaProducerMock {
+    connect: () => Promise<void>;
+    disconnect: () => Promise<void>;
+    send: (record: ProducerRecord) => Promise<unknown>;
+}
+/**
+ * Mock-friendly Kafka client interface (subset of kafkajs.Kafka).
+ */
+interface KafkaClientMock {
+    producer: (config?: ProducerConfig) => KafkaProducerMock;
+}
+/**
+ * Constructor signature for the Kafka client. Accepts a config
+ * object and returns a client with producer() factory.
+ */
+type KafkaClientConstructor = new (config: KafkaClientConfig) => KafkaClientMock;
+interface KafkaClientConfig {
+    clientId?: string;
+    brokers: string[];
+    ssl?: boolean | Record<string, unknown>;
+    sasl?: SASLConfig;
+    connectionTimeout?: number;
+    requestTimeout?: number;
+    retry?: RetryConfig;
+}
+interface ProducerConfig {
+    allowAutoTopicCreation?: boolean;
+    idempotent?: boolean;
+}
+interface ProducerRecord {
+    topic: string;
+    messages: ProducerMessage[];
+    acks?: number;
+    compression?: number;
+    timeout?: number;
+}
+interface ProducerMessage {
+    key?: string;
+    value: string;
+    headers?: Record<string, string>;
+    timestamp?: string;
+    partition?: number;
+}
+interface CompressionTypesMap {
+    None: number;
+    GZIP: number;
+    Snappy: number;
+    LZ4: number;
+    ZSTD: number;
+}
+type CompressionType = 'none' | 'gzip' | 'snappy' | 'lz4' | 'zstd';
+interface SASLConfig {
+    mechanism: 'plain' | 'scram-sha-256' | 'scram-sha-512' | 'aws' | 'oauthbearer';
+    username?: string;
+    password?: string;
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    sessionToken?: string;
+    authorizationIdentity?: string;
+}
+interface RetryConfig {
+    maxRetryTime?: number;
+    initialRetryTime?: number;
+    retries?: number;
+}
+interface KafkaSettings {
+    brokers: string[];
+    clientId?: string;
+    ssl?: boolean | Record<string, unknown>;
+    sasl?: SASLConfig;
+    connectionTimeout?: number;
+    requestTimeout?: number;
+    topic: string;
+    acks?: number;
+    timeout?: number;
+    compression?: CompressionType;
+    idempotent?: boolean;
+    allowAutoTopicCreation?: boolean;
+    key?: string;
+    headers?: Record<string, string>;
+    retry?: RetryConfig;
+    _producer?: KafkaProducerMock;
+}
+interface Settings {
+    kafka: KafkaSettings;
+}
+/**
+ * Env -- optional Kafka SDK override. Production leaves this undefined
+ * and the destination creates real Kafka client instances. Tests provide
+ * mocks via env.Kafka.
+ */
+interface Env extends DestinationServer.Env {
+    Kafka?: {
+        Kafka: KafkaClientConstructor;
+        CompressionTypes: CompressionTypesMap;
+    };
+}
+
+declare const push: Env;
+declare const simulation: string[];
+
+declare const env_push: typeof push;
+declare const env_simulation: typeof simulation;
+declare namespace env {
+  export { env_push as push, env_simulation as simulation };
+}
+
+/**
+ * Extended step example that may carry destination-level settings overrides.
+ */
+type KafkaStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+};
+/**
+ * Default event -- full WalkerOS.Event serialized as JSON to the configured
+ * topic. Message key defaults to entity_action when no key path is set.
+ */
+declare const defaultEvent: KafkaStepExample;
+/**
+ * Mapped event name -- rule.name renames the event, which also changes the
+ * default message key when no key mapping is configured.
+ */
+declare const mappedEventName: KafkaStepExample;
+/**
+ * Mapped data -- data.map transforms the event payload. Value is the mapped
+ * object serialized as JSON.
+ */
+declare const mappedData: KafkaStepExample;
+/**
+ * Key from user -- settings.kafka.key path resolves the message key from
+ * the event (here user.id).
+ */
+declare const keyFromUser: KafkaStepExample;
+/**
+ * Topic override -- rule.settings.topic routes this rule to a different
+ * topic than the destination default.
+ */
+declare const topicOverride: KafkaStepExample;
+/**
+ * Ignored event -- mapping.ignore: true produces no producer.send call.
+ */
+declare const ignoredEvent: KafkaStepExample;
+
+type step_KafkaStepExample = KafkaStepExample;
+declare const step_defaultEvent: typeof defaultEvent;
+declare const step_ignoredEvent: typeof ignoredEvent;
+declare const step_keyFromUser: typeof keyFromUser;
+declare const step_mappedData: typeof mappedData;
+declare const step_mappedEventName: typeof mappedEventName;
+declare const step_topicOverride: typeof topicOverride;
+declare namespace step {
+  export { type step_KafkaStepExample as KafkaStepExample, step_defaultEvent as defaultEvent, step_ignoredEvent as ignoredEvent, step_keyFromUser as keyFromUser, step_mappedData as mappedData, step_mappedEventName as mappedEventName, step_topicOverride as topicOverride };
+}
+
+export { env, step };

package/dist/examples/index.js

@@ -0,0 +1,234 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/examples/index.ts
+var examples_exports = {};
+__export(examples_exports, {
+  env: () => env_exports,
+  step: () => step_exports
+});
+module.exports = __toCommonJS(examples_exports);
+
+// src/examples/env.ts
+var env_exports = {};
+__export(env_exports, {
+  push: () => push,
+  simulation: () => simulation
+});
+var asyncConnect = () => Promise.resolve();
+var asyncDisconnect = () => Promise.resolve();
+var asyncSend = () => Promise.resolve([]);
+function createMockProducer() {
+  return {
+    connect: asyncConnect,
+    disconnect: asyncDisconnect,
+    send: asyncSend
+  };
+}
+var mockProducerFactory = () => createMockProducer();
+var MockKafkaClient = class {
+  constructor(_config) {
+  }
+  producer(config) {
+    return mockProducerFactory(config);
+  }
+};
+var MockKafkaConstructor = MockKafkaClient;
+var MockCompressionTypes = {
+  None: 0,
+  GZIP: 1,
+  Snappy: 2,
+  LZ4: 3,
+  ZSTD: 4
+};
+var push = {
+  Kafka: {
+    Kafka: MockKafkaConstructor,
+    CompressionTypes: MockCompressionTypes
+  }
+};
+var simulation = ["call:producer.send"];
+
+// src/examples/step.ts
+var step_exports = {};
+__export(step_exports, {
+  defaultEvent: () => defaultEvent,
+  ignoredEvent: () => ignoredEvent,
+  keyFromUser: () => keyFromUser,
+  mappedData: () => mappedData,
+  mappedEventName: () => mappedEventName,
+  topicOverride: () => topicOverride
+});
+var import_core = require("@walkeros/core");
+var defaultEvent = {
+  in: (0, import_core.getEvent)("page view", {
+    timestamp: 1700000100
+  }),
+  out: [
+    [
+      "producer.send",
+      {
+        topic: "walkeros-events",
+        messages: [
+          {
+            key: "page_view",
+            value: "json:event",
+            headers: { "content-type": "application/json" },
+            timestamp: "1700000100"
+          }
+        ],
+        acks: -1,
+        compression: 1
+      }
+    ]
+  ]
+};
+var mappedEventName = {
+  in: (0, import_core.getEvent)("order complete", {
+    timestamp: 1700000101
+  }),
+  mapping: {
+    name: "purchase"
+  },
+  out: [
+    [
+      "producer.send",
+      {
+        topic: "walkeros-events",
+        messages: [
+          {
+            key: "purchase",
+            value: "json:event",
+            headers: { "content-type": "application/json" },
+            timestamp: "1700000101"
+          }
+        ],
+        acks: -1,
+        compression: 1
+      }
+    ]
+  ]
+};
+var mappedData = {
+  in: (0, import_core.getEvent)("order complete", {
+    timestamp: 1700000102,
+    data: { id: "ORD-400", total: 99.99, currency: "EUR" }
+  }),
+  mapping: {
+    name: "purchase",
+    data: {
+      map: {
+        order_id: "data.id",
+        revenue: "data.total",
+        currency: "data.currency"
+      }
+    }
+  },
+  out: [
+    [
+      "producer.send",
+      {
+        topic: "walkeros-events",
+        messages: [
+          {
+            key: "purchase",
+            value: "json:data",
+            headers: { "content-type": "application/json" },
+            timestamp: "1700000102"
+          }
+        ],
+        acks: -1,
+        compression: 1
+      }
+    ]
+  ]
+};
+var keyFromUser = {
+  in: (0, import_core.getEvent)("user signup", {
+    timestamp: 1700000103,
+    user: { id: "usr-789" },
+    data: { plan: "pro" }
+  }),
+  settings: {
+    kafka: {
+      brokers: ["localhost:9092"],
+      topic: "walkeros-events",
+      key: "user.id"
+    }
+  },
+  out: [
+    [
+      "producer.send",
+      {
+        topic: "walkeros-events",
+        messages: [
+          {
+            key: "usr-789",
+            value: "json:event",
+            headers: { "content-type": "application/json" },
+            timestamp: "1700000103"
+          }
+        ],
+        acks: -1,
+        compression: 1
+      }
+    ]
+  ]
+};
+var topicOverride = {
+  in: (0, import_core.getEvent)("order complete", {
+    timestamp: 1700000104,
+    data: { id: "ORD-500", total: 42 }
+  }),
+  mapping: {
+    settings: {
+      topic: "orders-stream"
+    }
+  },
+  out: [
+    [
+      "producer.send",
+      {
+        topic: "orders-stream",
+        messages: [
+          {
+            key: "order_complete",
+            value: "json:event",
+            headers: { "content-type": "application/json" },
+            timestamp: "1700000104"
+          }
+        ],
+        acks: -1,
+        compression: 1
+      }
+    ]
+  ]
+};
+var ignoredEvent = {
+  in: (0, import_core.getEvent)("debug noise", {
+    timestamp: 1700000105
+  }),
+  mapping: { ignore: true },
+  out: []
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  env,
+  step
+});