@eventferry/kafka 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Samet GOKTEPE
+
+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,5 @@
+# @eventferry/kafka
+
+Kafka/Redpanda publisher for [eventferry](https://github.com/your-org/eventferry). One `KafkaPublisher` over two interchangeable drivers: `kafkajs` and `@confluentinc/kafka-javascript`. Idempotent + transactional producers, DLQ routing.
+
+See the [root README](../../README.md) for usage.

package/dist/index.cjs

@@ -0,0 +1,287 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ConfluentDriver: () => ConfluentDriver,
+  KafkaJsDriver: () => KafkaJsDriver,
+  KafkaPublisher: () => KafkaPublisher
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/kafkajs-driver.ts
+var KafkaJsDriver = class {
+  transactional;
+  producer = null;
+  opts;
+  constructor(opts) {
+    this.opts = opts;
+    this.transactional = opts.transactional ?? false;
+    if (this.transactional && !opts.transactionalId) {
+      throw new Error(
+        "KafkaJsDriver: transactionalId is required when transactional=true"
+      );
+    }
+  }
+  async connect() {
+    this.producer = await this.createProducer();
+    await this.producer.connect();
+  }
+  /**
+   * Construct the underlying kafkajs producer. Overridable as a test seam so
+   * the send/transaction logic can be exercised without a real broker.
+   */
+  async createProducer() {
+    const mod = await importKafkaJs();
+    const kafka = new mod.Kafka({
+      clientId: this.opts.clientId ?? "eventferry",
+      brokers: this.opts.brokers,
+      ssl: this.opts.ssl,
+      sasl: this.opts.sasl
+    });
+    return kafka.producer({
+      idempotent: this.opts.idempotent ?? true,
+      maxInFlightRequests: this.transactional ? 1 : void 0,
+      transactionalId: this.transactional ? this.opts.transactionalId : void 0
+    });
+  }
+  async disconnect() {
+    await this.producer?.disconnect();
+    this.producer = null;
+  }
+  async sendBatch(messages) {
+    if (!this.producer) throw new Error("KafkaJsDriver not connected");
+    const topicMessages = groupByTopic(messages, this.opts.compression);
+    if (this.transactional) {
+      const txn = await this.producer.transaction();
+      try {
+        await txn.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });
+        await txn.commit();
+        return messages.map((m) => ({ recordId: m.recordId, ok: true }));
+      } catch (err) {
+        await txn.abort().catch(() => void 0);
+        const error = err instanceof Error ? err : new Error(String(err));
+        return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));
+      }
+    }
+    try {
+      await this.producer.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });
+      return messages.map((m) => ({ recordId: m.recordId, ok: true }));
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));
+    }
+  }
+};
+function groupByTopic(messages, compression) {
+  const byTopic = /* @__PURE__ */ new Map();
+  for (const m of messages) {
+    const arr = byTopic.get(m.topic) ?? [];
+    arr.push({
+      key: m.key,
+      value: m.value,
+      headers: m.headers
+    });
+    byTopic.set(m.topic, arr);
+  }
+  return [...byTopic.entries()].map(([topic, msgs]) => ({
+    topic,
+    messages: msgs,
+    ...compression && compression !== "none" ? { compression } : {}
+  }));
+}
+async function importKafkaJs() {
+  try {
+    return await import("kafkajs");
+  } catch {
+    throw new Error(
+      'Driver "kafkajs" selected but the "kafkajs" package is not installed. Run: npm i kafkajs'
+    );
+  }
+}
+
+// src/confluent-driver.ts
+var ConfluentDriver = class {
+  transactional;
+  producer = null;
+  opts;
+  constructor(opts) {
+    this.opts = opts;
+    this.transactional = opts.transactional ?? false;
+    if (this.transactional && !opts.transactionalId) {
+      throw new Error(
+        "ConfluentDriver: transactionalId is required when transactional=true"
+      );
+    }
+  }
+  async connect() {
+    this.producer = await this.createProducer();
+    await this.producer.connect();
+  }
+  /**
+   * Construct the underlying confluent producer. Overridable as a test seam so
+   * the send/transaction logic can be exercised without a real broker.
+   */
+  async createProducer() {
+    const mod = await importConfluent();
+    const kafka = new mod.KafkaJS.Kafka({
+      kafkaJS: {
+        clientId: this.opts.clientId ?? "eventferry",
+        brokers: this.opts.brokers,
+        ssl: this.opts.ssl,
+        sasl: this.opts.sasl
+      }
+    });
+    return kafka.producer({
+      kafkaJS: {
+        idempotent: this.opts.idempotent ?? true,
+        ...this.transactional ? { transactionalId: this.opts.transactionalId } : {}
+      }
+    });
+  }
+  async disconnect() {
+    await this.producer?.disconnect();
+    this.producer = null;
+  }
+  async sendBatch(messages) {
+    if (!this.producer) throw new Error("ConfluentDriver not connected");
+    const topicMessages = groupByTopic2(messages);
+    const acks = this.opts.acks ?? -1;
+    const compression = this.opts.compression;
+    const doSends = async (target) => {
+      for (const tm of topicMessages) {
+        await target.send({
+          topic: tm.topic,
+          messages: tm.messages,
+          acks,
+          ...compression && compression !== "none" ? { compression } : {}
+        });
+      }
+    };
+    if (this.transactional) {
+      const txn = await this.producer.transaction();
+      try {
+        await doSends(txn);
+        await txn.commit();
+        return messages.map((m) => ({ recordId: m.recordId, ok: true }));
+      } catch (err) {
+        await txn.abort().catch(() => void 0);
+        const error = err instanceof Error ? err : new Error(String(err));
+        return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));
+      }
+    }
+    try {
+      await doSends(this.producer);
+      return messages.map((m) => ({ recordId: m.recordId, ok: true }));
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));
+    }
+  }
+};
+function groupByTopic2(messages) {
+  const byTopic = /* @__PURE__ */ new Map();
+  for (const m of messages) {
+    const arr = byTopic.get(m.topic) ?? [];
+    arr.push({ key: m.key, value: m.value, headers: m.headers });
+    byTopic.set(m.topic, arr);
+  }
+  return [...byTopic.entries()].map(([topic, msgs]) => ({
+    topic,
+    messages: msgs
+  }));
+}
+async function importConfluent() {
+  try {
+    return await import("@confluentinc/kafka-javascript");
+  } catch {
+    throw new Error(
+      'Driver "confluent" selected but "@confluentinc/kafka-javascript" is not installed. Run: npm i @confluentinc/kafka-javascript'
+    );
+  }
+}
+
+// src/publisher.ts
+var KafkaPublisher = class {
+  driver;
+  constructor(opts) {
+    this.driver = opts.customDriver ?? selectDriver(opts);
+  }
+  connect() {
+    return this.driver.connect();
+  }
+  disconnect() {
+    return this.driver.disconnect();
+  }
+  publish(messages) {
+    return this.driver.sendBatch(messages);
+  }
+  /**
+   * Send a single dead-lettered message. The message already carries the
+   * DLQ topic (the Relay rewrites it), plus the failure reason as a header.
+   */
+  async publishToDlq(message, error) {
+    const dlqMessage = {
+      ...message,
+      headers: {
+        ...message.headers,
+        "dlq-reason": error.message,
+        "dlq-original-topic": message.headers["original-topic"] ?? "",
+        "dlq-failed-at": (/* @__PURE__ */ new Date()).toISOString()
+      }
+    };
+    const [result] = await this.driver.sendBatch([dlqMessage]);
+    if (result && !result.ok) {
+      throw result.error ?? new Error("DLQ publish failed");
+    }
+  }
+  /** Whether the configured driver provides atomic (EOS) batch sends. */
+  get transactional() {
+    return this.driver.transactional;
+  }
+};
+function selectDriver(opts) {
+  const kind = opts.driver ?? "kafkajs";
+  switch (kind) {
+    case "kafkajs":
+      return new KafkaJsDriver(opts);
+    case "confluent":
+      return new ConfluentDriver(opts);
+    default:
+      throw new Error(`Unknown driver "${kind}"`);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConfluentDriver,
+  KafkaJsDriver,
+  KafkaPublisher
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/kafkajs-driver.ts","../src/confluent-driver.ts","../src/publisher.ts"],"sourcesContent":["export * from \"./driver.js\";\nexport * from \"./kafkajs-driver.js\";\nexport * from \"./confluent-driver.js\";\nexport * from \"./publisher.js\";\n","import type { PublishableMessage, PublishResult } from \"@eventferry/core\";\nimport type {\n  KafkaConnectionConfig,\n  KafkaDriver,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\n\n// Loosely-typed structural references to the kafkajs API so this file\n// compiles without kafkajs installed (it's an optional peer dep).\ninterface KjsProducer {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  // kafkajs: sendBatch takes { topicMessages }, send takes a single { topic, messages }.\n  sendBatch(args: unknown): Promise<unknown>;\n  transaction(): Promise<KjsTransaction>;\n}\ninterface KjsTransaction {\n  sendBatch(args: unknown): Promise<unknown>;\n  commit(): Promise<void>;\n  abort(): Promise<void>;\n}\ninterface KjsKafka {\n  producer(args?: unknown): KjsProducer;\n}\n\nexport interface KafkaJsDriverOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {}\n\n/**\n * Driver backed by the pure-JS `kafkajs` client. Simple, zero native deps.\n */\nexport class KafkaJsDriver implements KafkaDriver {\n  readonly transactional: boolean;\n  private producer: KjsProducer | null = null;\n  private readonly opts: KafkaJsDriverOptions;\n\n  constructor(opts: KafkaJsDriverOptions) {\n    this.opts = opts;\n    this.transactional = opts.transactional ?? false;\n    if (this.transactional && !opts.transactionalId) {\n      throw new Error(\n        \"KafkaJsDriver: transactionalId is required when transactional=true\",\n      );\n    }\n  }\n\n  async connect(): Promise<void> {\n    this.producer = await this.createProducer();\n    await this.producer.connect();\n  }\n\n  /**\n   * Construct the underlying kafkajs producer. Overridable as a test seam so\n   * the send/transaction logic can be exercised without a real broker.\n   */\n  protected async createProducer(): Promise<KjsProducer> {\n    const mod = await importKafkaJs();\n    const kafka: KjsKafka = new mod.Kafka({\n      clientId: this.opts.clientId ?? \"eventferry\",\n      brokers: this.opts.brokers,\n      ssl: this.opts.ssl,\n      sasl: this.opts.sasl,\n    });\n    return kafka.producer({\n      idempotent: this.opts.idempotent ?? true,\n      maxInFlightRequests: this.transactional ? 1 : undefined,\n      transactionalId: this.transactional ? this.opts.transactionalId : undefined,\n    });\n  }\n\n  async disconnect(): Promise<void> {\n    await this.producer?.disconnect();\n    this.producer = null;\n  }\n\n  async sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (!this.producer) throw new Error(\"KafkaJsDriver not connected\");\n    const topicMessages = groupByTopic(messages, this.opts.compression);\n\n    if (this.transactional) {\n      const txn = await this.producer.transaction();\n      try {\n        await txn.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });\n        await txn.commit();\n        return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n      } catch (err) {\n        await txn.abort().catch(() => undefined);\n        const error = err instanceof Error ? err : new Error(String(err));\n        return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));\n      }\n    }\n\n    try {\n      await this.producer.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });\n      return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));\n    }\n  }\n}\n\nfunction groupByTopic(messages: PublishableMessage[], compression?: string) {\n  const byTopic = new Map<string, unknown[]>();\n  for (const m of messages) {\n    const arr = byTopic.get(m.topic) ?? [];\n    arr.push({\n      key: m.key,\n      value: m.value,\n      headers: m.headers,\n    });\n    byTopic.set(m.topic, arr);\n  }\n  return [...byTopic.entries()].map(([topic, msgs]) => ({\n    topic,\n    messages: msgs,\n    ...(compression && compression !== \"none\" ? { compression } : {}),\n  }));\n}\n\nasync function importKafkaJs(): Promise<{ Kafka: new (cfg: unknown) => KjsKafka }> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (await import(\"kafkajs\")) as any;\n  } catch {\n    throw new Error(\n      'Driver \"kafkajs\" selected but the \"kafkajs\" package is not installed. Run: npm i kafkajs',\n    );\n  }\n}\n","import type { PublishableMessage, PublishResult } from \"@eventferry/core\";\nimport type {\n  KafkaConnectionConfig,\n  KafkaDriver,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\n\n// Structural typing of the confluent KafkaJS-compatible API surface so this\n// file compiles without the optional native dep installed.\ninterface CkProducer {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  send(args: unknown): Promise<unknown>;\n  transaction(): Promise<CkTransaction>;\n}\ninterface CkTransaction {\n  send(args: unknown): Promise<unknown>;\n  commit(): Promise<void>;\n  abort(): Promise<void>;\n}\ninterface CkKafka {\n  producer(args?: unknown): CkProducer;\n}\n\nexport interface ConfluentDriverOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {}\n\n/**\n * Driver backed by `@confluentinc/kafka-javascript` (librdkafka wrapper).\n * Higher throughput; uses the KafkaJS-compatible promisified API so the\n * adapter mirrors the kafkajs driver closely.\n */\nexport class ConfluentDriver implements KafkaDriver {\n  readonly transactional: boolean;\n  private producer: CkProducer | null = null;\n  private readonly opts: ConfluentDriverOptions;\n\n  constructor(opts: ConfluentDriverOptions) {\n    this.opts = opts;\n    this.transactional = opts.transactional ?? false;\n    if (this.transactional && !opts.transactionalId) {\n      throw new Error(\n        \"ConfluentDriver: transactionalId is required when transactional=true\",\n      );\n    }\n  }\n\n  async connect(): Promise<void> {\n    this.producer = await this.createProducer();\n    await this.producer.connect();\n  }\n\n  /**\n   * Construct the underlying confluent producer. Overridable as a test seam so\n   * the send/transaction logic can be exercised without a real broker.\n   */\n  protected async createProducer(): Promise<CkProducer> {\n    const mod = await importConfluent();\n    const kafka: CkKafka = new mod.KafkaJS.Kafka({\n      kafkaJS: {\n        clientId: this.opts.clientId ?? \"eventferry\",\n        brokers: this.opts.brokers,\n        ssl: this.opts.ssl,\n        sasl: this.opts.sasl,\n      },\n    });\n    return kafka.producer({\n      kafkaJS: {\n        idempotent: this.opts.idempotent ?? true,\n        ...(this.transactional\n          ? { transactionalId: this.opts.transactionalId }\n          : {}),\n      },\n    });\n  }\n\n  async disconnect(): Promise<void> {\n    await this.producer?.disconnect();\n    this.producer = null;\n  }\n\n  async sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (!this.producer) throw new Error(\"ConfluentDriver not connected\");\n    const topicMessages = groupByTopic(messages);\n    const acks = this.opts.acks ?? -1;\n    const compression = this.opts.compression;\n\n    const doSends = async (target: CkProducer | CkTransaction) => {\n      for (const tm of topicMessages) {\n        await target.send({\n          topic: tm.topic,\n          messages: tm.messages,\n          acks,\n          ...(compression && compression !== \"none\" ? { compression } : {}),\n        });\n      }\n    };\n\n    if (this.transactional) {\n      const txn = await this.producer.transaction();\n      try {\n        await doSends(txn);\n        await txn.commit();\n        return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n      } catch (err) {\n        await txn.abort().catch(() => undefined);\n        const error = err instanceof Error ? err : new Error(String(err));\n        return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));\n      }\n    }\n\n    try {\n      await doSends(this.producer);\n      return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));\n    }\n  }\n}\n\nfunction groupByTopic(messages: PublishableMessage[]) {\n  const byTopic = new Map<string, unknown[]>();\n  for (const m of messages) {\n    const arr = byTopic.get(m.topic) ?? [];\n    arr.push({ key: m.key, value: m.value, headers: m.headers });\n    byTopic.set(m.topic, arr);\n  }\n  return [...byTopic.entries()].map(([topic, msgs]) => ({\n    topic,\n    messages: msgs,\n  }));\n}\n\nasync function importConfluent(): Promise<{\n  KafkaJS: { Kafka: new (cfg: unknown) => CkKafka };\n}> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (await import(\"@confluentinc/kafka-javascript\")) as any;\n  } catch {\n    throw new Error(\n      'Driver \"confluent\" selected but \"@confluentinc/kafka-javascript\" is not installed. Run: npm i @confluentinc/kafka-javascript',\n    );\n  }\n}\n","import type {\n  PublishableMessage,\n  Publisher,\n  PublishResult,\n} from \"@eventferry/core\";\nimport { ConfluentDriver } from \"./confluent-driver.js\";\nimport type {\n  DriverKind,\n  KafkaConnectionConfig,\n  KafkaDriver,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\nimport { KafkaJsDriver } from \"./kafkajs-driver.js\";\n\nexport interface KafkaPublisherOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {\n  /** Which underlying client to use. Default \"kafkajs\". */\n  driver?: DriverKind;\n  /**\n   * Provide a fully custom driver instance instead of the built-ins.\n   * Useful for testing or unsupported clients.\n   */\n  customDriver?: KafkaDriver;\n}\n\n/**\n * The Publisher the Relay talks to. Wraps a pluggable KafkaDriver and\n * adds dead-letter routing. Works against Kafka and Redpanda identically\n * (Redpanda is Kafka-API compatible).\n */\nexport class KafkaPublisher implements Publisher {\n  private readonly driver: KafkaDriver;\n\n  constructor(opts: KafkaPublisherOptions) {\n    this.driver = opts.customDriver ?? selectDriver(opts);\n  }\n\n  connect(): Promise<void> {\n    return this.driver.connect();\n  }\n\n  disconnect(): Promise<void> {\n    return this.driver.disconnect();\n  }\n\n  publish(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    return this.driver.sendBatch(messages);\n  }\n\n  /**\n   * Send a single dead-lettered message. The message already carries the\n   * DLQ topic (the Relay rewrites it), plus the failure reason as a header.\n   */\n  async publishToDlq(message: PublishableMessage, error: Error): Promise<void> {\n    const dlqMessage: PublishableMessage = {\n      ...message,\n      headers: {\n        ...message.headers,\n        \"dlq-reason\": error.message,\n        \"dlq-original-topic\": message.headers[\"original-topic\"] ?? \"\",\n        \"dlq-failed-at\": new Date().toISOString(),\n      },\n    };\n    const [result] = await this.driver.sendBatch([dlqMessage]);\n    if (result && !result.ok) {\n      throw result.error ?? new Error(\"DLQ publish failed\");\n    }\n  }\n\n  /** Whether the configured driver provides atomic (EOS) batch sends. */\n  get transactional(): boolean {\n    return this.driver.transactional;\n  }\n}\n\nfunction selectDriver(opts: KafkaPublisherOptions): KafkaDriver {\n  const kind = opts.driver ?? \"kafkajs\";\n  switch (kind) {\n    case \"kafkajs\":\n      return new KafkaJsDriver(opts);\n    case \"confluent\":\n      return new ConfluentDriver(opts);\n    default:\n      throw new Error(`Unknown driver \"${kind}\"`);\n  }\n}\n"],"mappings":"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","names":["groupByTopic"]}

package/dist/index.d.cts

@@ -0,0 +1,144 @@
+import { PublishableMessage, PublishResult, Publisher } from '@eventferry/core';
+
+/**
+ * Low-level driver contract. Each concrete driver (kafkajs, confluent)
+ * adapts its native client to this minimal surface. The KafkaPublisher
+ * orchestrates batching, transactions and DLQ on top of it.
+ */
+interface KafkaDriver {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    /**
+     * Send a batch of records. The driver should preserve ordering for
+     * messages that share the same key (Kafka guarantees this per-partition).
+     * Returns one result per input message.
+     */
+    sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]>;
+    /**
+     * Whether this driver supports transactional (EOS) sends. The publisher
+     * uses this to decide whether `sendBatch` is atomic.
+     */
+    readonly transactional: boolean;
+}
+/** Shared connection config accepted by both drivers. */
+interface KafkaConnectionConfig {
+    brokers: string[];
+    clientId?: string;
+    ssl?: boolean;
+    sasl?: {
+        mechanism: "plain" | "scram-sha-256" | "scram-sha-512";
+        username: string;
+        password: string;
+    };
+}
+interface ProducerBehaviorConfig {
+    /** Enable idempotent producer (dedup + ordering). Default true. */
+    idempotent?: boolean;
+    /**
+     * Enable transactional producer for atomic batch publishing (EOS).
+     * Requires a stable transactionalId. Default false.
+     */
+    transactional?: boolean;
+    /** Required when transactional=true. Must be stable per producer instance. */
+    transactionalId?: string;
+    /** acks: -1/"all" (default), 0, or 1. */
+    acks?: number;
+    /** Compression codec. Driver maps to its native enum. */
+    compression?: "none" | "gzip" | "snappy" | "lz4" | "zstd";
+}
+type DriverKind = "kafkajs" | "confluent";
+
+interface KjsProducer {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    sendBatch(args: unknown): Promise<unknown>;
+    transaction(): Promise<KjsTransaction>;
+}
+interface KjsTransaction {
+    sendBatch(args: unknown): Promise<unknown>;
+    commit(): Promise<void>;
+    abort(): Promise<void>;
+}
+interface KafkaJsDriverOptions extends KafkaConnectionConfig, ProducerBehaviorConfig {
+}
+/**
+ * Driver backed by the pure-JS `kafkajs` client. Simple, zero native deps.
+ */
+declare class KafkaJsDriver implements KafkaDriver {
+    readonly transactional: boolean;
+    private producer;
+    private readonly opts;
+    constructor(opts: KafkaJsDriverOptions);
+    connect(): Promise<void>;
+    /**
+     * Construct the underlying kafkajs producer. Overridable as a test seam so
+     * the send/transaction logic can be exercised without a real broker.
+     */
+    protected createProducer(): Promise<KjsProducer>;
+    disconnect(): Promise<void>;
+    sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]>;
+}
+
+interface CkProducer {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(args: unknown): Promise<unknown>;
+    transaction(): Promise<CkTransaction>;
+}
+interface CkTransaction {
+    send(args: unknown): Promise<unknown>;
+    commit(): Promise<void>;
+    abort(): Promise<void>;
+}
+interface ConfluentDriverOptions extends KafkaConnectionConfig, ProducerBehaviorConfig {
+}
+/**
+ * Driver backed by `@confluentinc/kafka-javascript` (librdkafka wrapper).
+ * Higher throughput; uses the KafkaJS-compatible promisified API so the
+ * adapter mirrors the kafkajs driver closely.
+ */
+declare class ConfluentDriver implements KafkaDriver {
+    readonly transactional: boolean;
+    private producer;
+    private readonly opts;
+    constructor(opts: ConfluentDriverOptions);
+    connect(): Promise<void>;
+    /**
+     * Construct the underlying confluent producer. Overridable as a test seam so
+     * the send/transaction logic can be exercised without a real broker.
+     */
+    protected createProducer(): Promise<CkProducer>;
+    disconnect(): Promise<void>;
+    sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]>;
+}
+
+interface KafkaPublisherOptions extends KafkaConnectionConfig, ProducerBehaviorConfig {
+    /** Which underlying client to use. Default "kafkajs". */
+    driver?: DriverKind;
+    /**
+     * Provide a fully custom driver instance instead of the built-ins.
+     * Useful for testing or unsupported clients.
+     */
+    customDriver?: KafkaDriver;
+}
+/**
+ * The Publisher the Relay talks to. Wraps a pluggable KafkaDriver and
+ * adds dead-letter routing. Works against Kafka and Redpanda identically
+ * (Redpanda is Kafka-API compatible).
+ */
+declare class KafkaPublisher implements Publisher {
+    private readonly driver;
+    constructor(opts: KafkaPublisherOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    publish(messages: PublishableMessage[]): Promise<PublishResult[]>;
+    /**
+     * Send a single dead-lettered message. The message already carries the
+     * DLQ topic (the Relay rewrites it), plus the failure reason as a header.
+     */
+    publishToDlq(message: PublishableMessage, error: Error): Promise<void>;
+    /** Whether the configured driver provides atomic (EOS) batch sends. */
+    get transactional(): boolean;
+}
+
+export { ConfluentDriver, type ConfluentDriverOptions, type DriverKind, type KafkaConnectionConfig, type KafkaDriver, KafkaJsDriver, type KafkaJsDriverOptions, KafkaPublisher, type KafkaPublisherOptions, type ProducerBehaviorConfig };

package/dist/index.d.ts

@@ -0,0 +1,144 @@
+import { PublishableMessage, PublishResult, Publisher } from '@eventferry/core';
+
+/**
+ * Low-level driver contract. Each concrete driver (kafkajs, confluent)
+ * adapts its native client to this minimal surface. The KafkaPublisher
+ * orchestrates batching, transactions and DLQ on top of it.
+ */
+interface KafkaDriver {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    /**
+     * Send a batch of records. The driver should preserve ordering for
+     * messages that share the same key (Kafka guarantees this per-partition).
+     * Returns one result per input message.
+     */
+    sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]>;
+    /**
+     * Whether this driver supports transactional (EOS) sends. The publisher
+     * uses this to decide whether `sendBatch` is atomic.
+     */
+    readonly transactional: boolean;
+}
+/** Shared connection config accepted by both drivers. */
+interface KafkaConnectionConfig {
+    brokers: string[];
+    clientId?: string;
+    ssl?: boolean;
+    sasl?: {
+        mechanism: "plain" | "scram-sha-256" | "scram-sha-512";
+        username: string;
+        password: string;
+    };
+}
+interface ProducerBehaviorConfig {
+    /** Enable idempotent producer (dedup + ordering). Default true. */
+    idempotent?: boolean;
+    /**
+     * Enable transactional producer for atomic batch publishing (EOS).
+     * Requires a stable transactionalId. Default false.
+     */
+    transactional?: boolean;
+    /** Required when transactional=true. Must be stable per producer instance. */
+    transactionalId?: string;
+    /** acks: -1/"all" (default), 0, or 1. */
+    acks?: number;
+    /** Compression codec. Driver maps to its native enum. */
+    compression?: "none" | "gzip" | "snappy" | "lz4" | "zstd";
+}
+type DriverKind = "kafkajs" | "confluent";
+
+interface KjsProducer {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    sendBatch(args: unknown): Promise<unknown>;
+    transaction(): Promise<KjsTransaction>;
+}
+interface KjsTransaction {
+    sendBatch(args: unknown): Promise<unknown>;
+    commit(): Promise<void>;
+    abort(): Promise<void>;
+}
+interface KafkaJsDriverOptions extends KafkaConnectionConfig, ProducerBehaviorConfig {
+}
+/**
+ * Driver backed by the pure-JS `kafkajs` client. Simple, zero native deps.
+ */
+declare class KafkaJsDriver implements KafkaDriver {
+    readonly transactional: boolean;
+    private producer;
+    private readonly opts;
+    constructor(opts: KafkaJsDriverOptions);
+    connect(): Promise<void>;
+    /**
+     * Construct the underlying kafkajs producer. Overridable as a test seam so
+     * the send/transaction logic can be exercised without a real broker.
+     */
+    protected createProducer(): Promise<KjsProducer>;
+    disconnect(): Promise<void>;
+    sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]>;
+}
+
+interface CkProducer {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(args: unknown): Promise<unknown>;
+    transaction(): Promise<CkTransaction>;
+}
+interface CkTransaction {
+    send(args: unknown): Promise<unknown>;
+    commit(): Promise<void>;
+    abort(): Promise<void>;
+}
+interface ConfluentDriverOptions extends KafkaConnectionConfig, ProducerBehaviorConfig {
+}
+/**
+ * Driver backed by `@confluentinc/kafka-javascript` (librdkafka wrapper).
+ * Higher throughput; uses the KafkaJS-compatible promisified API so the
+ * adapter mirrors the kafkajs driver closely.
+ */
+declare class ConfluentDriver implements KafkaDriver {
+    readonly transactional: boolean;
+    private producer;
+    private readonly opts;
+    constructor(opts: ConfluentDriverOptions);
+    connect(): Promise<void>;
+    /**
+     * Construct the underlying confluent producer. Overridable as a test seam so
+     * the send/transaction logic can be exercised without a real broker.
+     */
+    protected createProducer(): Promise<CkProducer>;
+    disconnect(): Promise<void>;
+    sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]>;
+}
+
+interface KafkaPublisherOptions extends KafkaConnectionConfig, ProducerBehaviorConfig {
+    /** Which underlying client to use. Default "kafkajs". */
+    driver?: DriverKind;
+    /**
+     * Provide a fully custom driver instance instead of the built-ins.
+     * Useful for testing or unsupported clients.
+     */
+    customDriver?: KafkaDriver;
+}
+/**
+ * The Publisher the Relay talks to. Wraps a pluggable KafkaDriver and
+ * adds dead-letter routing. Works against Kafka and Redpanda identically
+ * (Redpanda is Kafka-API compatible).
+ */
+declare class KafkaPublisher implements Publisher {
+    private readonly driver;
+    constructor(opts: KafkaPublisherOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    publish(messages: PublishableMessage[]): Promise<PublishResult[]>;
+    /**
+     * Send a single dead-lettered message. The message already carries the
+     * DLQ topic (the Relay rewrites it), plus the failure reason as a header.
+     */
+    publishToDlq(message: PublishableMessage, error: Error): Promise<void>;
+    /** Whether the configured driver provides atomic (EOS) batch sends. */
+    get transactional(): boolean;
+}
+
+export { ConfluentDriver, type ConfluentDriverOptions, type DriverKind, type KafkaConnectionConfig, type KafkaDriver, KafkaJsDriver, type KafkaJsDriverOptions, KafkaPublisher, type KafkaPublisherOptions, type ProducerBehaviorConfig };

package/dist/index.js

@@ -0,0 +1,248 @@
+// src/kafkajs-driver.ts
+var KafkaJsDriver = class {
+  transactional;
+  producer = null;
+  opts;
+  constructor(opts) {
+    this.opts = opts;
+    this.transactional = opts.transactional ?? false;
+    if (this.transactional && !opts.transactionalId) {
+      throw new Error(
+        "KafkaJsDriver: transactionalId is required when transactional=true"
+      );
+    }
+  }
+  async connect() {
+    this.producer = await this.createProducer();
+    await this.producer.connect();
+  }
+  /**
+   * Construct the underlying kafkajs producer. Overridable as a test seam so
+   * the send/transaction logic can be exercised without a real broker.
+   */
+  async createProducer() {
+    const mod = await importKafkaJs();
+    const kafka = new mod.Kafka({
+      clientId: this.opts.clientId ?? "eventferry",
+      brokers: this.opts.brokers,
+      ssl: this.opts.ssl,
+      sasl: this.opts.sasl
+    });
+    return kafka.producer({
+      idempotent: this.opts.idempotent ?? true,
+      maxInFlightRequests: this.transactional ? 1 : void 0,
+      transactionalId: this.transactional ? this.opts.transactionalId : void 0
+    });
+  }
+  async disconnect() {
+    await this.producer?.disconnect();
+    this.producer = null;
+  }
+  async sendBatch(messages) {
+    if (!this.producer) throw new Error("KafkaJsDriver not connected");
+    const topicMessages = groupByTopic(messages, this.opts.compression);
+    if (this.transactional) {
+      const txn = await this.producer.transaction();
+      try {
+        await txn.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });
+        await txn.commit();
+        return messages.map((m) => ({ recordId: m.recordId, ok: true }));
+      } catch (err) {
+        await txn.abort().catch(() => void 0);
+        const error = err instanceof Error ? err : new Error(String(err));
+        return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));
+      }
+    }
+    try {
+      await this.producer.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });
+      return messages.map((m) => ({ recordId: m.recordId, ok: true }));
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));
+    }
+  }
+};
+function groupByTopic(messages, compression) {
+  const byTopic = /* @__PURE__ */ new Map();
+  for (const m of messages) {
+    const arr = byTopic.get(m.topic) ?? [];
+    arr.push({
+      key: m.key,
+      value: m.value,
+      headers: m.headers
+    });
+    byTopic.set(m.topic, arr);
+  }
+  return [...byTopic.entries()].map(([topic, msgs]) => ({
+    topic,
+    messages: msgs,
+    ...compression && compression !== "none" ? { compression } : {}
+  }));
+}
+async function importKafkaJs() {
+  try {
+    return await import("kafkajs");
+  } catch {
+    throw new Error(
+      'Driver "kafkajs" selected but the "kafkajs" package is not installed. Run: npm i kafkajs'
+    );
+  }
+}
+
+// src/confluent-driver.ts
+var ConfluentDriver = class {
+  transactional;
+  producer = null;
+  opts;
+  constructor(opts) {
+    this.opts = opts;
+    this.transactional = opts.transactional ?? false;
+    if (this.transactional && !opts.transactionalId) {
+      throw new Error(
+        "ConfluentDriver: transactionalId is required when transactional=true"
+      );
+    }
+  }
+  async connect() {
+    this.producer = await this.createProducer();
+    await this.producer.connect();
+  }
+  /**
+   * Construct the underlying confluent producer. Overridable as a test seam so
+   * the send/transaction logic can be exercised without a real broker.
+   */
+  async createProducer() {
+    const mod = await importConfluent();
+    const kafka = new mod.KafkaJS.Kafka({
+      kafkaJS: {
+        clientId: this.opts.clientId ?? "eventferry",
+        brokers: this.opts.brokers,
+        ssl: this.opts.ssl,
+        sasl: this.opts.sasl
+      }
+    });
+    return kafka.producer({
+      kafkaJS: {
+        idempotent: this.opts.idempotent ?? true,
+        ...this.transactional ? { transactionalId: this.opts.transactionalId } : {}
+      }
+    });
+  }
+  async disconnect() {
+    await this.producer?.disconnect();
+    this.producer = null;
+  }
+  async sendBatch(messages) {
+    if (!this.producer) throw new Error("ConfluentDriver not connected");
+    const topicMessages = groupByTopic2(messages);
+    const acks = this.opts.acks ?? -1;
+    const compression = this.opts.compression;
+    const doSends = async (target) => {
+      for (const tm of topicMessages) {
+        await target.send({
+          topic: tm.topic,
+          messages: tm.messages,
+          acks,
+          ...compression && compression !== "none" ? { compression } : {}
+        });
+      }
+    };
+    if (this.transactional) {
+      const txn = await this.producer.transaction();
+      try {
+        await doSends(txn);
+        await txn.commit();
+        return messages.map((m) => ({ recordId: m.recordId, ok: true }));
+      } catch (err) {
+        await txn.abort().catch(() => void 0);
+        const error = err instanceof Error ? err : new Error(String(err));
+        return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));
+      }
+    }
+    try {
+      await doSends(this.producer);
+      return messages.map((m) => ({ recordId: m.recordId, ok: true }));
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));
+    }
+  }
+};
+function groupByTopic2(messages) {
+  const byTopic = /* @__PURE__ */ new Map();
+  for (const m of messages) {
+    const arr = byTopic.get(m.topic) ?? [];
+    arr.push({ key: m.key, value: m.value, headers: m.headers });
+    byTopic.set(m.topic, arr);
+  }
+  return [...byTopic.entries()].map(([topic, msgs]) => ({
+    topic,
+    messages: msgs
+  }));
+}
+async function importConfluent() {
+  try {
+    return await import("@confluentinc/kafka-javascript");
+  } catch {
+    throw new Error(
+      'Driver "confluent" selected but "@confluentinc/kafka-javascript" is not installed. Run: npm i @confluentinc/kafka-javascript'
+    );
+  }
+}
+
+// src/publisher.ts
+var KafkaPublisher = class {
+  driver;
+  constructor(opts) {
+    this.driver = opts.customDriver ?? selectDriver(opts);
+  }
+  connect() {
+    return this.driver.connect();
+  }
+  disconnect() {
+    return this.driver.disconnect();
+  }
+  publish(messages) {
+    return this.driver.sendBatch(messages);
+  }
+  /**
+   * Send a single dead-lettered message. The message already carries the
+   * DLQ topic (the Relay rewrites it), plus the failure reason as a header.
+   */
+  async publishToDlq(message, error) {
+    const dlqMessage = {
+      ...message,
+      headers: {
+        ...message.headers,
+        "dlq-reason": error.message,
+        "dlq-original-topic": message.headers["original-topic"] ?? "",
+        "dlq-failed-at": (/* @__PURE__ */ new Date()).toISOString()
+      }
+    };
+    const [result] = await this.driver.sendBatch([dlqMessage]);
+    if (result && !result.ok) {
+      throw result.error ?? new Error("DLQ publish failed");
+    }
+  }
+  /** Whether the configured driver provides atomic (EOS) batch sends. */
+  get transactional() {
+    return this.driver.transactional;
+  }
+};
+function selectDriver(opts) {
+  const kind = opts.driver ?? "kafkajs";
+  switch (kind) {
+    case "kafkajs":
+      return new KafkaJsDriver(opts);
+    case "confluent":
+      return new ConfluentDriver(opts);
+    default:
+      throw new Error(`Unknown driver "${kind}"`);
+  }
+}
+export {
+  ConfluentDriver,
+  KafkaJsDriver,
+  KafkaPublisher
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/kafkajs-driver.ts","../src/confluent-driver.ts","../src/publisher.ts"],"sourcesContent":["import type { PublishableMessage, PublishResult } from \"@eventferry/core\";\nimport type {\n  KafkaConnectionConfig,\n  KafkaDriver,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\n\n// Loosely-typed structural references to the kafkajs API so this file\n// compiles without kafkajs installed (it's an optional peer dep).\ninterface KjsProducer {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  // kafkajs: sendBatch takes { topicMessages }, send takes a single { topic, messages }.\n  sendBatch(args: unknown): Promise<unknown>;\n  transaction(): Promise<KjsTransaction>;\n}\ninterface KjsTransaction {\n  sendBatch(args: unknown): Promise<unknown>;\n  commit(): Promise<void>;\n  abort(): Promise<void>;\n}\ninterface KjsKafka {\n  producer(args?: unknown): KjsProducer;\n}\n\nexport interface KafkaJsDriverOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {}\n\n/**\n * Driver backed by the pure-JS `kafkajs` client. Simple, zero native deps.\n */\nexport class KafkaJsDriver implements KafkaDriver {\n  readonly transactional: boolean;\n  private producer: KjsProducer | null = null;\n  private readonly opts: KafkaJsDriverOptions;\n\n  constructor(opts: KafkaJsDriverOptions) {\n    this.opts = opts;\n    this.transactional = opts.transactional ?? false;\n    if (this.transactional && !opts.transactionalId) {\n      throw new Error(\n        \"KafkaJsDriver: transactionalId is required when transactional=true\",\n      );\n    }\n  }\n\n  async connect(): Promise<void> {\n    this.producer = await this.createProducer();\n    await this.producer.connect();\n  }\n\n  /**\n   * Construct the underlying kafkajs producer. Overridable as a test seam so\n   * the send/transaction logic can be exercised without a real broker.\n   */\n  protected async createProducer(): Promise<KjsProducer> {\n    const mod = await importKafkaJs();\n    const kafka: KjsKafka = new mod.Kafka({\n      clientId: this.opts.clientId ?? \"eventferry\",\n      brokers: this.opts.brokers,\n      ssl: this.opts.ssl,\n      sasl: this.opts.sasl,\n    });\n    return kafka.producer({\n      idempotent: this.opts.idempotent ?? true,\n      maxInFlightRequests: this.transactional ? 1 : undefined,\n      transactionalId: this.transactional ? this.opts.transactionalId : undefined,\n    });\n  }\n\n  async disconnect(): Promise<void> {\n    await this.producer?.disconnect();\n    this.producer = null;\n  }\n\n  async sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (!this.producer) throw new Error(\"KafkaJsDriver not connected\");\n    const topicMessages = groupByTopic(messages, this.opts.compression);\n\n    if (this.transactional) {\n      const txn = await this.producer.transaction();\n      try {\n        await txn.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });\n        await txn.commit();\n        return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n      } catch (err) {\n        await txn.abort().catch(() => undefined);\n        const error = err instanceof Error ? err : new Error(String(err));\n        return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));\n      }\n    }\n\n    try {\n      await this.producer.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });\n      return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));\n    }\n  }\n}\n\nfunction groupByTopic(messages: PublishableMessage[], compression?: string) {\n  const byTopic = new Map<string, unknown[]>();\n  for (const m of messages) {\n    const arr = byTopic.get(m.topic) ?? [];\n    arr.push({\n      key: m.key,\n      value: m.value,\n      headers: m.headers,\n    });\n    byTopic.set(m.topic, arr);\n  }\n  return [...byTopic.entries()].map(([topic, msgs]) => ({\n    topic,\n    messages: msgs,\n    ...(compression && compression !== \"none\" ? { compression } : {}),\n  }));\n}\n\nasync function importKafkaJs(): Promise<{ Kafka: new (cfg: unknown) => KjsKafka }> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (await import(\"kafkajs\")) as any;\n  } catch {\n    throw new Error(\n      'Driver \"kafkajs\" selected but the \"kafkajs\" package is not installed. Run: npm i kafkajs',\n    );\n  }\n}\n","import type { PublishableMessage, PublishResult } from \"@eventferry/core\";\nimport type {\n  KafkaConnectionConfig,\n  KafkaDriver,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\n\n// Structural typing of the confluent KafkaJS-compatible API surface so this\n// file compiles without the optional native dep installed.\ninterface CkProducer {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  send(args: unknown): Promise<unknown>;\n  transaction(): Promise<CkTransaction>;\n}\ninterface CkTransaction {\n  send(args: unknown): Promise<unknown>;\n  commit(): Promise<void>;\n  abort(): Promise<void>;\n}\ninterface CkKafka {\n  producer(args?: unknown): CkProducer;\n}\n\nexport interface ConfluentDriverOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {}\n\n/**\n * Driver backed by `@confluentinc/kafka-javascript` (librdkafka wrapper).\n * Higher throughput; uses the KafkaJS-compatible promisified API so the\n * adapter mirrors the kafkajs driver closely.\n */\nexport class ConfluentDriver implements KafkaDriver {\n  readonly transactional: boolean;\n  private producer: CkProducer | null = null;\n  private readonly opts: ConfluentDriverOptions;\n\n  constructor(opts: ConfluentDriverOptions) {\n    this.opts = opts;\n    this.transactional = opts.transactional ?? false;\n    if (this.transactional && !opts.transactionalId) {\n      throw new Error(\n        \"ConfluentDriver: transactionalId is required when transactional=true\",\n      );\n    }\n  }\n\n  async connect(): Promise<void> {\n    this.producer = await this.createProducer();\n    await this.producer.connect();\n  }\n\n  /**\n   * Construct the underlying confluent producer. Overridable as a test seam so\n   * the send/transaction logic can be exercised without a real broker.\n   */\n  protected async createProducer(): Promise<CkProducer> {\n    const mod = await importConfluent();\n    const kafka: CkKafka = new mod.KafkaJS.Kafka({\n      kafkaJS: {\n        clientId: this.opts.clientId ?? \"eventferry\",\n        brokers: this.opts.brokers,\n        ssl: this.opts.ssl,\n        sasl: this.opts.sasl,\n      },\n    });\n    return kafka.producer({\n      kafkaJS: {\n        idempotent: this.opts.idempotent ?? true,\n        ...(this.transactional\n          ? { transactionalId: this.opts.transactionalId }\n          : {}),\n      },\n    });\n  }\n\n  async disconnect(): Promise<void> {\n    await this.producer?.disconnect();\n    this.producer = null;\n  }\n\n  async sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (!this.producer) throw new Error(\"ConfluentDriver not connected\");\n    const topicMessages = groupByTopic(messages);\n    const acks = this.opts.acks ?? -1;\n    const compression = this.opts.compression;\n\n    const doSends = async (target: CkProducer | CkTransaction) => {\n      for (const tm of topicMessages) {\n        await target.send({\n          topic: tm.topic,\n          messages: tm.messages,\n          acks,\n          ...(compression && compression !== \"none\" ? { compression } : {}),\n        });\n      }\n    };\n\n    if (this.transactional) {\n      const txn = await this.producer.transaction();\n      try {\n        await doSends(txn);\n        await txn.commit();\n        return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n      } catch (err) {\n        await txn.abort().catch(() => undefined);\n        const error = err instanceof Error ? err : new Error(String(err));\n        return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));\n      }\n    }\n\n    try {\n      await doSends(this.producer);\n      return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      return messages.map((m) => ({ recordId: m.recordId, ok: false, error }));\n    }\n  }\n}\n\nfunction groupByTopic(messages: PublishableMessage[]) {\n  const byTopic = new Map<string, unknown[]>();\n  for (const m of messages) {\n    const arr = byTopic.get(m.topic) ?? [];\n    arr.push({ key: m.key, value: m.value, headers: m.headers });\n    byTopic.set(m.topic, arr);\n  }\n  return [...byTopic.entries()].map(([topic, msgs]) => ({\n    topic,\n    messages: msgs,\n  }));\n}\n\nasync function importConfluent(): Promise<{\n  KafkaJS: { Kafka: new (cfg: unknown) => CkKafka };\n}> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (await import(\"@confluentinc/kafka-javascript\")) as any;\n  } catch {\n    throw new Error(\n      'Driver \"confluent\" selected but \"@confluentinc/kafka-javascript\" is not installed. Run: npm i @confluentinc/kafka-javascript',\n    );\n  }\n}\n","import type {\n  PublishableMessage,\n  Publisher,\n  PublishResult,\n} from \"@eventferry/core\";\nimport { ConfluentDriver } from \"./confluent-driver.js\";\nimport type {\n  DriverKind,\n  KafkaConnectionConfig,\n  KafkaDriver,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\nimport { KafkaJsDriver } from \"./kafkajs-driver.js\";\n\nexport interface KafkaPublisherOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {\n  /** Which underlying client to use. Default \"kafkajs\". */\n  driver?: DriverKind;\n  /**\n   * Provide a fully custom driver instance instead of the built-ins.\n   * Useful for testing or unsupported clients.\n   */\n  customDriver?: KafkaDriver;\n}\n\n/**\n * The Publisher the Relay talks to. Wraps a pluggable KafkaDriver and\n * adds dead-letter routing. Works against Kafka and Redpanda identically\n * (Redpanda is Kafka-API compatible).\n */\nexport class KafkaPublisher implements Publisher {\n  private readonly driver: KafkaDriver;\n\n  constructor(opts: KafkaPublisherOptions) {\n    this.driver = opts.customDriver ?? selectDriver(opts);\n  }\n\n  connect(): Promise<void> {\n    return this.driver.connect();\n  }\n\n  disconnect(): Promise<void> {\n    return this.driver.disconnect();\n  }\n\n  publish(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    return this.driver.sendBatch(messages);\n  }\n\n  /**\n   * Send a single dead-lettered message. The message already carries the\n   * DLQ topic (the Relay rewrites it), plus the failure reason as a header.\n   */\n  async publishToDlq(message: PublishableMessage, error: Error): Promise<void> {\n    const dlqMessage: PublishableMessage = {\n      ...message,\n      headers: {\n        ...message.headers,\n        \"dlq-reason\": error.message,\n        \"dlq-original-topic\": message.headers[\"original-topic\"] ?? \"\",\n        \"dlq-failed-at\": new Date().toISOString(),\n      },\n    };\n    const [result] = await this.driver.sendBatch([dlqMessage]);\n    if (result && !result.ok) {\n      throw result.error ?? new Error(\"DLQ publish failed\");\n    }\n  }\n\n  /** Whether the configured driver provides atomic (EOS) batch sends. */\n  get transactional(): boolean {\n    return this.driver.transactional;\n  }\n}\n\nfunction selectDriver(opts: KafkaPublisherOptions): KafkaDriver {\n  const kind = opts.driver ?? \"kafkajs\";\n  switch (kind) {\n    case \"kafkajs\":\n      return new KafkaJsDriver(opts);\n    case \"confluent\":\n      return new ConfluentDriver(opts);\n    default:\n      throw new Error(`Unknown driver \"${kind}\"`);\n  }\n}\n"],"mappings":"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","names":["groupByTopic"]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@eventferry/kafka",
+  "version": "1.0.0",
+  "description": "Kafka/Redpanda publisher for @eventferry (kafkajs + confluent drivers)",
+  "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"
+  ],
+  "keywords": [
+    "outbox",
+    "kafka",
+    "redpanda",
+    "kafkajs",
+    "confluent"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SametGoktepe/eventferry.git",
+    "directory": "packages/kafka"
+  },
+  "homepage": "https://github.com/SametGoktepe/eventferry/tree/main/packages/kafka#readme",
+  "bugs": "https://github.com/SametGoktepe/eventferry/issues",
+  "peerDependencies": {
+    "kafkajs": "^2.0.0",
+    "@confluentinc/kafka-javascript": "^1.0.0",
+    "@eventferry/core": "1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "kafkajs": {
+      "optional": true
+    },
+    "@confluentinc/kafka-javascript": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "kafkajs": "^2.2.4",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8",
+    "@eventferry/core": "1.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}