@eventferry/kafka 2.0.0 → 3.0.0

package/dist/index.cjs

@@ -32,10 +32,99 @@ var index_exports = {};
 __export(index_exports, {
   ConfluentDriver: () => ConfluentDriver,
   KafkaJsDriver: () => KafkaJsDriver,
-  KafkaPublisher: () => KafkaPublisher
+  KafkaPublisher: () => KafkaPublisher,
+  classifyConfluentError: () => classifyConfluentError,
+  classifyKafkajsError: () => classifyKafkajsError
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/kafkajs-classifier.ts
+function classifyKafkajsError(err) {
+  if (!err || typeof err !== "object") return "retriable";
+  const e = err;
+  if (e.name === "KafkaJSConnectionError") return "retriable";
+  if (e.name === "KafkaJSRequestTimeoutError") return "retriable";
+  if (e.name === "KafkaJSNonRetriableError") return "fatal";
+  const type = typeof e.type === "string" ? e.type : void 0;
+  if (type) {
+    if (RETRIABLE_TYPES.has(type)) return "retriable";
+    if (POISON_TYPES.has(type)) return "poison";
+    if (FATAL_TYPES.has(type)) return "fatal";
+  }
+  if (typeof e.code === "number") {
+    const k = CODE_TO_KIND.get(e.code);
+    if (k) return k;
+  }
+  return "retriable";
+}
+var RETRIABLE_TYPES = /* @__PURE__ */ new Set([
+  "NOT_LEADER_FOR_PARTITION",
+  "LEADER_NOT_AVAILABLE",
+  "UNKNOWN_TOPIC_OR_PARTITION",
+  "NETWORK_EXCEPTION",
+  "REQUEST_TIMED_OUT",
+  "REPLICA_NOT_AVAILABLE",
+  "NOT_ENOUGH_REPLICAS",
+  "NOT_ENOUGH_REPLICAS_AFTER_APPEND",
+  "FENCED_LEADER_EPOCH",
+  "UNKNOWN_LEADER_EPOCH",
+  "BROKER_NOT_AVAILABLE",
+  "COORDINATOR_LOAD_IN_PROGRESS",
+  "COORDINATOR_NOT_AVAILABLE"
+]);
+var POISON_TYPES = /* @__PURE__ */ new Set([
+  "CORRUPT_MESSAGE",
+  "MESSAGE_TOO_LARGE",
+  "INVALID_RECORD",
+  "UNSUPPORTED_COMPRESSION_TYPE",
+  "INVALID_REQUIRED_ACKS",
+  "INVALID_PARTITIONS"
+]);
+var FATAL_TYPES = /* @__PURE__ */ new Set([
+  "INVALID_PRODUCER_EPOCH",
+  "PRODUCER_FENCED",
+  "TOPIC_AUTHORIZATION_FAILED",
+  "CLUSTER_AUTHORIZATION_FAILED",
+  "TRANSACTIONAL_ID_AUTHORIZATION_FAILED",
+  "SASL_AUTHENTICATION_FAILED",
+  "INVALID_TRANSACTION_STATE",
+  "UNSUPPORTED_VERSION"
+]);
+var CODE_TO_KIND = /* @__PURE__ */ new Map([
+  [2, "poison"],
+  // CORRUPT_MESSAGE
+  [3, "retriable"],
+  // UNKNOWN_TOPIC_OR_PARTITION
+  [5, "retriable"],
+  // LEADER_NOT_AVAILABLE
+  [6, "retriable"],
+  // NOT_LEADER_FOR_PARTITION
+  [7, "retriable"],
+  // REQUEST_TIMED_OUT
+  [9, "retriable"],
+  // REPLICA_NOT_AVAILABLE
+  [10, "poison"],
+  // MESSAGE_TOO_LARGE
+  [13, "retriable"],
+  // NETWORK_EXCEPTION
+  [19, "retriable"],
+  // NOT_ENOUGH_REPLICAS
+  [29, "fatal"],
+  // TOPIC_AUTHORIZATION_FAILED
+  [31, "fatal"],
+  // CLUSTER_AUTHORIZATION_FAILED
+  [47, "fatal"],
+  // INVALID_PRODUCER_EPOCH
+  [58, "fatal"],
+  // SASL_AUTHENTICATION_FAILED
+  [74, "retriable"],
+  // FENCED_LEADER_EPOCH
+  [76, "poison"],
+  // UNSUPPORTED_COMPRESSION_TYPE
+  [87, "poison"]
+  // INVALID_RECORD
+]);
+
 // src/kafkajs-driver.ts
 var KafkaJsDriver = class {
   transactional;
@@ -87,19 +176,27 @@ var KafkaJsDriver = class {
         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 }));
+        return failedResults(messages, err);
       }
     }
     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 }));
+      return failedResults(messages, err);
     }
   }
 };
+function failedResults(messages, err) {
+  const error = err instanceof Error ? err : new Error(String(err));
+  const errorKind = classifyKafkajsError(err);
+  return messages.map((m) => ({
+    recordId: m.recordId,
+    ok: false,
+    error,
+    errorKind
+  }));
+}
 function groupByTopic(messages, compression) {
   const byTopic = /* @__PURE__ */ new Map();
   for (const m of messages) {
@@ -127,6 +224,104 @@ async function importKafkaJs() {
   }
 }
 
+// src/confluent-classifier.ts
+function classifyConfluentError(err) {
+  if (!err || typeof err !== "object") return "retriable";
+  const e = err;
+  if (typeof e.code === "number") {
+    const k = CODE_TO_KIND2.get(e.code);
+    if (k) return k;
+  }
+  if (typeof e.name === "string") {
+    const k = NAME_TO_KIND.get(e.name);
+    if (k) return k;
+  }
+  return "retriable";
+}
+var CODE_TO_KIND2 = /* @__PURE__ */ new Map([
+  // Library-internal (negative codes)
+  [-184, "backpressure"],
+  // ERR__QUEUE_FULL — our outbound buffer is full
+  [-185, "retriable"],
+  // ERR__TIMED_OUT
+  [-187, "retriable"],
+  // ERR__ALL_BROKERS_DOWN
+  [-188, "poison"],
+  // ERR__UNKNOWN_TOPIC — topic doesn't exist on broker
+  [-190, "poison"],
+  // ERR__UNKNOWN_PARTITION
+  [-192, "retriable"],
+  // ERR__MSG_TIMED_OUT
+  [-195, "retriable"],
+  // ERR__TRANSPORT
+  [-198, "poison"],
+  // ERR__BAD_COMPRESSION
+  [-144, "fatal"],
+  // ERR__FENCED — producer fenced by another with same txn id
+  [-150, "fatal"],
+  // ERR__FATAL — unrecoverable librdkafka error
+  [-169, "fatal"],
+  // ERR__AUTHENTICATION
+  [-181, "fatal"],
+  // ERR__SSL
+  [-196, "retriable"],
+  // ERR__FAIL — catch-all, safe-default to retriable
+  // Wire-protocol (non-negative codes — Kafka error-code registry)
+  [2, "poison"],
+  // CORRUPT_MESSAGE
+  [3, "retriable"],
+  // UNKNOWN_TOPIC_OR_PARTITION
+  [5, "retriable"],
+  // LEADER_NOT_AVAILABLE
+  [6, "retriable"],
+  // NOT_LEADER_FOR_PARTITION
+  [7, "retriable"],
+  // REQUEST_TIMED_OUT
+  [9, "retriable"],
+  // REPLICA_NOT_AVAILABLE
+  [10, "poison"],
+  // MESSAGE_TOO_LARGE
+  [13, "retriable"],
+  // NETWORK_EXCEPTION
+  [19, "retriable"],
+  // NOT_ENOUGH_REPLICAS
+  [29, "fatal"],
+  // TOPIC_AUTHORIZATION_FAILED
+  [31, "fatal"],
+  // CLUSTER_AUTHORIZATION_FAILED
+  [47, "fatal"],
+  // INVALID_PRODUCER_EPOCH
+  [58, "fatal"],
+  // SASL_AUTHENTICATION_FAILED
+  [74, "retriable"],
+  // FENCED_LEADER_EPOCH
+  [76, "poison"],
+  // UNSUPPORTED_COMPRESSION_TYPE
+  [87, "poison"],
+  // INVALID_RECORD
+  [89, "quota"]
+  // THROTTLING_QUOTA_EXCEEDED
+]);
+var NAME_TO_KIND = /* @__PURE__ */ new Map([
+  ["ERR__QUEUE_FULL", "backpressure"],
+  ["ERR__FENCED", "fatal"],
+  ["ERR__FATAL", "fatal"],
+  ["ERR__AUTHENTICATION", "fatal"],
+  ["ERR__SSL", "fatal"],
+  ["ERR__UNKNOWN_TOPIC", "poison"],
+  ["ERR__UNKNOWN_PARTITION", "poison"],
+  ["ERR__BAD_COMPRESSION", "poison"],
+  ["ERR_TOPIC_AUTHORIZATION_FAILED", "fatal"],
+  ["ERR_CLUSTER_AUTHORIZATION_FAILED", "fatal"],
+  ["ERR_INVALID_PRODUCER_EPOCH", "fatal"],
+  ["ERR_SASL_AUTHENTICATION_FAILED", "fatal"],
+  ["ERR_CORRUPT_MESSAGE", "poison"],
+  ["ERR_MSG_SIZE_TOO_LARGE", "poison"],
+  ["ERR_INVALID_RECORD", "poison"],
+  ["ERR_UNSUPPORTED_COMPRESSION_TYPE", "poison"],
+  ["ERR_THROTTLING_QUOTA_EXCEEDED", "quota"]
+]);
+
 // src/confluent-driver.ts
 var ConfluentDriver = class {
   transactional;
@@ -193,19 +388,27 @@ var ConfluentDriver = class {
         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 }));
+        return failedResults2(messages, err);
       }
     }
     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 }));
+      return failedResults2(messages, err);
     }
   }
 };
+function failedResults2(messages, err) {
+  const error = err instanceof Error ? err : new Error(String(err));
+  const errorKind = classifyConfluentError(err);
+  return messages.map((m) => ({
+    recordId: m.recordId,
+    ok: false,
+    error,
+    errorKind
+  }));
+}
 function groupByTopic2(messages) {
   const byTopic = /* @__PURE__ */ new Map();
   for (const m of messages) {
@@ -282,6 +485,8 @@ function selectDriver(opts) {
 0 && (module.exports = {
   ConfluentDriver,
   KafkaJsDriver,
-  KafkaPublisher
+  KafkaPublisher,
+  classifyConfluentError,
+  classifyKafkajsError
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +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"]}
+{"version":3,"sources":["../src/index.ts","../src/kafkajs-classifier.ts","../src/kafkajs-driver.ts","../src/confluent-classifier.ts","../src/confluent-driver.ts","../src/publisher.ts"],"sourcesContent":["export * from \"./driver.js\";\nexport * from \"./kafkajs-driver.js\";\nexport * from \"./kafkajs-classifier.js\";\nexport * from \"./confluent-driver.js\";\nexport * from \"./confluent-classifier.js\";\nexport * from \"./publisher.js\";\n","import type { PublishErrorKind } from \"@eventferry/core\";\n\n/**\n * Classify a kafkajs producer error into a {@link PublishErrorKind} so the\n * core relay can decide whether to retry, short-circuit to the DLQ, or pause\n * polling.\n *\n * Mapping verified against `kafkajs/src/errors.js` (v2.x). Protocol error\n * codes match the Kafka Protocol error-code registry. Library-specific\n * subclasses (`KafkaJSRequestTimeoutError`, `KafkaJSConnectionError`,\n * `KafkaJSNonRetriableError`) are matched by the `name` property kafkajs\n * sets on its Error subclasses.\n *\n * Unknown errors fall back to `\"retriable\"` — the safe bias. At worst we\n * retry an error that should have been skipped; in practice we'd rather\n * over-retry than mis-classify a transient blip as terminal.\n */\nexport function classifyKafkajsError(err: unknown): PublishErrorKind {\n  if (!err || typeof err !== \"object\") return \"retriable\";\n  const e = err as { name?: string; type?: string; code?: number };\n\n  // Class-based first — these don't carry a protocol error code.\n  if (e.name === \"KafkaJSConnectionError\") return \"retriable\";\n  if (e.name === \"KafkaJSRequestTimeoutError\") return \"retriable\";\n  if (e.name === \"KafkaJSNonRetriableError\") return \"fatal\";\n\n  // Protocol error type (string) — kafkajs's KafkaJSProtocolError exposes\n  // both `type` (uppercase string) and `code` (number). Use `type` first\n  // for readability and fall back to `code` for codes that lack a stable\n  // string label.\n  const type = typeof e.type === \"string\" ? e.type : undefined;\n  if (type) {\n    if (RETRIABLE_TYPES.has(type)) return \"retriable\";\n    if (POISON_TYPES.has(type)) return \"poison\";\n    if (FATAL_TYPES.has(type)) return \"fatal\";\n  }\n\n  if (typeof e.code === \"number\") {\n    const k = CODE_TO_KIND.get(e.code);\n    if (k) return k;\n  }\n\n  return \"retriable\";\n}\n\nconst RETRIABLE_TYPES = new Set<string>([\n  \"NOT_LEADER_FOR_PARTITION\",\n  \"LEADER_NOT_AVAILABLE\",\n  \"UNKNOWN_TOPIC_OR_PARTITION\",\n  \"NETWORK_EXCEPTION\",\n  \"REQUEST_TIMED_OUT\",\n  \"REPLICA_NOT_AVAILABLE\",\n  \"NOT_ENOUGH_REPLICAS\",\n  \"NOT_ENOUGH_REPLICAS_AFTER_APPEND\",\n  \"FENCED_LEADER_EPOCH\",\n  \"UNKNOWN_LEADER_EPOCH\",\n  \"BROKER_NOT_AVAILABLE\",\n  \"COORDINATOR_LOAD_IN_PROGRESS\",\n  \"COORDINATOR_NOT_AVAILABLE\",\n]);\n\nconst POISON_TYPES = new Set<string>([\n  \"CORRUPT_MESSAGE\",\n  \"MESSAGE_TOO_LARGE\",\n  \"INVALID_RECORD\",\n  \"UNSUPPORTED_COMPRESSION_TYPE\",\n  \"INVALID_REQUIRED_ACKS\",\n  \"INVALID_PARTITIONS\",\n]);\n\nconst FATAL_TYPES = new Set<string>([\n  \"INVALID_PRODUCER_EPOCH\",\n  \"PRODUCER_FENCED\",\n  \"TOPIC_AUTHORIZATION_FAILED\",\n  \"CLUSTER_AUTHORIZATION_FAILED\",\n  \"TRANSACTIONAL_ID_AUTHORIZATION_FAILED\",\n  \"SASL_AUTHENTICATION_FAILED\",\n  \"INVALID_TRANSACTION_STATE\",\n  \"UNSUPPORTED_VERSION\",\n]);\n\n/** Numeric fallback for clusters that only return the wire code. */\nconst CODE_TO_KIND: ReadonlyMap<number, PublishErrorKind> = new Map([\n  [2, \"poison\"], // CORRUPT_MESSAGE\n  [3, \"retriable\"], // UNKNOWN_TOPIC_OR_PARTITION\n  [5, \"retriable\"], // LEADER_NOT_AVAILABLE\n  [6, \"retriable\"], // NOT_LEADER_FOR_PARTITION\n  [7, \"retriable\"], // REQUEST_TIMED_OUT\n  [9, \"retriable\"], // REPLICA_NOT_AVAILABLE\n  [10, \"poison\"], // MESSAGE_TOO_LARGE\n  [13, \"retriable\"], // NETWORK_EXCEPTION\n  [19, \"retriable\"], // NOT_ENOUGH_REPLICAS\n  [29, \"fatal\"], // TOPIC_AUTHORIZATION_FAILED\n  [31, \"fatal\"], // CLUSTER_AUTHORIZATION_FAILED\n  [47, \"fatal\"], // INVALID_PRODUCER_EPOCH\n  [58, \"fatal\"], // SASL_AUTHENTICATION_FAILED\n  [74, \"retriable\"], // FENCED_LEADER_EPOCH\n  [76, \"poison\"], // UNSUPPORTED_COMPRESSION_TYPE\n  [87, \"poison\"], // INVALID_RECORD\n]);\n","import type { PublishableMessage, PublishResult } from \"@eventferry/core\";\nimport { classifyKafkajsError } from \"./kafkajs-classifier.js\";\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        return failedResults(messages, err);\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      return failedResults(messages, err);\n    }\n  }\n}\n\nfunction failedResults(\n  messages: PublishableMessage[],\n  err: unknown,\n): PublishResult[] {\n  const error = err instanceof Error ? err : new Error(String(err));\n  const errorKind = classifyKafkajsError(err);\n  return messages.map((m) => ({\n    recordId: m.recordId,\n    ok: false,\n    error,\n    errorKind,\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 { PublishErrorKind } from \"@eventferry/core\";\n\n/**\n * Classify a `@confluentinc/kafka-javascript` (librdkafka) producer error\n * into a {@link PublishErrorKind} so the core relay can decide whether to\n * retry, short-circuit to the DLQ, or pause polling.\n *\n * librdkafka exposes errors as numeric `RD_KAFKA_RESP_ERR_*` codes — negative\n * codes are library-internal (transport, queue-full, ssl), non-negative\n * codes are wire-protocol errors that match the Kafka protocol's error-code\n * registry. The confluent driver surfaces these on `err.code` (alongside\n * an `err.name` for the symbolic form).\n *\n * Unknown errors fall back to `\"retriable\"` — the safe bias.\n */\nexport function classifyConfluentError(err: unknown): PublishErrorKind {\n  if (!err || typeof err !== \"object\") return \"retriable\";\n  const e = err as { code?: number; name?: string };\n\n  if (typeof e.code === \"number\") {\n    const k = CODE_TO_KIND.get(e.code);\n    if (k) return k;\n  }\n\n  if (typeof e.name === \"string\") {\n    const k = NAME_TO_KIND.get(e.name);\n    if (k) return k;\n  }\n\n  return \"retriable\";\n}\n\n/**\n * Authoritative mapping for the most-common librdkafka producer error codes.\n * Sources: `librdkafka/src/rdkafka.h` (`RD_KAFKA_RESP_ERR_*` enum) and the\n * Kafka Protocol error-code registry. Adding a code here is a one-line\n * change — start narrow, broaden as production exposes new codes.\n */\nconst CODE_TO_KIND: ReadonlyMap<number, PublishErrorKind> = new Map([\n  // Library-internal (negative codes)\n  [-184, \"backpressure\"], // ERR__QUEUE_FULL — our outbound buffer is full\n  [-185, \"retriable\"], // ERR__TIMED_OUT\n  [-187, \"retriable\"], // ERR__ALL_BROKERS_DOWN\n  [-188, \"poison\"], // ERR__UNKNOWN_TOPIC — topic doesn't exist on broker\n  [-190, \"poison\"], // ERR__UNKNOWN_PARTITION\n  [-192, \"retriable\"], // ERR__MSG_TIMED_OUT\n  [-195, \"retriable\"], // ERR__TRANSPORT\n  [-198, \"poison\"], // ERR__BAD_COMPRESSION\n  [-144, \"fatal\"], // ERR__FENCED — producer fenced by another with same txn id\n  [-150, \"fatal\"], // ERR__FATAL — unrecoverable librdkafka error\n  [-169, \"fatal\"], // ERR__AUTHENTICATION\n  [-181, \"fatal\"], // ERR__SSL\n  [-196, \"retriable\"], // ERR__FAIL — catch-all, safe-default to retriable\n\n  // Wire-protocol (non-negative codes — Kafka error-code registry)\n  [2, \"poison\"], // CORRUPT_MESSAGE\n  [3, \"retriable\"], // UNKNOWN_TOPIC_OR_PARTITION\n  [5, \"retriable\"], // LEADER_NOT_AVAILABLE\n  [6, \"retriable\"], // NOT_LEADER_FOR_PARTITION\n  [7, \"retriable\"], // REQUEST_TIMED_OUT\n  [9, \"retriable\"], // REPLICA_NOT_AVAILABLE\n  [10, \"poison\"], // MESSAGE_TOO_LARGE\n  [13, \"retriable\"], // NETWORK_EXCEPTION\n  [19, \"retriable\"], // NOT_ENOUGH_REPLICAS\n  [29, \"fatal\"], // TOPIC_AUTHORIZATION_FAILED\n  [31, \"fatal\"], // CLUSTER_AUTHORIZATION_FAILED\n  [47, \"fatal\"], // INVALID_PRODUCER_EPOCH\n  [58, \"fatal\"], // SASL_AUTHENTICATION_FAILED\n  [74, \"retriable\"], // FENCED_LEADER_EPOCH\n  [76, \"poison\"], // UNSUPPORTED_COMPRESSION_TYPE\n  [87, \"poison\"], // INVALID_RECORD\n  [89, \"quota\"], // THROTTLING_QUOTA_EXCEEDED\n]);\n\n/** Symbolic name fallback for clients that surface `err.name` only. */\nconst NAME_TO_KIND: ReadonlyMap<string, PublishErrorKind> = new Map([\n  [\"ERR__QUEUE_FULL\", \"backpressure\"],\n  [\"ERR__FENCED\", \"fatal\"],\n  [\"ERR__FATAL\", \"fatal\"],\n  [\"ERR__AUTHENTICATION\", \"fatal\"],\n  [\"ERR__SSL\", \"fatal\"],\n  [\"ERR__UNKNOWN_TOPIC\", \"poison\"],\n  [\"ERR__UNKNOWN_PARTITION\", \"poison\"],\n  [\"ERR__BAD_COMPRESSION\", \"poison\"],\n  [\"ERR_TOPIC_AUTHORIZATION_FAILED\", \"fatal\"],\n  [\"ERR_CLUSTER_AUTHORIZATION_FAILED\", \"fatal\"],\n  [\"ERR_INVALID_PRODUCER_EPOCH\", \"fatal\"],\n  [\"ERR_SASL_AUTHENTICATION_FAILED\", \"fatal\"],\n  [\"ERR_CORRUPT_MESSAGE\", \"poison\"],\n  [\"ERR_MSG_SIZE_TOO_LARGE\", \"poison\"],\n  [\"ERR_INVALID_RECORD\", \"poison\"],\n  [\"ERR_UNSUPPORTED_COMPRESSION_TYPE\", \"poison\"],\n  [\"ERR_THROTTLING_QUOTA_EXCEEDED\", \"quota\"],\n]);\n","import type { PublishableMessage, PublishResult } from \"@eventferry/core\";\nimport { classifyConfluentError } from \"./confluent-classifier.js\";\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        return failedResults(messages, err);\n      }\n    }\n\n    try {\n      await doSends(this.producer);\n      return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n    } catch (err) {\n      return failedResults(messages, err);\n    }\n  }\n}\n\nfunction failedResults(\n  messages: PublishableMessage[],\n  err: unknown,\n): PublishResult[] {\n  const error = err instanceof Error ? err : new Error(String(err));\n  const errorKind = classifyConfluentError(err);\n  return messages.map((m) => ({\n    recordId: m.recordId,\n    ok: false,\n    error,\n    errorKind,\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":["CODE_TO_KIND","groupByTopic","failedResults"]}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { PublishableMessage, PublishResult, Publisher } from '@eventferry/core';
+import { PublishableMessage, PublishResult, PublishErrorKind, Publisher } from '@eventferry/core';
 
 /**
  * Low-level driver contract. Each concrete driver (kafkajs, confluent)
@@ -79,6 +79,23 @@ declare class KafkaJsDriver implements KafkaDriver {
     sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]>;
 }
 
+/**
+ * Classify a kafkajs producer error into a {@link PublishErrorKind} so the
+ * core relay can decide whether to retry, short-circuit to the DLQ, or pause
+ * polling.
+ *
+ * Mapping verified against `kafkajs/src/errors.js` (v2.x). Protocol error
+ * codes match the Kafka Protocol error-code registry. Library-specific
+ * subclasses (`KafkaJSRequestTimeoutError`, `KafkaJSConnectionError`,
+ * `KafkaJSNonRetriableError`) are matched by the `name` property kafkajs
+ * sets on its Error subclasses.
+ *
+ * Unknown errors fall back to `"retriable"` — the safe bias. At worst we
+ * retry an error that should have been skipped; in practice we'd rather
+ * over-retry than mis-classify a transient blip as terminal.
+ */
+declare function classifyKafkajsError(err: unknown): PublishErrorKind;
+
 interface CkProducer {
     connect(): Promise<void>;
     disconnect(): Promise<void>;
@@ -112,6 +129,21 @@ declare class ConfluentDriver implements KafkaDriver {
     sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]>;
 }
 
+/**
+ * Classify a `@confluentinc/kafka-javascript` (librdkafka) producer error
+ * into a {@link PublishErrorKind} so the core relay can decide whether to
+ * retry, short-circuit to the DLQ, or pause polling.
+ *
+ * librdkafka exposes errors as numeric `RD_KAFKA_RESP_ERR_*` codes — negative
+ * codes are library-internal (transport, queue-full, ssl), non-negative
+ * codes are wire-protocol errors that match the Kafka protocol's error-code
+ * registry. The confluent driver surfaces these on `err.code` (alongside
+ * an `err.name` for the symbolic form).
+ *
+ * Unknown errors fall back to `"retriable"` — the safe bias.
+ */
+declare function classifyConfluentError(err: unknown): PublishErrorKind;
+
 interface KafkaPublisherOptions extends KafkaConnectionConfig, ProducerBehaviorConfig {
     /** Which underlying client to use. Default "kafkajs". */
     driver?: DriverKind;
@@ -141,4 +173,4 @@ declare class KafkaPublisher implements Publisher {
     get transactional(): boolean;
 }
 
-export { ConfluentDriver, type ConfluentDriverOptions, type DriverKind, type KafkaConnectionConfig, type KafkaDriver, KafkaJsDriver, type KafkaJsDriverOptions, KafkaPublisher, type KafkaPublisherOptions, type ProducerBehaviorConfig };
+export { ConfluentDriver, type ConfluentDriverOptions, type DriverKind, type KafkaConnectionConfig, type KafkaDriver, KafkaJsDriver, type KafkaJsDriverOptions, KafkaPublisher, type KafkaPublisherOptions, type ProducerBehaviorConfig, classifyConfluentError, classifyKafkajsError };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PublishableMessage, PublishResult, Publisher } from '@eventferry/core';
+import { PublishableMessage, PublishResult, PublishErrorKind, Publisher } from '@eventferry/core';
 
 /**
  * Low-level driver contract. Each concrete driver (kafkajs, confluent)
@@ -79,6 +79,23 @@ declare class KafkaJsDriver implements KafkaDriver {
     sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]>;
 }
 
+/**
+ * Classify a kafkajs producer error into a {@link PublishErrorKind} so the
+ * core relay can decide whether to retry, short-circuit to the DLQ, or pause
+ * polling.
+ *
+ * Mapping verified against `kafkajs/src/errors.js` (v2.x). Protocol error
+ * codes match the Kafka Protocol error-code registry. Library-specific
+ * subclasses (`KafkaJSRequestTimeoutError`, `KafkaJSConnectionError`,
+ * `KafkaJSNonRetriableError`) are matched by the `name` property kafkajs
+ * sets on its Error subclasses.
+ *
+ * Unknown errors fall back to `"retriable"` — the safe bias. At worst we
+ * retry an error that should have been skipped; in practice we'd rather
+ * over-retry than mis-classify a transient blip as terminal.
+ */
+declare function classifyKafkajsError(err: unknown): PublishErrorKind;
+
 interface CkProducer {
     connect(): Promise<void>;
     disconnect(): Promise<void>;
@@ -112,6 +129,21 @@ declare class ConfluentDriver implements KafkaDriver {
     sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]>;
 }
 
+/**
+ * Classify a `@confluentinc/kafka-javascript` (librdkafka) producer error
+ * into a {@link PublishErrorKind} so the core relay can decide whether to
+ * retry, short-circuit to the DLQ, or pause polling.
+ *
+ * librdkafka exposes errors as numeric `RD_KAFKA_RESP_ERR_*` codes — negative
+ * codes are library-internal (transport, queue-full, ssl), non-negative
+ * codes are wire-protocol errors that match the Kafka protocol's error-code
+ * registry. The confluent driver surfaces these on `err.code` (alongside
+ * an `err.name` for the symbolic form).
+ *
+ * Unknown errors fall back to `"retriable"` — the safe bias.
+ */
+declare function classifyConfluentError(err: unknown): PublishErrorKind;
+
 interface KafkaPublisherOptions extends KafkaConnectionConfig, ProducerBehaviorConfig {
     /** Which underlying client to use. Default "kafkajs". */
     driver?: DriverKind;
@@ -141,4 +173,4 @@ declare class KafkaPublisher implements Publisher {
     get transactional(): boolean;
 }
 
-export { ConfluentDriver, type ConfluentDriverOptions, type DriverKind, type KafkaConnectionConfig, type KafkaDriver, KafkaJsDriver, type KafkaJsDriverOptions, KafkaPublisher, type KafkaPublisherOptions, type ProducerBehaviorConfig };
+export { ConfluentDriver, type ConfluentDriverOptions, type DriverKind, type KafkaConnectionConfig, type KafkaDriver, KafkaJsDriver, type KafkaJsDriverOptions, KafkaPublisher, type KafkaPublisherOptions, type ProducerBehaviorConfig, classifyConfluentError, classifyKafkajsError };

package/dist/index.js

@@ -1,3 +1,90 @@
+// src/kafkajs-classifier.ts
+function classifyKafkajsError(err) {
+  if (!err || typeof err !== "object") return "retriable";
+  const e = err;
+  if (e.name === "KafkaJSConnectionError") return "retriable";
+  if (e.name === "KafkaJSRequestTimeoutError") return "retriable";
+  if (e.name === "KafkaJSNonRetriableError") return "fatal";
+  const type = typeof e.type === "string" ? e.type : void 0;
+  if (type) {
+    if (RETRIABLE_TYPES.has(type)) return "retriable";
+    if (POISON_TYPES.has(type)) return "poison";
+    if (FATAL_TYPES.has(type)) return "fatal";
+  }
+  if (typeof e.code === "number") {
+    const k = CODE_TO_KIND.get(e.code);
+    if (k) return k;
+  }
+  return "retriable";
+}
+var RETRIABLE_TYPES = /* @__PURE__ */ new Set([
+  "NOT_LEADER_FOR_PARTITION",
+  "LEADER_NOT_AVAILABLE",
+  "UNKNOWN_TOPIC_OR_PARTITION",
+  "NETWORK_EXCEPTION",
+  "REQUEST_TIMED_OUT",
+  "REPLICA_NOT_AVAILABLE",
+  "NOT_ENOUGH_REPLICAS",
+  "NOT_ENOUGH_REPLICAS_AFTER_APPEND",
+  "FENCED_LEADER_EPOCH",
+  "UNKNOWN_LEADER_EPOCH",
+  "BROKER_NOT_AVAILABLE",
+  "COORDINATOR_LOAD_IN_PROGRESS",
+  "COORDINATOR_NOT_AVAILABLE"
+]);
+var POISON_TYPES = /* @__PURE__ */ new Set([
+  "CORRUPT_MESSAGE",
+  "MESSAGE_TOO_LARGE",
+  "INVALID_RECORD",
+  "UNSUPPORTED_COMPRESSION_TYPE",
+  "INVALID_REQUIRED_ACKS",
+  "INVALID_PARTITIONS"
+]);
+var FATAL_TYPES = /* @__PURE__ */ new Set([
+  "INVALID_PRODUCER_EPOCH",
+  "PRODUCER_FENCED",
+  "TOPIC_AUTHORIZATION_FAILED",
+  "CLUSTER_AUTHORIZATION_FAILED",
+  "TRANSACTIONAL_ID_AUTHORIZATION_FAILED",
+  "SASL_AUTHENTICATION_FAILED",
+  "INVALID_TRANSACTION_STATE",
+  "UNSUPPORTED_VERSION"
+]);
+var CODE_TO_KIND = /* @__PURE__ */ new Map([
+  [2, "poison"],
+  // CORRUPT_MESSAGE
+  [3, "retriable"],
+  // UNKNOWN_TOPIC_OR_PARTITION
+  [5, "retriable"],
+  // LEADER_NOT_AVAILABLE
+  [6, "retriable"],
+  // NOT_LEADER_FOR_PARTITION
+  [7, "retriable"],
+  // REQUEST_TIMED_OUT
+  [9, "retriable"],
+  // REPLICA_NOT_AVAILABLE
+  [10, "poison"],
+  // MESSAGE_TOO_LARGE
+  [13, "retriable"],
+  // NETWORK_EXCEPTION
+  [19, "retriable"],
+  // NOT_ENOUGH_REPLICAS
+  [29, "fatal"],
+  // TOPIC_AUTHORIZATION_FAILED
+  [31, "fatal"],
+  // CLUSTER_AUTHORIZATION_FAILED
+  [47, "fatal"],
+  // INVALID_PRODUCER_EPOCH
+  [58, "fatal"],
+  // SASL_AUTHENTICATION_FAILED
+  [74, "retriable"],
+  // FENCED_LEADER_EPOCH
+  [76, "poison"],
+  // UNSUPPORTED_COMPRESSION_TYPE
+  [87, "poison"]
+  // INVALID_RECORD
+]);
+
 // src/kafkajs-driver.ts
 var KafkaJsDriver = class {
   transactional;
@@ -49,19 +136,27 @@ var KafkaJsDriver = class {
         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 }));
+        return failedResults(messages, err);
       }
     }
     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 }));
+      return failedResults(messages, err);
     }
   }
 };
+function failedResults(messages, err) {
+  const error = err instanceof Error ? err : new Error(String(err));
+  const errorKind = classifyKafkajsError(err);
+  return messages.map((m) => ({
+    recordId: m.recordId,
+    ok: false,
+    error,
+    errorKind
+  }));
+}
 function groupByTopic(messages, compression) {
   const byTopic = /* @__PURE__ */ new Map();
   for (const m of messages) {
@@ -89,6 +184,104 @@ async function importKafkaJs() {
   }
 }
 
+// src/confluent-classifier.ts
+function classifyConfluentError(err) {
+  if (!err || typeof err !== "object") return "retriable";
+  const e = err;
+  if (typeof e.code === "number") {
+    const k = CODE_TO_KIND2.get(e.code);
+    if (k) return k;
+  }
+  if (typeof e.name === "string") {
+    const k = NAME_TO_KIND.get(e.name);
+    if (k) return k;
+  }
+  return "retriable";
+}
+var CODE_TO_KIND2 = /* @__PURE__ */ new Map([
+  // Library-internal (negative codes)
+  [-184, "backpressure"],
+  // ERR__QUEUE_FULL — our outbound buffer is full
+  [-185, "retriable"],
+  // ERR__TIMED_OUT
+  [-187, "retriable"],
+  // ERR__ALL_BROKERS_DOWN
+  [-188, "poison"],
+  // ERR__UNKNOWN_TOPIC — topic doesn't exist on broker
+  [-190, "poison"],
+  // ERR__UNKNOWN_PARTITION
+  [-192, "retriable"],
+  // ERR__MSG_TIMED_OUT
+  [-195, "retriable"],
+  // ERR__TRANSPORT
+  [-198, "poison"],
+  // ERR__BAD_COMPRESSION
+  [-144, "fatal"],
+  // ERR__FENCED — producer fenced by another with same txn id
+  [-150, "fatal"],
+  // ERR__FATAL — unrecoverable librdkafka error
+  [-169, "fatal"],
+  // ERR__AUTHENTICATION
+  [-181, "fatal"],
+  // ERR__SSL
+  [-196, "retriable"],
+  // ERR__FAIL — catch-all, safe-default to retriable
+  // Wire-protocol (non-negative codes — Kafka error-code registry)
+  [2, "poison"],
+  // CORRUPT_MESSAGE
+  [3, "retriable"],
+  // UNKNOWN_TOPIC_OR_PARTITION
+  [5, "retriable"],
+  // LEADER_NOT_AVAILABLE
+  [6, "retriable"],
+  // NOT_LEADER_FOR_PARTITION
+  [7, "retriable"],
+  // REQUEST_TIMED_OUT
+  [9, "retriable"],
+  // REPLICA_NOT_AVAILABLE
+  [10, "poison"],
+  // MESSAGE_TOO_LARGE
+  [13, "retriable"],
+  // NETWORK_EXCEPTION
+  [19, "retriable"],
+  // NOT_ENOUGH_REPLICAS
+  [29, "fatal"],
+  // TOPIC_AUTHORIZATION_FAILED
+  [31, "fatal"],
+  // CLUSTER_AUTHORIZATION_FAILED
+  [47, "fatal"],
+  // INVALID_PRODUCER_EPOCH
+  [58, "fatal"],
+  // SASL_AUTHENTICATION_FAILED
+  [74, "retriable"],
+  // FENCED_LEADER_EPOCH
+  [76, "poison"],
+  // UNSUPPORTED_COMPRESSION_TYPE
+  [87, "poison"],
+  // INVALID_RECORD
+  [89, "quota"]
+  // THROTTLING_QUOTA_EXCEEDED
+]);
+var NAME_TO_KIND = /* @__PURE__ */ new Map([
+  ["ERR__QUEUE_FULL", "backpressure"],
+  ["ERR__FENCED", "fatal"],
+  ["ERR__FATAL", "fatal"],
+  ["ERR__AUTHENTICATION", "fatal"],
+  ["ERR__SSL", "fatal"],
+  ["ERR__UNKNOWN_TOPIC", "poison"],
+  ["ERR__UNKNOWN_PARTITION", "poison"],
+  ["ERR__BAD_COMPRESSION", "poison"],
+  ["ERR_TOPIC_AUTHORIZATION_FAILED", "fatal"],
+  ["ERR_CLUSTER_AUTHORIZATION_FAILED", "fatal"],
+  ["ERR_INVALID_PRODUCER_EPOCH", "fatal"],
+  ["ERR_SASL_AUTHENTICATION_FAILED", "fatal"],
+  ["ERR_CORRUPT_MESSAGE", "poison"],
+  ["ERR_MSG_SIZE_TOO_LARGE", "poison"],
+  ["ERR_INVALID_RECORD", "poison"],
+  ["ERR_UNSUPPORTED_COMPRESSION_TYPE", "poison"],
+  ["ERR_THROTTLING_QUOTA_EXCEEDED", "quota"]
+]);
+
 // src/confluent-driver.ts
 var ConfluentDriver = class {
   transactional;
@@ -155,19 +348,27 @@ var ConfluentDriver = class {
         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 }));
+        return failedResults2(messages, err);
       }
     }
     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 }));
+      return failedResults2(messages, err);
     }
   }
 };
+function failedResults2(messages, err) {
+  const error = err instanceof Error ? err : new Error(String(err));
+  const errorKind = classifyConfluentError(err);
+  return messages.map((m) => ({
+    recordId: m.recordId,
+    ok: false,
+    error,
+    errorKind
+  }));
+}
 function groupByTopic2(messages) {
   const byTopic = /* @__PURE__ */ new Map();
   for (const m of messages) {
@@ -243,6 +444,8 @@ function selectDriver(opts) {
 export {
   ConfluentDriver,
   KafkaJsDriver,
-  KafkaPublisher
+  KafkaPublisher,
+  classifyConfluentError,
+  classifyKafkajsError
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"]}
+{"version":3,"sources":["../src/kafkajs-classifier.ts","../src/kafkajs-driver.ts","../src/confluent-classifier.ts","../src/confluent-driver.ts","../src/publisher.ts"],"sourcesContent":["import type { PublishErrorKind } from \"@eventferry/core\";\n\n/**\n * Classify a kafkajs producer error into a {@link PublishErrorKind} so the\n * core relay can decide whether to retry, short-circuit to the DLQ, or pause\n * polling.\n *\n * Mapping verified against `kafkajs/src/errors.js` (v2.x). Protocol error\n * codes match the Kafka Protocol error-code registry. Library-specific\n * subclasses (`KafkaJSRequestTimeoutError`, `KafkaJSConnectionError`,\n * `KafkaJSNonRetriableError`) are matched by the `name` property kafkajs\n * sets on its Error subclasses.\n *\n * Unknown errors fall back to `\"retriable\"` — the safe bias. At worst we\n * retry an error that should have been skipped; in practice we'd rather\n * over-retry than mis-classify a transient blip as terminal.\n */\nexport function classifyKafkajsError(err: unknown): PublishErrorKind {\n  if (!err || typeof err !== \"object\") return \"retriable\";\n  const e = err as { name?: string; type?: string; code?: number };\n\n  // Class-based first — these don't carry a protocol error code.\n  if (e.name === \"KafkaJSConnectionError\") return \"retriable\";\n  if (e.name === \"KafkaJSRequestTimeoutError\") return \"retriable\";\n  if (e.name === \"KafkaJSNonRetriableError\") return \"fatal\";\n\n  // Protocol error type (string) — kafkajs's KafkaJSProtocolError exposes\n  // both `type` (uppercase string) and `code` (number). Use `type` first\n  // for readability and fall back to `code` for codes that lack a stable\n  // string label.\n  const type = typeof e.type === \"string\" ? e.type : undefined;\n  if (type) {\n    if (RETRIABLE_TYPES.has(type)) return \"retriable\";\n    if (POISON_TYPES.has(type)) return \"poison\";\n    if (FATAL_TYPES.has(type)) return \"fatal\";\n  }\n\n  if (typeof e.code === \"number\") {\n    const k = CODE_TO_KIND.get(e.code);\n    if (k) return k;\n  }\n\n  return \"retriable\";\n}\n\nconst RETRIABLE_TYPES = new Set<string>([\n  \"NOT_LEADER_FOR_PARTITION\",\n  \"LEADER_NOT_AVAILABLE\",\n  \"UNKNOWN_TOPIC_OR_PARTITION\",\n  \"NETWORK_EXCEPTION\",\n  \"REQUEST_TIMED_OUT\",\n  \"REPLICA_NOT_AVAILABLE\",\n  \"NOT_ENOUGH_REPLICAS\",\n  \"NOT_ENOUGH_REPLICAS_AFTER_APPEND\",\n  \"FENCED_LEADER_EPOCH\",\n  \"UNKNOWN_LEADER_EPOCH\",\n  \"BROKER_NOT_AVAILABLE\",\n  \"COORDINATOR_LOAD_IN_PROGRESS\",\n  \"COORDINATOR_NOT_AVAILABLE\",\n]);\n\nconst POISON_TYPES = new Set<string>([\n  \"CORRUPT_MESSAGE\",\n  \"MESSAGE_TOO_LARGE\",\n  \"INVALID_RECORD\",\n  \"UNSUPPORTED_COMPRESSION_TYPE\",\n  \"INVALID_REQUIRED_ACKS\",\n  \"INVALID_PARTITIONS\",\n]);\n\nconst FATAL_TYPES = new Set<string>([\n  \"INVALID_PRODUCER_EPOCH\",\n  \"PRODUCER_FENCED\",\n  \"TOPIC_AUTHORIZATION_FAILED\",\n  \"CLUSTER_AUTHORIZATION_FAILED\",\n  \"TRANSACTIONAL_ID_AUTHORIZATION_FAILED\",\n  \"SASL_AUTHENTICATION_FAILED\",\n  \"INVALID_TRANSACTION_STATE\",\n  \"UNSUPPORTED_VERSION\",\n]);\n\n/** Numeric fallback for clusters that only return the wire code. */\nconst CODE_TO_KIND: ReadonlyMap<number, PublishErrorKind> = new Map([\n  [2, \"poison\"], // CORRUPT_MESSAGE\n  [3, \"retriable\"], // UNKNOWN_TOPIC_OR_PARTITION\n  [5, \"retriable\"], // LEADER_NOT_AVAILABLE\n  [6, \"retriable\"], // NOT_LEADER_FOR_PARTITION\n  [7, \"retriable\"], // REQUEST_TIMED_OUT\n  [9, \"retriable\"], // REPLICA_NOT_AVAILABLE\n  [10, \"poison\"], // MESSAGE_TOO_LARGE\n  [13, \"retriable\"], // NETWORK_EXCEPTION\n  [19, \"retriable\"], // NOT_ENOUGH_REPLICAS\n  [29, \"fatal\"], // TOPIC_AUTHORIZATION_FAILED\n  [31, \"fatal\"], // CLUSTER_AUTHORIZATION_FAILED\n  [47, \"fatal\"], // INVALID_PRODUCER_EPOCH\n  [58, \"fatal\"], // SASL_AUTHENTICATION_FAILED\n  [74, \"retriable\"], // FENCED_LEADER_EPOCH\n  [76, \"poison\"], // UNSUPPORTED_COMPRESSION_TYPE\n  [87, \"poison\"], // INVALID_RECORD\n]);\n","import type { PublishableMessage, PublishResult } from \"@eventferry/core\";\nimport { classifyKafkajsError } from \"./kafkajs-classifier.js\";\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        return failedResults(messages, err);\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      return failedResults(messages, err);\n    }\n  }\n}\n\nfunction failedResults(\n  messages: PublishableMessage[],\n  err: unknown,\n): PublishResult[] {\n  const error = err instanceof Error ? err : new Error(String(err));\n  const errorKind = classifyKafkajsError(err);\n  return messages.map((m) => ({\n    recordId: m.recordId,\n    ok: false,\n    error,\n    errorKind,\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 { PublishErrorKind } from \"@eventferry/core\";\n\n/**\n * Classify a `@confluentinc/kafka-javascript` (librdkafka) producer error\n * into a {@link PublishErrorKind} so the core relay can decide whether to\n * retry, short-circuit to the DLQ, or pause polling.\n *\n * librdkafka exposes errors as numeric `RD_KAFKA_RESP_ERR_*` codes — negative\n * codes are library-internal (transport, queue-full, ssl), non-negative\n * codes are wire-protocol errors that match the Kafka protocol's error-code\n * registry. The confluent driver surfaces these on `err.code` (alongside\n * an `err.name` for the symbolic form).\n *\n * Unknown errors fall back to `\"retriable\"` — the safe bias.\n */\nexport function classifyConfluentError(err: unknown): PublishErrorKind {\n  if (!err || typeof err !== \"object\") return \"retriable\";\n  const e = err as { code?: number; name?: string };\n\n  if (typeof e.code === \"number\") {\n    const k = CODE_TO_KIND.get(e.code);\n    if (k) return k;\n  }\n\n  if (typeof e.name === \"string\") {\n    const k = NAME_TO_KIND.get(e.name);\n    if (k) return k;\n  }\n\n  return \"retriable\";\n}\n\n/**\n * Authoritative mapping for the most-common librdkafka producer error codes.\n * Sources: `librdkafka/src/rdkafka.h` (`RD_KAFKA_RESP_ERR_*` enum) and the\n * Kafka Protocol error-code registry. Adding a code here is a one-line\n * change — start narrow, broaden as production exposes new codes.\n */\nconst CODE_TO_KIND: ReadonlyMap<number, PublishErrorKind> = new Map([\n  // Library-internal (negative codes)\n  [-184, \"backpressure\"], // ERR__QUEUE_FULL — our outbound buffer is full\n  [-185, \"retriable\"], // ERR__TIMED_OUT\n  [-187, \"retriable\"], // ERR__ALL_BROKERS_DOWN\n  [-188, \"poison\"], // ERR__UNKNOWN_TOPIC — topic doesn't exist on broker\n  [-190, \"poison\"], // ERR__UNKNOWN_PARTITION\n  [-192, \"retriable\"], // ERR__MSG_TIMED_OUT\n  [-195, \"retriable\"], // ERR__TRANSPORT\n  [-198, \"poison\"], // ERR__BAD_COMPRESSION\n  [-144, \"fatal\"], // ERR__FENCED — producer fenced by another with same txn id\n  [-150, \"fatal\"], // ERR__FATAL — unrecoverable librdkafka error\n  [-169, \"fatal\"], // ERR__AUTHENTICATION\n  [-181, \"fatal\"], // ERR__SSL\n  [-196, \"retriable\"], // ERR__FAIL — catch-all, safe-default to retriable\n\n  // Wire-protocol (non-negative codes — Kafka error-code registry)\n  [2, \"poison\"], // CORRUPT_MESSAGE\n  [3, \"retriable\"], // UNKNOWN_TOPIC_OR_PARTITION\n  [5, \"retriable\"], // LEADER_NOT_AVAILABLE\n  [6, \"retriable\"], // NOT_LEADER_FOR_PARTITION\n  [7, \"retriable\"], // REQUEST_TIMED_OUT\n  [9, \"retriable\"], // REPLICA_NOT_AVAILABLE\n  [10, \"poison\"], // MESSAGE_TOO_LARGE\n  [13, \"retriable\"], // NETWORK_EXCEPTION\n  [19, \"retriable\"], // NOT_ENOUGH_REPLICAS\n  [29, \"fatal\"], // TOPIC_AUTHORIZATION_FAILED\n  [31, \"fatal\"], // CLUSTER_AUTHORIZATION_FAILED\n  [47, \"fatal\"], // INVALID_PRODUCER_EPOCH\n  [58, \"fatal\"], // SASL_AUTHENTICATION_FAILED\n  [74, \"retriable\"], // FENCED_LEADER_EPOCH\n  [76, \"poison\"], // UNSUPPORTED_COMPRESSION_TYPE\n  [87, \"poison\"], // INVALID_RECORD\n  [89, \"quota\"], // THROTTLING_QUOTA_EXCEEDED\n]);\n\n/** Symbolic name fallback for clients that surface `err.name` only. */\nconst NAME_TO_KIND: ReadonlyMap<string, PublishErrorKind> = new Map([\n  [\"ERR__QUEUE_FULL\", \"backpressure\"],\n  [\"ERR__FENCED\", \"fatal\"],\n  [\"ERR__FATAL\", \"fatal\"],\n  [\"ERR__AUTHENTICATION\", \"fatal\"],\n  [\"ERR__SSL\", \"fatal\"],\n  [\"ERR__UNKNOWN_TOPIC\", \"poison\"],\n  [\"ERR__UNKNOWN_PARTITION\", \"poison\"],\n  [\"ERR__BAD_COMPRESSION\", \"poison\"],\n  [\"ERR_TOPIC_AUTHORIZATION_FAILED\", \"fatal\"],\n  [\"ERR_CLUSTER_AUTHORIZATION_FAILED\", \"fatal\"],\n  [\"ERR_INVALID_PRODUCER_EPOCH\", \"fatal\"],\n  [\"ERR_SASL_AUTHENTICATION_FAILED\", \"fatal\"],\n  [\"ERR_CORRUPT_MESSAGE\", \"poison\"],\n  [\"ERR_MSG_SIZE_TOO_LARGE\", \"poison\"],\n  [\"ERR_INVALID_RECORD\", \"poison\"],\n  [\"ERR_UNSUPPORTED_COMPRESSION_TYPE\", \"poison\"],\n  [\"ERR_THROTTLING_QUOTA_EXCEEDED\", \"quota\"],\n]);\n","import type { PublishableMessage, PublishResult } from \"@eventferry/core\";\nimport { classifyConfluentError } from \"./confluent-classifier.js\";\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        return failedResults(messages, err);\n      }\n    }\n\n    try {\n      await doSends(this.producer);\n      return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n    } catch (err) {\n      return failedResults(messages, err);\n    }\n  }\n}\n\nfunction failedResults(\n  messages: PublishableMessage[],\n  err: unknown,\n): PublishResult[] {\n  const error = err instanceof Error ? err : new Error(String(err));\n  const errorKind = classifyConfluentError(err);\n  return messages.map((m) => ({\n    recordId: m.recordId,\n    ok: false,\n    error,\n    errorKind,\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":["CODE_TO_KIND","groupByTopic","failedResults"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eventferry/kafka",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Kafka/Redpanda publisher for @eventferry (kafkajs + confluent drivers)",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -49,7 +49,7 @@
   "peerDependencies": {
     "kafkajs": "^2.0.0",
     "@confluentinc/kafka-javascript": "^1.0.0",
-    "@eventferry/core": "2.0.0"
+    "@eventferry/core": "3.0.0"
   },
   "peerDependenciesMeta": {
     "kafkajs": {
@@ -64,7 +64,7 @@
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8",
-    "@eventferry/core": "2.0.0"
+    "@eventferry/core": "3.0.0"
   },
   "scripts": {
     "build": "tsup",