@eventferry/kafka 3.0.0 → 3.2.0

package/dist/index.js

@@ -85,7 +85,27 @@ var CODE_TO_KIND = /* @__PURE__ */ new Map([
   // INVALID_RECORD
 ]);
 
+// src/transactional-id.ts
+async function resolveTransactionalId(input) {
+  if (input === void 0) {
+    throw new Error("transactionalId is required when transactional=true");
+  }
+  const raw = typeof input === "function" ? await input() : input;
+  if (typeof raw !== "string" || raw.length === 0) {
+    throw new Error(
+      "transactionalId resolver must return a non-empty string"
+    );
+  }
+  return raw;
+}
+
 // src/kafkajs-driver.ts
+var UNSUPPORTED_BY_KAFKAJS = [
+  "lingerMs",
+  "batchSize",
+  "deliveryTimeoutMs",
+  "maxRequestSize"
+];
 var KafkaJsDriver = class {
   transactional;
   producer = null;
@@ -98,6 +118,7 @@ var KafkaJsDriver = class {
         "KafkaJsDriver: transactionalId is required when transactional=true"
       );
     }
+    warnUnsupportedKafkajsOptions(opts);
   }
   async connect() {
     this.producer = await this.createProducer();
@@ -112,13 +133,37 @@ var KafkaJsDriver = class {
     const kafka = new mod.Kafka({
       clientId: this.opts.clientId ?? "eventferry",
       brokers: this.opts.brokers,
+      // kafkajs accepts `ssl: tls.ConnectionOptions` directly — Buffer + PEM
+      // string both supported. Our TlsConfig is a structural subset of that
+      // (`rejectUnauthorized` intentionally omitted; the cluster CA goes via
+      // `ca`). No translation needed.
       ssl: this.opts.ssl,
+      // SASL: PLAIN / SCRAM-SHA-256 / SCRAM-SHA-512 / OAUTHBEARER. kafkajs's
+      // shape matches ours; for OAUTHBEARER kafkajs reads only `value` from
+      // the provider's returned token (other fields are ignored).
       sasl: this.opts.sasl
     });
+    const createPartitioner = resolveCreatePartitioner(
+      mod.Partitioners,
+      this.opts.partitioner,
+      this.transactional
+    );
+    const resolvedTxId = this.transactional ? await resolveTransactionalId(this.opts.transactionalId) : void 0;
     return kafka.producer({
       idempotent: this.opts.idempotent ?? true,
-      maxInFlightRequests: this.transactional ? 1 : void 0,
-      transactionalId: this.transactional ? this.opts.transactionalId : void 0
+      // Idempotent / transactional producers cap maxInFlight at 5. When the
+      // user picks transactional we force 1 to keep strict ordering across
+      // retries on classic (non-idempotent) clusters that haven't migrated
+      // to the broker-side fence.
+      maxInFlightRequests: this.transactional ? 1 : this.opts.maxInFlightRequests,
+      transactionalId: resolvedTxId,
+      // kafkajs accepts these directly when set; undefined falls through to
+      // the kafkajs default.
+      requestTimeout: this.opts.requestTimeoutMs,
+      transactionTimeout: this.opts.transactionTimeoutMs,
+      // Setting any partitioner choice silences kafkajs's
+      // KafkaJSPartitionerNotSpecified warning.
+      createPartitioner
     });
   }
   async disconnect() {
@@ -136,6 +181,11 @@ 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));
+        try {
+          this.opts.onTransactionAbort?.(error);
+        } catch {
+        }
         return failedResults(messages, err);
       }
     }
@@ -164,7 +214,12 @@ function groupByTopic(messages, compression) {
     arr.push({
       key: m.key,
       value: m.value,
-      headers: m.headers
+      headers: m.headers,
+      // Per-message partition override. When set, kafkajs routes the record
+      // to this exact partition; when undefined, the configured partitioner
+      // chooses. We keep the key here too because compacted topics need it
+      // even when partition is pinned.
+      ...m.partition !== void 0 ? { partition: m.partition } : {}
     });
     byTopic.set(m.topic, arr);
   }
@@ -174,6 +229,35 @@ function groupByTopic(messages, compression) {
     ...compression && compression !== "none" ? { compression } : {}
   }));
 }
+function resolveCreatePartitioner(partitioners, choice, transactional) {
+  if (!partitioners) return void 0;
+  const effective = choice ?? (transactional ? "default" : "java-compatible");
+  switch (effective) {
+    case "java-compatible":
+      return partitioners.JavaCompatiblePartitioner;
+    case "legacy":
+      return partitioners.LegacyPartitioner;
+    case "default":
+      return partitioners.DefaultPartitioner;
+  }
+}
+var warnedKafkajsKeys = /* @__PURE__ */ new Set();
+function warnUnsupportedKafkajsOptions(opts) {
+  for (const key of UNSUPPORTED_BY_KAFKAJS) {
+    if (opts[key] === void 0) continue;
+    if (warnedKafkajsKeys.has(key)) continue;
+    warnedKafkajsKeys.add(key);
+    const message = `'${key}' is not configurable on the kafkajs driver and was ignored. Switch to the confluent driver (driver: "confluent") for fine-grained tuning, or remove the option to silence this warning.`;
+    if (opts.logger) {
+      opts.logger.warn(`[@eventferry/kafka] ${message}`, { option: key });
+    } else {
+      console.warn(`[@eventferry/kafka] ${message}`);
+    }
+  }
+}
+function _resetKafkajsWarnDedup() {
+  warnedKafkajsKeys.clear();
+}
 async function importKafkaJs() {
   try {
     return await import("kafkajs");
@@ -282,6 +366,71 @@ var NAME_TO_KIND = /* @__PURE__ */ new Map([
   ["ERR_THROTTLING_QUOTA_EXCEEDED", "quota"]
 ]);
 
+// src/confluent-config.ts
+function buildConfluentClientConfig(opts) {
+  const kafkaJS = {
+    clientId: opts.clientId ?? "eventferry",
+    brokers: opts.brokers
+  };
+  const librdkafka = {};
+  if (opts.lingerMs !== void 0) librdkafka["linger.ms"] = opts.lingerMs;
+  if (opts.batchSize !== void 0) librdkafka["batch.size"] = opts.batchSize;
+  if (opts.maxInFlightRequests !== void 0) {
+    librdkafka["max.in.flight.requests.per.connection"] = opts.maxInFlightRequests;
+  }
+  if (opts.requestTimeoutMs !== void 0) {
+    librdkafka["request.timeout.ms"] = opts.requestTimeoutMs;
+  }
+  if (opts.deliveryTimeoutMs !== void 0) {
+    librdkafka["delivery.timeout.ms"] = opts.deliveryTimeoutMs;
+  }
+  if (opts.maxRequestSize !== void 0) {
+    librdkafka["message.max.bytes"] = opts.maxRequestSize;
+  }
+  if (opts.transactionTimeoutMs !== void 0) {
+    librdkafka["transaction.timeout.ms"] = opts.transactionTimeoutMs;
+  }
+  const tlsRequested = opts.ssl === true || isTlsConfig(opts.ssl);
+  const saslRequested = !!opts.sasl;
+  if (saslRequested && tlsRequested) {
+    librdkafka["security.protocol"] = "sasl_ssl";
+  } else if (tlsRequested) {
+    librdkafka["security.protocol"] = "ssl";
+  } else if (saslRequested) {
+    librdkafka["security.protocol"] = "sasl_plaintext";
+  }
+  if (isTlsConfig(opts.ssl)) {
+    const tls = opts.ssl;
+    if (tls.ca !== void 0) {
+      librdkafka["ssl.ca.pem"] = stringifyPem(tls.ca);
+    }
+    if (tls.cert !== void 0) {
+      librdkafka["ssl.certificate.pem"] = stringifyPem(tls.cert);
+    }
+    if (tls.key !== void 0) {
+      librdkafka["ssl.key.pem"] = stringifyPem(tls.key);
+    }
+    if (tls.passphrase !== void 0) {
+      librdkafka["ssl.key.password"] = tls.passphrase;
+    }
+  } else if (opts.ssl === true) {
+    kafkaJS["ssl"] = true;
+  }
+  if (opts.sasl) {
+    kafkaJS["sasl"] = opts.sasl;
+  }
+  return { kafkaJS, librdkafka };
+}
+function isTlsConfig(v) {
+  return typeof v === "object" && v !== null;
+}
+function stringifyPem(input) {
+  if (Array.isArray(input)) {
+    return input.map((x) => typeof x === "string" ? x : x.toString("utf8")).join("\n");
+  }
+  return typeof input === "string" ? input : input.toString("utf8");
+}
+
 // src/confluent-driver.ts
 var ConfluentDriver = class {
   transactional;
@@ -306,18 +455,16 @@ var ConfluentDriver = class {
    */
   async createProducer() {
     const mod = await importConfluent();
+    const { kafkaJS, librdkafka } = buildConfluentClientConfig(this.opts);
     const kafka = new mod.KafkaJS.Kafka({
-      kafkaJS: {
-        clientId: this.opts.clientId ?? "eventferry",
-        brokers: this.opts.brokers,
-        ssl: this.opts.ssl,
-        sasl: this.opts.sasl
-      }
+      kafkaJS,
+      ...librdkafka
     });
+    const resolvedTxId = this.transactional ? await resolveTransactionalId(this.opts.transactionalId) : void 0;
     return kafka.producer({
       kafkaJS: {
         idempotent: this.opts.idempotent ?? true,
-        ...this.transactional ? { transactionalId: this.opts.transactionalId } : {}
+        ...resolvedTxId ? { transactionalId: resolvedTxId } : {}
       }
     });
   }
@@ -348,6 +495,11 @@ 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));
+        try {
+          this.opts.onTransactionAbort?.(error);
+        } catch {
+        }
         return failedResults2(messages, err);
       }
     }
@@ -373,7 +525,14 @@ 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 });
+    arr.push({
+      key: m.key,
+      value: m.value,
+      headers: m.headers,
+      // Per-message partition override. librdkafka honors an explicit
+      // partition value; undefined leaves the default partitioner in charge.
+      ...m.partition !== void 0 ? { partition: m.partition } : {}
+    });
     byTopic.set(m.topic, arr);
   }
   return [...byTopic.entries()].map(([topic, msgs]) => ({
@@ -391,20 +550,108 @@ async function importConfluent() {
   }
 }
 
+// src/hooks.ts
+async function safeHook(logger, hookName, invoke) {
+  try {
+    const r = invoke();
+    if (r && typeof r.then === "function") {
+      await r;
+    }
+  } catch (err) {
+    const error = err instanceof Error ? err : new Error(String(err));
+    logger?.warn(`[@eventferry/kafka] hook ${hookName} threw; ignored`, {
+      error: error.message
+    });
+  }
+}
+
+// src/tracing.ts
+var NoopKafkaTracer = class {
+  startPublishSpan() {
+    return NOOP_SPAN;
+  }
+};
+var NOOP_SPAN = {
+  setAttribute() {
+  },
+  setAttributes() {
+  },
+  setStatus() {
+  },
+  recordException() {
+  },
+  end() {
+  }
+};
+
 // src/publisher.ts
 var KafkaPublisher = class {
   driver;
+  logger;
+  hooks;
+  tracer;
   constructor(opts) {
-    this.driver = opts.customDriver ?? selectDriver(opts);
+    this.logger = opts.logger;
+    this.hooks = opts.hooks ?? {};
+    this.tracer = opts.tracer ?? new NoopKafkaTracer();
+    const onTransactionAbort = this.hooks.onTransactionAbort ? (error) => {
+      void safeHook(
+        this.logger,
+        "onTransactionAbort",
+        () => this.hooks.onTransactionAbort?.(error)
+      );
+    } : void 0;
+    this.driver = opts.customDriver ?? selectDriver({ ...opts, onTransactionAbort });
   }
-  connect() {
-    return this.driver.connect();
+  async connect() {
+    await this.driver.connect();
+    await safeHook(this.logger, "onConnect", () => this.hooks.onConnect?.());
   }
-  disconnect() {
-    return this.driver.disconnect();
+  async disconnect() {
+    await this.driver.disconnect();
+    await safeHook(
+      this.logger,
+      "onDisconnect",
+      () => this.hooks.onDisconnect?.()
+    );
   }
-  publish(messages) {
-    return this.driver.sendBatch(messages);
+  async publish(messages) {
+    if (messages.length === 0) return [];
+    const span = this.startBatchSpan(messages);
+    let results;
+    try {
+      results = await this.driver.sendBatch(messages);
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      span.setStatus({ code: "error", message: error.message });
+      span.recordException(error);
+      span.end();
+      await safeHook(this.logger, "onError", () => this.hooks.onError?.(error));
+      throw err;
+    }
+    const byId = new Map(messages.map((m) => [m.recordId, m]));
+    let allOk = true;
+    for (const r of results) {
+      const msg = byId.get(r.recordId);
+      if (!msg) continue;
+      await safeHook(
+        this.logger,
+        "onPublish",
+        () => this.hooks.onPublish?.(r, msg)
+      );
+      if (!r.ok) {
+        allOk = false;
+        const err = r.error ?? new Error("publish failed");
+        await safeHook(
+          this.logger,
+          "onError",
+          () => this.hooks.onError?.(err, msg)
+        );
+      }
+    }
+    span.setStatus(allOk ? { code: "ok" } : { code: "error" });
+    span.end();
+    return results;
   }
   /**
    * Send a single dead-lettered message. The message already carries the
@@ -429,6 +676,23 @@ var KafkaPublisher = class {
   get transactional() {
     return this.driver.transactional;
   }
+  /**
+   * Start a span for the batch following the OTel messaging conventions.
+   *
+   * Multi-topic batches: per the OTel spec, the span name uses the
+   * destination — we pick the FIRST topic in the batch and document the
+   * limitation. Callers that publish heterogeneous batches and care about
+   * per-topic spans should split their batches upstream.
+   */
+  startBatchSpan(messages) {
+    const topic = messages[0]?.topic ?? "unknown";
+    return this.tracer.startPublishSpan(`${topic} publish`, {
+      "messaging.system": "kafka",
+      "messaging.operation.type": "publish",
+      "messaging.destination.name": topic,
+      "messaging.batch.message_count": messages.length
+    });
+  }
 };
 function selectDriver(opts) {
   const kind = opts.driver ?? "kafkajs";
@@ -445,7 +709,11 @@ export {
   ConfluentDriver,
   KafkaJsDriver,
   KafkaPublisher,
+  NoopKafkaTracer,
+  _resetKafkajsWarnDedup,
+  buildConfluentClientConfig,
   classifyConfluentError,
-  classifyKafkajsError
+  classifyKafkajsError,
+  safeHook
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"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"]}
+{"version":3,"sources":["../src/kafkajs-classifier.ts","../src/transactional-id.ts","../src/kafkajs-driver.ts","../src/confluent-classifier.ts","../src/confluent-config.ts","../src/confluent-driver.ts","../src/hooks.ts","../src/tracing.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","/**\n * Resolve a {@link KafkaConnectionConfig}-style `transactionalId` into the\n * concrete string the underlying driver expects.\n *\n * Accepts:\n *   - `string`           — used verbatim.\n *   - `() => string`     — invoked once at connect time.\n *   - `() => Promise<string>` — awaited at connect time.\n *\n * Throws when the input is undefined (caller should pre-validate) or when\n * the callable yields an empty string.\n */\nexport async function resolveTransactionalId(\n  input: string | (() => string | Promise<string>) | undefined,\n): Promise<string> {\n  if (input === undefined) {\n    throw new Error(\"transactionalId is required when transactional=true\");\n  }\n  const raw = typeof input === \"function\" ? await input() : input;\n  if (typeof raw !== \"string\" || raw.length === 0) {\n    throw new Error(\n      \"transactionalId resolver must return a non-empty string\",\n    );\n  }\n  return raw;\n}\n","import type {\n  Logger,\n  PublishableMessage,\n  PublishResult,\n} from \"@eventferry/core\";\nimport { classifyKafkajsError } from \"./kafkajs-classifier.js\";\nimport { resolveTransactionalId } from \"./transactional-id.js\";\nimport type {\n  KafkaConnectionConfig,\n  KafkaDriver,\n  KafkaJsPartitionerChoice,\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// kafkajs's `Partitioners` namespace: three factory functions; we pluck them\n// at runtime rather than depending on the kafkajs types.\ninterface KjsPartitionersNamespace {\n  DefaultPartitioner: () => unknown;\n  LegacyPartitioner: () => unknown;\n  JavaCompatiblePartitioner: () => unknown;\n}\n\nexport interface KafkaJsDriverOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {\n  /**\n   * Optional logger for the driver's own diagnostics (e.g. warnings about\n   * unsupported tuning options). When absent the driver falls back to\n   * `console.warn` so existing users see the same output.\n   */\n  logger?: Logger;\n}\n\n/**\n * kafkajs producer-level knobs we expose on the typed API that kafkajs does\n * NOT actually support. On this driver these are warn-and-ignore; users\n * who need them should switch to the confluent driver.\n */\nconst UNSUPPORTED_BY_KAFKAJS = [\n  \"lingerMs\",\n  \"batchSize\",\n  \"deliveryTimeoutMs\",\n  \"maxRequestSize\",\n] as const;\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    warnUnsupportedKafkajsOptions(opts);\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      // kafkajs accepts `ssl: tls.ConnectionOptions` directly — Buffer + PEM\n      // string both supported. Our TlsConfig is a structural subset of that\n      // (`rejectUnauthorized` intentionally omitted; the cluster CA goes via\n      // `ca`). No translation needed.\n      ssl: this.opts.ssl,\n      // SASL: PLAIN / SCRAM-SHA-256 / SCRAM-SHA-512 / OAUTHBEARER. kafkajs's\n      // shape matches ours; for OAUTHBEARER kafkajs reads only `value` from\n      // the provider's returned token (other fields are ignored).\n      sasl: this.opts.sasl,\n    });\n    const createPartitioner = resolveCreatePartitioner(\n      mod.Partitioners,\n      this.opts.partitioner,\n      this.transactional,\n    );\n    // Resolve a callable transactionalId — async-safe so runtime context\n    // (pod name, AZ index, k8s ordinal) can be derived at connect time.\n    const resolvedTxId = this.transactional\n      ? await resolveTransactionalId(this.opts.transactionalId)\n      : undefined;\n    return kafka.producer({\n      idempotent: this.opts.idempotent ?? true,\n      // Idempotent / transactional producers cap maxInFlight at 5. When the\n      // user picks transactional we force 1 to keep strict ordering across\n      // retries on classic (non-idempotent) clusters that haven't migrated\n      // to the broker-side fence.\n      maxInFlightRequests: this.transactional\n        ? 1\n        : this.opts.maxInFlightRequests,\n      transactionalId: resolvedTxId,\n      // kafkajs accepts these directly when set; undefined falls through to\n      // the kafkajs default.\n      requestTimeout: this.opts.requestTimeoutMs,\n      transactionTimeout: this.opts.transactionTimeoutMs,\n      // Setting any partitioner choice silences kafkajs's\n      // KafkaJSPartitionerNotSpecified warning.\n      createPartitioner,\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        // Notify the abort hook BEFORE returning failedResults. The hook is\n        // best-effort: try/catch around it so a misbehaving hook can't make\n        // the abort path itself throw.\n        try {\n          this.opts.onTransactionAbort?.(error);\n        } catch {\n          // swallow — already documented as best-effort\n        }\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      // Per-message partition override. When set, kafkajs routes the record\n      // to this exact partition; when undefined, the configured partitioner\n      // chooses. We keep the key here too because compacted topics need it\n      // even when partition is pinned.\n      ...(m.partition !== undefined ? { partition: m.partition } : {}),\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\n/**\n * Resolve the `createPartitioner` factory kafkajs expects on\n * `producer({...})`. Returns `undefined` to fall through to the kafkajs\n * default when no choice is made AND the producer is non-transactional\n * (transactional producers don't trigger the no-partitioner warning).\n */\nfunction resolveCreatePartitioner(\n  partitioners: KjsPartitionersNamespace | undefined,\n  choice: KafkaJsPartitionerChoice | undefined,\n  transactional: boolean,\n): (() => unknown) | undefined {\n  if (!partitioners) return undefined;\n  // Default to the java-compatible partitioner when the caller didn't pick.\n  // It matches the Java client (murmur2) and silences the noisy warning;\n  // for transactional producers we leave the kafkajs default alone since\n  // EOS ordering is partitioner-agnostic and the warning doesn't fire there.\n  const effective: KafkaJsPartitionerChoice =\n    choice ?? (transactional ? \"default\" : \"java-compatible\");\n  switch (effective) {\n    case \"java-compatible\":\n      return partitioners.JavaCompatiblePartitioner;\n    case \"legacy\":\n      return partitioners.LegacyPartitioner;\n    case \"default\":\n      return partitioners.DefaultPartitioner;\n  }\n}\n\n/** Process-wide dedup so we never warn for the same option twice. */\nconst warnedKafkajsKeys = new Set<string>();\n\nfunction warnUnsupportedKafkajsOptions(opts: KafkaJsDriverOptions): void {\n  for (const key of UNSUPPORTED_BY_KAFKAJS) {\n    if (opts[key] === undefined) continue;\n    if (warnedKafkajsKeys.has(key)) continue;\n    warnedKafkajsKeys.add(key);\n    const message =\n      `'${key}' is not configurable on the kafkajs driver and was ignored. ` +\n      `Switch to the confluent driver (driver: \"confluent\") for fine-grained tuning, ` +\n      `or remove the option to silence this warning.`;\n    // Route through the configured logger when present; otherwise fall back\n    // to console.warn so users who never plumbed a logger still see the\n    // diagnostic (matches the prior behavior).\n    if (opts.logger) {\n      opts.logger.warn(`[@eventferry/kafka] ${message}`, { option: key });\n    } else {\n      console.warn(`[@eventferry/kafka] ${message}`);\n    }\n  }\n}\n\n/** Internal — used by tests. Resets the dedup so warnings can be observed in isolation. */\nexport function _resetKafkajsWarnDedup(): void {\n  warnedKafkajsKeys.clear();\n}\n\nasync function importKafkaJs(): Promise<{\n  Kafka: new (cfg: unknown) => KjsKafka;\n  Partitioners: KjsPartitionersNamespace;\n}> {\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 {\n  KafkaConnectionConfig,\n  ProducerBehaviorConfig,\n  TlsConfig,\n} from \"./driver.js\";\n\n/**\n * Translate eventferry's normalized `KafkaConnectionConfig` into the shape\n * expected by `@confluentinc/kafka-javascript`'s `KafkaJS.Kafka` constructor.\n *\n * Returns an object with two parts:\n *   - `kafkaJS`: the kafkajs-compatible config layer (clientId, brokers, and\n *     simple ssl/sasl when no advanced TLS is needed).\n *   - top-level keys: librdkafka-style config (e.g. `ssl.ca.pem`,\n *     `security.protocol`) used when the user supplies a {@link TlsConfig}.\n *\n * Why a separate translator: the kafkajs-compat layer accepts the simple\n * `ssl: true` boolean but the verified path for mTLS (CA + cert + key) is\n * librdkafka's `ssl.*.pem` keys. The translator picks the right surface\n * based on what the caller supplied. Buffer inputs are coerced to strings —\n * librdkafka accepts PEM strings, NOT Buffers.\n */\nexport interface ConfluentClientConfig {\n  kafkaJS: Record<string, unknown>;\n  // librdkafka top-level keys; kept as a Record so we can spread them.\n  librdkafka: Record<string, unknown>;\n}\n\nexport function buildConfluentClientConfig(\n  opts: KafkaConnectionConfig & ProducerBehaviorConfig,\n): ConfluentClientConfig {\n  const kafkaJS: Record<string, unknown> = {\n    clientId: opts.clientId ?? \"eventferry\",\n    brokers: opts.brokers,\n  };\n  const librdkafka: Record<string, unknown> = {};\n\n  // ── Producer tuning passthrough (librdkafka config keys) ─────────────\n  if (opts.lingerMs !== undefined) librdkafka[\"linger.ms\"] = opts.lingerMs;\n  if (opts.batchSize !== undefined) librdkafka[\"batch.size\"] = opts.batchSize;\n  if (opts.maxInFlightRequests !== undefined) {\n    librdkafka[\"max.in.flight.requests.per.connection\"] =\n      opts.maxInFlightRequests;\n  }\n  if (opts.requestTimeoutMs !== undefined) {\n    librdkafka[\"request.timeout.ms\"] = opts.requestTimeoutMs;\n  }\n  if (opts.deliveryTimeoutMs !== undefined) {\n    librdkafka[\"delivery.timeout.ms\"] = opts.deliveryTimeoutMs;\n  }\n  if (opts.maxRequestSize !== undefined) {\n    librdkafka[\"message.max.bytes\"] = opts.maxRequestSize;\n  }\n  if (opts.transactionTimeoutMs !== undefined) {\n    librdkafka[\"transaction.timeout.ms\"] = opts.transactionTimeoutMs;\n  }\n\n  const tlsRequested = opts.ssl === true || isTlsConfig(opts.ssl);\n  const saslRequested = !!opts.sasl;\n\n  if (saslRequested && tlsRequested) {\n    librdkafka[\"security.protocol\"] = \"sasl_ssl\";\n  } else if (tlsRequested) {\n    librdkafka[\"security.protocol\"] = \"ssl\";\n  } else if (saslRequested) {\n    librdkafka[\"security.protocol\"] = \"sasl_plaintext\";\n  } // else: leave as default (plaintext)\n\n  if (isTlsConfig(opts.ssl)) {\n    // Custom TLS — explicit librdkafka PEM keys. Buffers are coerced to\n    // strings (librdkafka does not accept Buffer).\n    const tls = opts.ssl;\n    if (tls.ca !== undefined) {\n      librdkafka[\"ssl.ca.pem\"] = stringifyPem(tls.ca);\n    }\n    if (tls.cert !== undefined) {\n      librdkafka[\"ssl.certificate.pem\"] = stringifyPem(tls.cert);\n    }\n    if (tls.key !== undefined) {\n      librdkafka[\"ssl.key.pem\"] = stringifyPem(tls.key);\n    }\n    if (tls.passphrase !== undefined) {\n      librdkafka[\"ssl.key.password\"] = tls.passphrase;\n    }\n    // servername (SNI) — librdkafka derives SNI from `ssl.endpoint.identification.algorithm`;\n    // explicit SNI override is not documented in the v1.x kafkaJS-compat surface, so we\n    // honor it as a no-op for now and document the limitation in the gap analysis.\n  } else if (opts.ssl === true) {\n    // Simple TLS — kafkajs-compat boolean is sufficient.\n    kafkaJS[\"ssl\"] = true;\n  }\n\n  if (opts.sasl) {\n    // SASL — kafkajs-compat shape works for both password mechanisms and\n    // OAUTHBEARER (the confluent client implements the provider callback).\n    kafkaJS[\"sasl\"] = opts.sasl;\n  }\n\n  return { kafkaJS, librdkafka };\n}\n\nfunction isTlsConfig(v: unknown): v is TlsConfig {\n  return typeof v === \"object\" && v !== null;\n}\n\nfunction stringifyPem(input: string | Buffer | Array<string | Buffer>): string {\n  if (Array.isArray(input)) {\n    return input.map((x) => (typeof x === \"string\" ? x : x.toString(\"utf8\"))).join(\"\\n\");\n  }\n  return typeof input === \"string\" ? input : input.toString(\"utf8\");\n}\n","import type { PublishableMessage, PublishResult } from \"@eventferry/core\";\nimport { classifyConfluentError } from \"./confluent-classifier.js\";\nimport { buildConfluentClientConfig } from \"./confluent-config.js\";\nimport { resolveTransactionalId } from \"./transactional-id.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 { kafkaJS, librdkafka } = buildConfluentClientConfig(this.opts);\n    const kafka: CkKafka = new mod.KafkaJS.Kafka({\n      kafkaJS,\n      ...librdkafka,\n    });\n    // Resolve a callable transactionalId — async-safe so runtime context\n    // (pod name, AZ index, k8s ordinal) can be derived at connect time.\n    const resolvedTxId = this.transactional\n      ? await resolveTransactionalId(this.opts.transactionalId)\n      : undefined;\n    return kafka.producer({\n      kafkaJS: {\n        idempotent: this.opts.idempotent ?? true,\n        ...(resolvedTxId ? { transactionalId: resolvedTxId } : {}),\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        try {\n          this.opts.onTransactionAbort?.(error);\n        } catch {\n          // swallow — abort hook is best-effort\n        }\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({\n      key: m.key,\n      value: m.value,\n      headers: m.headers,\n      // Per-message partition override. librdkafka honors an explicit\n      // partition value; undefined leaves the default partitioner in charge.\n      ...(m.partition !== undefined ? { partition: m.partition } : {}),\n    });\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 { PublishableMessage, PublishResult, Logger } from \"@eventferry/core\";\n\n/**\n * Lifecycle hooks fired by `KafkaPublisher`. Every hook is optional. The\n * publisher wraps each invocation in a try/catch and logs (via the\n * configured logger) on failure — a misbehaving hook will NEVER break\n * publishing.\n *\n * Typical wiring:\n *   - Custom observability stacks (Datadog APM, New Relic) → `onPublish`,\n *     `onError`, `onTransactionAbort`.\n *   - Connection-aware readiness probes → `onConnect` / `onDisconnect`.\n *   - Audit logs of every published record → `onPublish`.\n */\nexport interface KafkaPublisherHooks {\n  /** Fires after the underlying client successfully connects. */\n  onConnect?(): void | Promise<void>;\n  /** Fires after the underlying client disconnects (clean shutdown). */\n  onDisconnect?(): void | Promise<void>;\n  /**\n   * Fires once per record after a publish attempt — both successes and\n   * failures. The `result.ok` flag distinguishes them.\n   */\n  onPublish?(\n    result: PublishResult,\n    message: PublishableMessage,\n  ): void | Promise<void>;\n  /**\n   * Fires for any error surfaced from the publish path — driver-thrown\n   * errors, transaction abort errors, etc. `message` is set when the error\n   * is per-record; absent for batch-level errors (e.g. connect failure).\n   */\n  onError?(\n    error: Error,\n    message?: PublishableMessage,\n  ): void | Promise<void>;\n  /**\n   * Fires when a transactional sendBatch's inner abort path is taken.\n   * Useful for observability dashboards that track EOS failure rates.\n   */\n  onTransactionAbort?(error: Error): void | Promise<void>;\n}\n\n/**\n * Invoke a hook safely. Never throws back into the caller — logs the hook's\n * failure via the configured logger (or no-op when logger is absent).\n */\nexport async function safeHook(\n  logger: Logger | undefined,\n  hookName: keyof KafkaPublisherHooks,\n  invoke: () => void | Promise<void> | undefined,\n): Promise<void> {\n  try {\n    const r = invoke();\n    if (r && typeof (r as Promise<void>).then === \"function\") {\n      await r;\n    }\n  } catch (err) {\n    const error = err instanceof Error ? err : new Error(String(err));\n    logger?.warn(`[@eventferry/kafka] hook ${hookName} threw; ignored`, {\n      error: error.message,\n    });\n  }\n}\n","/**\n * Tracing surface for the publisher.\n *\n * eventferry deliberately does not depend on `@opentelemetry/api` — instead\n * users wire a thin adapter over their tracing system (OpenTelemetry,\n * Datadog, internal, …). This file defines the minimal contract; an\n * OpenTelemetry adapter is ~10 lines (see the README).\n *\n * The contract follows the **current stable** OpenTelemetry messaging\n * semantic conventions\n * ({@link https://github.com/open-telemetry/semantic-conventions/blob/main/docs/messaging/kafka.md spec}):\n *\n *   - Span name: `\"{topic} publish\"`\n *   - `SpanKind.PRODUCER`\n *   - Required attributes: `messaging.system=kafka`,\n *     `messaging.operation.type=publish`, `messaging.destination.name=<topic>`\n *   - Recommended: `messaging.batch.message_count`, `messaging.kafka.partition`,\n *     `server.address`, `server.port`\n *   - One span per batch (NOT per message — per-message spans cause\n *     cardinality explosion and the spec actively warns against this)\n */\n\n/** Attribute values the spec allows. */\nexport type SpanAttributeValue = string | number | boolean;\n\n/**\n * Minimal span surface the publisher needs. Implementations wrap a\n * tracing-system-specific span; methods MUST never throw out of the\n * publisher's hot path (wrap your own SDK calls in try/catch).\n */\nexport interface SpanLike {\n  setAttribute(key: string, value: SpanAttributeValue): void;\n  setAttributes(attrs: Record<string, SpanAttributeValue>): void;\n  /** OK on success; ERROR on failure. The `message` is the error message. */\n  setStatus(status: { code: \"ok\" | \"error\"; message?: string }): void;\n  /** Attach an exception to the span (OpenTelemetry `recordException`). */\n  recordException(error: Error): void;\n  end(): void;\n}\n\n/**\n * Factory the publisher calls once per `sendBatch` to start a span.\n * Implementations MUST set `SpanKind.PRODUCER` and the messaging semconv\n * attributes on the returned span before returning it.\n */\nexport interface KafkaTracer {\n  /**\n   * Start a publish span.\n   * @param name        Recommended format: `\"{topic} publish\"`.\n   * @param attributes  Initial attributes (the publisher supplies the messaging\n   *                    semconv set: system, destination.name, operation.type,\n   *                    batch.message_count, plus optional kafka.partition and\n   *                    server.address/port).\n   */\n  startPublishSpan(\n    name: string,\n    attributes: Record<string, SpanAttributeValue>,\n  ): SpanLike;\n}\n\n/**\n * No-op tracer. Used when the user does not configure one. Cheap allocation\n * — never touches I/O.\n */\nexport class NoopKafkaTracer implements KafkaTracer {\n  startPublishSpan(): SpanLike {\n    return NOOP_SPAN;\n  }\n}\n\nconst NOOP_SPAN: SpanLike = {\n  setAttribute() {},\n  setAttributes() {},\n  setStatus() {},\n  recordException() {},\n  end() {},\n};\n","import type {\n  Logger,\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\";\nimport { safeHook } from \"./hooks.js\";\nimport type { KafkaPublisherHooks } from \"./hooks.js\";\nimport { NoopKafkaTracer } from \"./tracing.js\";\nimport type { KafkaTracer, SpanLike } from \"./tracing.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   * Optional structured logger. When set, the publisher routes its own\n   * diagnostics (driver warnings, hook failures) through it. When omitted,\n   * the publisher is silent — only the underlying drivers may still log.\n   */\n  logger?: Logger;\n  /**\n   * Optional lifecycle hooks. Every hook is invoked safely (try/catch +\n   * logged via `logger`) and a misbehaving hook will never break publishing.\n   */\n  hooks?: KafkaPublisherHooks;\n  /**\n   * Optional tracer. When set, `publish()` wraps each batch in a span that\n   * follows the current stable OpenTelemetry messaging semantic conventions.\n   * Use a thin adapter over your tracing SDK (see {@link KafkaTracer}).\n   */\n  tracer?: KafkaTracer;\n}\n\n/**\n * The Publisher the Relay talks to. Wraps a pluggable KafkaDriver and adds\n * dead-letter routing, observability hooks, and OpenTelemetry-shaped publish\n * spans. Works against Kafka and Redpanda identically (Redpanda is Kafka-API\n * compatible).\n */\nexport class KafkaPublisher implements Publisher {\n  private readonly driver: KafkaDriver;\n  private readonly logger: Logger | undefined;\n  private readonly hooks: KafkaPublisherHooks;\n  private readonly tracer: KafkaTracer;\n\n  constructor(opts: KafkaPublisherOptions) {\n    this.logger = opts.logger;\n    this.hooks = opts.hooks ?? {};\n    this.tracer = opts.tracer ?? new NoopKafkaTracer();\n    // Plumb the logger into driver construction so driver-side diagnostics\n    // (e.g. kafkajs unsupported-tuning warnings) route through it too.\n    // Plumb a safe-wrapped onTransactionAbort callback so the driver-level\n    // transaction abort path fans out to the user-supplied hook safely.\n    const onTransactionAbort = this.hooks.onTransactionAbort\n      ? (error: Error) => {\n          void safeHook(this.logger, \"onTransactionAbort\", () =>\n            this.hooks.onTransactionAbort?.(error),\n          );\n        }\n      : undefined;\n    this.driver =\n      opts.customDriver ?? selectDriver({ ...opts, onTransactionAbort });\n  }\n\n  async connect(): Promise<void> {\n    await this.driver.connect();\n    await safeHook(this.logger, \"onConnect\", () => this.hooks.onConnect?.());\n  }\n\n  async disconnect(): Promise<void> {\n    await this.driver.disconnect();\n    await safeHook(this.logger, \"onDisconnect\", () =>\n      this.hooks.onDisconnect?.(),\n    );\n  }\n\n  async publish(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (messages.length === 0) return [];\n\n    const span = this.startBatchSpan(messages);\n    let results: PublishResult[];\n    try {\n      results = await this.driver.sendBatch(messages);\n    } catch (err) {\n      // Driver-level throw — every record is a failure attributed to the\n      // batch-level error. Record on the span, fire hook, rethrow.\n      const error = err instanceof Error ? err : new Error(String(err));\n      span.setStatus({ code: \"error\", message: error.message });\n      span.recordException(error);\n      span.end();\n      await safeHook(this.logger, \"onError\", () => this.hooks.onError?.(error));\n      throw err;\n    }\n\n    // Per-record hooks. Walk by index so the original message is available.\n    const byId = new Map(messages.map((m) => [m.recordId, m]));\n    let allOk = true;\n    for (const r of results) {\n      const msg = byId.get(r.recordId);\n      if (!msg) continue;\n      await safeHook(this.logger, \"onPublish\", () =>\n        this.hooks.onPublish?.(r, msg),\n      );\n      if (!r.ok) {\n        allOk = false;\n        const err = r.error ?? new Error(\"publish failed\");\n        await safeHook(this.logger, \"onError\", () =>\n          this.hooks.onError?.(err, msg),\n        );\n      }\n    }\n\n    span.setStatus(allOk ? { code: \"ok\" } : { code: \"error\" });\n    span.end();\n    return results;\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  /**\n   * Start a span for the batch following the OTel messaging conventions.\n   *\n   * Multi-topic batches: per the OTel spec, the span name uses the\n   * destination — we pick the FIRST topic in the batch and document the\n   * limitation. Callers that publish heterogeneous batches and care about\n   * per-topic spans should split their batches upstream.\n   */\n  private startBatchSpan(messages: PublishableMessage[]): SpanLike {\n    const topic = messages[0]?.topic ?? \"unknown\";\n    return this.tracer.startPublishSpan(`${topic} publish`, {\n      \"messaging.system\": \"kafka\",\n      \"messaging.operation.type\": \"publish\",\n      \"messaging.destination.name\": topic,\n      \"messaging.batch.message_count\": messages.length,\n    });\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": "3.0.0",
+  "version": "3.2.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": "3.0.0"
+    "@eventferry/core": "3.2.0"
   },
   "peerDependenciesMeta": {
     "kafkajs": {
@@ -64,7 +64,7 @@
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8",
-    "@eventferry/core": "3.0.0"
+    "@eventferry/core": "3.2.0"
   },
   "scripts": {
     "build": "tsup",