@fbsm/saga-transport-kafka 0.0.1-beta.0

package/README.md

@@ -0,0 +1,141 @@
+# @fbsm/saga-transport-kafka
+
+KafkaJS-based transport adapter for `@fbsm/saga-core`. Provides `eachBatch` consumption, key-based message grouping, and watermark-based offset tracking.
+
+## Installation
+
+```bash
+npm install @fbsm/saga-transport-kafka kafkajs
+```
+
+## Usage
+
+### With NestJS (`@fbsm/saga-nestjs`)
+
+```typescript
+import { Module } from '@nestjs/common';
+import { SagaModule } from '@fbsm/saga-nestjs';
+import { KafkaTransport } from '@fbsm/saga-transport-kafka';
+
+@Module({
+  imports: [
+    SagaModule.forRoot({
+      serviceName: 'my-service',
+      transport: new KafkaTransport({
+        brokers: ['localhost:9092'],
+        clientId: 'my-service',
+        autoCreateTopics: true,
+      }),
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+### Standalone (without NestJS)
+
+```typescript
+import { SagaPublisher, SagaRunner, SagaRegistry, SagaParser, createOtelContext } from '@fbsm/saga-core';
+import { KafkaTransport } from '@fbsm/saga-transport-kafka';
+
+const transport = new KafkaTransport({
+  brokers: ['localhost:9092'],
+  clientId: 'my-service',
+});
+
+const otelCtx = createOtelContext();
+const registry = new SagaRegistry();
+const parser = new SagaParser();
+const publisher = new SagaPublisher(transport, otelCtx);
+const runner = new SagaRunner(registry, transport, publisher, parser, {
+  serviceName: 'my-service',
+});
+
+// Register participants...
+// registry.register(participant);
+
+await runner.start();
+```
+
+## API Reference
+
+### `KafkaTransport`
+
+```typescript
+import { KafkaTransport } from '@fbsm/saga-transport-kafka';
+
+const transport = new KafkaTransport({
+  brokers: ['localhost:9092'],
+  clientId: 'my-service',
+  ssl: true,
+  sasl: {
+    mechanism: 'scram-sha-256',
+    username: 'user',
+    password: 'pass',
+  },
+  partitionsConsumedConcurrently: 3,
+  autoCreateTopics: true,
+});
+```
+
+### `KafkaTransportOptions`
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `brokers` | `string[]` | — | Kafka broker addresses (**required**) |
+| `clientId` | `string` | `'saga-client'` | Client identifier |
+| `ssl` | `tls.ConnectionOptions \| boolean` | — | TLS/SSL config. Pass `true` for default TLS |
+| `sasl` | `SASLOptions` | — | SASL auth (PLAIN, SCRAM-SHA-256, SCRAM-SHA-512, OAUTHBEARER, AWS) |
+| `connectionTimeout` | `number` | `1000` | Connection timeout (ms) |
+| `authenticationTimeout` | `number` | — | Authentication timeout (ms) |
+| `requestTimeout` | `number` | — | Request timeout (ms) |
+| `retry` | `RetryOptions` | `{ initialRetryTime: 300, retries: 10 }` | KafkaJS client retry policy |
+| `logLevel` | `logLevel` | `WARN` | KafkaJS log level |
+| `socketFactory` | `ISocketFactory` | — | Custom socket factory (e.g., SOCKS proxy) |
+| `partitionsConsumedConcurrently` | `number` | `3` | Partitions consumed concurrently |
+| `enableOtelInstrumentation` | `boolean` | — | Register KafkaJS OTel instrumentation |
+| `autoCreateTopics` | `boolean` | `false` | Auto-create missing topics via admin client |
+| `logger` | `SagaLogger` | `ConsoleSagaLogger` | Custom logger |
+
+## Features
+
+### eachBatch with Key-Based Grouping
+
+Messages are consumed via KafkaJS `eachBatch` for high throughput. Within each batch, messages are grouped by key (default: `rootSagaId`):
+
+- **Parallel** across different keys (different saga trees)
+- **Sequential** within the same key (same saga tree)
+
+This ensures event ordering within a saga while maximizing throughput.
+
+### Watermark-Based Offset Tracking
+
+Offsets are committed using a watermark strategy: only the lowest unprocessed offset is committed. This prevents message loss if a later message in the batch completes before an earlier one.
+
+### Topic Naming
+
+Topics are derived from event types with an optional prefix:
+
+```
+topic = topicPrefix + eventType
+```
+
+Example with `topicPrefix: 'prod.'`:
+- `order.created` → topic `prod.order.created`
+- `payment.completed` → topic `prod.payment.completed`
+
+### Auto-Create Topics
+
+When `autoCreateTopics: true`, the transport uses the Kafka admin client to create any missing topics before subscribing. Useful for development environments.
+
+### Header-Based Metadata
+
+All saga context metadata is propagated via Kafka headers. See [Kafka Headers](../saga-core/README.md#kafka-headers) for the full list.
+
+---
+
+## Further Reading
+
+- [@fbsm/saga-core](../saga-core/README.md) — Core library reference
+- [@fbsm/saga-nestjs](../saga-nestjs/README.md) — NestJS integration
+- [Custom Transport](../doc/custom-transport.md) — Implement your own transport

package/dist/index.cjs

@@ -0,0 +1,218 @@
+"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/kafka.transport.ts
+var import_kafkajs = require("kafkajs");
+var import_saga_core = require("@fbsm/saga-core");
+
+// src/watermark-tracker.ts
+var WatermarkTracker = class {
+  arrivedOffsets = [];
+  completed = /* @__PURE__ */ new Set();
+  reset(offsets) {
+    this.arrivedOffsets = offsets;
+    this.completed.clear();
+  }
+  markCompleted(offset) {
+    this.completed.add(offset);
+  }
+  getCommittableOffset() {
+    let lastSafe = null;
+    for (const offset of this.arrivedOffsets) {
+      if (this.completed.has(offset)) {
+        lastSafe = offset;
+      } else {
+        break;
+      }
+    }
+    return lastSafe;
+  }
+};
+
+// src/kafka.transport.ts
+var KafkaTransport = class {
+  constructor(options) {
+    this.options = options;
+    this.logger = options.logger ?? new import_saga_core.ConsoleSagaLogger();
+    this.kafka = new import_kafkajs.Kafka({
+      clientId: options.clientId ?? "saga-client",
+      brokers: options.brokers,
+      ssl: options.ssl,
+      sasl: options.sasl,
+      connectionTimeout: options.connectionTimeout,
+      authenticationTimeout: options.authenticationTimeout,
+      requestTimeout: options.requestTimeout,
+      retry: options.retry ?? {
+        initialRetryTime: 300,
+        retries: 10
+      },
+      logLevel: options.logLevel ?? import_kafkajs.logLevel.WARN,
+      socketFactory: options.socketFactory
+    });
+    this.producer = this.kafka.producer();
+  }
+  kafka;
+  producer;
+  consumer = null;
+  logger;
+  async connect() {
+    await this.producer.connect();
+  }
+  async disconnect() {
+    await this.producer.disconnect();
+    if (this.consumer) {
+      await this.consumer.disconnect();
+    }
+  }
+  async publish(message) {
+    await this.producer.send({
+      topic: message.topic,
+      messages: [
+        {
+          key: message.key,
+          value: message.value,
+          headers: message.headers
+        }
+      ]
+    });
+  }
+  async subscribe(topics, handler, options) {
+    const groupId = options?.groupId ?? "saga-default-group";
+    if (this.options.autoCreateTopics) {
+      await this.ensureTopicsExist(topics);
+    }
+    await this.connectConsumerWithRetry(groupId, topics, handler, options);
+  }
+  async ensureTopicsExist(topics) {
+    const admin = this.kafka.admin();
+    await admin.connect();
+    try {
+      const existing = await admin.listTopics();
+      const missing = topics.filter((t) => !existing.includes(t));
+      if (missing.length > 0) {
+        await admin.createTopics({
+          topics: missing.map((t) => ({ topic: t, numPartitions: 3, replicationFactor: 1 }))
+        });
+      }
+    } finally {
+      await admin.disconnect();
+    }
+  }
+  async connectConsumerWithRetry(groupId, topics, handler, options, maxAttempts = 10) {
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      try {
+        this.consumer = this.kafka.consumer({
+          groupId,
+          retry: { initialRetryTime: 500, retries: 8 }
+        });
+        await this.consumer.connect();
+        for (const topic of topics) {
+          await this.consumer.subscribe({
+            topic,
+            fromBeginning: options?.fromBeginning ?? false
+          });
+        }
+        await this.consumer.run({
+          partitionsConsumedConcurrently: this.options.partitionsConsumedConcurrently ?? 3,
+          eachBatch: async (payload) => {
+            await this.processBatch(payload, handler);
+          }
+        });
+        return;
+      } catch (err) {
+        this.logger.warn(
+          `[KafkaTransport] Consumer failed to start (attempt ${attempt}/${maxAttempts}): ${err.message}`
+        );
+        try {
+          await this.consumer?.disconnect();
+        } catch {
+        }
+        this.consumer = null;
+        if (attempt === maxAttempts) {
+          throw err;
+        }
+        const delay = Math.min(1e3 * Math.pow(2, attempt - 1), 1e4);
+        await new Promise((r) => setTimeout(r, delay));
+      }
+    }
+  }
+  async processBatch(payload, handler) {
+    const { batch, resolveOffset, heartbeat, isRunning, isStale } = payload;
+    const tracker = new WatermarkTracker();
+    const offsets = batch.messages.map((m) => m.offset);
+    tracker.reset(offsets);
+    const groups = /* @__PURE__ */ new Map();
+    for (const message of batch.messages) {
+      const key = message.key?.toString() ?? "__no_key__";
+      if (!groups.has(key)) {
+        groups.set(key, []);
+      }
+      groups.get(key).push(message);
+    }
+    await Promise.all(
+      Array.from(groups.entries()).map(async ([, messages]) => {
+        for (const message of messages) {
+          if (!isRunning() || isStale()) {
+            return;
+          }
+          const inbound = {
+            topic: batch.topic,
+            key: message.key?.toString() ?? "",
+            value: message.value?.toString() ?? "",
+            headers: this.convertHeaders(message.headers)
+          };
+          await handler(inbound);
+          tracker.markCompleted(message.offset);
+          const committable = tracker.getCommittableOffset();
+          if (committable) {
+            resolveOffset(committable);
+          }
+          await heartbeat();
+        }
+      })
+    );
+  }
+  convertHeaders(headers) {
+    const result = {};
+    if (!headers) return result;
+    for (const [key, value] of Object.entries(headers)) {
+      if (Buffer.isBuffer(value)) {
+        result[key] = value.toString();
+      } else if (typeof value === "string") {
+        result[key] = value;
+      } else if (Array.isArray(value) && value.length > 0) {
+        const first = value[0];
+        result[key] = Buffer.isBuffer(first) ? first.toString() : String(first);
+      }
+    }
+    return result;
+  }
+};
+// 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/kafka.transport.ts","../src/watermark-tracker.ts"],"sourcesContent":["export { KafkaTransport } from './kafka.transport';\nexport type { KafkaTransportOptions } from './kafka-transport-options';\n","import { Kafka, Producer, Consumer, EachBatchPayload, IHeaders, logLevel } from 'kafkajs';\nimport type {\n  SagaTransport,\n  InboundMessage,\n  OutboundMessage,\n  TransportSubscribeOptions,\n  SagaLogger,\n} from '@fbsm/saga-core';\nimport { ConsoleSagaLogger } from '@fbsm/saga-core';\nimport { WatermarkTracker } from './watermark-tracker';\nimport type { KafkaTransportOptions } from './kafka-transport-options';\n\nexport class KafkaTransport implements SagaTransport {\n  private kafka: Kafka;\n  private producer: Producer;\n  private consumer: Consumer | null = null;\n  private logger: SagaLogger;\n\n  constructor(private options: KafkaTransportOptions) {\n    this.logger = options.logger ?? new ConsoleSagaLogger();\n    this.kafka = new Kafka({\n      clientId: options.clientId ?? 'saga-client',\n      brokers: options.brokers,\n      ssl: options.ssl,\n      sasl: options.sasl,\n      connectionTimeout: options.connectionTimeout,\n      authenticationTimeout: options.authenticationTimeout,\n      requestTimeout: options.requestTimeout,\n      retry: options.retry ?? {\n        initialRetryTime: 300,\n        retries: 10,\n      },\n      logLevel: options.logLevel ?? logLevel.WARN,\n      socketFactory: options.socketFactory,\n    });\n    this.producer = this.kafka.producer();\n  }\n\n  async connect(): Promise<void> {\n    await this.producer.connect();\n  }\n\n  async disconnect(): Promise<void> {\n    await this.producer.disconnect();\n    if (this.consumer) {\n      await this.consumer.disconnect();\n    }\n  }\n\n  async publish(message: OutboundMessage): Promise<void> {\n    await this.producer.send({\n      topic: message.topic,\n      messages: [\n        {\n          key: message.key,\n          value: message.value,\n          headers: message.headers,\n        },\n      ],\n    });\n  }\n\n  async subscribe(\n    topics: string[],\n    handler: (message: InboundMessage) => Promise<void>,\n    options?: TransportSubscribeOptions,\n  ): Promise<void> {\n    const groupId = options?.groupId ?? 'saga-default-group';\n\n    if (this.options.autoCreateTopics) {\n      await this.ensureTopicsExist(topics);\n    }\n\n    await this.connectConsumerWithRetry(groupId, topics, handler, options);\n  }\n\n  private async ensureTopicsExist(topics: string[]): Promise<void> {\n    const admin = this.kafka.admin();\n    await admin.connect();\n    try {\n      const existing = await admin.listTopics();\n      const missing = topics.filter((t) => !existing.includes(t));\n      if (missing.length > 0) {\n        await admin.createTopics({\n          topics: missing.map((t) => ({ topic: t, numPartitions: 3, replicationFactor: 1 })),\n        });\n      }\n    } finally {\n      await admin.disconnect();\n    }\n  }\n\n  private async connectConsumerWithRetry(\n    groupId: string,\n    topics: string[],\n    handler: (message: InboundMessage) => Promise<void>,\n    options?: TransportSubscribeOptions,\n    maxAttempts = 10,\n  ): Promise<void> {\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        this.consumer = this.kafka.consumer({\n          groupId,\n          retry: { initialRetryTime: 500, retries: 8 },\n        });\n\n        await this.consumer.connect();\n\n        for (const topic of topics) {\n          await this.consumer.subscribe({\n            topic,\n            fromBeginning: options?.fromBeginning ?? false,\n          });\n        }\n\n        await this.consumer.run({\n          partitionsConsumedConcurrently: this.options.partitionsConsumedConcurrently ?? 3,\n          eachBatch: async (payload: EachBatchPayload) => {\n            await this.processBatch(payload, handler);\n          },\n        });\n\n        return;\n      } catch (err) {\n        this.logger.warn(\n          `[KafkaTransport] Consumer failed to start (attempt ${attempt}/${maxAttempts}): ${(err as Error).message}`,\n        );\n\n        try {\n          await this.consumer?.disconnect();\n        } catch {\n          // ignore disconnect errors\n        }\n        this.consumer = null;\n\n        if (attempt === maxAttempts) {\n          throw err;\n        }\n\n        const delay = Math.min(1000 * Math.pow(2, attempt - 1), 10000);\n        await new Promise((r) => setTimeout(r, delay));\n      }\n    }\n  }\n\n  private async processBatch(\n    payload: EachBatchPayload,\n    handler: (message: InboundMessage) => Promise<void>,\n  ): Promise<void> {\n    const { batch, resolveOffset, heartbeat, isRunning, isStale } = payload;\n    const tracker = new WatermarkTracker();\n\n    const offsets = batch.messages.map((m) => m.offset);\n    tracker.reset(offsets);\n\n    // Group messages by key (sagaId) for ordered processing within saga\n    const groups = new Map<string, typeof batch.messages>();\n\n    for (const message of batch.messages) {\n      const key = message.key?.toString() ?? '__no_key__';\n      if (!groups.has(key)) {\n        groups.set(key, []);\n      }\n      groups.get(key)!.push(message);\n    }\n\n    // Process groups in parallel, messages within each group sequentially\n    await Promise.all(\n      Array.from(groups.entries()).map(async ([, messages]) => {\n        for (const message of messages) {\n          if (!isRunning() || isStale()) {\n            return;\n          }\n\n          const inbound: InboundMessage = {\n            topic: batch.topic,\n            key: message.key?.toString() ?? '',\n            value: message.value?.toString() ?? '',\n            headers: this.convertHeaders(message.headers),\n          };\n\n          await handler(inbound);\n\n          tracker.markCompleted(message.offset);\n          const committable = tracker.getCommittableOffset();\n          if (committable) {\n            resolveOffset(committable);\n          }\n\n          await heartbeat();\n        }\n      }),\n    );\n  }\n\n  private convertHeaders(headers?: IHeaders): Record<string, string> {\n    const result: Record<string, string> = {};\n    if (!headers) return result;\n\n    for (const [key, value] of Object.entries(headers)) {\n      if (Buffer.isBuffer(value)) {\n        result[key] = value.toString();\n      } else if (typeof value === 'string') {\n        result[key] = value;\n      } else if (Array.isArray(value) && value.length > 0) {\n        const first = value[0];\n        result[key] = Buffer.isBuffer(first) ? first.toString() : String(first);\n      }\n    }\n\n    return result;\n  }\n}\n","export class WatermarkTracker {\n  private arrivedOffsets: string[] = [];\n  private completed = new Set<string>();\n\n  reset(offsets: string[]): void {\n    this.arrivedOffsets = offsets;\n    this.completed.clear();\n  }\n\n  markCompleted(offset: string): void {\n    this.completed.add(offset);\n  }\n\n  getCommittableOffset(): string | null {\n    let lastSafe: string | null = null;\n    for (const offset of this.arrivedOffsets) {\n      if (this.completed.has(offset)) {\n        lastSafe = offset;\n      } else {\n        break;\n      }\n    }\n    return lastSafe;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,52 @@
+import { SagaLogger, SagaTransport, OutboundMessage, InboundMessage, TransportSubscribeOptions } from '@fbsm/saga-core';
+import { KafkaConfig, logLevel } from 'kafkajs';
+
+interface KafkaTransportOptions {
+    /** Kafka broker addresses */
+    brokers: string[] | KafkaConfig['brokers'];
+    /** Client identifier for Kafka connections. Default: 'saga-client' */
+    clientId?: string;
+    /** TLS/SSL configuration. Pass `true` for default TLS or a tls.ConnectionOptions object */
+    ssl?: KafkaConfig['ssl'];
+    /** SASL authentication configuration (PLAIN, SCRAM-SHA-256, SCRAM-SHA-512, OAUTHBEARER, AWS) */
+    sasl?: KafkaConfig['sasl'];
+    /** Connection timeout in milliseconds. Default: KafkaJS default (1000) */
+    connectionTimeout?: number;
+    /** Authentication timeout in milliseconds */
+    authenticationTimeout?: number;
+    /** Request timeout in milliseconds */
+    requestTimeout?: number;
+    /** KafkaJS retry options for the client-level retry policy */
+    retry?: KafkaConfig['retry'];
+    /** KafkaJS log level. Default: WARN */
+    logLevel?: logLevel;
+    /** Custom socket factory for advanced networking (e.g., SOCKS proxy) */
+    socketFactory?: KafkaConfig['socketFactory'];
+    /** Number of partitions consumed concurrently. Default: 3 */
+    partitionsConsumedConcurrently?: number;
+    /** Register KafkaJsInstrumentation with OTel SDK. Default: true if OTel available */
+    enableOtelInstrumentation?: boolean;
+    /** Auto-create topics via admin client before subscribing. Default: false */
+    autoCreateTopics?: boolean;
+    /** Custom logger. Default: ConsoleSagaLogger */
+    logger?: SagaLogger;
+}
+
+declare class KafkaTransport implements SagaTransport {
+    private options;
+    private kafka;
+    private producer;
+    private consumer;
+    private logger;
+    constructor(options: KafkaTransportOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    publish(message: OutboundMessage): Promise<void>;
+    subscribe(topics: string[], handler: (message: InboundMessage) => Promise<void>, options?: TransportSubscribeOptions): Promise<void>;
+    private ensureTopicsExist;
+    private connectConsumerWithRetry;
+    private processBatch;
+    private convertHeaders;
+}
+
+export { KafkaTransport, type KafkaTransportOptions };

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+import { SagaLogger, SagaTransport, OutboundMessage, InboundMessage, TransportSubscribeOptions } from '@fbsm/saga-core';
+import { KafkaConfig, logLevel } from 'kafkajs';
+
+interface KafkaTransportOptions {
+    /** Kafka broker addresses */
+    brokers: string[] | KafkaConfig['brokers'];
+    /** Client identifier for Kafka connections. Default: 'saga-client' */
+    clientId?: string;
+    /** TLS/SSL configuration. Pass `true` for default TLS or a tls.ConnectionOptions object */
+    ssl?: KafkaConfig['ssl'];
+    /** SASL authentication configuration (PLAIN, SCRAM-SHA-256, SCRAM-SHA-512, OAUTHBEARER, AWS) */
+    sasl?: KafkaConfig['sasl'];
+    /** Connection timeout in milliseconds. Default: KafkaJS default (1000) */
+    connectionTimeout?: number;
+    /** Authentication timeout in milliseconds */
+    authenticationTimeout?: number;
+    /** Request timeout in milliseconds */
+    requestTimeout?: number;
+    /** KafkaJS retry options for the client-level retry policy */
+    retry?: KafkaConfig['retry'];
+    /** KafkaJS log level. Default: WARN */
+    logLevel?: logLevel;
+    /** Custom socket factory for advanced networking (e.g., SOCKS proxy) */
+    socketFactory?: KafkaConfig['socketFactory'];
+    /** Number of partitions consumed concurrently. Default: 3 */
+    partitionsConsumedConcurrently?: number;
+    /** Register KafkaJsInstrumentation with OTel SDK. Default: true if OTel available */
+    enableOtelInstrumentation?: boolean;
+    /** Auto-create topics via admin client before subscribing. Default: false */
+    autoCreateTopics?: boolean;
+    /** Custom logger. Default: ConsoleSagaLogger */
+    logger?: SagaLogger;
+}
+
+declare class KafkaTransport implements SagaTransport {
+    private options;
+    private kafka;
+    private producer;
+    private consumer;
+    private logger;
+    constructor(options: KafkaTransportOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    publish(message: OutboundMessage): Promise<void>;
+    subscribe(topics: string[], handler: (message: InboundMessage) => Promise<void>, options?: TransportSubscribeOptions): Promise<void>;
+    private ensureTopicsExist;
+    private connectConsumerWithRetry;
+    private processBatch;
+    private convertHeaders;
+}
+
+export { KafkaTransport, type KafkaTransportOptions };

package/dist/index.js

@@ -0,0 +1,191 @@
+// src/kafka.transport.ts
+import { Kafka, logLevel } from "kafkajs";
+import { ConsoleSagaLogger } from "@fbsm/saga-core";
+
+// src/watermark-tracker.ts
+var WatermarkTracker = class {
+  arrivedOffsets = [];
+  completed = /* @__PURE__ */ new Set();
+  reset(offsets) {
+    this.arrivedOffsets = offsets;
+    this.completed.clear();
+  }
+  markCompleted(offset) {
+    this.completed.add(offset);
+  }
+  getCommittableOffset() {
+    let lastSafe = null;
+    for (const offset of this.arrivedOffsets) {
+      if (this.completed.has(offset)) {
+        lastSafe = offset;
+      } else {
+        break;
+      }
+    }
+    return lastSafe;
+  }
+};
+
+// src/kafka.transport.ts
+var KafkaTransport = class {
+  constructor(options) {
+    this.options = options;
+    this.logger = options.logger ?? new ConsoleSagaLogger();
+    this.kafka = new Kafka({
+      clientId: options.clientId ?? "saga-client",
+      brokers: options.brokers,
+      ssl: options.ssl,
+      sasl: options.sasl,
+      connectionTimeout: options.connectionTimeout,
+      authenticationTimeout: options.authenticationTimeout,
+      requestTimeout: options.requestTimeout,
+      retry: options.retry ?? {
+        initialRetryTime: 300,
+        retries: 10
+      },
+      logLevel: options.logLevel ?? logLevel.WARN,
+      socketFactory: options.socketFactory
+    });
+    this.producer = this.kafka.producer();
+  }
+  kafka;
+  producer;
+  consumer = null;
+  logger;
+  async connect() {
+    await this.producer.connect();
+  }
+  async disconnect() {
+    await this.producer.disconnect();
+    if (this.consumer) {
+      await this.consumer.disconnect();
+    }
+  }
+  async publish(message) {
+    await this.producer.send({
+      topic: message.topic,
+      messages: [
+        {
+          key: message.key,
+          value: message.value,
+          headers: message.headers
+        }
+      ]
+    });
+  }
+  async subscribe(topics, handler, options) {
+    const groupId = options?.groupId ?? "saga-default-group";
+    if (this.options.autoCreateTopics) {
+      await this.ensureTopicsExist(topics);
+    }
+    await this.connectConsumerWithRetry(groupId, topics, handler, options);
+  }
+  async ensureTopicsExist(topics) {
+    const admin = this.kafka.admin();
+    await admin.connect();
+    try {
+      const existing = await admin.listTopics();
+      const missing = topics.filter((t) => !existing.includes(t));
+      if (missing.length > 0) {
+        await admin.createTopics({
+          topics: missing.map((t) => ({ topic: t, numPartitions: 3, replicationFactor: 1 }))
+        });
+      }
+    } finally {
+      await admin.disconnect();
+    }
+  }
+  async connectConsumerWithRetry(groupId, topics, handler, options, maxAttempts = 10) {
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      try {
+        this.consumer = this.kafka.consumer({
+          groupId,
+          retry: { initialRetryTime: 500, retries: 8 }
+        });
+        await this.consumer.connect();
+        for (const topic of topics) {
+          await this.consumer.subscribe({
+            topic,
+            fromBeginning: options?.fromBeginning ?? false
+          });
+        }
+        await this.consumer.run({
+          partitionsConsumedConcurrently: this.options.partitionsConsumedConcurrently ?? 3,
+          eachBatch: async (payload) => {
+            await this.processBatch(payload, handler);
+          }
+        });
+        return;
+      } catch (err) {
+        this.logger.warn(
+          `[KafkaTransport] Consumer failed to start (attempt ${attempt}/${maxAttempts}): ${err.message}`
+        );
+        try {
+          await this.consumer?.disconnect();
+        } catch {
+        }
+        this.consumer = null;
+        if (attempt === maxAttempts) {
+          throw err;
+        }
+        const delay = Math.min(1e3 * Math.pow(2, attempt - 1), 1e4);
+        await new Promise((r) => setTimeout(r, delay));
+      }
+    }
+  }
+  async processBatch(payload, handler) {
+    const { batch, resolveOffset, heartbeat, isRunning, isStale } = payload;
+    const tracker = new WatermarkTracker();
+    const offsets = batch.messages.map((m) => m.offset);
+    tracker.reset(offsets);
+    const groups = /* @__PURE__ */ new Map();
+    for (const message of batch.messages) {
+      const key = message.key?.toString() ?? "__no_key__";
+      if (!groups.has(key)) {
+        groups.set(key, []);
+      }
+      groups.get(key).push(message);
+    }
+    await Promise.all(
+      Array.from(groups.entries()).map(async ([, messages]) => {
+        for (const message of messages) {
+          if (!isRunning() || isStale()) {
+            return;
+          }
+          const inbound = {
+            topic: batch.topic,
+            key: message.key?.toString() ?? "",
+            value: message.value?.toString() ?? "",
+            headers: this.convertHeaders(message.headers)
+          };
+          await handler(inbound);
+          tracker.markCompleted(message.offset);
+          const committable = tracker.getCommittableOffset();
+          if (committable) {
+            resolveOffset(committable);
+          }
+          await heartbeat();
+        }
+      })
+    );
+  }
+  convertHeaders(headers) {
+    const result = {};
+    if (!headers) return result;
+    for (const [key, value] of Object.entries(headers)) {
+      if (Buffer.isBuffer(value)) {
+        result[key] = value.toString();
+      } else if (typeof value === "string") {
+        result[key] = value;
+      } else if (Array.isArray(value) && value.length > 0) {
+        const first = value[0];
+        result[key] = Buffer.isBuffer(first) ? first.toString() : String(first);
+      }
+    }
+    return result;
+  }
+};
+export {
+  KafkaTransport
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/kafka.transport.ts","../src/watermark-tracker.ts"],"sourcesContent":["import { Kafka, Producer, Consumer, EachBatchPayload, IHeaders, logLevel } from 'kafkajs';\nimport type {\n  SagaTransport,\n  InboundMessage,\n  OutboundMessage,\n  TransportSubscribeOptions,\n  SagaLogger,\n} from '@fbsm/saga-core';\nimport { ConsoleSagaLogger } from '@fbsm/saga-core';\nimport { WatermarkTracker } from './watermark-tracker';\nimport type { KafkaTransportOptions } from './kafka-transport-options';\n\nexport class KafkaTransport implements SagaTransport {\n  private kafka: Kafka;\n  private producer: Producer;\n  private consumer: Consumer | null = null;\n  private logger: SagaLogger;\n\n  constructor(private options: KafkaTransportOptions) {\n    this.logger = options.logger ?? new ConsoleSagaLogger();\n    this.kafka = new Kafka({\n      clientId: options.clientId ?? 'saga-client',\n      brokers: options.brokers,\n      ssl: options.ssl,\n      sasl: options.sasl,\n      connectionTimeout: options.connectionTimeout,\n      authenticationTimeout: options.authenticationTimeout,\n      requestTimeout: options.requestTimeout,\n      retry: options.retry ?? {\n        initialRetryTime: 300,\n        retries: 10,\n      },\n      logLevel: options.logLevel ?? logLevel.WARN,\n      socketFactory: options.socketFactory,\n    });\n    this.producer = this.kafka.producer();\n  }\n\n  async connect(): Promise<void> {\n    await this.producer.connect();\n  }\n\n  async disconnect(): Promise<void> {\n    await this.producer.disconnect();\n    if (this.consumer) {\n      await this.consumer.disconnect();\n    }\n  }\n\n  async publish(message: OutboundMessage): Promise<void> {\n    await this.producer.send({\n      topic: message.topic,\n      messages: [\n        {\n          key: message.key,\n          value: message.value,\n          headers: message.headers,\n        },\n      ],\n    });\n  }\n\n  async subscribe(\n    topics: string[],\n    handler: (message: InboundMessage) => Promise<void>,\n    options?: TransportSubscribeOptions,\n  ): Promise<void> {\n    const groupId = options?.groupId ?? 'saga-default-group';\n\n    if (this.options.autoCreateTopics) {\n      await this.ensureTopicsExist(topics);\n    }\n\n    await this.connectConsumerWithRetry(groupId, topics, handler, options);\n  }\n\n  private async ensureTopicsExist(topics: string[]): Promise<void> {\n    const admin = this.kafka.admin();\n    await admin.connect();\n    try {\n      const existing = await admin.listTopics();\n      const missing = topics.filter((t) => !existing.includes(t));\n      if (missing.length > 0) {\n        await admin.createTopics({\n          topics: missing.map((t) => ({ topic: t, numPartitions: 3, replicationFactor: 1 })),\n        });\n      }\n    } finally {\n      await admin.disconnect();\n    }\n  }\n\n  private async connectConsumerWithRetry(\n    groupId: string,\n    topics: string[],\n    handler: (message: InboundMessage) => Promise<void>,\n    options?: TransportSubscribeOptions,\n    maxAttempts = 10,\n  ): Promise<void> {\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        this.consumer = this.kafka.consumer({\n          groupId,\n          retry: { initialRetryTime: 500, retries: 8 },\n        });\n\n        await this.consumer.connect();\n\n        for (const topic of topics) {\n          await this.consumer.subscribe({\n            topic,\n            fromBeginning: options?.fromBeginning ?? false,\n          });\n        }\n\n        await this.consumer.run({\n          partitionsConsumedConcurrently: this.options.partitionsConsumedConcurrently ?? 3,\n          eachBatch: async (payload: EachBatchPayload) => {\n            await this.processBatch(payload, handler);\n          },\n        });\n\n        return;\n      } catch (err) {\n        this.logger.warn(\n          `[KafkaTransport] Consumer failed to start (attempt ${attempt}/${maxAttempts}): ${(err as Error).message}`,\n        );\n\n        try {\n          await this.consumer?.disconnect();\n        } catch {\n          // ignore disconnect errors\n        }\n        this.consumer = null;\n\n        if (attempt === maxAttempts) {\n          throw err;\n        }\n\n        const delay = Math.min(1000 * Math.pow(2, attempt - 1), 10000);\n        await new Promise((r) => setTimeout(r, delay));\n      }\n    }\n  }\n\n  private async processBatch(\n    payload: EachBatchPayload,\n    handler: (message: InboundMessage) => Promise<void>,\n  ): Promise<void> {\n    const { batch, resolveOffset, heartbeat, isRunning, isStale } = payload;\n    const tracker = new WatermarkTracker();\n\n    const offsets = batch.messages.map((m) => m.offset);\n    tracker.reset(offsets);\n\n    // Group messages by key (sagaId) for ordered processing within saga\n    const groups = new Map<string, typeof batch.messages>();\n\n    for (const message of batch.messages) {\n      const key = message.key?.toString() ?? '__no_key__';\n      if (!groups.has(key)) {\n        groups.set(key, []);\n      }\n      groups.get(key)!.push(message);\n    }\n\n    // Process groups in parallel, messages within each group sequentially\n    await Promise.all(\n      Array.from(groups.entries()).map(async ([, messages]) => {\n        for (const message of messages) {\n          if (!isRunning() || isStale()) {\n            return;\n          }\n\n          const inbound: InboundMessage = {\n            topic: batch.topic,\n            key: message.key?.toString() ?? '',\n            value: message.value?.toString() ?? '',\n            headers: this.convertHeaders(message.headers),\n          };\n\n          await handler(inbound);\n\n          tracker.markCompleted(message.offset);\n          const committable = tracker.getCommittableOffset();\n          if (committable) {\n            resolveOffset(committable);\n          }\n\n          await heartbeat();\n        }\n      }),\n    );\n  }\n\n  private convertHeaders(headers?: IHeaders): Record<string, string> {\n    const result: Record<string, string> = {};\n    if (!headers) return result;\n\n    for (const [key, value] of Object.entries(headers)) {\n      if (Buffer.isBuffer(value)) {\n        result[key] = value.toString();\n      } else if (typeof value === 'string') {\n        result[key] = value;\n      } else if (Array.isArray(value) && value.length > 0) {\n        const first = value[0];\n        result[key] = Buffer.isBuffer(first) ? first.toString() : String(first);\n      }\n    }\n\n    return result;\n  }\n}\n","export class WatermarkTracker {\n  private arrivedOffsets: string[] = [];\n  private completed = new Set<string>();\n\n  reset(offsets: string[]): void {\n    this.arrivedOffsets = offsets;\n    this.completed.clear();\n  }\n\n  markCompleted(offset: string): void {\n    this.completed.add(offset);\n  }\n\n  getCommittableOffset(): string | null {\n    let lastSafe: string | null = null;\n    for (const offset of this.arrivedOffsets) {\n      if (this.completed.has(offset)) {\n        lastSafe = offset;\n      } else {\n        break;\n      }\n    }\n    return lastSafe;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@fbsm/saga-transport-kafka",
+  "version": "0.0.1-beta.0",
+  "description": "KafkaJS transport adapter for saga choreography: eachBatch, watermark offset tracking",
+  "license": "MIT",
+  "author": "fbsm",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fbsm/saga-library",
+    "directory": "packages/saga-transport-kafka"
+  },
+  "keywords": [
+    "saga",
+    "kafka",
+    "kafkajs",
+    "transport",
+    "microservices",
+    "event-driven"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "kafkajs": "^2.2.0",
+    "@fbsm/saga-core": "0.0.1-beta.0"
+  },
+  "peerDependencies": {
+    "@opentelemetry/instrumentation-kafkajs": "^0.7.0"
+  },
+  "peerDependenciesMeta": {
+    "@opentelemetry/instrumentation-kafkajs": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}