@saga-bus/transport-kafka 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Dean Foran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,89 @@
+# @saga-bus/transport-kafka
+
+Apache Kafka transport for saga-bus using KafkaJS.
+
+## Installation
+
+```bash
+pnpm add @saga-bus/transport-kafka kafkajs
+```
+
+## Usage
+
+```typescript
+import { Kafka } from "kafkajs";
+import { KafkaTransport } from "@saga-bus/transport-kafka";
+import { createBus } from "@saga-bus/core";
+
+const kafka = new Kafka({
+  clientId: "my-app",
+  brokers: ["localhost:9092"],
+});
+
+const transport = new KafkaTransport({
+  kafka,
+  groupId: "my-consumer-group",
+  defaultTopic: "saga-events",
+});
+
+const bus = createBus({
+  transport,
+  sagas: [...],
+});
+
+await bus.start();
+```
+
+## Features
+
+- Topic-based message routing
+- Consumer group coordination
+- Automatic topic creation (optional)
+- Configurable partitions and replication
+- Message key routing via correlation ID
+- Offset management
+
+## Message Format
+
+Messages are published with:
+
+| Field | Value |
+|-------|-------|
+| `key` | Correlation ID (for partition affinity) |
+| `value` | JSON-serialized message envelope |
+| `headers.type` | Message type |
+| `headers.correlationId` | Correlation ID |
+| `headers.messageId` | Unique message ID |
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `kafka` | `Kafka` | required | KafkaJS instance |
+| `defaultTopic` | `string` | - | Default topic |
+| `groupId` | `string` | - | Consumer group ID |
+| `createTopics` | `boolean` | `false` | Auto-create topics |
+| `numPartitions` | `number` | `3` | Partitions for new topics |
+| `replicationFactor` | `number` | `1` | Replication factor |
+| `fromBeginning` | `boolean` | `false` | Start from earliest |
+| `sessionTimeout` | `number` | `30000` | Session timeout (ms) |
+| `heartbeatInterval` | `number` | `3000` | Heartbeat interval (ms) |
+
+## Topic Routing
+
+Override the default topic per-publish:
+
+```typescript
+await bus.publish(
+  { type: "OrderCreated", payload: { orderId: "123" } },
+  { endpoint: "orders-topic" }
+);
+```
+
+## Partition Affinity
+
+Messages with the same correlation ID are routed to the same partition, ensuring ordered processing per saga instance.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,223 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  KafkaTransport: () => KafkaTransport
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/KafkaTransport.ts
+var import_node_crypto = require("crypto");
+var KafkaTransport = class {
+  kafka;
+  defaultTopic;
+  groupId;
+  createTopics;
+  numPartitions;
+  replicationFactor;
+  fromBeginning;
+  sessionTimeout;
+  heartbeatInterval;
+  producer = null;
+  consumer = null;
+  handlers = /* @__PURE__ */ new Map();
+  subscriptions = [];
+  isRunning = false;
+  constructor(options) {
+    this.kafka = options.kafka;
+    this.defaultTopic = options.defaultTopic;
+    this.groupId = options.groupId;
+    this.createTopics = options.createTopics ?? false;
+    this.numPartitions = options.numPartitions ?? 3;
+    this.replicationFactor = options.replicationFactor ?? 1;
+    this.fromBeginning = options.fromBeginning ?? false;
+    this.sessionTimeout = options.sessionTimeout ?? 3e4;
+    this.heartbeatInterval = options.heartbeatInterval ?? 3e3;
+  }
+  async start() {
+    if (this.isRunning) {
+      return;
+    }
+    this.producer = this.kafka.producer();
+    await this.producer.connect();
+    if (this.subscriptions.length > 0) {
+      if (!this.groupId) {
+        throw new Error("groupId is required for consuming");
+      }
+      if (this.createTopics) {
+        await this.ensureTopics();
+      }
+      this.consumer = this.kafka.consumer({
+        groupId: this.groupId,
+        sessionTimeout: this.sessionTimeout,
+        heartbeatInterval: this.heartbeatInterval
+      });
+      await this.consumer.connect();
+      for (const sub of this.subscriptions) {
+        await this.consumer.subscribe({
+          topic: sub.topic,
+          fromBeginning: this.fromBeginning
+        });
+      }
+      this.isRunning = true;
+      await this.consumer.run({
+        autoCommit: false,
+        eachMessage: async (payload) => {
+          await this.processMessage(payload);
+        }
+      });
+    } else {
+      this.isRunning = true;
+    }
+  }
+  async stop() {
+    this.isRunning = false;
+    if (this.consumer) {
+      await this.consumer.disconnect();
+      this.consumer = null;
+    }
+    if (this.producer) {
+      await this.producer.disconnect();
+      this.producer = null;
+    }
+  }
+  async subscribe(options, handler) {
+    const topic = options.endpoint;
+    if (!topic) {
+      throw new Error("endpoint (topic) is required for subscribing");
+    }
+    if (!this.groupId) {
+      throw new Error("groupId is required for subscribing");
+    }
+    this.handlers.set(
+      topic,
+      handler
+    );
+    this.subscriptions.push({
+      topic,
+      concurrency: options.concurrency ?? 1
+    });
+  }
+  async publish(message, options) {
+    const topic = options.endpoint || this.defaultTopic;
+    if (!topic) {
+      throw new Error("endpoint (topic) is required for publishing");
+    }
+    if (!this.producer) {
+      this.producer = this.kafka.producer();
+      await this.producer.connect();
+    }
+    const { key, headers = {} } = options;
+    const envelope = {
+      id: (0, import_node_crypto.randomUUID)(),
+      type: message.type,
+      payload: message,
+      headers: {
+        ...headers,
+        "x-message-type": message.type
+      },
+      timestamp: /* @__PURE__ */ new Date(),
+      partitionKey: key
+    };
+    const partitionKey = key ?? envelope.id;
+    const kafkaHeaders = {
+      messageId: envelope.id,
+      messageType: envelope.type,
+      ...headers
+    };
+    await this.producer.send({
+      topic,
+      messages: [
+        {
+          key: partitionKey,
+          value: JSON.stringify(envelope),
+          headers: kafkaHeaders
+        }
+      ]
+    });
+  }
+  async ensureTopics() {
+    const admin = this.kafka.admin();
+    await admin.connect();
+    try {
+      const existingTopics = await admin.listTopics();
+      const topicsToCreate = this.subscriptions.map((s) => s.topic).filter((topic) => !existingTopics.includes(topic));
+      if (topicsToCreate.length > 0) {
+        await admin.createTopics({
+          topics: topicsToCreate.map((topic) => ({
+            topic,
+            numPartitions: this.numPartitions,
+            replicationFactor: this.replicationFactor
+          }))
+        });
+      }
+    } finally {
+      await admin.disconnect();
+    }
+  }
+  async processMessage(payload) {
+    const { topic, partition, message } = payload;
+    if (!message.value) {
+      return;
+    }
+    try {
+      const parsed = JSON.parse(message.value.toString());
+      const envelope = {
+        ...parsed,
+        timestamp: new Date(parsed.timestamp)
+      };
+      const handler = this.handlers.get(topic);
+      if (handler) {
+        await handler(envelope);
+      }
+      await this.consumer.commitOffsets([
+        {
+          topic,
+          partition,
+          offset: (BigInt(message.offset) + 1n).toString()
+        }
+      ]);
+    } catch (error) {
+      console.error("[Kafka] Message processing error:", error);
+      throw error;
+    }
+  }
+  /**
+   * Check if the transport is running.
+   */
+  isStarted() {
+    return this.isRunning;
+  }
+  /**
+   * Get transport statistics.
+   */
+  getStats() {
+    return {
+      subscriptionCount: this.subscriptions.length,
+      isRunning: this.isRunning
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  KafkaTransport
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/KafkaTransport.ts"],"sourcesContent":["export { KafkaTransport } from \"./KafkaTransport.js\";\nexport type { KafkaTransportOptions } from \"./types.js\";\n","import { randomUUID } from \"node:crypto\";\nimport type {\n  Kafka,\n  Producer,\n  Consumer,\n  EachMessagePayload,\n  Admin,\n} from \"kafkajs\";\nimport type {\n  Transport,\n  TransportSubscribeOptions,\n  TransportPublishOptions,\n  BaseMessage,\n  MessageEnvelope,\n} from \"@saga-bus/core\";\nimport type { KafkaTransportOptions, KafkaSubscription } from \"./types.js\";\n\n/**\n * Kafka transport for saga-bus using KafkaJS.\n *\n * Uses partition keys for message ordering within a saga.\n * Consumer groups enable horizontal scaling.\n *\n * @example\n * ```typescript\n * import { Kafka } from \"kafkajs\";\n *\n * const kafka = new Kafka({\n *   clientId: \"my-app\",\n *   brokers: [\"localhost:9092\"],\n * });\n *\n * const transport = new KafkaTransport({\n *   kafka,\n *   defaultTopic: \"saga-bus.events\",\n *   groupId: \"order-processor\",\n * });\n *\n * await transport.start();\n *\n * await transport.subscribe(\n *   { endpoint: \"saga-bus.orders\", concurrency: 5 },\n *   async (envelope) => { ... }\n * );\n *\n * await transport.publish(\n *   { type: \"OrderSubmitted\", orderId: \"123\" },\n *   { endpoint: \"saga-bus.orders\", key: \"order-123\" }\n * );\n * ```\n */\nexport class KafkaTransport implements Transport {\n  private readonly kafka: Kafka;\n  private readonly defaultTopic: string | undefined;\n  private readonly groupId: string | undefined;\n  private readonly createTopics: boolean;\n  private readonly numPartitions: number;\n  private readonly replicationFactor: number;\n  private readonly fromBeginning: boolean;\n  private readonly sessionTimeout: number;\n  private readonly heartbeatInterval: number;\n\n  private producer: Producer | null = null;\n  private consumer: Consumer | null = null;\n  private readonly handlers = new Map<\n    string,\n    (envelope: MessageEnvelope) => Promise<void>\n  >();\n  private readonly subscriptions: KafkaSubscription[] = [];\n  private isRunning = false;\n\n  constructor(options: KafkaTransportOptions) {\n    this.kafka = options.kafka;\n    this.defaultTopic = options.defaultTopic;\n    this.groupId = options.groupId;\n    this.createTopics = options.createTopics ?? false;\n    this.numPartitions = options.numPartitions ?? 3;\n    this.replicationFactor = options.replicationFactor ?? 1;\n    this.fromBeginning = options.fromBeginning ?? false;\n    this.sessionTimeout = options.sessionTimeout ?? 30000;\n    this.heartbeatInterval = options.heartbeatInterval ?? 3000;\n  }\n\n  async start(): Promise<void> {\n    if (this.isRunning) {\n      return;\n    }\n\n    // Connect producer\n    this.producer = this.kafka.producer();\n    await this.producer.connect();\n\n    // If we have subscriptions, start consumer\n    if (this.subscriptions.length > 0) {\n      if (!this.groupId) {\n        throw new Error(\"groupId is required for consuming\");\n      }\n\n      // Create topics if needed\n      if (this.createTopics) {\n        await this.ensureTopics();\n      }\n\n      // Create and connect consumer\n      this.consumer = this.kafka.consumer({\n        groupId: this.groupId,\n        sessionTimeout: this.sessionTimeout,\n        heartbeatInterval: this.heartbeatInterval,\n      });\n\n      await this.consumer.connect();\n\n      // Subscribe to all topics\n      for (const sub of this.subscriptions) {\n        await this.consumer.subscribe({\n          topic: sub.topic,\n          fromBeginning: this.fromBeginning,\n        });\n      }\n\n      this.isRunning = true;\n\n      // Start consuming with manual commit\n      await this.consumer.run({\n        autoCommit: false,\n        eachMessage: async (payload: EachMessagePayload) => {\n          await this.processMessage(payload);\n        },\n      });\n    } else {\n      this.isRunning = true;\n    }\n  }\n\n  async stop(): Promise<void> {\n    this.isRunning = false;\n\n    if (this.consumer) {\n      await this.consumer.disconnect();\n      this.consumer = null;\n    }\n\n    if (this.producer) {\n      await this.producer.disconnect();\n      this.producer = null;\n    }\n  }\n\n  async subscribe<TMessage extends BaseMessage>(\n    options: TransportSubscribeOptions,\n    handler: (envelope: MessageEnvelope<TMessage>) => Promise<void>\n  ): Promise<void> {\n    const topic = options.endpoint;\n\n    if (!topic) {\n      throw new Error(\"endpoint (topic) is required for subscribing\");\n    }\n\n    if (!this.groupId) {\n      throw new Error(\"groupId is required for subscribing\");\n    }\n\n    // Store handler\n    this.handlers.set(\n      topic,\n      handler as (envelope: MessageEnvelope) => Promise<void>\n    );\n\n    this.subscriptions.push({\n      topic,\n      concurrency: options.concurrency ?? 1,\n    });\n  }\n\n  async publish<TMessage extends BaseMessage>(\n    message: TMessage,\n    options: TransportPublishOptions\n  ): Promise<void> {\n    const topic = options.endpoint || this.defaultTopic;\n\n    if (!topic) {\n      throw new Error(\"endpoint (topic) is required for publishing\");\n    }\n\n    // Lazily connect producer if not started\n    if (!this.producer) {\n      this.producer = this.kafka.producer();\n      await this.producer.connect();\n    }\n\n    const { key, headers = {} } = options;\n\n    // Create envelope\n    const envelope: MessageEnvelope<TMessage> = {\n      id: randomUUID(),\n      type: message.type,\n      payload: message,\n      headers: {\n        ...headers,\n        \"x-message-type\": message.type,\n      },\n      timestamp: new Date(),\n      partitionKey: key,\n    };\n\n    // Partition key for ordering\n    const partitionKey = key ?? envelope.id;\n\n    // Convert headers to Kafka format (Buffer values)\n    const kafkaHeaders: Record<string, string> = {\n      messageId: envelope.id,\n      messageType: envelope.type,\n      ...headers,\n    };\n\n    await this.producer.send({\n      topic,\n      messages: [\n        {\n          key: partitionKey,\n          value: JSON.stringify(envelope),\n          headers: kafkaHeaders,\n        },\n      ],\n    });\n  }\n\n  private async ensureTopics(): Promise<void> {\n    const admin: Admin = this.kafka.admin();\n    await admin.connect();\n\n    try {\n      const existingTopics = await admin.listTopics();\n      const topicsToCreate = this.subscriptions\n        .map((s) => s.topic)\n        .filter((topic) => !existingTopics.includes(topic));\n\n      if (topicsToCreate.length > 0) {\n        await admin.createTopics({\n          topics: topicsToCreate.map((topic) => ({\n            topic,\n            numPartitions: this.numPartitions,\n            replicationFactor: this.replicationFactor,\n          })),\n        });\n      }\n    } finally {\n      await admin.disconnect();\n    }\n  }\n\n  private async processMessage(payload: EachMessagePayload): Promise<void> {\n    const { topic, partition, message } = payload;\n\n    if (!message.value) {\n      return;\n    }\n\n    try {\n      // Parse envelope\n      const parsed = JSON.parse(message.value.toString()) as MessageEnvelope;\n\n      // Reconstruct Date objects\n      const envelope: MessageEnvelope = {\n        ...parsed,\n        timestamp: new Date(parsed.timestamp),\n      };\n\n      // Find handler for this topic\n      const handler = this.handlers.get(topic);\n\n      if (handler) {\n        await handler(envelope);\n      }\n\n      // Commit offset on success\n      await this.consumer!.commitOffsets([\n        {\n          topic,\n          partition,\n          offset: (BigInt(message.offset) + 1n).toString(),\n        },\n      ]);\n    } catch (error) {\n      console.error(\"[Kafka] Message processing error:\", error);\n      // Don't commit - message will be redelivered\n      throw error;\n    }\n  }\n\n  /**\n   * Check if the transport is running.\n   */\n  isStarted(): boolean {\n    return this.isRunning;\n  }\n\n  /**\n   * Get transport statistics.\n   */\n  getStats(): { subscriptionCount: number; isRunning: boolean } {\n    return {\n      subscriptionCount: this.subscriptions.length,\n      isRunning: this.isRunning,\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,123 @@
+import { Transport, BaseMessage, TransportSubscribeOptions, MessageEnvelope, TransportPublishOptions } from '@saga-bus/core';
+import { Kafka } from 'kafkajs';
+
+/**
+ * Kafka transport configuration options.
+ */
+interface KafkaTransportOptions {
+    /**
+     * KafkaJS Kafka instance.
+     */
+    kafka: Kafka;
+    /**
+     * Default topic for publish/subscribe.
+     * Can be overridden per-operation via endpoint.
+     */
+    defaultTopic?: string;
+    /**
+     * Consumer group ID.
+     * Required for subscribing.
+     */
+    groupId?: string;
+    /**
+     * Whether to create topics if they don't exist.
+     * @default false
+     */
+    createTopics?: boolean;
+    /**
+     * Number of partitions when creating topics.
+     * @default 3
+     */
+    numPartitions?: number;
+    /**
+     * Replication factor when creating topics.
+     * @default 1
+     */
+    replicationFactor?: number;
+    /**
+     * Whether to start consuming from the beginning.
+     * @default false (latest)
+     */
+    fromBeginning?: boolean;
+    /**
+     * Session timeout in milliseconds.
+     * @default 30000
+     */
+    sessionTimeout?: number;
+    /**
+     * Heartbeat interval in milliseconds.
+     * @default 3000
+     */
+    heartbeatInterval?: number;
+}
+
+/**
+ * Kafka transport for saga-bus using KafkaJS.
+ *
+ * Uses partition keys for message ordering within a saga.
+ * Consumer groups enable horizontal scaling.
+ *
+ * @example
+ * ```typescript
+ * import { Kafka } from "kafkajs";
+ *
+ * const kafka = new Kafka({
+ *   clientId: "my-app",
+ *   brokers: ["localhost:9092"],
+ * });
+ *
+ * const transport = new KafkaTransport({
+ *   kafka,
+ *   defaultTopic: "saga-bus.events",
+ *   groupId: "order-processor",
+ * });
+ *
+ * await transport.start();
+ *
+ * await transport.subscribe(
+ *   { endpoint: "saga-bus.orders", concurrency: 5 },
+ *   async (envelope) => { ... }
+ * );
+ *
+ * await transport.publish(
+ *   { type: "OrderSubmitted", orderId: "123" },
+ *   { endpoint: "saga-bus.orders", key: "order-123" }
+ * );
+ * ```
+ */
+declare class KafkaTransport implements Transport {
+    private readonly kafka;
+    private readonly defaultTopic;
+    private readonly groupId;
+    private readonly createTopics;
+    private readonly numPartitions;
+    private readonly replicationFactor;
+    private readonly fromBeginning;
+    private readonly sessionTimeout;
+    private readonly heartbeatInterval;
+    private producer;
+    private consumer;
+    private readonly handlers;
+    private readonly subscriptions;
+    private isRunning;
+    constructor(options: KafkaTransportOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    subscribe<TMessage extends BaseMessage>(options: TransportSubscribeOptions, handler: (envelope: MessageEnvelope<TMessage>) => Promise<void>): Promise<void>;
+    publish<TMessage extends BaseMessage>(message: TMessage, options: TransportPublishOptions): Promise<void>;
+    private ensureTopics;
+    private processMessage;
+    /**
+     * Check if the transport is running.
+     */
+    isStarted(): boolean;
+    /**
+     * Get transport statistics.
+     */
+    getStats(): {
+        subscriptionCount: number;
+        isRunning: boolean;
+    };
+}
+
+export { KafkaTransport, type KafkaTransportOptions };

package/dist/index.d.ts

@@ -0,0 +1,123 @@
+import { Transport, BaseMessage, TransportSubscribeOptions, MessageEnvelope, TransportPublishOptions } from '@saga-bus/core';
+import { Kafka } from 'kafkajs';
+
+/**
+ * Kafka transport configuration options.
+ */
+interface KafkaTransportOptions {
+    /**
+     * KafkaJS Kafka instance.
+     */
+    kafka: Kafka;
+    /**
+     * Default topic for publish/subscribe.
+     * Can be overridden per-operation via endpoint.
+     */
+    defaultTopic?: string;
+    /**
+     * Consumer group ID.
+     * Required for subscribing.
+     */
+    groupId?: string;
+    /**
+     * Whether to create topics if they don't exist.
+     * @default false
+     */
+    createTopics?: boolean;
+    /**
+     * Number of partitions when creating topics.
+     * @default 3
+     */
+    numPartitions?: number;
+    /**
+     * Replication factor when creating topics.
+     * @default 1
+     */
+    replicationFactor?: number;
+    /**
+     * Whether to start consuming from the beginning.
+     * @default false (latest)
+     */
+    fromBeginning?: boolean;
+    /**
+     * Session timeout in milliseconds.
+     * @default 30000
+     */
+    sessionTimeout?: number;
+    /**
+     * Heartbeat interval in milliseconds.
+     * @default 3000
+     */
+    heartbeatInterval?: number;
+}
+
+/**
+ * Kafka transport for saga-bus using KafkaJS.
+ *
+ * Uses partition keys for message ordering within a saga.
+ * Consumer groups enable horizontal scaling.
+ *
+ * @example
+ * ```typescript
+ * import { Kafka } from "kafkajs";
+ *
+ * const kafka = new Kafka({
+ *   clientId: "my-app",
+ *   brokers: ["localhost:9092"],
+ * });
+ *
+ * const transport = new KafkaTransport({
+ *   kafka,
+ *   defaultTopic: "saga-bus.events",
+ *   groupId: "order-processor",
+ * });
+ *
+ * await transport.start();
+ *
+ * await transport.subscribe(
+ *   { endpoint: "saga-bus.orders", concurrency: 5 },
+ *   async (envelope) => { ... }
+ * );
+ *
+ * await transport.publish(
+ *   { type: "OrderSubmitted", orderId: "123" },
+ *   { endpoint: "saga-bus.orders", key: "order-123" }
+ * );
+ * ```
+ */
+declare class KafkaTransport implements Transport {
+    private readonly kafka;
+    private readonly defaultTopic;
+    private readonly groupId;
+    private readonly createTopics;
+    private readonly numPartitions;
+    private readonly replicationFactor;
+    private readonly fromBeginning;
+    private readonly sessionTimeout;
+    private readonly heartbeatInterval;
+    private producer;
+    private consumer;
+    private readonly handlers;
+    private readonly subscriptions;
+    private isRunning;
+    constructor(options: KafkaTransportOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    subscribe<TMessage extends BaseMessage>(options: TransportSubscribeOptions, handler: (envelope: MessageEnvelope<TMessage>) => Promise<void>): Promise<void>;
+    publish<TMessage extends BaseMessage>(message: TMessage, options: TransportPublishOptions): Promise<void>;
+    private ensureTopics;
+    private processMessage;
+    /**
+     * Check if the transport is running.
+     */
+    isStarted(): boolean;
+    /**
+     * Get transport statistics.
+     */
+    getStats(): {
+        subscriptionCount: number;
+        isRunning: boolean;
+    };
+}
+
+export { KafkaTransport, type KafkaTransportOptions };

package/dist/index.js

@@ -0,0 +1,196 @@
+// src/KafkaTransport.ts
+import { randomUUID } from "crypto";
+var KafkaTransport = class {
+  kafka;
+  defaultTopic;
+  groupId;
+  createTopics;
+  numPartitions;
+  replicationFactor;
+  fromBeginning;
+  sessionTimeout;
+  heartbeatInterval;
+  producer = null;
+  consumer = null;
+  handlers = /* @__PURE__ */ new Map();
+  subscriptions = [];
+  isRunning = false;
+  constructor(options) {
+    this.kafka = options.kafka;
+    this.defaultTopic = options.defaultTopic;
+    this.groupId = options.groupId;
+    this.createTopics = options.createTopics ?? false;
+    this.numPartitions = options.numPartitions ?? 3;
+    this.replicationFactor = options.replicationFactor ?? 1;
+    this.fromBeginning = options.fromBeginning ?? false;
+    this.sessionTimeout = options.sessionTimeout ?? 3e4;
+    this.heartbeatInterval = options.heartbeatInterval ?? 3e3;
+  }
+  async start() {
+    if (this.isRunning) {
+      return;
+    }
+    this.producer = this.kafka.producer();
+    await this.producer.connect();
+    if (this.subscriptions.length > 0) {
+      if (!this.groupId) {
+        throw new Error("groupId is required for consuming");
+      }
+      if (this.createTopics) {
+        await this.ensureTopics();
+      }
+      this.consumer = this.kafka.consumer({
+        groupId: this.groupId,
+        sessionTimeout: this.sessionTimeout,
+        heartbeatInterval: this.heartbeatInterval
+      });
+      await this.consumer.connect();
+      for (const sub of this.subscriptions) {
+        await this.consumer.subscribe({
+          topic: sub.topic,
+          fromBeginning: this.fromBeginning
+        });
+      }
+      this.isRunning = true;
+      await this.consumer.run({
+        autoCommit: false,
+        eachMessage: async (payload) => {
+          await this.processMessage(payload);
+        }
+      });
+    } else {
+      this.isRunning = true;
+    }
+  }
+  async stop() {
+    this.isRunning = false;
+    if (this.consumer) {
+      await this.consumer.disconnect();
+      this.consumer = null;
+    }
+    if (this.producer) {
+      await this.producer.disconnect();
+      this.producer = null;
+    }
+  }
+  async subscribe(options, handler) {
+    const topic = options.endpoint;
+    if (!topic) {
+      throw new Error("endpoint (topic) is required for subscribing");
+    }
+    if (!this.groupId) {
+      throw new Error("groupId is required for subscribing");
+    }
+    this.handlers.set(
+      topic,
+      handler
+    );
+    this.subscriptions.push({
+      topic,
+      concurrency: options.concurrency ?? 1
+    });
+  }
+  async publish(message, options) {
+    const topic = options.endpoint || this.defaultTopic;
+    if (!topic) {
+      throw new Error("endpoint (topic) is required for publishing");
+    }
+    if (!this.producer) {
+      this.producer = this.kafka.producer();
+      await this.producer.connect();
+    }
+    const { key, headers = {} } = options;
+    const envelope = {
+      id: randomUUID(),
+      type: message.type,
+      payload: message,
+      headers: {
+        ...headers,
+        "x-message-type": message.type
+      },
+      timestamp: /* @__PURE__ */ new Date(),
+      partitionKey: key
+    };
+    const partitionKey = key ?? envelope.id;
+    const kafkaHeaders = {
+      messageId: envelope.id,
+      messageType: envelope.type,
+      ...headers
+    };
+    await this.producer.send({
+      topic,
+      messages: [
+        {
+          key: partitionKey,
+          value: JSON.stringify(envelope),
+          headers: kafkaHeaders
+        }
+      ]
+    });
+  }
+  async ensureTopics() {
+    const admin = this.kafka.admin();
+    await admin.connect();
+    try {
+      const existingTopics = await admin.listTopics();
+      const topicsToCreate = this.subscriptions.map((s) => s.topic).filter((topic) => !existingTopics.includes(topic));
+      if (topicsToCreate.length > 0) {
+        await admin.createTopics({
+          topics: topicsToCreate.map((topic) => ({
+            topic,
+            numPartitions: this.numPartitions,
+            replicationFactor: this.replicationFactor
+          }))
+        });
+      }
+    } finally {
+      await admin.disconnect();
+    }
+  }
+  async processMessage(payload) {
+    const { topic, partition, message } = payload;
+    if (!message.value) {
+      return;
+    }
+    try {
+      const parsed = JSON.parse(message.value.toString());
+      const envelope = {
+        ...parsed,
+        timestamp: new Date(parsed.timestamp)
+      };
+      const handler = this.handlers.get(topic);
+      if (handler) {
+        await handler(envelope);
+      }
+      await this.consumer.commitOffsets([
+        {
+          topic,
+          partition,
+          offset: (BigInt(message.offset) + 1n).toString()
+        }
+      ]);
+    } catch (error) {
+      console.error("[Kafka] Message processing error:", error);
+      throw error;
+    }
+  }
+  /**
+   * Check if the transport is running.
+   */
+  isStarted() {
+    return this.isRunning;
+  }
+  /**
+   * Get transport statistics.
+   */
+  getStats() {
+    return {
+      subscriptionCount: this.subscriptions.length,
+      isRunning: this.isRunning
+    };
+  }
+};
+export {
+  KafkaTransport
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/KafkaTransport.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type {\n  Kafka,\n  Producer,\n  Consumer,\n  EachMessagePayload,\n  Admin,\n} from \"kafkajs\";\nimport type {\n  Transport,\n  TransportSubscribeOptions,\n  TransportPublishOptions,\n  BaseMessage,\n  MessageEnvelope,\n} from \"@saga-bus/core\";\nimport type { KafkaTransportOptions, KafkaSubscription } from \"./types.js\";\n\n/**\n * Kafka transport for saga-bus using KafkaJS.\n *\n * Uses partition keys for message ordering within a saga.\n * Consumer groups enable horizontal scaling.\n *\n * @example\n * ```typescript\n * import { Kafka } from \"kafkajs\";\n *\n * const kafka = new Kafka({\n *   clientId: \"my-app\",\n *   brokers: [\"localhost:9092\"],\n * });\n *\n * const transport = new KafkaTransport({\n *   kafka,\n *   defaultTopic: \"saga-bus.events\",\n *   groupId: \"order-processor\",\n * });\n *\n * await transport.start();\n *\n * await transport.subscribe(\n *   { endpoint: \"saga-bus.orders\", concurrency: 5 },\n *   async (envelope) => { ... }\n * );\n *\n * await transport.publish(\n *   { type: \"OrderSubmitted\", orderId: \"123\" },\n *   { endpoint: \"saga-bus.orders\", key: \"order-123\" }\n * );\n * ```\n */\nexport class KafkaTransport implements Transport {\n  private readonly kafka: Kafka;\n  private readonly defaultTopic: string | undefined;\n  private readonly groupId: string | undefined;\n  private readonly createTopics: boolean;\n  private readonly numPartitions: number;\n  private readonly replicationFactor: number;\n  private readonly fromBeginning: boolean;\n  private readonly sessionTimeout: number;\n  private readonly heartbeatInterval: number;\n\n  private producer: Producer | null = null;\n  private consumer: Consumer | null = null;\n  private readonly handlers = new Map<\n    string,\n    (envelope: MessageEnvelope) => Promise<void>\n  >();\n  private readonly subscriptions: KafkaSubscription[] = [];\n  private isRunning = false;\n\n  constructor(options: KafkaTransportOptions) {\n    this.kafka = options.kafka;\n    this.defaultTopic = options.defaultTopic;\n    this.groupId = options.groupId;\n    this.createTopics = options.createTopics ?? false;\n    this.numPartitions = options.numPartitions ?? 3;\n    this.replicationFactor = options.replicationFactor ?? 1;\n    this.fromBeginning = options.fromBeginning ?? false;\n    this.sessionTimeout = options.sessionTimeout ?? 30000;\n    this.heartbeatInterval = options.heartbeatInterval ?? 3000;\n  }\n\n  async start(): Promise<void> {\n    if (this.isRunning) {\n      return;\n    }\n\n    // Connect producer\n    this.producer = this.kafka.producer();\n    await this.producer.connect();\n\n    // If we have subscriptions, start consumer\n    if (this.subscriptions.length > 0) {\n      if (!this.groupId) {\n        throw new Error(\"groupId is required for consuming\");\n      }\n\n      // Create topics if needed\n      if (this.createTopics) {\n        await this.ensureTopics();\n      }\n\n      // Create and connect consumer\n      this.consumer = this.kafka.consumer({\n        groupId: this.groupId,\n        sessionTimeout: this.sessionTimeout,\n        heartbeatInterval: this.heartbeatInterval,\n      });\n\n      await this.consumer.connect();\n\n      // Subscribe to all topics\n      for (const sub of this.subscriptions) {\n        await this.consumer.subscribe({\n          topic: sub.topic,\n          fromBeginning: this.fromBeginning,\n        });\n      }\n\n      this.isRunning = true;\n\n      // Start consuming with manual commit\n      await this.consumer.run({\n        autoCommit: false,\n        eachMessage: async (payload: EachMessagePayload) => {\n          await this.processMessage(payload);\n        },\n      });\n    } else {\n      this.isRunning = true;\n    }\n  }\n\n  async stop(): Promise<void> {\n    this.isRunning = false;\n\n    if (this.consumer) {\n      await this.consumer.disconnect();\n      this.consumer = null;\n    }\n\n    if (this.producer) {\n      await this.producer.disconnect();\n      this.producer = null;\n    }\n  }\n\n  async subscribe<TMessage extends BaseMessage>(\n    options: TransportSubscribeOptions,\n    handler: (envelope: MessageEnvelope<TMessage>) => Promise<void>\n  ): Promise<void> {\n    const topic = options.endpoint;\n\n    if (!topic) {\n      throw new Error(\"endpoint (topic) is required for subscribing\");\n    }\n\n    if (!this.groupId) {\n      throw new Error(\"groupId is required for subscribing\");\n    }\n\n    // Store handler\n    this.handlers.set(\n      topic,\n      handler as (envelope: MessageEnvelope) => Promise<void>\n    );\n\n    this.subscriptions.push({\n      topic,\n      concurrency: options.concurrency ?? 1,\n    });\n  }\n\n  async publish<TMessage extends BaseMessage>(\n    message: TMessage,\n    options: TransportPublishOptions\n  ): Promise<void> {\n    const topic = options.endpoint || this.defaultTopic;\n\n    if (!topic) {\n      throw new Error(\"endpoint (topic) is required for publishing\");\n    }\n\n    // Lazily connect producer if not started\n    if (!this.producer) {\n      this.producer = this.kafka.producer();\n      await this.producer.connect();\n    }\n\n    const { key, headers = {} } = options;\n\n    // Create envelope\n    const envelope: MessageEnvelope<TMessage> = {\n      id: randomUUID(),\n      type: message.type,\n      payload: message,\n      headers: {\n        ...headers,\n        \"x-message-type\": message.type,\n      },\n      timestamp: new Date(),\n      partitionKey: key,\n    };\n\n    // Partition key for ordering\n    const partitionKey = key ?? envelope.id;\n\n    // Convert headers to Kafka format (Buffer values)\n    const kafkaHeaders: Record<string, string> = {\n      messageId: envelope.id,\n      messageType: envelope.type,\n      ...headers,\n    };\n\n    await this.producer.send({\n      topic,\n      messages: [\n        {\n          key: partitionKey,\n          value: JSON.stringify(envelope),\n          headers: kafkaHeaders,\n        },\n      ],\n    });\n  }\n\n  private async ensureTopics(): Promise<void> {\n    const admin: Admin = this.kafka.admin();\n    await admin.connect();\n\n    try {\n      const existingTopics = await admin.listTopics();\n      const topicsToCreate = this.subscriptions\n        .map((s) => s.topic)\n        .filter((topic) => !existingTopics.includes(topic));\n\n      if (topicsToCreate.length > 0) {\n        await admin.createTopics({\n          topics: topicsToCreate.map((topic) => ({\n            topic,\n            numPartitions: this.numPartitions,\n            replicationFactor: this.replicationFactor,\n          })),\n        });\n      }\n    } finally {\n      await admin.disconnect();\n    }\n  }\n\n  private async processMessage(payload: EachMessagePayload): Promise<void> {\n    const { topic, partition, message } = payload;\n\n    if (!message.value) {\n      return;\n    }\n\n    try {\n      // Parse envelope\n      const parsed = JSON.parse(message.value.toString()) as MessageEnvelope;\n\n      // Reconstruct Date objects\n      const envelope: MessageEnvelope = {\n        ...parsed,\n        timestamp: new Date(parsed.timestamp),\n      };\n\n      // Find handler for this topic\n      const handler = this.handlers.get(topic);\n\n      if (handler) {\n        await handler(envelope);\n      }\n\n      // Commit offset on success\n      await this.consumer!.commitOffsets([\n        {\n          topic,\n          partition,\n          offset: (BigInt(message.offset) + 1n).toString(),\n        },\n      ]);\n    } catch (error) {\n      console.error(\"[Kafka] Message processing error:\", error);\n      // Don't commit - message will be redelivered\n      throw error;\n    }\n  }\n\n  /**\n   * Check if the transport is running.\n   */\n  isStarted(): boolean {\n    return this.isRunning;\n  }\n\n  /**\n   * Get transport statistics.\n   */\n  getStats(): { subscriptionCount: number; isRunning: boolean } {\n    return {\n      subscriptionCount: this.subscriptions.length,\n      isRunning: this.isRunning,\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@saga-bus/transport-kafka",
+  "version": "0.1.0",
+  "description": "Kafka transport for saga-bus",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deanforan/saga-bus.git",
+    "directory": "packages/transport-kafka"
+  },
+  "keywords": [
+    "saga",
+    "message-bus",
+    "transport",
+    "kafka",
+    "kafkajs"
+  ],
+  "dependencies": {
+    "kafkajs": "^2.2.4",
+    "@saga-bus/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@testcontainers/kafka": "^10.0.0",
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.0.0",
+    "@repo/eslint-config": "0.0.0",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "peerDependencies": {
+    "kafkajs": ">=2.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}